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
   16-Aug-2020
   17-Aug-2020
   18-Aug-2020

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

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

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

   17-Aug-2020 15:40:10   17-Sep-2020 15:40:10   17-Oct-2020 15:40:10

Column 4

   17-Nov-2020 15:40:10

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

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

D = caldiff(t,{'weeks','days'})
D = 1x3 calendarDuration
   4w 3d   4w 2d   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
Для просмотра документации необходимо авторизоваться на сайте