Сгенерируйте последовательность дат и времени

Последовательность значений Datetime или длительности между конечными точками с размером шага

В этом примере показано, как использовать оператор двоеточия (:) для генерации последовательностей datetime или duration значения так же, как вы создаете регулярно разнесенные числовые векторы.

Используйте размер шага по умолчанию

Создайте последовательность значений datetime, начиная с 1 ноября 2013 года и заканчивая 5 ноября 2013 года. Размер шага по умолчанию является одним календарным днем.

t1 = datetime(2013,11,1,8,0,0);
t2 = datetime(2013,11,5,8,0,0);
t = t1:t2
t = 1x5 datetime
Columns 1 through 3

   01-Nov-2013 08:00:00   02-Nov-2013 08:00:00   03-Nov-2013 08:00:00

Columns 4 through 5

   04-Nov-2013 08:00:00   05-Nov-2013 08:00:00

Задайте размер шага

Задайте размер шага 2 календарных дня с помощью caldays функция.

t = t1:caldays(2):t2
t = 1x3 datetime
   01-Nov-2013 08:00:00   03-Nov-2013 08:00:00   05-Nov-2013 08:00:00

Задайте размер шага в модулях, отличных от дней. Создайте последовательность значений datetime с интервалом 18 часа.

t = t1:hours(18):t2
t = 1x6 datetime
Columns 1 through 3

   01-Nov-2013 08:00:00   02-Nov-2013 02:00:00   02-Nov-2013 20:00:00

Columns 4 through 6

   03-Nov-2013 14:00:00   04-Nov-2013 08:00:00   05-Nov-2013 02:00:00

Используйте years, days, minutes, и seconds функции для создания последовательностей datetime и длительность с использованием других дат и временных модулей с фиксированной длиной. Создайте последовательность значений длительности от 0 до 3 минут с шагом в 30 секунд.

d = 0:seconds(30):minutes(3)
d = 1x7 duration
     0 sec    30 sec    60 sec    90 sec   120 sec   150 sec   180 sec

Сравнение размеров шагов длительности по фиксированной длине и календарной длительности

Назначьте часовой пояс t1 и t2. В America/New_York часовой пояс, t1 теперь происходит непосредственно перед переходом на летнее время.

t1.TimeZone = 'America/New_York';
t2.TimeZone = 'America/New_York';

Если вы создаете последовательность с помощью шага размером один календарный день, то различие между последовательными datetime значения не всегда равны 24 часам.

t = t1:t2;
dt = diff(t)
dt = 1x4 duration
   24:00:00   25:00:00   24:00:00   24:00:00

Создайте последовательность значений datetime с интервалом в один день с фиксированной длиной,

t = t1:days(1):t2
t = 1x5 datetime
Columns 1 through 3

   01-Nov-2013 08:00:00   02-Nov-2013 08:00:00   03-Nov-2013 07:00:00

Columns 4 through 5

   04-Nov-2013 07:00:00   05-Nov-2013 07:00:00

Проверьте, что различие между последовательными datetime значения составляют 24 часа.

dt = diff(t)
dt = 1x4 duration
   24:00:00   24:00:00   24:00:00   24:00:00

Целочисленный размер шага

Если вы задаете размер шага в терминах целого числа, это интерпретируется как число 24-часовых дней.

t = t1:1:t2
t = 1x5 datetime
Columns 1 through 3

   01-Nov-2013 08:00:00   02-Nov-2013 08:00:00   03-Nov-2013 07:00:00

Columns 4 through 5

   04-Nov-2013 07:00:00   05-Nov-2013 07:00:00

Добавьте длительность или календарную длительность для создания последовательности дат

В этом примере показано, как добавить длительность или календарную длительность к datetime, чтобы создать последовательность значений datetime.

Создайте скаляр datetime, представляющий 1 ноября 2013 года в 8:00 утра.

t1 = datetime(2013,11,1,8,0,0);

Добавьте последовательность часов фиксированной длины к datetime.

t = t1 + hours(0:2)
t = 1x3 datetime
   01-Nov-2013 08:00:00   01-Nov-2013 09:00:00   01-Nov-2013 10:00:00

Добавьте последовательность календарных месяцев к datetime.

t = t1 + calmonths(1:5)
t = 1x5 datetime
Columns 1 through 3

   01-Dec-2013 08:00:00   01-Jan-2014 08:00:00   01-Feb-2014 08:00:00

Columns 4 through 5

   01-Mar-2014 08:00:00   01-Apr-2014 08:00:00

Каждый datetime в t происходит в первый день каждого месяца.

Проверьте, что даты в t разнесены на 1 месяц.

dt = caldiff(t)
dt = 1x4 calendarDuration
   1mo   1mo   1mo   1mo

Определите количество дней между каждой датой.

dt = caldiff(t,'days')
dt = 1x4 calendarDuration
   31d   31d   28d   31d

