JapaneseCalendar Classe

Définition

Représente le calendrier japonais.

public ref class JapaneseCalendar : System::Globalization::Calendar
public class JapaneseCalendar : System.Globalization.Calendar
[System.Serializable]
public class JapaneseCalendar : System.Globalization.Calendar
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class JapaneseCalendar : System.Globalization.Calendar
type JapaneseCalendar = class
    inherit Calendar
[<System.Serializable>]
type JapaneseCalendar = class
    inherit Calendar
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type JapaneseCalendar = class
    inherit Calendar
Public Class JapaneseCalendar
Inherits Calendar
Héritage
JapaneseCalendar
Attributs

Remarques

Le calendrier japonais, également appelé calendrier Wareki, fonctionne exactement comme le calendrier grégorien, sauf que l’année et l’ère sont différentes.

Note

Pour plus d’informations sur l’utilisation de la JapaneseCalendar classe et les autres classes de calendrier dans .NET, consultez Utilisation des calendriers.

Le calendrier japonais reconnaît une ère pour le règne de chaque empereur. Les deux dernières époques sont l’ère Heisei, commençant par l’année civile grégorienne 1989 et l’ère Reiwa, commençant par l’année civile grégorienne 2019. Le nom de l’ère est généralement affiché avant l’année. Par exemple, l’année civile grégorienne 2001 est l’année civile japonaise Heisei 13. Notez que la première année d’une ère est appelée « Gannen ». Par conséquent, l’année civile grégorienne 1989 était l’année civile japonaise Heisei Gannen. Par défaut, les opérations de mise en forme avec des chaînes de format de date et d’heure spécifiées, telles que « D », « F » et « Y », génèrent Gannen plutôt que « 1 » dans la chaîne de résultat.

Important

Les ères dans les calendriers japonais sont basées sur le règne de l’empereur et sont donc censées changer. Par exemple, le 1er mai 2019 a marqué le début de l’ère Reiwa dans le JapaneseCalendar et JapaneseLunisolarCalendar. Ce changement d’ère affecte toutes les applications qui utilisent ces calendriers. Pour plus d’informations et pour déterminer si vos applications sont affectées, consultez Gestion d’une nouvelle ère dans le calendrier japonais dans .NET. Pour plus d’informations sur le test de vos applications sur les systèmes Windows afin de garantir leur préparation au changement d’ère, consultez Préparer votre application pour le changement d’ère japonaise. Pour les fonctionnalités de .NET qui prennent en charge les calendriers avec plusieurs ères et pour les meilleures pratiques lors de l’utilisation de calendriers qui prennent en charge plusieurs ères, consultez Utilisation des ères.

Cette classe affecte des nombres aux ères comme suit :

Valeur GetEra Nom de l’ère Abréviation de l’ère Dates grégoriennes
5 令和 (Reiwa) 令和 (R, r) 1er mai 2019 à présent
4 平成 (Heisei) 平 (H, h) 8 janvier 1989 au 30 avril 2019
3 昭和 (Showa) 昭 (S, s) 25 décembre 1926 au 7 janvier 1989
2 ス正 (Taisho) T, t) 30 juillet 1912 au 24 décembre 1926
1 明治 (Meiji) 明 (M, m) 23 octobre 1868 au 29 juillet 1912

Cette classe gère les dates du 23 octobre dans l’année Meiji 1 (dans le calendrier grégorien, 23 octobre 1868). Bien que le calendrier japonais ait été passé d’un calendrier lunaire à un calendrier solaire dans l’année Meiji 6 (1873 du calendrier grégorien), cette implémentation est basée uniquement sur le calendrier solaire.

Les années bissextiles dans le calendrier japonais correspondent aux mêmes années bissextiles dans le calendrier grégorien. Une année bissextile dans le calendrier grégorien est définie comme une année grégorienne qui est uniformément divisible par quatre, sauf si elle est divisible par 100. Cependant, les années grégoriennes qui sont divisibles par 400 sont des années bissextiles. Une année commune a 365 jours et une année bissextile a 366 jours.

Le calendrier japonais a 12 mois avec 28 à 31 jours chacun :

