DateTimeOffset.Add(TimeSpan) Metodo

Definizione

Spazio dei nomi:

System

Assembly:

System.Runtime.dll

Source:

DateTimeOffset.cs

Restituisce un nuovo oggetto DateTimeOffset che aggiunge un intervallo di tempo specificato al valore dell'istanza.

public:
 DateTimeOffset Add(TimeSpan timeSpan);

public DateTimeOffset Add (TimeSpan timeSpan);

member this.Add : TimeSpan -> DateTimeOffset

Public Function Add (timeSpan As TimeSpan) As DateTimeOffset

Parametri

timeSpan

TimeSpan

Oggetto TimeSpan che rappresenta un intervallo di tempo positivo o negativo.

Restituisce

DateTimeOffset

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

Eccezioni

ArgumentOutOfRangeException

Il valore risultante DateTimeOffset è minore di DateTimeOffset.MinValue.

-oppure-

Il valore risultante DateTimeOffset è maggiore di DateTimeOffset.MaxValue.

Esempio

Nell'esempio seguente viene creata una matrice di oggetti che rappresentano i tempi di TimeSpan volo tra le destinazioni. Il Add metodo aggiunge quindi questi tempi a un DateTimeOffset oggetto che rappresenta il tempo iniziale di takeoff 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 aggiunta. La DateTimeOffset struttura supporta anche metodi di addizione specializzati (ad esempio AddDays, AddHourse AddMinutes) per ogni intervallo di tempo.

Nota

Questo metodo restituisce un nuovo DateTimeOffset oggetto. Non modifica il valore dell'oggetto corrente aggiungendo timeSpan alla data e all'ora.

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 determinato fuso orario quando esegue l'aritmetica 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