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

PersianCalendar, classe

 

Représente le calendrier persan.

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

System.Object
  System.Globalization.Calendar
    System.Globalization.PersianCalendar

[SerializableAttribute]
public class PersianCalendar : Calendar

NomDescription
System_CAPS_pubmethodPersianCalendar()

Initialise une nouvelle instance de la classe PersianCalendar.

NomDescription
System_CAPS_pubpropertyAlgorithmType

Obtient une valeur indiquant si le calendrier actif est solaire, lunaire, ou luni-solaire.(Remplace Calendar.AlgorithmType.)

System_CAPS_protpropertyDaysInYearBeforeMinSupportedYear

Obtient le nombre de jours dans l'année qui précède l'année spécifiée par le MinSupportedDateTime propriété.(Hérité de Calendar.)

System_CAPS_pubpropertyEras

Obtient la liste des ères d'un objet PersianCalendar.(Remplace Calendar.Eras.)

System_CAPS_pubpropertyIsReadOnly

Obtient une valeur indiquant si cette Calendar objet est en lecture seule.(Hérité de Calendar.)

System_CAPS_pubpropertyMaxSupportedDateTime

Obtient les dernières date et heure prises en charge par la classe PersianCalendar.(Remplace Calendar.MaxSupportedDateTime.)

System_CAPS_pubpropertyMinSupportedDateTime

Obtient les premières date et heure prises en charge par la classe PersianCalendar.(Remplace Calendar.MinSupportedDateTime.)

System_CAPS_pubpropertyTwoDigitYearMax

Obtient ou définit la dernière année d'une plage de 100 ans pouvant être représentée par une année à 2 chiffres.(Remplace Calendar.TwoDigitYearMax.)

NomDescription
System_CAPS_pubmethodAddDays(DateTime, Int32)

Retourne un DateTime qui est le nombre spécifié de jours d'arrêt spécifié DateTime.(Hérité de Calendar.)

System_CAPS_pubmethodAddHours(DateTime, Int32)

Retourne un DateTime qui est le nombre spécifié d'heures d'absence spécifié DateTime.(Hérité de Calendar.)

System_CAPS_pubmethodAddMilliseconds(DateTime, Double)

Retourne un DateTime qui est le nombre spécifié de millisecondes à spécifié DateTime.(Hérité de Calendar.)

System_CAPS_pubmethodAddMinutes(DateTime, Int32)

Retourne un DateTime qui est le nombre spécifié de minutes spécifié DateTime.(Hérité de Calendar.)

System_CAPS_pubmethodAddMonths(DateTime, Int32)

Retourne un objet DateTime qui correspond au décalage du nombre de mois spécifié par rapport à l'objet DateTime spécifié.(Remplace Calendar.AddMonths(DateTime, Int32).)

System_CAPS_pubmethodAddSeconds(DateTime, Int32)

Retourne un DateTime qui est le nombre spécifié de secondes spécifié DateTime.(Hérité de Calendar.)

System_CAPS_pubmethodAddWeeks(DateTime, Int32)

Retourne un DateTime qui est le nombre spécifié de semaines spécifié loin de DateTime.(Hérité de Calendar.)

System_CAPS_pubmethodAddYears(DateTime, Int32)

Retourne un objet DateTime qui correspond au décalage du nombre d'années spécifié par rapport à l'objet DateTime spécifié.(Remplace Calendar.AddYears(DateTime, Int32).)

System_CAPS_pubmethodClone()

Crée un nouvel objet qui est une copie de l'utilisateur actuel Calendar objet.(Hérité de Calendar.)

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)

System_CAPS_pubmethodGetDayOfMonth(DateTime)

Retourne le jour du mois dans l'objet DateTime spécifié.(Remplace Calendar.GetDayOfMonth(DateTime).)

System_CAPS_pubmethodGetDayOfWeek(DateTime)

Retourne le jour de la semaine dans l'objet DateTime spécifié.(Remplace Calendar.GetDayOfWeek(DateTime).)

System_CAPS_pubmethodGetDayOfYear(DateTime)

Retourne le jour de l'année dans l'objet DateTime spécifié.(Remplace Calendar.GetDayOfYear(DateTime).)

System_CAPS_pubmethodGetDaysInMonth(Int32, Int32)

Retourne le nombre de jours dans le mois spécifié et l'année de l'ère actuelle.(Hérité de Calendar.)

System_CAPS_pubmethodGetDaysInMonth(Int32, Int32, Int32)

Retourne le nombre de jours dans le mois spécifié de l'année et de l'ère spécifiées.(Remplace Calendar.GetDaysInMonth(Int32, Int32, Int32).)

