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, которые поддерживают несколько эпох на основе правления императора, вызов этого метода может привести к непреднамереемой дате при смене эпохи. При создании экземпляра даты с помощью любого из этих календарей рекомендуется вызвать JapaneseCalendar.ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32) метод или JapaneseLunisolarCalendar.ToDateTime(Int32,Int32,Int32,Int32,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 массива свойств, который является значением текущей эпохи календаря.

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

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