DateTimeOffset.AddSeconds(Double) Metoda

Definicja

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 secondselement .

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.

Dotyczy

Zobacz też