between

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

Описание

пример

dt = between(t1,t2) возвращает различия между значениями datetime в t1 и t2. The dt выход a calendarDuration массив в терминах календарных компонентов лет, месяцев, дней и времени, таких что t2 = t1+dt.

пример

dt = between(t1,t2,components) возвращает различия между значениями datetime в терминах заданного календаря или временных компонентов.

Примеры

свернуть все

Создайте два datetime массивы.

t1 = datetime('now')
t1 = datetime
   23-Mar-2021 17:05:36

t2 = datetime('tomorrow','Format','dd-MMM-yyyy HH:mm:ss') + caldays(0:2)
t2 = 1x3 datetime
   24-Mar-2021 00:00:00   25-Mar-2021 00:00:00   26-Mar-2021 00:00:00

Найдите различие между двумя массивами.

dt = between(t1,t2)
dt = 1x3 calendarDuration
      6h 54m 23.164s   1d 6h 54m 23.164s   2d 6h 54m 23.164s

between возвращает calendarDuration массив, содержащий различия в днях, часах, минутах и секундах.

Создайте последовательность datetimes за 6-месячный период. Затем найдите количество дней между первой датой и каждой из дат в последовательности.

t1 = datetime(2013,1,1);
t2 = dateshift(t1,'end','month',0:4)
t2 = 1x5 datetime
   31-Jan-2013   28-Feb-2013   31-Mar-2013   30-Apr-2013   31-May-2013

dt = between(t1,t2,'Days')
dt = 1x5 calendarDuration
    30d    58d    89d   119d   150d

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

свернуть все

Дата и время входа, заданные как datetime массив, вектор символов, массив ячеек векторов символов или строковых массивов. По крайней мере, один из входов t1 и t2 должен быть datetime массив. t1 и t2 должен быть одинаковым размером, если только он не является скаляром.

Дата и время входа, заданные как datetime массив, вектор символов, массив ячеек векторов символов или строковых массивов. По крайней мере, один из входов t1 и t2 должен быть datetime массив. t1 и t2 должен быть одинаковым размером, если только он не является скаляром.

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

  • 'years'

  • 'quarters'

  • 'months'

  • 'weeks'

  • 'days'

  • 'time'

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

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

В целом, t2 не равно t1 + dt, если вы не включите 'time' в components.

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

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

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

свернуть все

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

Совет

  • Чтобы вычислить различия между значениями datetime в t1 и t2 в качестве точных длин фиксированной длины используйте t2-t1.

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

См. также

| | |

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