DateTimeOffset.AddMilliseconds(Double) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Retourne un nouvel objet DateTimeOffset qui ajoute un nombre de millisecondes spécifié à la valeur de cette instance.
public:
DateTimeOffset AddMilliseconds(double milliseconds);
public DateTimeOffset AddMilliseconds (double milliseconds);
member this.AddMilliseconds : double -> DateTimeOffset
Public Function AddMilliseconds (milliseconds As Double) As DateTimeOffset
Paramètres
- milliseconds
- Double
Nombre de millisecondes entières et partielles. Le nombre peut être négatif ou positif.
Retours
Objet dont la valeur est égale à la somme de la date et de l’heure représentées par l’objet DateTimeOffset actif et du nombre de millisecondes entières représenté par milliseconds
.
Exceptions
La valeur résultante DateTimeOffset est inférieure à DateTimeOffset.MinValue.
-ou-
La valeur résultante DateTimeOffset est supérieure à DateTimeOffset.MaxValue.
Remarques
La partie fractionnaire du milliseconds
paramètre est la partie fractionnaire d’une milliseconde. Par exemple, 4,5 équivaut à 4 millisecondes et 5 000 ticks, où une milliseconde équivaut à 10 000 tiques. Toutefois, dans .NET 6 et les versions antérieures, milliseconds
est arrondi à la milliseconde la plus proche, et toutes les valeurs de .5 ou supérieures sont arrondies vers le haut. Dans .NET 7 et versions ultérieures, la précision complète Double du milliseconds
paramètre est utilisée. Toutefois, en raison de l’imprécision inhérente des mathématiques à virgule flottante, la précision obtenue varie.
Notes
Cette méthode retourne un nouvel DateTimeOffset objet. Il ne modifie pas la valeur de l’objet actuel en ajoutant milliseconds
à sa date et heure.
Étant donné qu’un DateTimeOffset objet ne représente pas la date et l’heure d’un fuseau horaire spécifique, la AddMilliseconds méthode ne tient pas compte des règles d’ajustement d’un fuseau horaire particulier lorsqu’elle effectue une arithmétique de date et d’heure.