DateTimeOffset.Add(TimeSpan) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Devolve um novo DateTimeOffset objeto que adiciona um intervalo de tempo especificado ao valor desta instância.
public:
DateTimeOffset Add(TimeSpan timeSpan);public DateTimeOffset Add(TimeSpan timeSpan);member this.Add : TimeSpan -> DateTimeOffsetPublic Function Add (timeSpan As TimeSpan) As DateTimeOffsetParâmetros
Devoluções
Um objeto cujo valor é a soma da data e hora representadas pelo objeto atual DateTimeOffset e do intervalo de tempo representado por timeSpan.
Exceções
O valor resultante DateTimeOffset é inferior ao DateTimeOffset.MinValue.
-ou-
O valor resultante DateTimeOffset é superior ao DateTimeOffset.MaxValue.
Exemplos
O exemplo seguinte cria um array de TimeSpan objetos que representam os tempos de voo entre destinos. O Add método soma então esses tempos a um DateTimeOffset objeto que representa o tempo inicial de descolagem de um voo. O resultado reflete o horário de chegada programado a 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
Observações
Pode usar o Add método para adicionar mais do que um tipo de intervalo de tempo (dias, horas, minutos, segundos ou milissegundos) numa única operação. O comportamento deste método é idêntico ao operador de soma. A DateTimeOffset estrutura também suporta métodos especializados de adição (como AddDays, AddHours, e AddMinutes) para cada intervalo de tempo.
Note
Este método devolve um novo DateTimeOffset objeto. Não modifica o valor do objeto atual adicionando timeSpan à sua data e hora.
O Add método não afeta o valor da DateTimeOffset propriedade atual do Offset objeto.
Como um DateTimeOffset objeto não representa a data e a hora num fuso horário específico, o Add método não considera as regras de ajuste de um fuso horário específico ao realizar a aritmética de data e hora.
Se o timeSpan parâmetro for null, este método devolve o valor do objeto original DateTimeOffset inalterado.
