Exponenta Banner

dateshift

Переключите дату или сгенерируйте последовательность дат и время

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

Синтаксис

t2 = dateshift(t,'start',unit)
t2 = dateshift(t,'end',unit)
t2 = dateshift(t,'dayofweek',dow)
t2 = dateshift(___,rule)

Описание

t2 = dateshift(t,'start',unit) переключает каждое значение в массиве datetime t назад к началу модуля времени, заданного unit. Вывод t2 одного размера как t.

пример

t2 = dateshift(t,'end',unit) переключает значения вперед в конец модуля времени, заданного unit. Конец дня, часа, минуты, или второй является также началом следующего. Например, конец дня происходит в полночь в начале следующего дня. Конец года, четверти, месяц или неделя является полуночью в начале прошлого дня того периода времени.

пример

t2 = dateshift(t,'dayofweek',dow) возвращает следующее возникновение заданного дня недели на или после каждого datetime в массиве t. Если дата в t падает в заданный день недели, то dateshift возвращает ту же дату.

пример

t2 = dateshift(___,rule) переключает каждое значение в массиве t согласно шаблону, заданному rule. Можно использовать этот синтаксис с любым из аргументов в предыдущих синтаксисах.

Примеры

свернуть все

Скрипт Open Live Script

Задайте текущую дату.

t = datetime('today')
t = datetime

   21-Aug-2018

Переключите дату в конец того же месяца.

t2 = dateshift(t,'end','month')
t2 = datetime

   31-Aug-2018
Скрипт Open Live Script

Задайте текущую дату.

t = datetime('today')
t = datetime
   21-Aug-2018

Переключите дату к запуску следующего месяца.

t2 = dateshift(t,'start','month','next')
t2 = datetime
   01-Sep-2018

Переключите дату в конец следующего месяца.

t2 = dateshift(t,'end','month','next')
t2 = datetime
   30-Sep-2018
Скрипт Open Live Script

Переключите массив дат вперед к следующей пятнице.

t = datetime([2014,08,03;2014,04,15])
t = 2x1 datetime array
   03-Aug-2014
   15-Apr-2014


t2 = dateshift(t,'dayofweek','Friday')
t2 = 2x1 datetime array
   08-Aug-2014
   18-Apr-2014

Переключите массив дат назад к предыдущему понедельнику.

t2 = dateshift(t,'dayofweek','Monday','previous')
t2 = 2x1 datetime array
   28-Jul-2014
   14-Apr-2014
Скрипт Open Live Script

Найдите дату, которая падает в конце пятой недели с сегодняшнего дня.

t = datetime('today')
t = datetime
   21-Aug-2018


t2 = dateshift(t,'end','week',5)
t2 = datetime
   29-Sep-2018
Скрипт Open Live Script

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

t = datetime('today')
t = datetime
   21-Aug-2018


t2 = dateshift(t,'dayofweek','Friday',1:3)
t2 = 1x3 datetime array
   24-Aug-2018   31-Aug-2018   07-Sep-2018

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

свернуть все

Введите дату и время, заданную как массив datetime.

Модуль времени, заданного как одно из следующих значений:

  • год

  • четверть

  • месяц

  • неделя

  • день

  • час

  • минута

  • второй

День недели, заданной как скалярное целое число, указывающее на день недельного номера, или вектор символа или скаляр строки, содержащий локализованное дневное имя.

Пример: В 'воскресенье'

Пример 1

Типы данных: единственный | удваиваются | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | char | строка

Управляйте для сдвига значений datetime, заданных как вектор символа, представьте в виде строки скаляр, скалярное целое число или массив целочисленных значений. Если rule является вектором символа или строкой, это должно быть одно из следующих.

Значение ruleОписание
'next'Переключите datetime к следующему модулю времени или заданного дня.
(Правило по умолчанию в течение дня недели.)
'previous'Переключите datetime к предыдущему модулю времени или заданного дня.
самый близкийПереключите datetime к самому близкому возникновению модуля времени или заданного дня.
'current'Переключите datetime в текущем модуле времени, или к заданному дню на текущей неделе.
(Правило по умолчанию для модуля времени.)

Если rule является целым числом или массивом целых чисел, то:

  • Когда используется с входным параметром, unit, 0 соответствует запуску или концу текущего модуля для каждого datetime, 1 соответствует следующему модулю, -1 соответствует предыдущему модулю и так далее.

  • Когда используется с входным параметром, dow, 0 соответствует заданному дню на текущей неделе для каждого datetime, 1 соответствует следующему возникновению заданного дня, -1 соответствует предыдущему возникновению и так далее.

  • t и rule должны быть одного размера, или нужно быть скаляром.

Если вы задаете 'dayofweek', и t содержит значения datetime, которые падают в тот день недели, то dateshift обрабатывает те значения datetime как следующие или предыдущие случаи заданного дня недели. Например, dateshift(datetime(2015,12,24),'dayofweek','thu',rule) возвращает значение datetime с датой от 24 декабря 2015, если rule является 'next', 'previous', 1 или -1, потому что 24 декабря 2015 четверг.

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

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

|

Введенный в R2014b

Была ли эта тема полезной?
Документация MATLAB
Поддержка