DateTimeOffset.AddMilliseconds(Double) Metoda

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

Źródło:

DateTimeOffset.cs

Zwraca nowy DateTimeOffset obiekt, który dodaje określoną liczbę milisekund do wartości tego wystąpienia.

public:
 DateTimeOffset AddMilliseconds(double milliseconds);

public DateTimeOffset AddMilliseconds (double milliseconds);

member this.AddMilliseconds : double -> DateTimeOffset

Public Function AddMilliseconds (milliseconds As Double) As DateTimeOffset

Parametry

milliseconds

Double

Liczba milisekund całkowitych i ułamkowych. Liczba może być dodatnia lub ujemna.

Zwraca

DateTimeOffset

Obiekt, którego wartość jest sumą daty i godziny reprezentowanej przez bieżący DateTimeOffset obiekt oraz liczbę całych milisekund reprezentowanych przez milliseconds.

Wyjątki

ArgumentOutOfRangeException

Wynikowa DateTimeOffset wartość jest mniejsza niż DateTimeOffset.MinValue.

-lub-

Wynikowa DateTimeOffset wartość jest większa niż DateTimeOffset.MaxValue.

Uwagi

Część ułamkowa parametru milliseconds jest częścią ułamkową milisekundy. Na przykład wartość 4,5 jest równoważna 4 milisekundom i 5000 kleszczom, gdzie jedna milisekunda jest równa 10 000 kleszczy. Jednak w programie .NET 6 i starszych wersjach milliseconds jest zaokrąglany do najbliższej milisekundy, a wszystkie wartości 5 lub większe są zaokrąglane w górę. W programie .NET 7 i nowszych wersjach jest używana pełna Double precyzja parametru milliseconds . Jednak ze względu na nieodłączną nieprawdopodobność matematycznych zmiennoprzecinkowych precyzja wynikowa będzie się różnić.

Uwaga

Ta metoda zwraca nowy DateTimeOffset obiekt. Nie modyfikuje on wartości bieżącego obiektu przez dodanie milliseconds do jego daty i godziny.

DateTimeOffset Ponieważ obiekt nie reprezentuje daty i godziny w określonej strefie czasowej, AddMilliseconds metoda nie uwzględnia reguł korekty określonej strefy czasowej podczas wykonywania arytmetyki daty i godziny.

Zobacz też

• Wykonywanie operacji arytmetycznych przy użyciu dat i godzin