Valeur GetMonth Mois Anglais Jours dans les années courantes Jours dans les années bissextiles
1 1月 (Ichigatsu) Janvier 31 31
2 2月 (Nigatsu) Février 28 29
3 3月 (Sangatsu) mars 31 31
4 4月 (Shigatsu) Avril 30 30
5 5月 (Gogatsu) Mai 31 31
6 6月 (スgatsu) Juin 30 30
7 7月 (Shichigatsu) Juillet 31 31
8 8月 (Hachigatsu) Août 31 31
9 9月 (Kugatsu) Septembre 30 30
10 10月 (Juugatsu) Octobre 31 31
11 11月 (Juuichigatsu) Novembre 30 30
12 12月 (Juunigatsu) Décembre 31 31

Nigatsu, qui équivaut au mois de février du calendrier grégorien, a 29 jours pendant les années bissextiles et 28 pendant les années communes.

La date du 1er janvier 2001 A.D. dans le calendrier grégorien équivaut au premier jour d’Ichigatsu dans l’année Heisei 13 dans le calendrier japonais.

JapaneseCalendar S’il s’agit du calendrier actuel de la culture japonaise, DateTime.Parse reconnaît les abréviations de l’ère devant l’année. L’abréviation est l’abréviation de l’alphabet latin non sensible au caractère unique ou l’abréviation kanji à caractère unique. DateTime.Parse reconnaît également « 1 » ou Gannen (元年) comme la première année d’une ère.

Chaque CultureInfo objet prend en charge un ensemble de calendriers. La Calendar propriété retourne le calendrier par défaut de la culture, et la OptionalCalendars propriété retourne un tableau contenant tous les calendriers pris en charge par la culture. Pour modifier le calendrier utilisé par un CultureInfo, définissez la DateTimeFormatInfo.Calendar propriété sur un nouveau Calendar.

Constructeurs

Nom Description
JapaneseCalendar()

Initialise une nouvelle instance de la classe JapaneseCalendar.

Champs

Nom Description
CurrentEra

Représente l’ère actuelle du calendrier actuel. La valeur de ce champ est 0.

(Hérité de Calendar)

Propriétés

Nom Description
AlgorithmType

Obtient une valeur qui indique si le calendrier actuel est basé sur le soleil, lunaire ou une combinaison des deux.

DaysInYearBeforeMinSupportedYear

Obtient le nombre de jours de l’année qui précède l’année spécifiée par la MinSupportedDateTime propriété.

(Hérité de Calendar)
Eras

Obtient la liste des ères dans le JapaneseCalendar.

IsReadOnly

Obtient une valeur indiquant si cet Calendar objet est en lecture seule.

(Hérité de Calendar)
MaxSupportedDateTime

Obtient la date et l’heure les plus récentes prises en charge par l’objet actuel JapaneseCalendar .

MinSupportedDateTime

Obtient la date et l’heure les plus anciennes prises en charge par l’objet actuel JapaneseCalendar .

TwoDigitYearMax

Obtient ou définit la dernière année d’une plage de 100 ans qui peut être représentée par une année à 2 chiffres.

Méthodes

Nom Description
AddDays(DateTime, Int32)

Retourne un DateTime nombre spécifié de jours à partir de l’objet spécifié DateTime.

(Hérité de Calendar)
AddHours(DateTime, Int32)

Retourne un DateTime nombre spécifié d’heures à partir de l’objet spécifié DateTime.

(Hérité de Calendar)
AddMilliseconds(DateTime, Double)

Retourne un DateTime nombre spécifié de millisecondes à partir du nombre spécifié DateTime.

(Hérité de Calendar)
AddMinutes(DateTime, Int32)

Retourne un DateTime nombre spécifié de minutes à partir de l’objet spécifié DateTime.

(Hérité de Calendar)
AddMonths(DateTime, Int32)

Retourne un DateTime nombre spécifié de mois à partir du nombre spécifié DateTime.

AddSeconds(DateTime, Int32)

Retourne un DateTime nombre spécifié de secondes à partir de l’objet spécifié DateTime.

(Hérité de Calendar)
AddWeeks(DateTime, Int32)

Retourne un DateTime nombre spécifié de semaines à partir de l’objet spécifié DateTime.

(Hérité de Calendar)
AddYears(DateTime, Int32)

