DateTimeOffset.AddSeconds(Double) Metoda

Definice

Obor názvů:

System

Sestavení:

System.Runtime.dll

Source:

DateTimeOffset.cs

Vrátí nový DateTimeOffset objekt, který k hodnotě této instance přidá zadaný počet celých sekund a zlomek sekund.

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

Počet celých a zlomkových sekund. Číslo může být záporné nebo kladné.

Návraty

DateTimeOffset

Objekt, jehož hodnota je součet data a času reprezentovaných aktuálním DateTimeOffset objektem a počet sekund reprezentovaných funkcí seconds.

Výjimky

ArgumentOutOfRangeException

Výsledná DateTimeOffset hodnota je menší než DateTimeOffset.MinValue.

-nebo-

Výsledná DateTimeOffset hodnota je větší než DateTimeOffset.MaxValue.

Poznámky

Zlomková část parametru seconds je zlomková část sekundy. Hodnota zlomkových částí sekundy je uvedena v následující tabulce.

Druhá hodnota	Ekvivalent
0,1 sekundy	100 milisekund
0,01 sekunda	10 milisekund
,001 sekunda	1 milisekunda

V .NET 6 a starších verzích seconds se parametr zaokrouhlí na nejbližší milisekundu. V .NET 7 a novějších verzích se používá úplná Double přesnost parametru seconds . Kvůli nepřesnosti matematiky s plovoucí desetinou čárkou se ale bude výsledná přesnost lišit.

Poznámka

Tato metoda vrátí nový DateTimeOffset objekt. Nezmění hodnotu aktuálního objektu přidáním seconds k jeho datu a času.

DateTimeOffset Vzhledem k tomu, že objekt nepředstavuje datum a čas v určitém časovém pásmu, AddSeconds metoda při provádění aritmetických aritmetických operací data a času nebere v úvahu pravidla úprav určitého časového pásma.

Viz také

• Provádění aritmetických operací s daty a časy