Добавьте количество календарных месяцев к дате, 31 января 2014 г., чтобы создать последовательность дат, которые приходятся на последний день каждого месяца.

t = datetime(2014,1,31) + calmonths(0:11)
t = 1x12 datetime
Columns 1 through 5

   31-Jan-2014   28-Feb-2014   31-Mar-2014   30-Apr-2014   31-May-2014

Columns 6 through 10

   30-Jun-2014   31-Jul-2014   31-Aug-2014   30-Sep-2014   31-Oct-2014

Columns 11 through 12

   30-Nov-2014   31-Dec-2014

Задайте длину и конечные точки даты или последовательности длительности

В этом примере показано, как использовать linspace функция для создания равномерно разнесенных значений datetime или длительности между двумя заданными конечными точками.

Создайте последовательность из пяти дат с равными интервалами между 14 апреля 2014 года и 4 августа 2014 года. Сначала задайте конечные точки.

A = datetime(2014,04,14);
B = datetime(2014,08,04);

Третий вход для linspace задает количество точек с линейными интервалами для генерации между конечными точками.

C = linspace(A,B,5)
C = 1x5 datetime
   14-Apr-2014   12-May-2014   09-Jun-2014   07-Jul-2014   04-Aug-2014

Создайте последовательность из шести одинаково разнесенных длин между 1 и 5,5 часами.

A = duration(1,0,0);
B = duration(5,30,0);
C = linspace(A,B,6)
C = 1x6 duration
   01:00:00   01:54:00   02:48:00   03:42:00   04:36:00   05:30:00

Последовательность значений Datetime с использованием календарных правил

В этом примере показано, как использовать dateshift функция для генерации последовательностей дат и времени, где каждый образец подчиняется правилу, относящемуся к календарному модулю или модулю времени. Например, каждый datetime должен происходить в начале месяца, в конкретный день недели или в конце минуты. Получившиеся значения datetime в последовательности не обязательно равномерно разнесены.

Даты в конкретный день недели

Сгенерируйте последовательность дат, состоящую из следующих трёх вхождений понедельника. Во-первых, определите сегодняшнюю дату.

t1 = datetime('today','Format','dd-MMM-yyyy eee')
t1 = datetime
   23-Mar-2021 Tue

Первый вход в dateshift всегда является datetime массив, из которого необходимо сгенерировать последовательность. Задайте 'dayofweek' как второй вход, указывающий, что значения datetime в выход последовательности должны приходиться на определенный день недели. День недели можно задать либо по номеру, либо по имени. Например, вы можете задать понедельник как 2 или 'Monday'.

t = dateshift(t1,'dayofweek',2,1:3)
t = 1x3 datetime
   29-Mar-2021 Mon   05-Apr-2021 Mon   12-Apr-2021 Mon

Даты в начале месяца

Сгенерируйте последовательность дат начала месяца, начиная с 1 апреля 2014 года. Задайте 'start' как второй вход для dateshift чтобы указать, что все значения datetime в выход последовательности должны падать в начале определенного модуля времени. Третий входной параметр определяет модуль времени, в данном случае, месяц. Последний вход в dateshift может быть массивом целочисленных значений, который задает, как t1 следует сдвинуть. В этом случае 0 соответствует началу текущего месяца, и 4 соответствует началу четвертого месяца с t1.

t1 = datetime(2014,04,01);
t = dateshift(t1,'start','month',0:4)
t = 1x5 datetime
   01-Apr-2014   01-May-2014   01-Jun-2014   01-Jul-2014   01-Aug-2014

Даты в конце месяца

Сгенерируйте последовательность дат в конце месяца, начиная с 1 апреля 2014 года.

t1 = datetime(2014,04,01);
t = dateshift(t1,'end','month',0:2)
t = 1x3 datetime
   30-Apr-2014   31-May-2014   30-Jun-2014

Определите количество дней между каждой датой.

dt = caldiff(t,'days')
dt = 1x2 calendarDuration
   31d   30d

Даты не разнесены одинаково.

Другие модули измерения дат и времени

Можно задать другие модули времени, такие как неделя, день и час.

t1 = datetime('now')
t1 = datetime
   23-Mar-2021 17:00:44

t = dateshift(t1,'start','hour',0:4)
t = 1x5 datetime
Columns 1 through 3

   23-Mar-2021 17:00:00   23-Mar-2021 18:00:00   23-Mar-2021 19:00:00

Columns 4 through 5

   23-Mar-2021 20:00:00   23-Mar-2021 21:00:00

Предыдущие вхождения дат и времени

Сгенерируйте последовательность значений datetime, начиная с предыдущего часа. Отрицательные целые числа в последнем входе в dateshift соответствуют значениям datetime раньше t1.

t = dateshift(t1,'start','hour',-1:1)
t = 1x3 datetime
   23-Mar-2021 16:00:00   23-Mar-2021 17:00:00   23-Mar-2021 18:00:00

См. также

|