Метод add

Метод add класса DateTime прибавляет указанный промежуток времени к дате и возвращает новый объект DateTime. Исходный объект при этом не изменяется. В параметр мы передаем объект Duration, который описывает прибавляемый промежуток времени: дни, часы, минуты, секунды и миллисекунды.

Синтаксис

dateTime.add(duration)

Пример

Давайте прибавим к дате 3 дня:

void main()
{
	DateTime date = DateTime(2024, 1, 1);
	DateTime res = date.add(Duration(days: 3));
	print(res);
}

Результат выполнения кода:

"2024-01-04 00:00:00.000"

Пример

Давайте прибавим к дате 2 часа и 30 минут:

void main()
{
	DateTime date = DateTime(2024, 1, 1, 10, 0);
	DateTime res = date.add(Duration(hours: 2, minutes: 30));
	print(res);
}

Результат выполнения кода:

"2024-01-01 12:30:00.000"

Пример

Давайте прибавим промежуток, который переходит на следующий месяц:

void main()
{
	DateTime date = DateTime(2024, 1, 28);
	DateTime res = date.add(Duration(days: 5));
	print(res);
}

Результат выполнения кода:

"2024-02-02 00:00:00.000"

Смотрите также

метод subtract,
который вычитает промежуток времени
метод difference,
который возвращает разницу между датами
класс DateTime,
который представляет дату и время
метод now,
который возвращает текущую дату и время