exponenta event banner

addtodate

Изменение номера даты по полю

Синтаксис

R = addtodate(D, Q, F)

Описание

Примечание

Хотя серийные номера могут представлять даты и время, рекомендуется использовать datetime значения для представления точек времени и duration или calendarDuration значения для представления прошедшего времени.

R = addtodate(D, Q, F) добавляет количество Q в указанное поле даты F скалярного серийного номера даты D, возврат обновленного номера даты R.

Количество Q добавляемое число может быть положительным или отрицательным целым числом. Абсолютное значение Q должно быть меньше или равно 1e16. Поле даты F должен быть символьным вектором или строковым скаляром, равным одному из следующих: 'year', 'month', 'day', 'hour', 'minute', 'second', или 'millisecond'.

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

Примеры

Измените часы, дни и минуты данной даты:

t = datenum('07-Apr-2008 23:00:00');
datestr(t)
ans =
   07-Apr-2008 23:00:00

t= addtodate(t, 2, 'hour');
datestr(t)
ans =
   08-Apr-2008 01:00:00

t= addtodate(t, -7, 'day');
datestr(t)
ans =
   01-Apr-2008 01:00:00

t= addtodate(t, 59, 'minute');
datestr(t)
ans =
   01-Apr-2008 01:59:00

Добавление 20 дней до указанной даты в конце декабря приводит к переносу календаря на январь следующего года:

R = addtodate(datenum('12/24/2007 12:45'), 20, 'day');

datestr(R)
ans =
   13-Jan-2008 12:45:00

См. также

| | |

Представлен до R2006a