addtodate

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

Синтаксис

R = addtodate(D, Q, F)

Описание

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