Calendar.ToDateTime Método

Definição

Namespace:

System.Globalization

Assembly:

System.Runtime.dll

Quando substituído em uma classe derivada, retorna um DateTime que é definido como a data e hora especificadas.

Sobrecargas

ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)	Retorna um DateTime que é definido como a data e hora especificadas na era atual.
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)	Quando substituído em uma classe derivada, retorna um DateTime que é definido como a data e hora especificadas na era especificada.

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

Origem:

Calendar.cs

Retorna um DateTime que é definido como a data e hora especificadas na era atual.

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

Parâmetros

year

Int32

Um inteiro que representa o ano.

month

Int32

Um inteiro positivo que representa o mês.

day

Int32

Um inteiro positivo que representa o dia.

hour

Int32

Um inteiro de 0 a 23 que representa a hora.

minute

Int32

Um inteiro de 0 a 59 que representa o minuto.

second

Int32

Um inteiro de 0 a 59 que representa o segundo.

millisecond

Int32

Um inteiro de 0 a 999 que representa o milissegundo.

Retornos

DateTime

O DateTime que é definido como a data e hora especificadas na era atual.

Exceções

ArgumentOutOfRangeException

year está fora do intervalo com suporte do calendário.

- ou -

month está fora do intervalo com suporte do calendário.

- ou -

day está fora do intervalo com suporte do calendário.

- ou -

hour é menor que zero ou maior que 23.

- ou -

minute é menor que zero ou maior que 59.

- ou -

second é menor que zero ou maior que 59.

- ou -

millisecond é menor que zero ou maior que 999.

Comentários

Esse método retorna uma data e hora com base na era atual de um calendário específico. Para o JapaneseCalendar e JapaneseLunisolarCalendar, que dão suporte a várias eras com base no reinado do imperador, chamar esse método pode produzir uma data não intencional quando uma era muda. Ao instanciar uma data usando um desses calendários, recomendamos que você chame o JapaneseCalendar.ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32) método ou JapaneseLunisolarCalendar.ToDateTime(Int32,Int32,Int32,Int32,Int32,Int32,Int32,Int32,Int32) e especifique explicitamente uma era.

Confira também

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

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

Origem:

Calendar.cs

Quando substituído em uma classe derivada, retorna um DateTime que é definido como a data e hora especificadas na era especificada.

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

Parâmetros

year

Int32

Um inteiro que representa o ano.

month

Int32

Um inteiro positivo que representa o mês.

day

Int32

Um inteiro positivo que representa o dia.

hour

Int32

Um inteiro de 0 a 23 que representa a hora.

minute

Int32

Um inteiro de 0 a 59 que representa o minuto.

second

Int32

Um inteiro de 0 a 59 que representa o segundo.

millisecond

Int32

Um inteiro de 0 a 999 que representa o milissegundo.

era

Int32

Um inteiro que representa a era.

Retornos

DateTime

O DateTime que é definido como a data e hora especificadas na era atual.

Exceções

ArgumentOutOfRangeException

year está fora do intervalo com suporte do calendário.

- ou -

month está fora do intervalo com suporte do calendário.

- ou -

day está fora do intervalo com suporte do calendário.

- ou -

hour é menor que zero ou maior que 23.

- ou -

minute é menor que zero ou maior que 59.

- ou -

second é menor que zero ou maior que 59.

- ou -

millisecond é menor que zero ou maior que 999.

- ou -

era está fora do intervalo com suporte do calendário.

Comentários

O ToDateTime método é útil porque pode converter qualquer data no calendário atual em uma data de calendário gregoriano. A data gregoriana pode ser usada posteriormente, por exemplo, para comparar datas em calendários diferentes ou criar uma data equivalente em um calendário específico.

Notas aos Implementadores

A classe derivada deve dar suporte CurrentEra quando é passada como o era parâmetro . Uma maneira de dar suporte CurrentEra é substituindo-o pelo valor armazenado no primeiro elemento da matriz de Eras propriedades, que é o valor da era atual do calendário.

Confira também

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