DateTimeOffset.Add(TimeSpan) DateTimeOffset.Add(TimeSpan) DateTimeOffset.Add(TimeSpan) Method

Definizione

Restituisce un nuovo oggetto DateTimeOffset che aggiunge un intervallo di tempo specificato al valore dell'istanza.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

Parametri

timeSpan
TimeSpan TimeSpan TimeSpan

Oggetto TimeSpan che rappresenta un intervallo di tempo positivo o negativo.A TimeSpan object that represents a positive or a negative time interval.

Restituisce

Oggetto il cui valore è la somma della data e dell'ora rappresentate dall'oggetto DateTimeOffset corrente e dell'intervallo di tempo rappresentato da 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.

Eccezioni

Il valore DateTimeOffset risultante è minore di MinValue.The resulting DateTimeOffset value is less than MinValue.

-oppure--or- Il valore DateTimeOffset risultante è maggiore di MaxValue.The resulting DateTimeOffset value is greater than MaxValue.

Esempi

Nell'esempio seguente viene creata una matrice TimeSpan di oggetti che rappresentano i tempi di volo tra le destinazioni.The following example creates an array of TimeSpan objects that represent the flight times between destinations. Il Add metodo aggiunge quindi queste ore a un DateTimeOffset oggetto che rappresenta il tempo di decollo iniziale di un volo.The Add method then adds these times to a DateTimeOffset object that represents a flight's initial takeoff time. Il risultato riflette l'ora di arrivo pianificata in ogni destinazione.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

Commenti

È possibile usare il Add metodo per aggiungere più di un tipo di intervallo di tempo (giorni, ore, minuti, secondi o millisecondi) in un'unica operazione.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. Il comportamento di questo metodo è identico a quello dell'operatore di addizione.This method's behavior is identical to the addition operator. La DateTimeOffset struttura supporta inoltre metodi di aggiunta specializzati AddDays, ad esempio AddHours, e AddMinutes, per ogni intervallo di tempo.The DateTimeOffset structure also supports specialized addition methods (such as AddDays, AddHours, and AddMinutes) for each time interval.

Nota

Questo metodo restituisce un nuovo DateTimeOffset oggetto.This method returns a new DateTimeOffset object. Non modifica il valore dell'oggetto corrente aggiungendola timeSpan alla data e all'ora.It does not modify the value of the current object by adding timeSpan to its date and time.

Il Add metodo non influisce sul valore della Offset proprietà dell' DateTimeOffset oggetto corrente.The Add method does not affect the value of the current DateTimeOffset object's Offset property.

Poiché un DateTimeOffset oggetto non rappresenta la data e l'ora in un fuso orario specifico, il Add metodo non prende in considerazione le regole di rettifica di un determinato fuso orario quando esegue operazioni aritmetiche di data e ora.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.

Se il timeSpan parametro è null, questo metodo restituisce il valore dell'oggetto originale DateTimeOffset invariato.If the timeSpan parameter is null, this method returns the value of the original DateTimeOffset object unchanged.

Si applica a

Vedi anche