DateTimeOffset.Add(TimeSpan) Metodo

public:
 DateTimeOffset Add(TimeSpan timeSpan);

public DateTimeOffset Add(TimeSpan timeSpan);

member this.Add : TimeSpan -> DateTimeOffset

Public Function Add (timeSpan As TimeSpan) As DateTimeOffset

Parametri

Restituisce

Oggetto il cui valore è la somma della data e dell'ora rappresentate dall'oggetto corrente DateTimeOffset e dall'intervallo di tempo rappresentato da timeSpan.

Eccezioni

Esempio

Nell'esempio seguente viene creata una matrice di oggetti che rappresentano gli orari di TimeSpan volo tra le destinazioni. Il Add metodo aggiunge quindi queste volte a un DateTimeOffset oggetto che rappresenta il tempo di decollo iniziale di un volo. Il risultato riflette l'ora di arrivo pianificata in ogni destinazione.

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

Commenti

È possibile usare il Add metodo per aggiungere più tipi di intervallo di tempo (giorni, ore, minuti, secondi o millisecondi) in una singola operazione. Il comportamento di questo metodo è identico all'operatore di addizione. La DateTimeOffset struttura supporta anche metodi di addizione specializzati (ad esempio AddDays, AddHourse AddMinutes) per ogni intervallo di tempo.

Il Add metodo non influisce sul valore della proprietà dell'oggetto Offset correnteDateTimeOffset.

Poiché un DateTimeOffset oggetto non rappresenta la data e l'ora in un fuso orario specifico, il Add metodo non considera le regole di regolazione di un particolare fuso orario quando esegue l'aritmetica di data e ora.

Se il timeSpan parametro è null, questo metodo restituisce il valore dell'oggetto originale DateTimeOffset invariato.

Vedi anche

• Addition(DateTimeOffset, TimeSpan)
• Esecuzione di operazioni aritmetiche con date e ore