DateTimeOffset.AddSeconds(Double) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
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
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.