DateTimeOffset.AddSeconds(Double) Methode

Definition

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.

Gilt für:

Weitere Informationen