DateTimeOffset.Add(TimeSpan) Метод

Определение

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

System

Сборки:

netstandard.dll, System.Runtime.dll

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

DateTimeOffset.cs

Возвращает новый DateTimeOffset объект, добавляющий указанный интервал времени к значению этого экземпляра.

public:
 DateTimeOffset Add(TimeSpan timeSpan);

public DateTimeOffset Add(TimeSpan timeSpan);

member this.Add : TimeSpan -> DateTimeOffset

Public Function Add (timeSpan As TimeSpan) As DateTimeOffset

Параметры

timeSpan

TimeSpan

Объект TimeSpan , представляющий положительный или отрицательный интервал времени.

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

DateTimeOffset

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

Исключения

ArgumentOutOfRangeException

Полученное DateTimeOffset значение меньше DateTimeOffset.MinValue.

–или–

DateTimeOffset Полученное значение больше DateTimeOffset.MaxValue.

Примеры

В следующем примере создается массив TimeSpan объектов, представляющих время полета между назначениями. Затем метод Add добавляет эти времена в DateTimeOffset объект, представляющий начальное время взлета полета. Результат отражает запланированное время прибытия в каждом месте назначения.

DateTimeOffset takeOff = new DateTimeOffset(2007, 6, 1, 7, 55, 0,
                             new TimeSpan(-5, 0, 0));
DateTimeOffset currentTime = takeOff;
TimeSpan[] flightTimes = new TimeSpan[]
                  {new TimeSpan(2, 25, 0), new TimeSpan(1, 48, 0)};
Console.WriteLine("Takeoff is scheduled for {0:d} at {0:T}.",
                  takeOff);
for (int ctr = flightTimes.GetLowerBound(0);
     ctr <= flightTimes.GetUpperBound(0); ctr++)
{
   currentTime = currentTime.Add(flightTimes[ctr]);
   Console.WriteLine("Destination #{0} at {1}.", ctr + 1, currentTime);
}

let takeOff = DateTimeOffset(2007, 6, 1, 7, 55, 0, TimeSpan(-5, 0, 0))
let mutable currentTime = takeOff
let flightTimes = [| TimeSpan(2, 25, 0); TimeSpan(1, 48, 0) |]
printfn $"Takeoff is scheduled for {takeOff:d} at {takeOff:T}."
                
for i = 0 to flightTimes.Length - 1 do
    currentTime <- currentTime.Add flightTimes[i]
    printfn $"Destination #{i + 1} at {currentTime}."

Dim takeOff As New DateTimeOffset(#6/1/2007 7:55AM#, _
                                  New TimeSpan(-5, 0, 0))
Dim currentTime As DateTimeOffset = takeOff
Dim flightTimes() As TimeSpan = New TimeSpan() _
                  {New TimeSpan(2, 25, 0), New TimeSpan(1, 48, 0)}
Console.WriteLine("Takeoff is scheduled for {0:d} at {0:T}.", _
                  takeOff)
For ctr As Integer = flightTimes.GetLowerBound(0) To _
                     flightTimes.GetUpperBound(0)
   currentTime = currentTime.Add(flightTimes(ctr))
   Console.WriteLine("Destination #{0} at {1}.", ctr + 1, currentTime)
Next

Комментарии

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

Замечание

Этот метод возвращает новый DateTimeOffset объект. Он не изменяет значение текущего объекта, добавляя timeSpan его к дате и времени.

Метод Add не влияет на значение свойства текущего DateTimeOffset объекта Offset .

DateTimeOffset Так как объект не представляет дату и время в определенном часовом поясе, Add метод не рассматривает правила корректировки определенного часового пояса при выполнении арифметики даты и времени.

timeSpan Если параметр заданnull, этот метод возвращает значение исходного DateTimeOffset объекта без изменений.

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

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