Calendar.ToDateTime Метод

Определение

При переопределении в производном классе возвращает DateTime со указанным значением даты и времени.

Перегрузки

ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)

Возвращает DateTime с заданными значениями даты и времени текущей эры.

ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)

При переопределении в производном классе возвращает DateTime со значением даты и времени в заданной эре.

ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)

Возвращает DateTime с заданными значениями даты и времени текущей эры.

public:
 virtual DateTime ToDateTime(int year, int month, int day, int hour, int minute, int second, int millisecond);
public virtual DateTime ToDateTime (int year, int month, int day, int hour, int minute, int second, int millisecond);
abstract member ToDateTime : int * int * int * int * int * int * int -> DateTime
override this.ToDateTime : int * int * int * int * int * int * int -> DateTime
Public Overridable Function ToDateTime (year As Integer, month As Integer, day As Integer, hour As Integer, minute As Integer, second As Integer, millisecond As Integer) As DateTime

Параметры

year
Int32

Целое число, представляющее год.

month
Int32

Положительное целое число, представляющее месяц.

day
Int32

Положительное целое число, представляющее день.

hour
Int32

Целое число от 0 до 23, представляющее час.

minute
Int32

Целое число от 0 до 59, представляющее минуту.

second
Int32

Целое число от 0 до 59, представляющее секунду.

millisecond
Int32

Целое число от 0 до 999, представляющее миллисекунду.

Возвращаемое значение

DateTime

Объект DateTime с заданными значениями даты и времени в текущей эре.

Исключения

Значение параметра year находится вне диапазона, поддерживаемого календарем.

-или- Значение параметра month находится вне диапазона, поддерживаемого календарем.

-или- Значение параметра day находится вне диапазона, поддерживаемого календарем.

-или- Параметр hour меньше нуля или больше 23.

-или- Параметр minute меньше нуля или больше 59.

-или- Параметр second меньше нуля или больше 59.

-или- Параметр millisecond меньше нуля или больше 999.

Комментарии

Этот метод возвращает дату и время, основанные на текущей эре конкретного календаря. Для JapaneseCalendar и JapaneseLunisolarCalendar , которая поддерживает несколько эр на основе Reign императора, вызов этого метода может привести к непреднамеренной дате при изменении эры. При создании экземпляра даты с помощью любого из этих календарей рекомендуется вызывать JapaneseCalendar.ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32) метод или Жапанеселунисоларкалендар. ToDateTime (Int32, Int32 , Int32, Int32) и явно указывать эру.

См. также раздел

Применяется к

ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)

При переопределении в производном классе возвращает DateTime со значением даты и времени в заданной эре.

public:
 abstract DateTime ToDateTime(int year, int month, int day, int hour, int minute, int second, int millisecond, int era);
public abstract DateTime ToDateTime (int year, int month, int day, int hour, int minute, int second, int millisecond, int era);
abstract member ToDateTime : int * int * int * int * int * int * int * int -> DateTime
Public MustOverride 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

Параметры

year
Int32

Целое число, представляющее год.

month
Int32

Положительное целое число, представляющее месяц.

day
Int32

Положительное целое число, представляющее день.

hour
Int32

Целое число от 0 до 23, представляющее час.

minute
Int32

Целое число от 0 до 59, представляющее минуту.

second
Int32

Целое число от 0 до 59, представляющее секунду.

millisecond
Int32

Целое число от 0 до 999, представляющее миллисекунду.

era
Int32

Целое число, представляющее эру.

Возвращаемое значение

DateTime

Объект DateTime с заданными значениями даты и времени в текущей эре.

Исключения

Значение параметра year находится вне диапазона, поддерживаемого календарем.

-или- Значение параметра month находится вне диапазона, поддерживаемого календарем.

-или- Значение параметра day находится вне диапазона, поддерживаемого календарем.

-или- Параметр hour меньше нуля или больше 23.

-или- Параметр minute меньше нуля или больше 59.

-или- Параметр second меньше нуля или больше 59.

-или- Параметр millisecond меньше нуля или больше 999.

-или- Значение параметра era находится вне диапазона, поддерживаемого календарем.

Комментарии

ToDateTimeМетод полезен, поскольку он может преобразовать любую дату в текущем календаре в дату григорианского календаря. Дату григорианского календаря впоследствии можно использовать, например, для сравнения дат в разных календарях или создания эквивалентной даты в определенном календаре.

Примечания для тех, кто реализует этот метод

Производный класс должен поддерживать CurrentEra , когда он передается в качестве era параметра. Один из способов поддержки CurrentEra заключается в замене его значением, хранящимся в первом элементе Eras массива свойств, который является значением для текущей эры календаря.

См. также раздел

Применяется к