DateTimeOffset.Add(TimeSpan) Método

  • Referência

Definição

Namespace:
System
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Origem:
DateTimeOffset.cs
Origem:
DateTimeOffset.cs
Origem:
DateTimeOffset.cs

Retorna um novo objeto DateTimeOffset que adiciona um intervalo de tempo especificado ao valor dessa instância.

public:
 DateTimeOffset Add(TimeSpan timeSpan);
public DateTimeOffset Add (TimeSpan timeSpan);
member this.Add : TimeSpan -> DateTimeOffset
Public Function Add (timeSpan As TimeSpan) As DateTimeOffset

Parâmetros

timeSpan
TimeSpan

Um objeto TimeSpan que representa um alarme ou um intervalo de tempo negativo.

Retornos

DateTimeOffset

Um objeto cujo valor é a soma da data e hora representada pelo objeto DateTimeOffset atual e o intervalo de tempo representado por timeSpan.

Exceções

ArgumentOutOfRangeException

O valor resultante DateTimeOffset é menor que DateTimeOffset.MinValue.

-ou-

O valor resultante DateTimeOffset é maior que DateTimeOffset.MaxValue.

Exemplos

O exemplo a seguir cria uma matriz de objetos que representam os tempos de TimeSpan voo entre destinos. Em Add seguida, o método adiciona esses horários a um DateTimeOffset objeto que representa o tempo de decolagem inicial de um voo. O resultado reflete a hora de chegada agendada em cada destino.

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

Comentários

Você pode usar o Add método para adicionar mais de um tipo de intervalo de tempo (dias, horas, minutos, segundos ou milissegundos) em uma única operação. O comportamento desse método é idêntico ao operador de adição. A DateTimeOffset estrutura também dá suporte a métodos de adição especializados (como AddDays, AddHourse AddMinutes) para cada intervalo de tempo.

Observação

Este método retorna um novo objeto DateTimeOffset. Ele não modifica o valor do objeto atual adicionando timeSpan à sua data e hora.

O Add método não afeta o valor da propriedade do Offset objeto atualDateTimeOffset.

Como um DateTimeOffset objeto não representa a data e a hora em um fuso horário específico, o Add método não considera regras de ajuste de um fuso horário específico quando executa aritmética de data e hora.

Se o timeSpan parâmetro for null, esse método retornará o valor do objeto original DateTimeOffset inalterado.

Aplica-se a

Confira também