DateTimeOffset.AddSeconds(Double) Méthode

Définition

Espace de noms:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Source:

DateTimeOffset.cs

Retourne un nouvel objet DateTimeOffset qui ajoute un nombre spécifié de secondes entières et partielles à la valeur de cette instance.

C#

public DateTimeOffset AddSeconds(double seconds);

Paramètres

seconds

Double

Nombre de secondes 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 actuel et du nombre de secondes représenté par seconds.

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 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.

Note

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

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