Exponenta Banner

caldiff

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

свернуть все на странице

Синтаксис

dt = caldiff(t)
dt = caldiff(t,components)
dt = caldiff(t,components,dim)

Описание

пример

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.

Примеры

свернуть все

Скрипт Open Live Script

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

t = [datetime('yesterday');datetime('today');datetime('tomorrow')]
t = 3x1 datetime array
   19-Dec-2019
   20-Dec-2019
   21-Dec-2019


D = caldiff(t)
D = 2x1 calendarDuration array
   1d
   1d
Скрипт Open Live Script

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

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

   20-Dec-2019 17:06:30   20-Jan-2020 17:06:30   20-Feb-2020 17:06:30

Column 4

   20-Mar-2020 17:06:30


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

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

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

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

свернуть все

Введите дату и время, заданную как 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

Документация MATLAB
Поддержка