Calendar.ToDateTime Метод

Определение

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

System.Globalization

Сборка:

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) метод или JapaneseLunisolarCalendar.ToDateTime(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)