Compartilhar via


DateTimeOffset.Add(TimeSpan) Método

Definição

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

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

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