JapaneseCalendar Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rappresenta il calendario giapponese.
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- Ereditarietà
- Attributi
Commenti
Il calendario giapponese, noto anche come calendario Wareki, funziona esattamente come il calendario gregoriano, ad eccezione del fatto che l'anno e l'era sono diversi.
Nota
Per informazioni sull'uso della JapaneseCalendar classe e delle altre classi di calendario in .NET, vedere Uso dei calendari.
Il calendario giapponese riconosce un'era per ogni regno dell'imperatore. Le due epoche più recenti sono l'era Heisei, a partire dall'anno del calendario gregoriano 1989, e l'era Reiwa, a partire dall'anno di calendario gregoriano 2019. Il nome dell'era viene in genere visualizzato prima dell'anno. Ad esempio, l'anno di calendario gregoriano 2001 è l'anno di calendario giapponese Heisei 13. Si noti che il primo anno di un'era è chiamato "Gannen". Pertanto, l'anno del calendario gregoriano 1989 era l'anno del calendario giapponese Heisei Gannen. Per impostazione predefinita, le operazioni di formattazione con stringhe di formato data e ora specificate, ad esempio "D", "F" e "Y", output Gannen anziché "1" nella stringa di risultato.
Importante
Le ere nel calendario giapponese sono basate sul regno dell'imperatore e pertanto è previsto che cambino. Ad esempio, il 1° maggio 2019 contraddistingue l'inizio dell'era Reiwa in JapaneseCalendar e JapaneseLunisolarCalendar. Questo cambio di era interessa tutte le applicazioni che usano questi calendari. Per altre informazioni e per determinare se le applicazioni sono interessate, vedere Gestione di una nuova era nel calendario giapponese in .NET. Per informazioni sui test delle applicazioni nei sistemi Windows per garantire la loro idoneità per la modifica dell'era, vedere Preparare l'applicazione per la modifica dell'era giapponese. Per le funzionalità di .NET che supportano calendari con più era e per le procedure consigliate quando si usano calendari che supportano più epoche, vedere Uso delle era.
Questa classe assegna numeri alle epoche come indicato di seguito:
| Valore GetEra | Nome dell'era | Abbreviazione dell'era | Date gregoriane |
|---|---|---|---|
| 5 | 令和 (Reiwa) | 令和 (R, r) | 1 maggio 2019 da presentare |
| 4 | 平成 (Heisei) | 平 (H, h) | 8 gennaio 1989 al 30 aprile 2019 |
| 3 | 昭和 (Showa) | 昭 (S, s) | 25 dicembre 1926- 7 gennaio 1989 |
| 2 | 正 (Taisho) | 大 (T, t) | 30 luglio 1912- 24 dicembre 1926 |
| 1 | 明治 (Meiji) | 明 (M, m) | 8 settembre 1868 a luglio 29, 1912 |
Questa classe gestisce le date del 8 settembre nell'anno Meiji 1 (nel calendario gregoriano, 8 settembre 1868). Anche se il calendario giapponese è stato spostato da un calendario lunare a un calendario solare nell'anno Meiji 6 (1873 del calendario gregoriano), questa implementazione si basa solo sul calendario solare.
Gli anni salti nel calendario giapponese corrispondono agli stessi anni del calendario gregoriano. Un anno bisestile nel calendario gregoriano è definito come anno gregoriano che è uniformemente divisibile da quattro, tranne se è divisibile da 100. Tuttavia, gli anni gregoriani che sono divisibili per 400 sono anni saltati. Un anno comune ha 365 giorni e un anno bisestile ha 366 giorni.
Il calendario giapponese ha 12 mesi con 28-31 giorni ogni:
| Valore GetMonth | Month | Inglese | Giorni in anni comuni | Giorni in anni salti |
|---|---|---|---|---|
| 1 | 1月 (Ichigatsu) | January | 31 | 31 |
| 2 | 2月 (Nigatsu) | Febbraio | 28 | 29 |
| 3 | 3月 (Sangatsu) | Marzo | 31 | 31 |
| 4 | 4月 (Shigatsu) | April | 30 | 30 |
| 5 | 5月 (Gogatsu) | Mag | 31 | 31 |
| 6 | 6月 (Rokugatsu) | Giugno | 30 | 30 |
| 7 | 7月 (Shichigatsu) | Luglio | 31 | 31 |
| 8 | 8月 (Hachigatsu) | Agosto | 31 | 31 |
| 9 | 9月 (Kugatsu) | Settembre | 30 | 30 |
| 10 | 10月 (Juugatsu) | Ottobre | 31 | 31 |
| 11 | 11月 (Juuichigatsu) | Novembre | 30 | 30 |
| 12 | 12月 (Juunigatsu) | Dicembre | 31 | 31 |
Nigatsu, equivalente al mese del calendario gregoriano di febbraio, ha 29 giorni durante gli anni di salto e 28 negli anni comuni.
La data 1 gennaio 2001 A.D. nel calendario gregoriano equivale al primo giorno di Ichigatsu nell'anno Heisei 13 nel calendario giapponese.
Se è JapaneseCalendar il calendario corrente della cultura giapponese, DateTime.Parse riconosce le abbreviazioni dell'era davanti all'anno. L'abbreviazione è l'abbreviazione dell'alfabeto latino senza distinzione tra maiuscole e minuscole o l'abbreviazione Kanji a caratteri singoli. DateTime.Parse riconosce anche "1" o Gannen (元年) come primo anno di un'epoca.
Ogni CultureInfo oggetto supporta un set di calendari. La Calendar proprietà restituisce il calendario predefinito per le impostazioni cultura e la OptionalCalendars proprietà restituisce una matrice contenente tutti i calendari supportati dalle impostazioni cultura. Per modificare il calendario usato da un CultureInfooggetto , impostare la DateTimeFormatInfo.Calendar proprietà su un nuovo Calendaroggetto .
Costruttori
| JapaneseCalendar() |
Inizializza una nuova istanza della classe JapaneseCalendar. |
Campi
| CurrentEra |
Rappresenta l'era corrente del calendario corrente. Il valore di questo campo è 0. (Ereditato da Calendar) |
Proprietà
| AlgorithmType |
Ottiene un valore che indica se il calendario corrente è solare, lunare o una combinazione di entrambi (lunisolare). |
| AlgorithmType |
Ottiene un valore che indica se il calendario corrente è solare, lunare o una combinazione di entrambi (lunisolare). (Ereditato da Calendar) |
| DaysInYearBeforeMinSupportedYear |
Ottiene il numero di giorni all'anno che precedono l'anno specificato dalla proprietà MinSupportedDateTime. (Ereditato da Calendar) |
| Eras |
Ottiene l'elenco delle ere in JapaneseCalendar. |
| IsReadOnly |
Ottiene un valore che indica se l'oggetto Calendar è in sola lettura. (Ereditato da Calendar) |
| MaxSupportedDateTime |
Ottiene la data e l'ora più recenti supportate dall'oggetto JapaneseCalendar corrente. |
| MaxSupportedDateTime |
Ottiene la data e l'ora più recenti supportate dall'oggetto Calendar. (Ereditato da Calendar) |
| MinSupportedDateTime |
Ottiene la data e l'ora meno recenti supportate dall'oggetto JapaneseCalendar corrente. |
| MinSupportedDateTime |
Ottiene la data e l'ora meno recenti supportate dall'oggetto Calendar. (Ereditato da Calendar) |
| TwoDigitYearMax |
Ottiene o imposta l'ultimo anno che, nell'intervallo di un secolo, può essere rappresentato da un anno a due cifre. |
Metodi
| AddDays(DateTime, Int32) |
Restituisce un valore DateTime che rappresenta il numero di giorni specificato a partire dal valore DateTime specificato. (Ereditato da Calendar) |
| AddHours(DateTime, Int32) |
Restituisce un valore DateTime che rappresenta il numero di ore specificato a partire dal valore DateTime specificato. (Ereditato da Calendar) |
| AddMilliseconds(DateTime, Double) |
Restituisce un valore DateTime che rappresenta il numero di millisecondi specificato a partire dal valore DateTime specificato. (Ereditato da Calendar) |
| AddMinutes(DateTime, Int32) |
Restituisce un valore DateTime che rappresenta il numero di minuti specificato a partire dal valore DateTime specificato. (Ereditato da Calendar) |
| AddMonths(DateTime, Int32) |
Restituisce un valore DateTime che rappresenta il numero di mesi specificato a partire dal valore DateTime specificato. |
| AddSeconds(DateTime, Int32) |
Restituisce un valore DateTime che rappresenta il numero di secondi specificato a partire dal valore DateTime specificato. (Ereditato da Calendar) |
| AddWeeks(DateTime, Int32) |
Restituisce un valore DateTime che rappresenta il numero di settimane specificato a partire dal valore DateTime specificato. (Ereditato da Calendar) |
| AddYears(DateTime, Int32) |
Restituisce un valore DateTime che rappresenta il numero di anni specificato a partire dal valore DateTime specificato. |
| Clone() |
Crea un nuovo oggetto che rappresenta una copia dell'oggetto Calendar corrente. (Ereditato da Calendar) |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| GetDayOfMonth(DateTime) |
Restituisce il giorno del mese nel valore DateTime specificato. |
| GetDayOfWeek(DateTime) |
Restituisce il giorno della settimana nel valore DateTime specificato. |
| GetDayOfYear(DateTime) |
Restituisce il giorno dell'anno nell'oggetto DateTime specificato. |
| GetDaysInMonth(Int32, Int32) |
Restituisce il numero di giorni nel mese e nell'anno specificati dell'era corrente. (Ereditato da Calendar) |
| GetDaysInMonth(Int32, Int32, Int32) |
Restituisce il numero di giorni nel mese specificato nell'anno specificato dell'era specificata. |
| GetDaysInYear(Int32) |
Restituisce il numero di giorni nell'anno specificato dell'era corrente. (Ereditato da Calendar) |
| GetDaysInYear(Int32, Int32) |
Restituisce il numero di giorni nell'anno specificato dell'era specificata. |
| GetEra(DateTime) |
Restituisce l'era nel valore DateTime specificato. |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetHour(DateTime) |
Restituisce il valore delle ore nel valore DateTime specificato. (Ereditato da Calendar) |
| GetLeapMonth(Int32) |
Calcola il mese intercalare per un anno specificato. (Ereditato da Calendar) |
| GetLeapMonth(Int32, Int32) |
Calcola il mese intercalare per un anno e un'era specificati. |
| GetLeapMonth(Int32, Int32) |
Calcola il mese intercalare per un anno e un'era specificati. (Ereditato da Calendar) |
| GetMilliseconds(DateTime) |
Restituisce il valore dei millisecondi nel valore DateTime specificato. (Ereditato da Calendar) |
| GetMinute(DateTime) |
Restituisce il valore dei minuti nel valore DateTime specificato. (Ereditato da Calendar) |
| GetMonth(DateTime) |
Restituisce il mese nell'oggetto DateTime specificato. |
| GetMonthsInYear(Int32) |
Restituisce il numero di mesi nell'anno specificato dell'era corrente. (Ereditato da Calendar) |
| GetMonthsInYear(Int32, Int32) |
Restituisce il numero di mesi nell'anno specificato dell'era specificata. |
| GetSecond(DateTime) |
Restituisce il valore dei secondi nel valore DateTime specificato. (Ereditato da Calendar) |
| GetType() |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
| GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek) |
Restituisce la settimana dell'anno che comprende la data nel valore DateTime specificato. |
| GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek) |
Restituisce la settimana dell'anno che comprende la data nel valore DateTime specificato. (Ereditato da Calendar) |
| GetYear(DateTime) |
Restituisce l'anno nel valore DateTime specificato. |
| IsLeapDay(Int32, Int32, Int32) |
Determina se la data specificata nell'era corrente è un giorno intercalare. (Ereditato da Calendar) |
| IsLeapDay(Int32, Int32, Int32, Int32) |
Determina se la data specificata nell'era specificata corrisponde a un giorno intercalare. |
| IsLeapMonth(Int32, Int32) |
Determina se il mese specificato nell'anno specificato dell'era corrente è intercalare. (Ereditato da Calendar) |
| IsLeapMonth(Int32, Int32, Int32) |
Determina se il mese specificato nell'anno specificato dell'era specificata è intercalare. |
| IsLeapYear(Int32) |
Determina se l'anno specificato nell'era corrente è bisestile. (Ereditato da Calendar) |
| IsLeapYear(Int32, Int32) |
Determina se l'anno specificato nell'era specificata è bisestile. |
| MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
| ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32) |
Restituisce un valore DateTime impostato sulla data e sull'ora specificate nell'era corrente. (Ereditato da Calendar) |
| ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32) |
Restituisce un valore DateTime impostato sulla data e sull'ora specificate nell'era specificata. |
| ToFourDigitYear(Int32) |
Converte l'anno specificato in un anno a quattro cifre utilizzando la proprietà TwoDigitYearMax per determinare il secolo corretto. |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
