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)
- Исходный код:
- Calendar.cs
- Исходный код:
- Calendar.cs
- Исходный код:
- 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 -> DateTimePublic 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 с заданными значениями даты и времени в текущей эре.
Исключения
Значение параметра 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)
- Исходный код:
- Calendar.cs
- Исходный код:
- Calendar.cs
- Исходный код:
- 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 -> DateTimePublic 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 с заданными значениями даты и времени в текущей эре.
Исключения
Значение параметра year находится вне диапазона, поддерживаемого календарем.
-или-
Значение параметра month находится вне диапазона, поддерживаемого календарем.
-или-
Значение параметра day находится вне диапазона, поддерживаемого календарем.
-или-
Параметр hour меньше нуля или больше 23.
-или-
Параметр minute меньше нуля или больше 59.
-или-
Параметр second меньше нуля или больше 59.
-или-
Параметр millisecond меньше нуля или больше 999.
-или-
Значение параметра era находится вне диапазона, поддерживаемого календарем.
Комментарии
Метод ToDateTime полезен, так как он может преобразовать любую дату в текущем календаре в григорианский календарь. Впоследствии григорианскую дату можно использовать, например, для сравнения дат в разных календарях или создания эквивалентной даты в определенном календаре.
Примечания для тех, кто реализует этот метод
Производный класс должен поддерживать CurrentEra , когда он передается в era качестве параметра . Один из способов поддержки CurrentEra — заменить его значением, хранящимся в первом элементе Eras массива свойств, который является значением текущей эпохи календаря.