Retourne un DateTime nombre spécifié d’années à partir de l’objet spécifié DateTime.

Clone()

Crée un objet qui est une copie de l’objet actif Calendar .

(Hérité de Calendar)
Equals(Object)

Détermine si l’objet spécifié est égal à l’objet actuel.

(Hérité de Object)
GetDayOfMonth(DateTime)

Retourne le jour du mois dans le fichier spécifié DateTime.

GetDayOfWeek(DateTime)

Retourne le jour de la semaine dans le fichier spécifié DateTime.

GetDayOfYear(DateTime)

Retourne le jour de l’année dans le fichier spécifié DateTime.

GetDaysInMonth(Int32, Int32, Int32)

Retourne le nombre de jours dans le mois spécifié dans l’année spécifiée dans l’ère spécifiée.

GetDaysInMonth(Int32, Int32)

Retourne le nombre de jours dans le mois et l’année spécifiés de l’ère actuelle.

(Hérité de Calendar)
GetDaysInYear(Int32, Int32)

Retourne le nombre de jours dans l’année spécifiée dans l’ère spécifiée.

GetDaysInYear(Int32)

Retourne le nombre de jours dans l’année spécifiée de l’ère actuelle.

(Hérité de Calendar)
GetEra(DateTime)

Retourne l’ère dans le fichier spécifié DateTime.

GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetHour(DateTime)

Retourne la valeur d’heures dans le fichier spécifié DateTime.

(Hérité de Calendar)
GetLeapMonth(Int32, Int32)

Calcule le mois bissextile pour une année et une ère spécifiées.

GetLeapMonth(Int32)

Calcule le mois bissextile pour une année spécifiée.

(Hérité de Calendar)
GetMilliseconds(DateTime)

Retourne la valeur de millisecondes dans le fichier spécifié DateTime.

(Hérité de Calendar)
GetMinute(DateTime)

Retourne la valeur minutes dans le fichier spécifié DateTime.

(Hérité de Calendar)
GetMonth(DateTime)

Retourne le mois dans le fichier spécifié DateTime.

GetMonthsInYear(Int32, Int32)

Retourne le nombre de mois de l’année spécifiée dans l’ère spécifiée.

GetMonthsInYear(Int32)

Retourne le nombre de mois dans l’année spécifiée dans l’ère actuelle.

(Hérité de Calendar)
GetSecond(DateTime)

Retourne la valeur de secondes dans le fichier spécifié DateTime.

(Hérité de Calendar)
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek)

Retourne la semaine de l’année qui inclut la date dans le fichier spécifié DateTime.

GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek)

Retourne la semaine de l’année qui inclut la date dans la valeur spécifiée DateTime .

(Hérité de Calendar)
GetYear(DateTime)

Retourne l’année dans le fichier spécifié DateTime.

IsLeapDay(Int32, Int32, Int32, Int32)

Détermine si la date spécifiée dans l’ère spécifiée est un jour bissextile.

IsLeapDay(Int32, Int32, Int32)

Détermine si la date spécifiée dans l’ère actuelle est un jour bissextile.

(Hérité de Calendar)
IsLeapMonth(Int32, Int32, Int32)

Détermine si le mois spécifié dans l’année spécifiée dans l’ère spécifiée est un mois bissextile.

IsLeapMonth(Int32, Int32)

Détermine si le mois spécifié dans l’année spécifiée dans l’ère actuelle est un mois bissextile.

(Hérité de Calendar)
IsLeapYear(Int32, Int32)

Détermine si l’année spécifiée dans l’ère spécifiée est une année bissextile.

IsLeapYear(Int32)

Détermine si l’année spécifiée dans l’ère actuelle est une année bissextile.

(Hérité de Calendar)
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)

Retourne une DateTime valeur définie sur la date et l’heure spécifiées dans l’ère spécifiée.

ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)

Retourne une DateTime valeur définie sur la date et l’heure spécifiées dans l’ère actuelle.

(Hérité de Calendar)
ToFourDigitYear(Int32)

Convertit l’année spécifiée en année à quatre chiffres à l’aide de la TwoDigitYearMax propriété pour déterminer le siècle approprié.

ToString()

Retourne une chaîne qui représente l’objet actuel.

(Hérité de Object)

S’applique à

Voir aussi