DateTime.AddDays(Double) Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Source:

DateTime.cs

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

public:
 DateTime AddDays(double value);

public DateTime AddDays (double value);

member this.AddDays : double -> DateTime

Public Function AddDays (value As Double) As DateTime

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.

using namespace System;

int main()
{
   // Calculate what day of the week is 36 days from this instant.
   DateTime today = System::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

open System

let today = DateTime.Now
let answer = today.AddDays 36
printfn $"Today: {today:dddd}"
printfn $"36 days from today: {answer:dddd}"


// The example displays output like the following:
//       Today: Wednesday
//       36 days from today: Thursday

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

Class Class1
   Public Shared Sub Main()
      Dim today As System.DateTime
      Dim answer As System.DateTime

      today = System.DateTime.Now
      answer = today.AddDays(36)

      Console.WriteLine("Today: {0:dddd}", today)
      Console.WriteLine("36 days from today: {0:dddd}", answer)
   End Sub
End Class
' 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.

Voir aussi

• Double