System_CAPS_pubmethodGetDaysInYear(Int32)

Retourne le nombre de jours dans l'année spécifiée de l'ère actuelle.(Hérité de Calendar.)

System_CAPS_pubmethodGetDaysInYear(Int32, Int32)

Retourne le nombre de jours dans l'année spécifiée de l'ère spécifiée.(Remplace Calendar.GetDaysInYear(Int32, Int32).)

System_CAPS_pubmethodGetEra(DateTime)

Retourne l'ère de l'objet DateTime spécifié.(Remplace Calendar.GetEra(DateTime).)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetHour(DateTime)

Retourne la valeur des heures dans la DateTime.(Hérité de Calendar.)

System_CAPS_pubmethodGetLeapMonth(Int32)

Calcule le mois d'une année bissextile.(Hérité de Calendar.)

System_CAPS_pubmethodGetLeapMonth(Int32, Int32)

Retourne le mois intercalaire d'une année et d'une ère spécifiées.(Remplace Calendar.GetLeapMonth(Int32, Int32).)

System_CAPS_pubmethodGetMilliseconds(DateTime)

Retourne la valeur en millisecondes spécifié DateTime.(Hérité de Calendar.)

System_CAPS_pubmethodGetMinute(DateTime)

Retourne la valeur de minutes spécifié DateTime.(Hérité de Calendar.)

System_CAPS_pubmethodGetMonth(DateTime)

Retourne le mois de l'objet DateTime spécifié.(Remplace Calendar.GetMonth(DateTime).)

System_CAPS_pubmethodGetMonthsInYear(Int32)

Retourne le nombre de mois de l'année spécifiée de l'ère actuelle.(Hérité de Calendar.)

System_CAPS_pubmethodGetMonthsInYear(Int32, Int32)

Retourne le nombre de mois dans l'année spécifiée de l'ère spécifiée.(Remplace Calendar.GetMonthsInYear(Int32, Int32).)

System_CAPS_pubmethodGetSecond(DateTime)

Retourne les secondes spécifié DateTime.(Hérité de Calendar.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodGetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek)

Retourne la semaine de l'année qui inclut la date dans la DateTime valeur.(Hérité de Calendar.)

System_CAPS_pubmethodGetYear(DateTime)

Retourne l'année dans l'objet DateTime spécifié.(Remplace Calendar.GetYear(DateTime).)

System_CAPS_pubmethodIsLeapDay(Int32, Int32, Int32)

Détermine si la date spécifiée dans l'ère en cours est une année bissextile.(Hérité de Calendar.)

System_CAPS_pubmethodIsLeapDay(Int32, Int32, Int32, Int32)

Détermine si la date spécifiée est un jour intercalaire.(Remplace Calendar.IsLeapDay(Int32, Int32, Int32, Int32).)

System_CAPS_pubmethodIsLeapMonth(Int32, Int32)

Détermine si le mois spécifié de l'année spécifiée de l'ère actuelle est une année bissextile.(Hérité de Calendar.)

System_CAPS_pubmethodIsLeapMonth(Int32, Int32, Int32)

Détermine si le mois spécifié de l'année et de l'ère spécifiées est un mois intercalaire.(Remplace Calendar.IsLeapMonth(Int32, Int32, Int32).)

System_CAPS_pubmethodIsLeapYear(Int32)

Détermine si l'année spécifiée de l'ère actuelle est une année bissextile.(Hérité de Calendar.)

System_CAPS_pubmethodIsLeapYear(Int32, Int32)

Détermine si l'année spécifiée de l'ère spécifiée est une année bissextile.(Remplace Calendar.IsLeapYear(Int32, Int32).)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_pubmethodToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)

Retourne un DateTime qui est définie sur la date et heure spécifiées dans l’ère actuelle.(Hérité de Calendar.)

System_CAPS_pubmethodToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)

Retourne un objet DateTime auquel sont affectées la date, l'heure et l'ère spécifiées.(Remplace Calendar.ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32).)

System_CAPS_pubmethodToFourDigitYear(Int32)

Convertit l'année spécifiée en une représentation sur quatre chiffres de l'année.(Remplace Calendar.ToFourDigitYear(Int32).)

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

NomDescription
System_CAPS_pubfieldSystem_CAPS_staticPersianEra

Représente l'ère en cours. Ce champ est constant.

Le calendrier persan est utilisé dans la plupart des pays où le Perse est parlé, bien que certaines régions utilisent des noms de mois différents. Le calendrier persan est le calendrier officiel de l'Iran et Afghanistan, et il est un des autres calendriers dans les régions telles que le Kazakhstan et le Tadjikistan.

