Partager via


DateTimeOffset.AddSeconds(Double) Méthode

Définition

Retourne un nouvel DateTimeOffset objet qui ajoute un nombre spécifié de secondes entières et fractionnaires à 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 fractionnaires. Le nombre peut être négatif ou positif.

Retours

Objet dont la valeur est la somme de la date et de l’heure représentées par l’objet actuel DateTimeOffset et le nombre de secondes représentées 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 Framework, le seconds paramètre est arrondi à la milliseconde la plus proche. Dans .NET 7 et versions ultérieures, la précision complète Double du seconds paramètre est utilisée. Toutefois, en raison de l’imprécision inhérente des mathématiques à virgule flottante, la précision résultante varie.

Note

Cette méthode retourne un nouvel DateTimeOffset objet. Elle 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 considère pas les règles d’ajustement d’un fuseau horaire particulier lorsqu’elle effectue des arithmétiques de date et d’heure.

S’applique à

Voir aussi