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

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

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

Объект, значение которого равно сумме даты и времени, представленных текущим экземпляром, и интервала времени, представленного параметром 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( 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 экземпляра совпадает со свойством текущего экземпляра.

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

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