DateTimeOffset.AddSeconds(Double) Methode

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Quelle:

DateTimeOffset.cs

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

DateTimeOffset

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

ArgumentOutOfRangeException

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.

Weitere Informationen

• Ausführen von arithmetischen Vorgängen mit Datums- und Uhrzeitangaben