DateTimeOffset.Add(TimeSpan) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 -> DateTimeOffsetPublic Function Add (timeSpan As TimeSpan) As DateTimeOffsetParametri
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.
Eccezioni
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.
