DateTimeOffset.Add(TimeSpan) Método

  • Referencia

Definición

Espacio de nombres:
System
Ensamblado:
System.Runtime.dll
Ensamblado:
mscorlib.dll
Ensamblado:
netstandard.dll
Source:
DateTimeOffset.cs
Source:
DateTimeOffset.cs
Source:
DateTimeOffset.cs

Devuelve un nuevo objeto DateTimeOffset, que agrega un intervalo de tiempo especificado al valor de esta instancia.

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

Objeto TimeSpan que representa un intervalo de tiempo positivo o negativo.

Devoluciones

DateTimeOffset

Objeto cuyo valor es la suma de la fecha y hora representada por el objeto DateTimeOffset actual y el intervalo de tiempo representado por timeSpan.

Excepciones

ArgumentOutOfRangeException

El valor resultante DateTimeOffset es menor que DateTimeOffset.MinValue.

o bien

El valor resultante DateTimeOffset es mayor que DateTimeOffset.MaxValue.

Ejemplos

En el ejemplo siguiente se crea una matriz de TimeSpan objetos que representan los tiempos de vuelo entre destinos. A continuación, el Add método agrega estas horas a un DateTimeOffset objeto que representa el tiempo de interrupción inicial de un vuelo. El resultado refleja la hora de llegada programada en 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

Comentarios

Puede usar el Add método para agregar más de un tipo de intervalo de tiempo (días, horas, minutos, segundos o milisegundos) en una sola operación. El comportamiento de este método es idéntico al operador de suma. La DateTimeOffset estructura también admite métodos de suma especializados (como AddDays, AddHoursy AddMinutes) para cada intervalo de tiempo.

Nota

Este método devuelve un nuevo DateTimeOffset objeto . No modifica el valor del objeto actual agregando timeSpan a su fecha y hora.

El Add método no afecta al valor de la propiedad del Offset objeto actualDateTimeOffset.

Dado que un DateTimeOffset objeto no representa la fecha y hora de una zona horaria específica, el Add método no considera las reglas de ajuste de una zona horaria determinada cuando realiza la aritmética de fecha y hora.

Si el timeSpan parámetro es null, este método devuelve el valor del objeto original DateTimeOffset sin modificar.

Se aplica a

Consulte también