DateTimeOffset.AddSeconds(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ę sekund całkowitych i ułamkowych do wartości tego wystąpienia.
public:
DateTimeOffset AddSeconds(double seconds);
public DateTimeOffset AddSeconds (double seconds);
member this.AddSeconds : double -> DateTimeOffset
Public Function AddSeconds (seconds As Double) As DateTimeOffset
Parametry
- seconds
- Double
Liczba sekund 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ę sekund reprezentowanych przez seconds
element .
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 seconds
jest częścią ułamkową sekundy. Wartość części ułamkowych sekundy przedstawiono w poniższej tabeli.
Druga wartość | Odpowiednik |
---|---|
.1 s | 100 milisekund |
.01 s | 10 milisekund |
S.001 | 1 milisekunda |
W programie .NET 6 i starszych wersjach seconds
parametr jest zaokrąglany do najbliższej milisekundy. W programie .NET 7 i nowszych wersjach jest używana pełna Double precyzja parametru seconds
. 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 seconds
do jego daty i godziny.
DateTimeOffset Ponieważ obiekt nie reprezentuje daty i godziny w określonej strefie czasowej, AddSeconds metoda nie uwzględnia reguł korekty określonej strefy czasowej podczas wykonywania arytmetyki daty i godziny.