DateTime.Add(TimeSpan) DateTime.Add(TimeSpan) DateTime.Add(TimeSpan) DateTime.Add(TimeSpan) Method

Определение

Возвращает новый объект DateTime, добавляющий значение заданного объекта TimeSpan к значению данного экземпляра.Returns a new DateTime that adds the value of the specified TimeSpan to the value of this instance.

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 TimeSpan TimeSpan TimeSpan

Положительный или отрицательный интервал времени.A positive or negative time interval.

Возвраты

Объект, значение которого равно сумме даты и времени, представленных текущим экземпляром, и интервала времени, представленного параметром value.An object whose value is the sum of the date and time represented by this instance and the time interval represented by value.

Исключения

Итоговое значение DateTime меньше MinValue или больше MaxValue.The resulting DateTime is less than MinValue or greater than MaxValue.

Примеры

В следующем примере демонстрируется Add метод.The following example demonstrates the Add method. Он вычисляет день недели, 36 дней (864 часа) с этого момента.It calculates the day of the week that is 36 days (864 hours) from this moment.

// 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 метод, чтобы добавить более одного вида интервал времени (дни, часы, минуты, секунды или миллисекунды) в рамках одной операции.You can use the Add method to add more than one kind of time interval (days, hours, minutes, seconds, or milliseconds) in a single operation. Этот метод поведение идентично поведению, оператора сложения.This method's behavior is identical to that of the addition operator. DateTime Структура также поддерживает добавление специализированные методы (такие как AddDays, AddHours, и AddMinutes) для каждого интервала времени.The DateTime structure also supports specialized addition methods (such as AddDays, AddHours, and AddMinutes) for each time interval.

Add Метод принимает в учетной записи високосный год или количество дней в месяце, при выполнении арифметических операций дата.The Add method takes into account leap years and the number of days in a month when performing date arithmetic.

Этот метод не изменяет значение этой DateTime.This method does not change the value of this DateTime. Вместо этого он возвращает новый DateTime , значение которого является результатом этой операции.Instead, it returns a new DateTime whose value is the result of this operation. Kind Свойства нового DateTime экземпляра совпадает с текущим экземпляром.The Kind property of the new DateTime instance is the same as that of the current instance.

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

Дополнительно