Udostępnij za pośrednictwem


DateTimeOffset.AddMilliseconds(Double) Metoda

Definicja

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

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

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.

Dotyczy

Zobacz też