DateTimeOffset.Add(TimeSpan) Metodo

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

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 di oggetti TimeSpan 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 metodo Add aggiunge quindi queste ore a un oggetto DateTimeOffset 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 metodo Add 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 struttura DateTimeOffset supporta anche metodi di aggiunta specializzati, ad esempio AddDays, AddHourse 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 oggetto DateTimeOffset.This method returns a new DateTimeOffset object. Non modifica il valore dell'oggetto corrente aggiungendo timeSpan alla relativa data e ora.It does not modify the value of the current object by adding timeSpan to its date and time.

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

Poiché un oggetto DateTimeOffset non rappresenta la data e l'ora in un fuso orario specifico, il metodo Add non considera le regole di rettifica di un determinato fuso orario quando esegue l'aritmetica 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 parametro timeSpan è null, questo metodo restituisce il valore dell'oggetto DateTimeOffset originale invariato.If the timeSpan parameter is null, this method returns the value of the original DateTimeOffset object unchanged.

Si applica a

Vedi anche