DateTimeOffset.AddMilliseconds(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 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
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
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.