DateTimeOffset.AddMilliseconds(Double) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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.