Calendar.AddDays(DateTime, Int32) Méthode

Définition

Espace de noms:

System.Globalization

Assembly:

System.Runtime.dll

Source:

Calendar.cs

Retourne un DateTime qui est le nombre de jours spécifié jusqu’au DateTime spécifié.

C#

public virtual DateTime AddDays (DateTime time, int days);

Paramètres

time

DateTime

DateTime auquel ajouter les jours.

days

Int32

Nombre de jours à ajouter.

Retours

DateTime

DateTime obtenu en ajoutant le nombre de jours spécifié au DateTime spécifié.

Exceptions

ArgumentException

Le DateTime obtenu est en dehors de la plage prise en charge de ce calendrier.

ArgumentOutOfRangeException

days est en dehors de la plage prise en charge par la valeur de retour DateTime.

Exemples

L’exemple de code suivant illustre les membres de la Calendar classe .

C#

using System;
using System.Globalization;

public class SamplesCalendar  {

   public static void Main()  {

      // Sets a DateTime to April 3, 2002 of the Gregorian calendar.
      DateTime myDT = new DateTime( 2002, 4, 3, new GregorianCalendar() );

      // Uses the default calendar of the InvariantCulture.
      Calendar myCal = CultureInfo.InvariantCulture.Calendar;

      // Displays the values of the DateTime.
      Console.WriteLine( "April 3, 2002 of the Gregorian calendar:" );
      DisplayValues( myCal, myDT );

      // Adds 5 to every component of the DateTime.
      myDT = myCal.AddYears( myDT, 5 );
      myDT = myCal.AddMonths( myDT, 5 );
      myDT = myCal.AddWeeks( myDT, 5 );
      myDT = myCal.AddDays( myDT, 5 );
      myDT = myCal.AddHours( myDT, 5 );
      myDT = myCal.AddMinutes( myDT, 5 );
      myDT = myCal.AddSeconds( myDT, 5 );
      myDT = myCal.AddMilliseconds( myDT, 5 );

      // Displays the values of the DateTime.
      Console.WriteLine( "After adding 5 to each component of the DateTime:" );
      DisplayValues( myCal, myDT );
   }

   public static void DisplayValues( Calendar myCal, DateTime myDT )  {
      Console.WriteLine( "   Era:          {0}", myCal.GetEra( myDT ) );
      Console.WriteLine( "   Year:         {0}", myCal.GetYear( myDT ) );
      Console.WriteLine( "   Month:        {0}", myCal.GetMonth( myDT ) );
      Console.WriteLine( "   DayOfYear:    {0}", myCal.GetDayOfYear( myDT ) );
      Console.WriteLine( "   DayOfMonth:   {0}", myCal.GetDayOfMonth( myDT ) );
      Console.WriteLine( "   DayOfWeek:    {0}", myCal.GetDayOfWeek( myDT ) );
      Console.WriteLine( "   Hour:         {0}", myCal.GetHour( myDT ) );
      Console.WriteLine( "   Minute:       {0}", myCal.GetMinute( myDT ) );
      Console.WriteLine( "   Second:       {0}", myCal.GetSecond( myDT ) );
      Console.WriteLine( "   Milliseconds: {0}", myCal.GetMilliseconds( myDT ) );
      Console.WriteLine();
   }
}


/*
This code produces the following output.

April 3, 2002 of the Gregorian calendar:
   Era:          1
   Year:         2002
   Month:        4
   DayOfYear:    93
   DayOfMonth:   3
   DayOfWeek:    Wednesday
   Hour:         0
   Minute:       0
   Second:       0
   Milliseconds: 0

After adding 5 to each component of the DateTime:
   Era:          1
   Year:         2007
   Month:        10
   DayOfYear:    286
   DayOfMonth:   13
   DayOfWeek:    Saturday
   Hour:         5
   Minute:       5
   Second:       5
   Milliseconds: 5

*/

Remarques

La days valeur est ajoutée au spécifié DateTime. Si days est négatif, le résultat DateTime est antérieur au spécifié DateTime.

La partie de mois du résultat DateTime est affectée si le jour résultant est en dehors du mois du spécifié DateTime. La partie année du résultat DateTime est affectée si le mois résultant est en dehors de l’année du spécifié DateTime. La partie era du résultat DateTime est affectée si l’année résultante est en dehors de l’ère du spécifié DateTime. La partie heure de la journée du résultat DateTime reste la même que celle spécifiée DateTime.

La Kind propriété de la valeur retournée DateTime est DateTimeKind.Unspecifiedtoujours égale à . Vous pouvez conserver la Kind propriété du paramètre en time appelant la DateTime.SpecifyKind méthode, comme le montre l’exemple suivant.

C#

returnTime = DateTime.SpecifyKind(cal.AddDays(time, days), time.Kind);

S’applique à

Voir aussi

• DateTime
• AddYears(DateTime, Int32)
• AddMonths(DateTime, Int32)
• AddWeeks(DateTime, Int32)
• AddHours(DateTime, Int32)
• AddMinutes(DateTime, Int32)
• AddSeconds(DateTime, Int32)
• AddMilliseconds(DateTime, Double)