caldiff

Календарная математика последовательные различия

Описание

пример

dt = caldiff(t) вычисляет разницу во времени между смежными значениями datetime в t в терминах календарных лет компонентов, месяцев, дней и времени. caldiff вычисляет различия вдоль первого измерения массива, размер которого не равняется 1.

  • Если t вектор длины m, затем dt = caldiff(t) возвращает вектор длины m-1. Элементы dt различия между смежными элементами t.

    dt = [between(t(1),t(2)), between(t(2),t(3)),..., between(t(m-1),t(m))]
  • Если t невекторный p- m матрица, затем dt = caldiff(t) возвращает матрицу размера (p-1)- m, чьими элементами являются различия между строками t.

    dt(:,I) = [between(t(1,I),t(2,I), between(t(2,I),t(3,I)), ..., 
    between(t(p-1,I),t(p,I))]

пример

dt = caldiff(t,components) находит различия между последовательным datetimes в t в терминах заданного календаря или компонентов времени.

dt = caldiff(t,components,dim) находит различия между последовательным datetimes по измерению заданными dim.

Примеры

свернуть все

Создайте datetime массив и затем вычисляет различия между значениями в терминах календарных компонентов.

t = [datetime('yesterday');datetime('today');datetime('tomorrow')]
t = 3x1 datetime
   28-Jan-2020
   29-Jan-2020
   30-Jan-2020

D = caldiff(t)
D = 2x1 calendarDuration
   1d
   1d

Создайте datetime массив и затем вычисляет различия между значениями в терминах дней.

t = datetime('now') + calmonths(0:3)
t = 1x4 datetime
Columns 1 through 3

   29-Jan-2020 12:24:51   29-Feb-2020 12:24:51   29-Mar-2020 12:24:51

Column 4

   29-Apr-2020 12:24:51

D = caldiff(t,'days')
D = 1x3 calendarDuration
   31d   29d   31d

Компьютер различия между значениями datetime в терминах недель и дней.

D = caldiff(t,{'weeks','days'})
D = 1x3 calendarDuration
   4w 3d   4w 1d   4w 3d

Входные параметры

свернуть все

Введите дату и время в виде datetime массив.

Календарь или компоненты времени в виде одного из следующих векторов символов, или массив ячеек или массив строк, содержащий один или несколько из этих значений:

  • 'years'

  • 'quarters'

  • 'months'

  • 'weeks'

  • 'days'

  • 'time'

За исключением 'time', вышеупомянутые компоненты являются гибкими отрезками времени. Например, один месяц представляет различный отрезок времени, когда добавлено к datetime в январе чем тогда, когда добавлено к datetime в феврале.

caldiff работает с календарем или компонентами времени в порядке убывания, начиная с самого большого компонента.

В общем случае t(2:m) не равно t(1:m-1) + dt, если вы не включаете 'time' в components.

Пример: {'years','quarters'}

Типы данных: char | cell | string

Размерность, которая задает направление расчета в виде положительного целого числа. Если никакое значение не задано, значением по умолчанию является первое измерение массива, размер которого не равняется 1.

Выходные аргументы

свернуть все

Массив различия, возвращенный как скаляр, вектор, матрица или многомерный calendarDuration массив.

Советы

  • Вычислить последовательные различия между datetimes в t1 и t2 как точные модули фиксированной длины часов, минуты и секунды, используют diff(t).

Расширенные возможности

Смотрите также

| | |

Введенный в R2014b

Для просмотра документации необходимо авторизоваться на сайте