Early Preview
This is currently very much a preview. Please feel free to try things out,
but don't be upset if anything is not yet working. Feedback is welcome over on our
GitHub Dicussions page.
class System.​Globalization.​JapaneseCalendar
Assembly: System.Runtime
Inheritance: object → Calendar → JapaneseCalendar
Represents the Japanese calendar.
Properties
public
CalendarAlgorithmType
AlgorithmType
Gets a value that indicates whether the current calendar is solar-based, lunar-based, or a combination of both.
public
int[]
Eras
Gets the list of eras in the <see cref="T:System.Globalization.JapaneseCalendar" /> .
public
DateTime
MaxSupportedDateTime
Gets the latest date and time supported by the current <see cref="T:System.Globalization.JapaneseCalendar" /> object.
public
DateTime
MinSupportedDateTime
Gets the earliest date and time supported by the current <see cref="T:System.Globalization.JapaneseCalendar" /> object.
public
int
TwoDigitYearMax
Gets or sets the last year of a 100-year range that can be represented by a 2-digit year.
protected
int
DaysInYearBeforeMinSupportedYear
Gets the number of days in the year that precedes the year that is specified by the <see cref="P:System.Globalization.Calendar.MinSupportedDateTime" /> property.
public
bool
IsReadOnly
Gets a value indicating whether this <see cref="T:System.Globalization.Calendar" /> object is read-only.
Methods
public
DateTime
AddMonths​(DateTime time,
int months)
time
The <see cref="T:System.DateTime" /> to which to add months.
months
The number of months to add.
Returns The <see cref="T:System.DateTime" /> that results from adding the specified number of months to the specified <see cref="T:System.DateTime" /> .
Returns a <see cref="T:System.DateTime" /> that is the specified number of months away from the specified <see cref="T:System.DateTime" /> .
public
DateTime
AddYears​(DateTime time,
int years)
time
The <see cref="T:System.DateTime" /> to which to add years.
years
The number of years to add.
Returns The <see cref="T:System.DateTime" /> that results from adding the specified number of years to the specified <see cref="T:System.DateTime" /> .
Returns a <see cref="T:System.DateTime" /> that is the specified number of years away from the specified <see cref="T:System.DateTime" /> .
public
int
GetDayOfMonth​(DateTime time)
time
The <see cref="T:System.DateTime" /> to read.
Returns An integer from 1 to 31 that represents the day of the month in the specified <see cref="T:System.DateTime" /> .
Returns the day of the month in the specified <see cref="T:System.DateTime" /> .
public
DayOfWeek
GetDayOfWeek​(DateTime time)
time
The <see cref="T:System.DateTime" /> to read.
Returns A <see cref="T:System.DayOfWeek" /> value that represents the day of the week in the specified <see cref="T:System.DateTime" /> .
Returns the day of the week in the specified <see cref="T:System.DateTime" /> .
public
int
GetDayOfYear​(DateTime time)
time
The <see cref="T:System.DateTime" /> to read.
Returns An integer from 1 to 366 that represents the day of the year in the specified <see cref="T:System.DateTime" /> .
Returns the day of the year in the specified <see cref="T:System.DateTime" /> .
public
int
GetDaysInMonth​(int year,
int month,
int era)
year
An integer that represents the year.
month
An integer from 1 to 12 that represents the month.
era
An integer that represents the era.
Returns The number of days in the specified month in the specified year in the specified era.
Returns the number of days in the specified month in the specified year in the specified era.
public
int
GetDaysInYear​(int year,
int era)
year
An integer that represents the year.
era
An integer that represents the era.
Returns The number of days in the specified year in the specified era.
Returns the number of days in the specified year in the specified era.
public
int
GetEra​(DateTime time)
time
The <see cref="T:System.DateTime" /> to read.
Returns An integer that represents the era in the specified <see cref="T:System.DateTime" /> .
Returns the era in the specified <see cref="T:System.DateTime" /> .
public
int
GetLeapMonth​(int year,
int era)
year
A year.
era
An era.
Returns The return value is always 0 because the <see cref="T:System.Globalization.JapaneseCalendar" /> type does not support the notion of a leap month.
Calculates the leap month for a specified year and era.
public
int
GetMonth​(DateTime time)
time
The <see cref="T:System.DateTime" /> to read.
Returns An integer from 1 to 12 that represents the month in the specified <see cref="T:System.DateTime" /> .
Returns the month in the specified <see cref="T:System.DateTime" /> .
public
int
GetMonthsInYear​(int year,
int era)
year
An integer that represents the year.
era
An integer that represents the era.
Returns The return value is always 12.
Returns the number of months in the specified year in the specified era.
public
int
GetWeekOfYear​(DateTime time,
CalendarWeekRule rule,
DayOfWeek firstDayOfWeek)
time
The <see cref="T:System.DateTime" /> to read.
rule
One of the <see cref="T:System.Globalization.CalendarWeekRule" /> values that defines a calendar week.
firstDayOfWeek
One of the <see cref="T:System.DayOfWeek" /> values that represents the first day of the week.
Returns A 1-based integer that represents the week of the year that includes the date in the <paramref name="time" /> parameter.
Returns the week of the year that includes the date in the specified <see cref="T:System.DateTime" /> .
public
int
GetYear​(DateTime time)
time
The <see cref="T:System.DateTime" /> to read.
Returns An integer that represents the year in the specified <see cref="T:System.DateTime" /> .
Returns the year in the specified <see cref="T:System.DateTime" /> .
public
bool
IsLeapDay​(int year,
int month,
int day,
int era)
year
An integer that represents the year.
month
An integer from 1 to 12 that represents the month.
day
An integer from 1 to 31 that represents the day.
era
An integer that represents the era.
Returns <see langword="true" /> , if the specified day is a leap day; otherwise, <see langword="false" /> .
Determines whether the specified date in the specified era is a leap day.
public
bool
IsLeapMonth​(int year,
int month,
int era)
year
An integer that represents the year.
month
An integer from 1 to 12 that represents the month.
era
An integer that represents the era.
Returns This method always returns <see langword="false" /> , unless overridden by a derived class.
Determines whether the specified month in the specified year in the specified era is a leap month.
public
bool
IsLeapYear​(int year,
int era)
year
An integer that represents the year.
era
An integer that represents the era.
Returns <see langword="true" /> , if the specified year is a leap year; otherwise, <see langword="false" /> .
Determines whether the specified year in the specified era is a leap year.
public
DateTime
ToDateTime​(int year,
int month,
int day,
int hour,
int minute,
int second,
int millisecond,
int era)
year
An integer that represents the year.
month
An integer from 1 to 12 that represents the month.
day
An integer from 1 to 31 that represents the day.
hour
An integer from 0 to 23 that represents the hour.
minute
An integer from 0 to 59 that represents the minute.
second
An integer from 0 to 59 that represents the second.
millisecond
An integer from 0 to 999 that represents the millisecond.
era
An integer that represents the era.
Returns The <see cref="T:System.DateTime" /> that is set to the specified date and time in the current era.
Returns a <see cref="T:System.DateTime" /> that is set to the specified date and time in the specified era.
public
int
ToFourDigitYear​(int year)
year
An integer (usually two digits) that represents the year to convert.
Returns An integer that contains the four-digit representation of <paramref name="year" /> .
Converts the specified year to a four-digit year by using the <see cref="P:System.Globalization.JapaneseCalendar.TwoDigitYearMax" /> property to determine the appropriate century.
public
DateTime
AddDays​(DateTime time,
int days)
Inherited from Calendar
time
The <see cref="T:System.DateTime" /> to which to add days.
days
The number of days to add.
Returns The <see cref="T:System.DateTime" /> that results from adding the specified number of days to the specified <see cref="T:System.DateTime" /> .
Returns a <see cref="T:System.DateTime" /> that is the specified number of days away from the specified <see cref="T:System.DateTime" /> .
public
DateTime
AddHours​(DateTime time,
int hours)
Inherited from Calendar
time
The <see cref="T:System.DateTime" /> to which to add hours.
hours
The number of hours to add.
Returns The <see cref="T:System.DateTime" /> that results from adding the specified number of hours to the specified <see cref="T:System.DateTime" /> .
Returns a <see cref="T:System.DateTime" /> that is the specified number of hours away from the specified <see cref="T:System.DateTime" /> .
public
DateTime
AddMilliseconds​(DateTime time,
double milliseconds)
Inherited from Calendar
time
The <see cref="T:System.DateTime" /> to add milliseconds to.
milliseconds
The number of milliseconds to add.
Returns The <see cref="T:System.DateTime" /> that results from adding the specified number of milliseconds to the specified <see cref="T:System.DateTime" /> .
Returns a <see cref="T:System.DateTime" /> that is the specified number of milliseconds away from the specified <see cref="T:System.DateTime" /> .
public
DateTime
AddMinutes​(DateTime time,
int minutes)
Inherited from Calendar
time
The <see cref="T:System.DateTime" /> to which to add minutes.
minutes
The number of minutes to add.
Returns The <see cref="T:System.DateTime" /> that results from adding the specified number of minutes to the specified <see cref="T:System.DateTime" /> .
Returns a <see cref="T:System.DateTime" /> that is the specified number of minutes away from the specified <see cref="T:System.DateTime" /> .
public
DateTime
AddSeconds​(DateTime time,
int seconds)
Inherited from Calendar
time
The <see cref="T:System.DateTime" /> to which to add seconds.
seconds
The number of seconds to add.
Returns The <see cref="T:System.DateTime" /> that results from adding the specified number of seconds to the specified <see cref="T:System.DateTime" /> .
Returns a <see cref="T:System.DateTime" /> that is the specified number of seconds away from the specified <see cref="T:System.DateTime" /> .
public
DateTime
AddWeeks​(DateTime time,
int weeks)
Inherited from Calendar
time
The <see cref="T:System.DateTime" /> to which to add weeks.
weeks
The number of weeks to add.
Returns The <see cref="T:System.DateTime" /> that results from adding the specified number of weeks to the specified <see cref="T:System.DateTime" /> .
Returns a <see cref="T:System.DateTime" /> that is the specified number of weeks away from the specified <see cref="T:System.DateTime" /> .
public
object
Clone​()
Inherited from Calendar
Returns A new instance of <see cref="T:System.Object" /> that is the memberwise clone of the current <see cref="T:System.Globalization.Calendar" /> object.
Creates a new object that is a copy of the current <see cref="T:System.Globalization.Calendar" /> object.
public
int
GetDaysInMonth​(int year,
int month)
Inherited from Calendar
year
An integer that represents the year.
month
A positive integer that represents the month.
Returns The number of days in the specified month in the specified year in the current era.
Returns the number of days in the specified month and year of the current era.
public
int
GetDaysInYear​(int year)
Inherited from Calendar
year
An integer that represents the year.
Returns The number of days in the specified year in the current era.
Returns the number of days in the specified year of the current era.
public
int
GetHour​(DateTime time)
Inherited from Calendar
time
The <see cref="T:System.DateTime" /> to read.
Returns An integer from 0 to 23 that represents the hour in <paramref name="time" /> .
Returns the hours value in the specified <see cref="T:System.DateTime" /> .
public
int
GetLeapMonth​(int year)
Inherited from Calendar
year
A year.
Returns A positive integer that indicates the leap month in the specified year.
-or-
Zero if this calendar does not support a leap month or if the <paramref name="year" /> parameter does not represent a leap year.
Calculates the leap month for a specified year.
public
double
GetMilliseconds​(DateTime time)
Inherited from Calendar
time
The <see cref="T:System.DateTime" /> to read.
Returns A double-precision floating-point number from 0 to 999 that represents the milliseconds in the <paramref name="time" /> parameter.
Returns the milliseconds value in the specified <see cref="T:System.DateTime" /> .
public
int
GetMinute​(DateTime time)
Inherited from Calendar
time
The <see cref="T:System.DateTime" /> to read.
Returns An integer from 0 to 59 that represents the minutes in <paramref name="time" /> .
Returns the minutes value in the specified <see cref="T:System.DateTime" /> .
public
int
GetMonthsInYear​(int year)
Inherited from Calendar
year
An integer that represents the year.
Returns The number of months in the specified year in the current era.
Returns the number of months in the specified year in the current era.
public
int
GetSecond​(DateTime time)
Inherited from Calendar
time
The <see cref="T:System.DateTime" /> to read.
Returns An integer from 0 to 59 that represents the seconds in <paramref name="time" /> .
Returns the seconds value in the specified <see cref="T:System.DateTime" /> .
public
bool
IsLeapDay​(int year,
int month,
int day)
Inherited from Calendar
year
An integer that represents the year.
month
A positive integer that represents the month.
day
A positive integer that represents the day.
Returns <see langword="true" /> if the specified day is a leap day; otherwise, <see langword="false" /> .
Determines whether the specified date in the current era is a leap day.
public
bool
IsLeapMonth​(int year,
int month)
Inherited from Calendar
year
An integer that represents the year.
month
A positive integer that represents the month.
Returns <see langword="true" /> if the specified month is a leap month; otherwise, <see langword="false" /> .
Determines whether the specified month in the specified year in the current era is a leap month.
public
bool
IsLeapYear​(int year)
Inherited from Calendar
year
An integer that represents the year.
Returns <see langword="true" /> if the specified year is a leap year; otherwise, <see langword="false" /> .
Determines whether the specified year in the current era is a leap year.
public
DateTime
ToDateTime​(int year,
int month,
int day,
int hour,
int minute,
int second,
int millisecond)
Inherited from Calendar
year
An integer that represents the year.
month
A positive integer that represents the month.
day
A positive integer that represents the day.
hour
An integer from 0 to 23 that represents the hour.
minute
An integer from 0 to 59 that represents the minute.
second
An integer from 0 to 59 that represents the second.
millisecond
An integer from 0 to 999 that represents the millisecond.
Returns The <see cref="T:System.DateTime" /> that is set to the specified date and time in the current era.
Returns a <see cref="T:System.DateTime" /> that is set to the specified date and time in the current era.
public
bool
Equals​(object obj)
Inherited from object
obj
The object to compare with the current object.
Returns <see langword="true" /> if the specified object is equal to the current object; otherwise, <see langword="false" /> .
Determines whether the specified object is equal to the current object.
protected
void
Finalize​()
Inherited from object
Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.
public
int
GetHashCode​()
Inherited from object
Returns A hash code for the current object.
Serves as the default hash function.
public
Type
GetType​()
Inherited from object
Returns The exact runtime type of the current instance.
Gets the <see cref="T:System.Type" /> of the current instance.
protected
object
MemberwiseClone​()
Inherited from object
Returns A shallow copy of the current <see cref="T:System.Object" /> .
Creates a shallow copy of the current <see cref="T:System.Object" /> .
public
string
ToString​()
Inherited from object
Returns A string that represents the current object.
Returns a string that represents the current object.