функция DateTime::add

Расчитывает время и дату, большую текущей на заданный промежуток времени.

Синтаксис

DateTime
DateTime.add
(Duration duration)

Передаваемые параметры

Duration duration

Возвращаемое значение

DateTime

Описание

Метод add вычисляет и возвращает новое время и дату, представляющую текущую, увеличенную на заданный промежуток времени duration.

Заметки

Пример


void main() {
  // установим дату, например, 2010-01-01
  Date year2010 = new Date(2010, 1, 1, 0, 0, 0, 0);
  
  // добавим к нашей дате 365 дней, и получим новую:
  // 2011-01-01 00:00:00.000
  print(year2010.add(new Duration(365, 0, 0, 0, 0)));

  // добавим к нашей дате 1 минуту, и получим новую:
  // 2010-01-01 00:01:00.000
  print(year2010.add(new Duration(0, 0, 1, 0, 0)));
  
  // а если добавить  отрицательное количество дней, например, -365, получим:  
  // 2009-01-01 00:00:00.000
  print(year2010.add(new Duration(-365, 0, 0, 0, 0)));
  // это будет аналогично вызову метода subtract
  // 2009-01-01 00:00:00.000
  print(year2010.subtract(new Duration(365, 0, 0, 0, 0)));

  // с помощью этого метода можно легко узнать какое число будет через 7 дней:
  print(new Date.now().add(new Duration(7, 0, 0, 0, 0)));
}

Официальная документация (английский)