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