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

UmAlQuraCalendar.AddYears méthode (DateTime, Int32)

 

Date de publication : novembre 2016

Calcule une date qui est un nombre spécifié d’années à partir d’une date initiale spécifiée.

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

public override DateTime AddYears(
	DateTime time,
	int years
)

Paramètres

time
Type: System.DateTime

La date à laquelle ajouter des années. La classe UmAlQuraCalendar prend en charge uniquement les dates comprises entre le 30/04/1900 00.00.00 (date grégorienne) et le 16/11/2077 23:59:59 (date grégorienne).

years
Type: System.Int32

Nombre positif ou négatif d'années à ajouter.

Valeur de retour

Type: System.DateTime

La date obtenue en ajoutant le nombre d’années spécifié par le years paramètre à la date spécifiée par la time paramètre.

Exception Condition
ArgumentException

La date obtenue est en dehors de la plage prise en charge par le UmAlQuraCalendar (classe).

ArgumentOutOfRangeException

years est inférieur à -10.000 ou supérieur à 10 000.

ou

time ne figure pas dans la plage prise en charge par ce calendrier.

La partie jour de la DateTime est affectée si le jour résultant n’est pas un jour valide du mois obtenu de l’année obtenue. Il est remplacé par le dernier jour valide du mois obtenu de l’année obtenue. La partie mois de la DateTime reste identique à celui spécifié DateTime. Cette implémentation prend en charge uniquement l’ère actuelle. Par conséquent, une exception est levée si l’année obtenue est en dehors de l’ère de l’objet DateTime. La partie heure du jour de la DateTime reste identique à celui spécifié DateTime.

Par exemple, Zulhijjah comprend 29 jours, sauf durant les années bissextiles lorsque c’est de 30 jours. Si la date spécifiée est le jour de Zulhijjah durant une année bissextile 30 et la valeur de le years paramètre est 1, la date obtenue est le 29ème jour de Zulhijjah de l’année suivante.

Si years est négatif, résultant DateTime est antérieure à spécifié DateTime.

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

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

L’exemple suivant instancie un DateTime valeur et affiche les valeurs de plusieurs de ses composants dans le calendrier Um AL Qura. Ensuite, il appelle le AddYears et AddMonths méthodes pour ajouter 2 années et 10 mois dans le calendrier Um Al Qura à la valeur de date. Enfin, il affiche à nouveau les valeurs de ces composants date dans le calendrier Um Al Qura.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      DateTime date1 = new DateTime(2011, 4, 3, new GregorianCalendar());
      Calendar cal = new UmAlQuraCalendar();

      Console.WriteLine("{0:MMMM d, yyyy} in the Gregorian calendar is equivalent to:", date1);
      DisplayCalendarInfo(cal, date1);

      // Add 2 years and 10 months by calling UmAlQuraCalendar methods.
      date1 = cal.AddYears(date1, 2);
      date1 = cal.AddMonths(date1, 10);       

      Console.WriteLine("After adding 2 years and 10 months in the {0} calendar,", 
                        GetCalendarName(cal));
      Console.WriteLine("{0:MMMM d, yyyy} in the Gregorian calendar is equivalent to:", date1);
      DisplayCalendarInfo(cal, date1);
   }

   private static void DisplayCalendarInfo(Calendar cal, DateTime date1)
   {
      Console.WriteLine("   Calendar:   {0}", GetCalendarName(cal));    
      Console.WriteLine("   Era:        {0}", cal.GetEra(date1));
      Console.WriteLine("   Year:       {0}", cal.GetYear(date1));
      Console.WriteLine("   Month:      {0}", cal.GetMonth(date1));
      Console.WriteLine("   DayOfYear:  {0}", cal.GetDayOfYear(date1));
      Console.WriteLine("   DayOfMonth: {0}", cal.GetDayOfMonth(date1));
      Console.WriteLine("   DayOfWeek:  {0}\n", cal.GetDayOfWeek(date1));
   }

   private static string GetCalendarName(Calendar cal)
   {
      return cal.ToString().Replace("System.Globalization.", "").
             Replace("Calendar", "");   
   }
}
// The example displays the following output:
//    April 3, 2011 in the Gregorian calendar is equivalent to:
//       Calendar:   UmAlQura
//       Era:        1
//       Year:       1432
//       Month:      4
//       DayOfYear:  118
//       DayOfMonth: 29
//       DayOfWeek:  Sunday
//    
//    After adding 2 years and 10 months in the UmAlQura calendar,
//    January 1, 2014 in the Gregorian calendar is equivalent to:
//       Calendar:   UmAlQura
//       Era:        1
//       Year:       1435
//       Month:      2
//       DayOfYear:  59
//       DayOfMonth: 29
//       DayOfWeek:  Wednesday

Plateforme Windows universelle
Disponible depuis 10
.NET Framework
Disponible depuis 2.0
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.0
Retour au début
Afficher: