addtodate

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

Синтаксис

R = addtodate(D, Q, F)

Описание

Примечание

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

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

Количество Q быть добавленным может быть положительным или отрицательным целым числом. Абсолютное значение Q должно быть меньше чем или равно 1e16. Поле даты F должен быть вектор символов или строковый скаляр, равный одному из следующего: 'year'месяцденьчасминутавторой, или '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