Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Calendar.AddYears, méthode (DateTime, Int32)

 

En cas de substitution dans une classe dérivée, retourne un DateTime qui correspond au nombre d'années spécifié jusqu'au DateTime spécifié.

Espace de noms:   System.Globalization
Assembly:  mscorlib (dans mscorlib.dll)

public abstract DateTime AddYears(
	DateTime time,
	int years
)

Paramètres

time

DateTime auquel ajouter des années.

years

Nombre d'années à ajouter.

Valeur de retour

Type: System.DateTime

DateTime qui résulte de l'ajout du nombre d'années spécifié au DateTime spécifié.

Exception Condition
ArgumentException

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

ArgumentOutOfRangeException

years sort de la plage prise en charge par la valeur de retour DateTime.

La valeur years est ajoutée au DateTime spécifié.Si years est négatif, le DateTime obtenu est antérieur au DateTime spécifié.

La partie jour du DateTime obtenu est affectée si le jour obtenu n'est pas un jour valide du mois obtenu de l'année obtenue.Elle est remplacée par le dernier jour valide du mois obtenu de l'année obtenue.La partie mois du DateTime obtenu est affectée si le mois obtenu n'est pas valide pour l'année obtenue.Elle est remplacée par le dernier mois valide de l'année obtenue.La partie ère du DateTime résultant est affectée si l'année résultante se trouve en dehors de l'ère du DateTime spécifié.La partie heure du DateTime résultant demeure identique au DateTime spécifié.

Par exemple, dans le calendrier grégorien, février compte 28 jours, hormis durant une année bissextile où il compte 29 jours.Si la date spécifiée est le 29ème jour de février dans une année bissextile et si la valeur de years est 1, la date résultante est le 28ème jour de février l'année suivante.

Si years est négatif, le DateTime obtenu est antérieur au DateTime spécifié.

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

returnTime = DateTime.SpecifyKind(cal.AddYears(time, years), time.Kind);

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

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

*/

Universal Windows Platform
Disponible depuis 4.5
.NET Framework
Disponible depuis 1.1
Portable Class Library
Pris en charge dans : portable .NET platforms
Silverlight
Disponible depuis 2.0
Windows Phone Silverlight
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1
Retour au début
Afficher: