JapaneseCalendar Classe
Définition
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::Calendarpublic 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.Calendartype JapaneseCalendar = class
inherit Calendar[<System.Serializable>]
type JapaneseCalendar = class
inherit Calendar[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type JapaneseCalendar = class
inherit CalendarPublic Class JapaneseCalendar
Inherits Calendar- Héritage
- Attributs
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’époque 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 époque pour le règne de chaque empereur. Les deux ères les plus récentes sont l’ère Heisei, à partir de l’année calendaire grégorienne 1989, et l’ère Reiwa, à partir de l’année 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 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 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 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 connaître les fonctionnalités de .NET qui prennent en charge les calendriers avec plusieurs ères et pour connaître 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 era | Dates grégoriennes |
|---|---|---|---|
| 5 | 令和 (Reiwa) | 令和 (R, r) | Du 1er mai 2019 à aujourd’hui |
| 4 | 平成 (Heisei) | 平 (H, h) | 8 janvier 1989 au 30 avril 2019 |
| 3 | 昭和 (Showa) | 昭 (S, s) | Du 25 décembre 1926 au 7 janvier 1989 |
| 2 | ス正 (Taisho) | Leur (T, t) | Du 30 juillet 1912 au 24 décembre 1926 |
| 1 | 明治 (Meiji) | 明 (M, m) | Du 8 septembre 1868 au 29 juillet 1912 |
Cette classe gère les dates du 8 septembre de 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 sur le calendrier solaire uniquement.
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 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 communes | 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月 (Rokugatsu) | 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 est équivalent au mois calendaire grégorien de février, a 29 jours pendant les années bissextiles et 28 pendant les années communes.
La date du 1er janvier 2001 dans le calendrier grégorien équivaut au premier jour d’Ichigatsu de l’année Heisei 13 dans le calendrier japonais.
Si 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 l’abréviation de l’alphabet latin à caractère unique qui ne respecte pas la casse 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 pour la culture, et la OptionalCalendars propriété renvoie un tableau contenant tous les calendriers pris en charge par la culture. Pour modifier le calendrier utilisé par un CultureInfo, définissez la propriété sur DateTimeFormatInfo.Calendar 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) |
