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