System_CAPS_noteRemarque

Pour plus d'informations sur l'utilisation de la PersianCalendar classe et autres classes dans le .NET Framework de calendrier, consultez Utilisation des calendriers.

Les dates du calendrier persan commencent l'année du Hijra, qui correspond à 622 (notre ère) et l'année lorsque Muhammad (PBUH) migré depuis la Mecque vers Medina. Par exemple, l'ère du 21 mars 2002 date correspond au premier jour du mois de Farvardeen de l'année 1381 (Anno Persico).

Le calendrier persan est basé sur une année solaire et dure environ 365 jours. Une année parcourt les quatre saisons, et une nouvelle année commence lorsque le soleil s'affiche à l'intersection de l'Équateur de l'hémisphère sud à l'hémisphère nord à partir du centre de la terre. La nouvelle année marque le premier jour du mois de Farvardeen qui est le premier jour du printemps dans l'hémisphère nord.

Chacun des six premiers mois du calendrier persan contient 31 jours, chacun des cinq mois a 30 jours, et le dernier mois contient 29 jours dans une année normale et 30 jours dans une année bissextile. Une année bissextile est une année qui, lorsqu'elle est divisée par 33, a un reste de 1, 5, 9, 13, 17, 22, 26 ou 30. Par exemple, l'année 1370 est une année bissextile parce que sa division par 33 génère un reste de 17. Il existe environ huit années bissextiles dans chaque cycle de 33 années.

Compter les .NET Framework 4.6, la PersianCalendar classe utilise l'algorithme astronomique SOLAIRE hégirien plutôt que d'un algorithme d'observation pour calculer des dates. Cela rend le PersianCalendar implémentation cohérente avec le calendrier persan utilisé en Iran et Afghanistan, les deux pays dans lequel le calendrier persan est plus largement utilisées. La modification affecte toutes les applications qui s'exécutent sur le .NET Framework 4, ou si une version ultérieure du .NET Framework 4.6 est installé.

Suite à l'algorithme modifié :

  • Les deux algorithmes doivent retourner des résultats identiques en convertissant les dates entre 1800 et 2123 dans le calendrier grégorien.

  • Les deux algorithmes peuvent retourner des résultats différents lors de la conversion des dates antérieures à 1800 et après 2123 dans le calendrier grégorien.

  • Le MinSupportedDateTime modification de la valeur à partir du 21 mars 0622 dans le calendrier grégorien pour le 22 mars 0622 dans le calendrier grégorien.

  • Le MaxSupportedDateTime modification de la valeur à partir du 10e jour du 10e mois de l'année 9378 dans le calendrier persan pour le 13e jour du 10e mois de l'année 9378 dans le calendrier persan.

  • Le IsLeapYear méthode peut retourner un résultat différent que précédemment.

Les applications utilisent un PersianCalendar objet pour calculer des dates dans le calendrier persan ou convertir des dates persanes de dates du calendrier grégorien.

Vous ne pouvez pas utiliser un PersianCalendar objet comme calendrier par défaut pour une culture. Le calendrier par défaut est spécifié par le CultureInfo.Calendar propriété et doit être un des calendriers retournés par la CultureInfo.OptionalCalendars propriété. Actuellement, la PersianCalendar classe n'est pas un calendrier facultatif pour toute culture prise en charge par la CultureInfo classe et par conséquent ne peut pas être un calendrier par défaut.

