Прочитать на английском

Поделиться через


DateTime.Add(TimeSpan) Метод

Определение

Возвращает новый объект DateTime, добавляющий значение заданного объекта TimeSpan к значению данного экземпляра.

public DateTime Add(TimeSpan value);

Параметры

value
TimeSpan

Положительный или отрицательный интервал времени.

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

Объект, значение которого равно сумме даты и времени, представленных текущим экземпляром, и интервала времени, представленного параметром value.

Исключения

Полученный результат DateTime меньше DateTime.MinValue или больше DateTime.MaxValue.

Примеры

В следующем примере демонстрируется Add метод. Он вычисляет день недели, который составляет 36 дней (864 часа) с этого момента.

// Calculate what day of the week is 36 days from this instant.
System.DateTime today = System.DateTime.Now;
System.TimeSpan duration = new System.TimeSpan(36, 0, 0, 0);
System.DateTime answer = today.Add(duration);
System.Console.WriteLine("{0:dddd}", answer);

Комментарии

Метод можно использовать для Add добавления нескольких типов интервалов времени (дней, часов, минут, секунд или миллисекунд) в одной операции. Поведение этого метода идентично поведению оператора сложения. Структура DateTime также поддерживает специализированные методы сложения (такие как AddDays, AddHoursи AddMinutes) для каждого интервала времени.

Метод Add учитывает високосные годы и количество дней в месяце при выполнении арифметики даты.

Этот метод не изменяет значение данного DateTimeобъекта . Вместо этого он возвращает новый DateTime объект , значение которого является результатом этой операции. Свойство Kind нового DateTime экземпляра совпадает со свойством текущего экземпляра.

Применяется к

Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

См. также раздел