DateTimeOffset.AddSeconds(Double) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt ein neues DateTimeOffset-Objekt zurück, das eine angegebene Anzahl von ganzen Sekunden und Bruchteilen von Sekunden zum Wert dieser Instanz addiert.
public:
DateTimeOffset AddSeconds(double seconds);
public DateTimeOffset AddSeconds (double seconds);
member this.AddSeconds : double -> DateTimeOffset
Public Function AddSeconds (seconds As Double) As DateTimeOffset
Parameter
- seconds
- Double
Eine Zahl, die aus ganzen Sekunden und dem Bruchteil einer Sekunde besteht. Die Zahl kann negativ oder positiv sein.
Gibt zurück
Ein Objekt, dessen Wert die Summe aus der vom aktuellen DateTimeOffset-Objekt dargestellten Datums- und Uhrzeitangabe und der von seconds
dargestellten Anzahl von Sekunden ist.
Ausnahmen
Der resultierende DateTimeOffset Wert ist kleiner als DateTimeOffset.MinValue.
Oder
Der resultierende DateTimeOffset Wert ist größer als DateTimeOffset.MaxValue.
Hinweise
Der Bruchteil des seconds
Parameters ist der Bruchteil einer Sekunde. Der Wert von Bruchteilen einer Sekunde ist in der folgenden Tabelle dargestellt.
Zweiter Wert | Entsprechung |
---|---|
.1 Sekunde | 100 Millisekunden |
.01 Sekunde | Zehn Millisekunden |
.001 Sekunde | Eine Millisekunde |
In .NET 6 und früheren Versionen wird der seconds
Parameter auf die nächste Millisekunde gerundet. In .NET 7 und höheren Versionen wird die volle Double Genauigkeit des seconds
Parameters verwendet. Aufgrund der inhärenten Ungenauigkeit der Gleitkomma-Mathematik variiert die resultierende Genauigkeit jedoch.
Hinweis
Diese Methode gibt ein neues DateTimeOffset Objekt zurück. Der Wert des aktuellen Objekts wird nicht geändert, indem datum und uhrzeit hinzugefügt seconds
werden.
Da ein DateTimeOffset Objekt das Datum und die Uhrzeit in einer bestimmten Zeitzone nicht darstellt, berücksichtigt die AddSeconds Methode die Anpassungsregeln einer bestimmten Zeitzone nicht, wenn sie Datums- und Uhrzeitarithmetik ausführt.