DateTimeOffset.AddSeconds(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 spécifié de secondes entières et partielles à la valeur de cette instance.
public:
DateTimeOffset AddSeconds(double seconds);
public DateTimeOffset AddSeconds (double seconds);
member this.AddSeconds : double -> DateTimeOffset
Public Function AddSeconds (seconds As Double) As DateTimeOffset
Paramètres
- seconds
- Double
Nombre de secondes 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 actuel et du nombre de secondes représenté par seconds
.
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 seconds
paramètre est la partie fractionnaire d’une seconde. La valeur des parties fractionnaires d’une seconde est indiquée dans le tableau suivant.
Deuxième valeur | Équivalent |
---|---|
.1 seconde | 100 millisecondes |
.01 seconde | 10 millisecondes |
.001 seconde | 1 milliseconde |
Dans .NET 6 et les versions antérieures, le seconds
paramètre est arrondi à la milliseconde la plus proche. Dans .NET 7 et versions ultérieures, la précision totale Double du seconds
paramètre est utilisée. Toutefois, en raison de l’imprécision inhérente des calculs à 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 seconds
à sa date et à son heure.
Étant donné qu’un DateTimeOffset objet ne représente pas la date et l’heure dans un fuseau horaire spécifique, la AddSeconds méthode ne prend pas en compte les règles d’ajustement d’un fuseau horaire particulier lorsqu’elle effectue des opérations arithmétiques de date et d’heure.