DateTime.AddDays(Double) Méthode

Définition

Espace de noms:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Source:

DateTime.cs

Retourne un nouveau DateTime qui ajoute le nombre de jours spécifié à la valeur de cette instance.

C#

public DateTime AddDays(double value);

Paramètres

value

Double

Nombre de jours entiers et partiels. Le paramètre value peut être négatif ou positif.

Retours

DateTime

Objet dont la valeur est égale à la somme de la date et de l'heure représentées par cette instance et du nombre de jours représenté par value.

Exceptions

ArgumentOutOfRangeException

Le résultat DateTime est inférieur à DateTime.MinValue ou supérieur à DateTime.MaxValue.

Exemples

L’exemple suivant utilise la AddDays méthode pour déterminer le jour de la semaine 36 jours après la date actuelle.

C#

using System;

class Class1
{
    static void Main()
    {
        DateTime today = DateTime.Now;
        DateTime answer = today.AddDays(36);
        Console.WriteLine("Today: {0:dddd}", today);
        Console.WriteLine("36 days from today: {0:dddd}", answer);
    }
}
// The example displays output like the following:
//       Today: Wednesday
//       36 days from today: Thursday

Remarques

Cette méthode ne modifie pas la valeur de ce DateTime. Au lieu de cela, elle retourne un nouveau DateTime dont la valeur est le résultat de cette opération.

La partie fractionnaire de value est la partie fractionnaire d’une journée. Par exemple, 4,5 équivaut à 4 jours, 12 heures, 0 minute, 0 seconde, 0 milliseconde et 0 cycles.

Dans .NET 6 et les versions antérieures, le value paramètre est arrondi à la milliseconde la plus proche. Dans .NET 7 et versions ultérieures, la précision totale Double du value paramètre est utilisée. Toutefois, en raison de l’imprécision inhérente des calculs à virgule flottante, la précision obtenue varie.

La AddDays méthode prend en compte les années bissextiles et le nombre de jours dans un mois lors de l’exécution de l’arithmétique de date.

S’applique à

Voir aussi

• Double