DateTimeOffset.AddMinutes(Double) Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Source:

DateTimeOffset.cs

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

public:
 DateTimeOffset AddMinutes(double minutes);

public DateTimeOffset AddMinutes (double minutes);

member this.AddMinutes : double -> DateTimeOffset

Public Function AddMinutes (minutes As Double) As DateTimeOffset

Paramètres

minutes

Double

Nombre de minutes 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 actif et du nombre de minutes représenté par minutes.

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 minutes paramètre est la partie fractionnaire d’une minute. Par exemple, 4,5 équivaut à 4 minutes, 30 secondes, 0 millisecondes.

Dans .NET 6 et les versions antérieures, le minutes paramètre est arrondi à la milliseconde la plus proche. Dans .NET 7 et versions ultérieures, la précision complète Double du minutes paramètre est utilisée. Toutefois, en raison de l’imprécision inhérente des mathématiques à 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 minutes à sa date et heure.

Étant donné qu’un DateTimeOffset objet ne représente pas la date et l’heure d’un fuseau horaire spécifique, la AddMinutes méthode ne tient pas compte des règles d’ajustement d’un fuseau horaire particulier lorsqu’elle effectue une arithmétique de date et d’heure.

La conversion d’intervalles de temps de moins d’une minute en fraction peut entraîner une perte de précision. (Par exemple, une seconde est 0,01666 d’une minute.) Si cela pose problème, vous pouvez utiliser la Add méthode, qui vous permet de spécifier plusieurs types d’intervalles de temps dans un seul appel de méthode et élimine la nécessité de convertir des intervalles de temps en parties fractionnaires d’une minute.

Voir aussi

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