DateTimeOffset.AddMilliseconds(Double) Methode

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Source:

DateTimeOffset.cs

Gibt ein neues DateTimeOffset-Objekt zurück, das eine angegebene Anzahl von Millisekunden zum Wert dieser Instanz addiert.

public:
 DateTimeOffset AddMilliseconds(double milliseconds);

public DateTimeOffset AddMilliseconds (double milliseconds);

member this.AddMilliseconds : double -> DateTimeOffset

Public Function AddMilliseconds (milliseconds As Double) As DateTimeOffset

Parameter

milliseconds

Double

Eine Zahl, die aus ganzen Millisekunden und dem Bruchteil einer Millisekunde 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 milliseconds dargestellten Anzahl von ganzen Millisekunden 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 milliseconds Parameters ist der Bruchteil einer Millisekunde. Beispielsweise entspricht 4,5 4 Millisekunden und 5000 Ticks, wobei eine Millisekunde 10.000 Ticks entspricht. In .NET 6 und früheren Versionen milliseconds wird jedoch auf die nächste Millisekunde gerundet, und alle Werte von .5 oder höher werden aufgerundet. In .NET 7 und höheren Versionen wird die volle Double Genauigkeit des milliseconds 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 milliseconds werden.

Da ein DateTimeOffset Objekt das Datum und die Uhrzeit in einer bestimmten Zeitzone nicht darstellt, berücksichtigt die AddMilliseconds 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