L'exemple suivant instancie DateTime objets à l'aide de la DateTime.Now propriété, un DateTime constructeur et le calendrier persan ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32) méthode. Il affiche ensuite ces dates dans les calendriers grégoriens et le persan. Il affiche également la plage de dates du calendrier persan.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
        PersianCalendar pc = new PersianCalendar();
        DateTime thisDate = DateTime.Now;

        // Display the current date using the Gregorian and Persian calendars. 
        Console.WriteLine("Today in the Gregorian Calendar:  {0:dddd}, {0}", thisDate);
        Console.WriteLine("Today in the Persian Calendar:    {0}, {1}/{2}/{3} {4}:{5}:{6}\n",  
                      pc.GetDayOfWeek(thisDate), 
                      pc.GetMonth(thisDate), 
                      pc.GetDayOfMonth(thisDate),  
                      pc.GetYear(thisDate), 
                      pc.GetHour(thisDate), 
                      pc.GetMinute(thisDate), 
                      pc.GetSecond(thisDate));

        // Create a date using the Gregorian calendar.
        thisDate = new DateTime(2013, 5, 28, 10, 35, 0);
        Console.WriteLine("Gregorian Calendar:  {0:D} ", thisDate);
        Console.WriteLine("Persian Calendar:    {0}, {1}/{2}/{3} {4}:{5}:{6}\n",  
                          pc.GetDayOfWeek(thisDate), 
                          pc.GetMonth(thisDate), 
                          pc.GetDayOfMonth(thisDate),  
                          pc.GetYear(thisDate), 
                          pc.GetHour(thisDate), 
                          pc.GetMinute(thisDate), 
                          pc.GetSecond(thisDate));

        // Create a date using the Persian calendar.
        thisDate = pc.ToDateTime(1395, 4, 22, 12, 30, 0, 0);
        Console.WriteLine("Gregorian Calendar:  {0:D} ", thisDate);
        Console.WriteLine("Persian Calendar:    {0}, {1}/{2}/{3} {4}:{5}:{6}\n",  
                      pc.GetDayOfWeek(thisDate), 
                      pc.GetMonth(thisDate), 
                      pc.GetDayOfMonth(thisDate),  
                      pc.GetYear(thisDate), 
                      pc.GetHour(thisDate), 
                      pc.GetMinute(thisDate), 
                      pc.GetSecond(thisDate));

        // Show the Persian Calendar date range.
        Console.WriteLine("Minimum Persian Calendar date (Gregorian Calendar):  {0:D} ", 
                          pc.MinSupportedDateTime);
        Console.WriteLine("Minimum Persian Calendar date (Persian Calendar):  " +    
                          "{0}, {1}/{2}/{3} {4}:{5}:{6}\n",  
                          pc.GetDayOfWeek(pc.MinSupportedDateTime), 
                          pc.GetMonth(pc.MinSupportedDateTime), 
                          pc.GetDayOfMonth(pc.MinSupportedDateTime),  
                          pc.GetYear(pc.MinSupportedDateTime), 
                          pc.GetHour(pc.MinSupportedDateTime), 
                          pc.GetMinute(pc.MinSupportedDateTime), 
                          pc.GetSecond(pc.MinSupportedDateTime));

        Console.WriteLine("Maximum Persian Calendar date (Gregorian Calendar):  {0:D} ", 
                          pc.MaxSupportedDateTime);
        Console.WriteLine("Maximum Persian Calendar date (Persian Calendar):  " +   
                          "{0}, {1}/{2}/{3} {4}:{5}:{6}\n",  
                          pc.GetDayOfWeek(pc.MaxSupportedDateTime), 
                          pc.GetMonth(pc.MaxSupportedDateTime), 
                          pc.GetDayOfMonth(pc.MaxSupportedDateTime),  
                          pc.GetYear(pc.MaxSupportedDateTime), 
                          pc.GetHour(pc.MinSupportedDateTime), 
                          pc.GetMinute(pc.MaxSupportedDateTime), 
                          pc.GetSecond(pc.MaxSupportedDateTime));
   }
}
// The example displays the following output when run under the .NET Framework 4.6:
//    Today in the Gregorian Calendar:  Monday, 2/4/2013 9:11:36 AM
//    Today in the Persian Calendar:    Monday, 11/16/1391 9:11:36
//
//    Gregorian Calendar:  Tuesday, May 28, 2013
//    Persian Calendar:    Tuesday, 3/7/1392 10:35:0
//
//    Gregorian Calendar:  Tuesday, July 12, 2016
//    Persian Calendar:    Tuesday, 4/22/1395 12:30:0
//
//    Minimum Persian Calendar date (Gregorian Calendar):  Friday, March 22, 0622
//    Minimum Persian Calendar date (Persian Calendar):  Friday, 1/1/1 0:0:0
//
//    Maximum Persian Calendar date (Gregorian Calendar):  Friday, December 31, 9999
//    Maximum Persian Calendar date (Persian Calendar):  Friday, 10/13/9378 0:59:59
//
// The example displays the following output when run under versions of
// the .NET Framework before the .NET Framework 4.6:
//    Today in the Gregorian Calendar:  Monday, 2/4/2013 9:11:36 AM
//    Today in the Persian Calendar:    Monday, 11/16/1391 9:11:36
//    
//    Gregorian Calendar:  Tuesday, May 28, 2013
//    Persian Calendar:    Tuesday, 3/7/1392 10:35:0
//    
//    Gregorian Calendar:  Tuesday, July 12, 2016
//    Persian Calendar:    Tuesday, 4/22/1395 12:30:0
//    
//    Minimum Persian Calendar date (Gregorian Calendar):  Thursday, March 21, 0622
//    Minimum Persian Calendar date (Persian Calendar):  Thursday, 1/1/1 0:0:0
//    
//    Maximum Persian Calendar date (Gregorian Calendar):  Friday, December 31, 9999
//    Maximum Persian Calendar date (Persian Calendar):  Friday, 10/10/9378 0:59:59

