DateTime.Add(TimeSpan) Метод

  • Ссылка

Определение

Пространство имен:
System
Сборка:
System.Runtime.dll
Сборка:
mscorlib.dll
Сборка:
netstandard.dll
Исходный код:
DateTime.cs
Исходный код:
DateTime.cs
Исходный код:
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.
System::DateTime today = System::DateTime::Now;
System::TimeSpan duration( 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.
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 экземпляра совпадает со свойством текущего экземпляра.

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

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