DateTimeOffset.Add(TimeSpan) Método

Definición

Devuelve un nuevo objeto DateTimeOffset, que agrega un intervalo de tiempo especificado al valor de esta instancia.Returns a new DateTimeOffset object that adds a specified time interval to the value of this instance.

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.A TimeSpan object that represents a positive or a negative time interval.

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.An object whose value is the sum of the date and time represented by the current DateTimeOffset object and the time interval represented by timeSpan.

Excepciones

El valor DateTimeOffset resultante es menor que MinValue.The resulting DateTimeOffset value is less than MinValue.

o bien-or- El valor DateTimeOffset resultante es mayor que MaxValue.The resulting DateTimeOffset value is greater than MaxValue.

Ejemplos

En el ejemplo siguiente se crea una matriz de TimeSpan objetos que representan las horas de vuelo entre destinos.The following example creates an array of TimeSpan objects that represent the flight times between destinations. AddDespués, el método agrega estas horas a un DateTimeOffset objeto que representa la hora de TAKEOFF inicial de un vuelo.The Add method then adds these times to a DateTimeOffset object that represents a flight's initial takeoff time. El resultado refleja la hora de llegada programada en cada destino.The result reflects the scheduled arrival time at each destination.

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);
}
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.You can use the Add method to add more than one kind of time interval (days, hours, minutes, seconds, or milliseconds) in a single operation. El comportamiento de este método es idéntico al operador de suma.This method's behavior is identical to the addition operator. La DateTimeOffset estructura también admite métodos de suma especializados (como AddDays , AddHours y AddMinutes ) para cada intervalo de tiempo.The DateTimeOffset structure also supports specialized addition methods (such as AddDays, AddHours, and AddMinutes) for each time interval.

Nota

Este método devuelve un nuevo DateTimeOffset objeto.This method returns a new DateTimeOffset object. No modifica el valor del objeto actual agregando timeSpan a su fecha y hora.It does not modify the value of the current object by adding timeSpan to its date and time.

El Add método no afecta al valor de la DateTimeOffset propiedad del objeto actual Offset .The Add method does not affect the value of the current DateTimeOffset object's Offset property.

Dado que un DateTimeOffset objeto no representa la fecha y la hora de una zona horaria específica, el Add método no tiene en cuenta las reglas de ajuste de una zona horaria concreta cuando realiza operaciones aritméticas de fecha y hora.Because a DateTimeOffset object does not represent the date and time in a specific time zone, the Add method does not consider a particular time zone's adjustment rules when it performs date and time arithmetic.

Si el timeSpan parámetro es null , este método devuelve el valor del objeto original DateTimeOffset sin modificar.If the timeSpan parameter is null, this method returns the value of the original DateTimeOffset object unchanged.

Se aplica a

Consulte también