L'exemple suivant illustre les membres de champ, de propriété et de méthode de la PersianCalendar classe.

using System;
using System.Globalization;

class Sample 
{
    public static void Main() 
    {
      PersianCalendar jc = new PersianCalendar();
      DateTime thisDate = DateTime.Now;

		//--------------------------------------------------------------------------------
		// Properties
		//--------------------------------------------------------------------------------
      Console.WriteLine("\n........... Selected Properties .....................\n");
      Console.Write("Eras:");
      foreach (int era in jc.Eras)
      {
         Console.WriteLine(" era = {0}", era);
      }
		//--------------------------------------------------------------------------------
      Console.WriteLine("\nTwoDigitYearMax = {0}", jc.TwoDigitYearMax);
		//--------------------------------------------------------------------------------
		// Methods
		//--------------------------------------------------------------------------------
      Console.WriteLine("\n............ Selected Methods .......................\n");

		//--------------------------------------------------------------------------------
      Console.WriteLine("GetDayOfYear: day = {0}", jc.GetDayOfYear(thisDate));
		//--------------------------------------------------------------------------------
      Console.WriteLine("GetDaysInMonth: days = {0}", 
                        jc.GetDaysInMonth( thisDate.Year, thisDate.Month, 
                        PersianCalendar.PersianEra));
		//--------------------------------------------------------------------------------
      Console.WriteLine("GetDaysInYear: days = {0}", 
                        jc.GetDaysInYear(thisDate.Year, PersianCalendar.PersianEra));
		//--------------------------------------------------------------------------------
      Console.WriteLine("GetLeapMonth: leap month (if any) = {0}", 
                        jc.GetLeapMonth(thisDate.Year, PersianCalendar.PersianEra));
		//-------------------------------------------------------------
      Console.WriteLine("GetMonthsInYear: months in a year = {0}", 
                        jc.GetMonthsInYear(thisDate.Year, PersianCalendar.PersianEra));
		//--------------------------------------------------------------------------------
      Console.WriteLine("IsLeapDay: This is a leap day = {0}", 
                        jc.IsLeapDay(thisDate.Year, thisDate.Month, thisDate.Day, 
                        PersianCalendar.PersianEra));
		//--------------------------------------------------------------------------------
      Console.WriteLine("IsLeapMonth: This is a leap month = {0}", 
                        jc.IsLeapMonth(thisDate.Year, thisDate.Month, 
                        PersianCalendar.PersianEra));
		//--------------------------------------------------------------------------------
      Console.WriteLine("IsLeapYear: 1370 is a leap year = {0}", 
                        jc.IsLeapYear(1370, PersianCalendar.PersianEra));
		//--------------------------------------------------------------------------------

		// Get the 4-digit year for a year whose last two digits are 99. The 4-digit year 
		// depends on the current value of the TwoDigitYearMax property.

      Console.WriteLine("ToFourDigitYear:");
      Console.WriteLine("  If TwoDigitYearMax = {0}, ToFourDigitYear(99) = {1}", 
                         jc.TwoDigitYearMax, jc.ToFourDigitYear(99));
      jc.TwoDigitYearMax = thisDate.Year;
      Console.WriteLine("  If TwoDigitYearMax = {0}, ToFourDigitYear(99) = {1}", 
                        jc.TwoDigitYearMax, jc.ToFourDigitYear(99));
    }
}
// The example displays the following output:
//       ........... Selected Properties .....................
//       
//       Eras: era = 1
//       
//       TwoDigitYearMax = 99
//       
//       ............ Selected Methods .......................
//       
//       GetDayOfYear: day = 1
//       GetDaysInMonth: days = 31
//       GetDaysInYear: days = 365
//       GetLeapMonth: leap month (if any) = 0
//       GetMonthsInYear: months in a year = 12
//       IsLeapDay: This is a leap day = False
//       IsLeapMonth: This is a leap month = False
//       IsLeapYear: 1370 is a leap year = True
//       ToFourDigitYear:
//         If TwoDigitYearMax = 99, ToFourDigitYear(99) = 99
//         If TwoDigitYearMax = 2012, ToFourDigitYear(99) = 1999

Universal Windows Platform
Disponible depuis 10
.NET Framework
Disponible depuis 2.0
Silverlight
Disponible depuis 5.0

Tous les membres statiques (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Retour au début
Afficher: