JapaneseCalendar Classe

Référence

Définition

Espace de noms:: System.Globalization

Assemblys:: mscorlib.dll, System.Globalization.Calendars.dll

Assembly:: System.Runtime.dll

Assembly:: System.Globalization.Calendars.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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: Object

Calendar
JapaneseCalendar

Attributs: SerializableAttribute ComVisibleAttribute

Remarques

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

Notes

Pour plus d’informations sur l’utilisation de la JapaneseCalendar classe et des 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, à compter de 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 au lieu de « 1 » dans la chaîne de résultat.

Important

Les ères des calendriers japonais sont basées sur le règne de l’empereur et sont donc amenées à changer. Par exemple, le 1 mai 2019 a marqué le début de l’ère Reiwa dans 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 Windows systèmes afin de garantir leur préparation au changement d’ère, consultez préparer votre application pour la modification de l’ère japonaise. Pour les fonctionnalités de .NET qui prennent en charge les calendriers avec plusieurs ères et pour les meilleures pratiques lorsque vous travaillez avec des 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ésenter
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)	8 septembre 1868 au 29 juillet 1912

Cette classe gère les dates du 8 septembre dans l’année Meiji 1 (dans le calendrier grégorien, 8 septembre 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 du 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 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	Month	Anglais	Jours dans les années courantes	Jours dans les années bissextiles
1	1月 (Ichigatsu)	Janvier	31	31
2	2月 (Nigatsu)	February	28	29
3	3月 (Sangatsu)	Mars	31	31
4	4月 (Shigatsu)	avril	30	30
5	5月 (Gogatsu)	Mai	31	31
6	6月 (スgatsu)	June	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 bisses et 28 pendant les années courantes.

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

Si c’est JapaneseCalendar le calendrier actuel de la culture japonaise, DateTime.Parse reconnaît les abréviations de l’ère devant l’année. L’abréviation est soit l’abréviation de l’alphabet latin insensible à un caractère unique, soit 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

JapaneseCalendar()

Initialise une nouvelle instance de la classe JapaneseCalendar.

Champs

CurrentEra

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

(Hérité de Calendar)

Propriétés

AlgorithmType	Obtient une valeur qui indique si le calendrier actuel est solaire, lunaire, ou une combinaison des deux.
AlgorithmType	Obtient une valeur qui indique si le calendrier actuel est solaire, lunaire, ou une combinaison des deux. (Hérité de Calendar)
DaysInYearBeforeMinSupportedYear	Obtient le nombre de jours dans l’année qui précède l’année spécifiée par la propriété MinSupportedDateTime. (Hérité de Calendar)
Eras	Obtient la liste des ères dans JapaneseCalendar.
IsReadOnly	Obtient une valeur qui indique si cet objet Calendar est en lecture seule. (Hérité de Calendar)
MaxSupportedDateTime	Obtient les dernières date et heure prises en charge par l’objet JapaneseCalendar actuel.
MaxSupportedDateTime	Obtient les dernières date et heure prises en charge par cet objet Calendar. (Hérité de Calendar)
MinSupportedDateTime	Obtient les premières date et heure prises en charge par l’objet JapaneseCalendar actuel.
MinSupportedDateTime	Obtient les premières date et heure prises en charge par cet objet Calendar. (Hérité de Calendar)
TwoDigitYearMax	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.

Méthodes

AddDays(DateTime, Int32)	Retourne un DateTime qui est le nombre de jours spécifié jusqu’au DateTime spécifié. (Hérité de Calendar)
AddHours(DateTime, Int32)	Retourne un DateTime qui représente le nombre d’heures jusqu’au DateTime spécifié. (Hérité de Calendar)
AddMilliseconds(DateTime, Double)	Retourne un DateTime qui correspond au nombre de millisecondes spécifié jusqu’au DateTime spécifié. (Hérité de Calendar)
AddMinutes(DateTime, Int32)	Retourne un DateTime qui correspond au nombre de minutes jusqu’au DateTime spécifié. (Hérité de Calendar)
AddMonths(DateTime, Int32)	Retourne un DateTime qui est le nombre de mois spécifié jusqu’au DateTime spécifié.
AddSeconds(DateTime, Int32)	Retourne un DateTime qui correspond au nombre de secondes spécifié jusqu’au DateTime spécifié. (Hérité de Calendar)
AddWeeks(DateTime, Int32)	Retourne un DateTime qui correspond au nombre de semaines spécifié jusqu’au DateTime spécifié. (Hérité de Calendar)
AddYears(DateTime, Int32)	Retourne un DateTime qui est le nombre d’années spécifié jusqu’au DateTime spécifié.
Clone()	Crée un objet qui est une copie de l’objet Calendaractuel. (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 du DateTime spécifié.
GetDayOfWeek(DateTime)	Retourne le jour de la semaine du DateTime spécifié.
GetDayOfYear(DateTime)	Retourne le jour de l’année dans le DateTime spécifié.
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)
GetDaysInMonth(Int32, Int32, Int32)	Retourne le nombre de jours dans le mois spécifié de l’année spécifiée de l’ère spécifiée.
GetDaysInYear(Int32)	Retourne le nombre de jours de l’année spécifiée de l’ère actuelle. (Hérité de Calendar)
GetDaysInYear(Int32, Int32)	Retourne le nombre de jours dans l’année spécifiée de l’ère spécifiée.
GetEra(DateTime)	Retourne l’ère du DateTime spécifié.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetHour(DateTime)	Retourne l’heure du DateTime spécifié. (Hérité de Calendar)
GetLeapMonth(Int32)	Calcule le mois d’une année bissextile d’une spécifiée. (Hérité de Calendar)
GetLeapMonth(Int32, Int32)	Calcule le mois d’une année bissextile d’une année et d’une ère spécifiées.
GetLeapMonth(Int32, Int32)	Calcule le mois d’une année bissextile d’une année et d’une ère spécifiées. (Hérité de Calendar)
GetMilliseconds(DateTime)	Retourne la valeur en millisecondes du DateTime spécifié. (Hérité de Calendar)
GetMinute(DateTime)	Retourne les minutes du DateTime spécifié. (Hérité de Calendar)
GetMonth(DateTime)	Retourne le mois du DateTime spécifié.
GetMonthsInYear(Int32)	Retourne le nombre de mois de l’année spécifiée dans l’ère actuelle. (Hérité de Calendar)
GetMonthsInYear(Int32, Int32)	Retourne le nombre de mois dans l’année spécifiée de l’ère spécifiée.
GetSecond(DateTime)	Retourne les secondes du DateTime spécifié. (Hérité de Calendar)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek)	Retourne la semaine de l’année qui contient la date du DateTime spécifié.
GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek)	Retourne la semaine de l’année qui contient la date de la valeur DateTime spécifiée. (Hérité de Calendar)
GetYear(DateTime)	Retourne l’année dans le DateTime spécifié.
IsLeapDay(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)
IsLeapDay(Int32, Int32, Int32, Int32)	Détermine si la date spécifiée de l’ère spécifiée est un jour bissextile.
IsLeapMonth(Int32, Int32)	Détermine si le mois spécifié de l’année spécifiée dans l’ère en cours est un mois bissextile. (Hérité de Calendar)
IsLeapMonth(Int32, Int32, Int32)	Détermine si le mois spécifié dans l’année spécifiée de l’ère spécifiée est un mois 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)
IsLeapYear(Int32, Int32)	Détermine si l'année spécifiée de l'ère spécifiée est une année bissextile.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)	Retourne un DateTime correspondant à la date et à l’heure spécifiées pour l’ère actuelle. (Hérité de Calendar)
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)	Retourne un DateTime auquel sont affectées la date et l’heure spécifiées dans l’ère spécifiée.
ToFourDigitYear(Int32)	Convertit l’année spécifiée en une année à quatre chiffres en utilisant la propriété TwoDigitYearMax pour déterminer le siècle approprié.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

S’applique à