DateTimeOffset.AddMilliseconds(Double) Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Source:

DateTimeOffset.cs

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

DateTimeOffset

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

ArgumentOutOfRangeException

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.

Voir aussi

• Exécution d’opérations arithmétiques avec dates et heures