JapaneseCalendar Classe

Riferimento

Definizione

Spazio dei nomi:: System.Globalization

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

Assembly:: System.Runtime.dll

Assembly:: System.Globalization.Calendars.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

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

Ereditarietà: Object

Calendar
JapaneseCalendar

Attributi: SerializableAttribute ComVisibleAttribute

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 era come segue:

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 di 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)

Si applica a