DateTimeOffset.AddSeconds(Double) Méthode

Définition

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.

S’applique à

Voir aussi