DateTimeOffset.Add(TimeSpan) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Retourneert een nieuw DateTimeOffset object dat een opgegeven tijdsinterval toevoegt aan de waarde van dit exemplaar.
public:
DateTimeOffset Add(TimeSpan timeSpan);public DateTimeOffset Add(TimeSpan timeSpan);member this.Add : TimeSpan -> DateTimeOffsetPublic Function Add (timeSpan As TimeSpan) As DateTimeOffsetParameters
- timeSpan
- TimeSpan
Een TimeSpan object dat een positief of een negatief tijdsinterval vertegenwoordigt.
Retouren
Een object waarvan de waarde de som is van de datum en tijd die wordt vertegenwoordigd door het huidige DateTimeOffset object en het tijdsinterval dat wordt vertegenwoordigd door timeSpan.
Uitzonderingen
De resulterende DateTimeOffset waarde is kleiner dan DateTimeOffset.MinValue.
– of –
De resulterende DateTimeOffset waarde is groter dan DateTimeOffset.MaxValue.
Voorbeelden
In het volgende voorbeeld wordt een matrix gemaakt met TimeSpan objecten die de vluchttijden tussen bestemmingen vertegenwoordigen. De Add methode voegt deze tijden vervolgens toe aan een DateTimeOffset object dat de initiële starttijd van een vlucht vertegenwoordigt. Het resultaat weerspiegelt de geplande aankomsttijd op elke bestemming.
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
Opmerkingen
U kunt de Add methode gebruiken om meer dan één soort tijdsinterval (dagen, uren, minuten, seconden of milliseconden) toe te voegen in één bewerking. Het gedrag van deze methode is identiek aan de optellingsoperator. De DateTimeOffset structuur ondersteunt ook gespecialiseerde optellingsmethoden (zoals AddDays, AddHoursen AddMinutes) voor elk tijdsinterval.
Note
Met deze methode wordt een nieuw DateTimeOffset object geretourneerd. De waarde van het huidige object wordt niet gewijzigd door deze toe te voegen aan timeSpan de datum en tijd.
De Add methode heeft geen invloed op de waarde van de eigenschap van het huidige DateTimeOffset object Offset .
Omdat een DateTimeOffset object de datum en tijd in een specifieke tijdzone niet vertegenwoordigt, wordt bij het uitvoeren van datum- en tijdberekeningen geen rekening gehouden met de Add aanpassingsregels van een bepaalde tijdzone.
Als de timeSpan parameter is null, retourneert deze methode de waarde van het oorspronkelijke DateTimeOffset object ongewijzigd.
