DateTime.Add(TimeSpan) Метод

Определение

Возвращает новый объект 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.

Исключения

Итоговое значение DateTime меньше MinValue или больше 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.
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 текущего экземпляра.

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

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