DateTimeOffset.Add(TimeSpan) Метод

Определение

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

System

Сборка:

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)
• Выполнение арифметических операций с датами и временем