DateTime.Add(TimeSpan) Метод

Определение

Пространство имен:

System

Сборки:

netstandard.dll, System.Runtime.dll

Исходный код:

DateTime.cs

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

public:
 DateTime Add(TimeSpan value);

public DateTime Add(TimeSpan value);

member this.Add : TimeSpan -> DateTime

Public Function Add (value As TimeSpan) As DateTime

Параметры

value

TimeSpan

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

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

DateTime

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

Исключения

ArgumentOutOfRangeException

DateTime Результат меньше DateTime.MinValue или больше DateTime.MaxValue.

Примеры

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

// Calculate what day of the week is 36 days from this instant.
let today = DateTime.Now
let duration = TimeSpan(36, 0, 0, 0)
let answer = today.Add duration
printfn $"{answer:dddd}"

// 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);

' Calculate what day of the week is 36 days from this instant.
Dim today As System.DateTime
Dim duration As System.TimeSpan
Dim answer As System.DateTime

today = System.DateTime.Now
duration = New System.TimeSpan(36, 0, 0, 0)
answer = today.Add(duration)

System.Console.WriteLine("{0:dddd}", answer)

Комментарии

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

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

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

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

• TimeSpan
• Add(TimeSpan)
• Выполнение арифметических операций с датами и временем