• Article

JapaneseCalendar.ToDateTime Method (Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Returns a DateTime that is set to the specified date and time in the specified era.

Namespace:  System.Globalization
Assembly:  mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Overrides Function ToDateTime ( _
    year As Integer, _
    month As Integer, _
    day As Integer, _
    hour As Integer, _
    minute As Integer, _
    second As Integer, _
    millisecond As Integer, _
    era As Integer _
) As DateTime

public override DateTime ToDateTime(
    int year,
    int month,
    int day,
    int hour,
    int minute,
    int second,
    int millisecond,
    int era
)

Parameters

  • year
    Type: System.Int32
    An integer that represents the year.
  • month
    Type: System.Int32
    An integer from 1 to 12 that represents the month.
  • day
    Type: System.Int32
    An integer from 1 to 31 that represents the day.
  • hour
    Type: System.Int32
    An integer from 0 to 23 that represents the hour.
  • minute
    Type: System.Int32
    An integer from 0 to 59 that represents the minute.
  • second
    Type: System.Int32
    An integer from 0 to 59 that represents the second.
  • millisecond
    Type: System.Int32
    An integer from 0 to 999 that represents the millisecond.
  • era
    Type: System.Int32
    An integer that represents the era.

Return Value

Type: System.DateTime
The DateTime that is set to the specified date and time in the current era.

Exceptions

Exception Condition
ArgumentOutOfRangeException

year is outside the range supported by the calendar.

-or-

month is outside the range supported by the calendar.

-or-

day is outside the range supported by the calendar.

-or-

hour is less than zero or greater than 23.

-or-

minute is less than zero or greater than 59.

-or-

second is less than zero or greater than 59.

-or-

millisecond is less than zero or greater than 999.

-or-

era is outside the range supported by the calendar.

Remarks

The ToDateTime method is useful because it can convert any date in the current calendar to a Gregorian calendar date. The Gregorian date can subsequently be used, for example, to compare dates in different calendars or create an equivalent date in a particular calendar.

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.