Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

UmAlQuraCalendar.AddYears, méthode

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
Date à laquelle ajouter des années. La classe UmAlQuraCalendar prend en charge uniquement les dates comprises entre le 30/04/1900 00:00:00 (calendrier grégorien) et le 16/11/2077 23:59:59 (calendrier grégorien).
years
Type : System.Int32
Nombre positif ou négatif d'années à ajouter.

Valeur de retour

Type : System.DateTime
Date obtenue en ajoutant le nombre d'années spécifié par le paramètre years à la date spécifiée par le paramètre time.

ExceptionCondition
ArgumentException

La date obtenue ne figure pas dans la plage prise en charge par la classe UmAlQuraCalendar.

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 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 résultant demeure identique au DateTime spécifié. Cette implémentation prend uniquement en charge l'ère en cours. Par conséquent, une exception est levée si l'année obtenue 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, le mois de Zulhijjah comprend 29 jours, sauf les années bissextiles, où il comprend 30 jours. Si la date spécifiée est le 30ème jour de Zulhijjah durant une année bissextile et si la valeur du paramètre years est 1, la date obtenue est le 29ème jour de Zulhijjah de 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 suivant instancie une valeur DateTime et affiche les valeurs de plusieurs de ses composants dans le calendrier Um AL Qura. Ensuite, elle appelle les méthodes AddYears et AddMonths 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


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

.NET pour les applications Windows Phone

Pris en charge dans : Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft