Calendar.ToDateTime Метод

Определение

Пространство имен:

System.Globalization

Сборки:

netstandard.dll, System.Runtime.dll

При переопределении в производном классе возвращает 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)

Исходный код:

Calendar.cs

Возвращает значение указанной 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 параметра задана указанная дата и время в текущей эре.

Исключения

ArgumentOutOfRangeException

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

–или–

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

–или–

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

–или–

hour меньше нуля или больше 23.

–или–

minute меньше нуля или больше 59.

–или–

second меньше нуля или больше 59.

–или–

millisecond меньше нуля или больше 999.

Комментарии

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

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

• DateTime
• GetMonthsInYear(Int32)
• GetDaysInMonth(Int32, Int32)

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

Исходный код:

Calendar.cs

При переопределении в производном классе возвращает 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 параметра задана указанная дата и время в текущей эре.

Исключения

ArgumentOutOfRangeException

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

–или–

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

–или–

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

–или–

hour меньше нуля или больше 23.

–или–

minute меньше нуля или больше 59.

–или–

second меньше нуля или больше 59.

–или–

millisecond меньше нуля или больше 999.

–или–

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

Комментарии

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

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

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

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

• DateTime
• CurrentEra
• Eras
• GetMonthsInYear(Int32)
• GetDaysInMonth(Int32, Int32)