DateTimeOffset.AddMilliseconds(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ý přidá zadaný počet milisekund k hodnotě této instance.
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
Počet celých a desetinných milisekund. Čí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čtu celých milisekund reprezentovaných hodnotou milliseconds
.
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 milliseconds
je zlomková část milisekundy. Například hodnota 4,5 odpovídá 4 milisekundám a 5 000 klisen, kde jedna milisekunda se rovná 10 000 tis. V .NET 6 a starších verzích milliseconds
se ale zaokrouhlí na nejbližší milisekundu a všechny hodnoty 0,5 nebo vyšší se zaokrouhlují nahoru. V .NET 7 a novějších verzích se používá úplná Double přesnost parametru milliseconds
. 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 milliseconds
k jeho datu a času.
DateTimeOffset Vzhledem k tomu, že objekt nepředstavuje datum a čas v určitém časovém pásmu, AddMilliseconds 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.