Calendar.ToDateTime Metoda

Definicja

Przestrzeń nazw:

System.Globalization

Zestawy:

netstandard.dll, System.Runtime.dll

Po zastąpieniu w klasie pochodnej zwraca wartość ustawioną DateTime na określoną datę i godzinę.

Przeciążenia

Nazwa	Opis
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)	Zwraca wartość ustawioną DateTime na określoną datę i godzinę w bieżącej erze.
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)	Po zastąpieniu w klasie pochodnej zwraca wartość ustawioną DateTime na określoną datę i godzinę w określonej erze.

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

Źródło:

Calendar.cs

Zwraca wartość ustawioną DateTime na określoną datę i godzinę w bieżącej erze.

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

Parametry

year

Int32

Liczba całkowita reprezentująca rok.

month

Int32

Dodatnia liczba całkowita reprezentująca miesiąc.

day

Int32

Dodatnia liczba całkowita reprezentująca dzień.

hour

Int32

Liczba całkowita z zakresu od 0 do 23, która reprezentuje godzinę.

minute

Int32

Liczba całkowita z zakresu od 0 do 59, która reprezentuje minutę.

second

Int32

Liczba całkowita z zakresu od 0 do 59, która reprezentuje drugą.

millisecond

Int32

Liczba całkowita z zakresu od 0 do 999, która reprezentuje milisekundę.

Zwraca

DateTime

Ustawiono DateTime określoną datę i godzinę w bieżącej erze.

Wyjątki

ArgumentOutOfRangeException

year znajduje się poza zakresem obsługiwanym przez kalendarz.

— lub —

month znajduje się poza zakresem obsługiwanym przez kalendarz.

— lub —

day znajduje się poza zakresem obsługiwanym przez kalendarz.

— lub —

hour wartość jest mniejsza niż zero lub większa niż 23.

— lub —

minute wartość jest mniejsza niż zero lub większa niż 59.

— lub —

second wartość jest mniejsza niż zero lub większa niż 59.

— lub —

millisecond wartość jest mniejsza niż zero lub większa niż 999.

Uwagi

Ta metoda zwraca datę i godzinę na podstawie bieżącej ery określonego kalendarza. JapaneseCalendar W przypadku elementów iJapaneseLunisolarCalendar, które obsługują wiele epok na podstawie panowania cesarza, wywołanie tej metody może spowodować niezamierzoną datę, gdy zmienia się era. Podczas tworzenia wystąpienia daty przy użyciu jednego z tych kalendarzy zalecamy wywołanie JapaneseCalendar.ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32) metody lub JapaneseLunisolarCalendar.ToDateTime(Int32,Int32,Int32,Int32,Int32,Int32,Int32,Int32,Int32,Int32,Int32).

Zobacz też

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

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

Źródło:

Calendar.cs

Po zastąpieniu w klasie pochodnej zwraca wartość ustawioną DateTime na określoną datę i godzinę w określonej erze.

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

Parametry

year

Int32

Liczba całkowita reprezentująca rok.

month

Int32

Dodatnia liczba całkowita reprezentująca miesiąc.

day

Int32

Dodatnia liczba całkowita reprezentująca dzień.

hour

Int32

Liczba całkowita z zakresu od 0 do 23, która reprezentuje godzinę.

minute

Int32

Liczba całkowita z zakresu od 0 do 59, która reprezentuje minutę.

second

Int32

Liczba całkowita z zakresu od 0 do 59, która reprezentuje drugą.

millisecond

Int32

Liczba całkowita z zakresu od 0 do 999, która reprezentuje milisekundę.

era

Int32

Liczba całkowita reprezentująca erę.

Zwraca

DateTime

Ustawiono DateTime określoną datę i godzinę w bieżącej erze.

Wyjątki

ArgumentOutOfRangeException

year znajduje się poza zakresem obsługiwanym przez kalendarz.

— lub —

month znajduje się poza zakresem obsługiwanym przez kalendarz.

— lub —

day znajduje się poza zakresem obsługiwanym przez kalendarz.

— lub —

hour wartość jest mniejsza niż zero lub większa niż 23.

— lub —

minute wartość jest mniejsza niż zero lub większa niż 59.

— lub —

second wartość jest mniejsza niż zero lub większa niż 59.

— lub —

millisecond wartość jest mniejsza niż zero lub większa niż 999.

— lub —

era znajduje się poza zakresem obsługiwanym przez kalendarz.

Uwagi

Metoda jest przydatna ToDateTime , ponieważ może przekonwertować dowolną datę w bieżącym kalendarzu na datę kalendarza gregoriańskiego. Następnie można użyć daty gregoriańskiej, aby porównać daty w różnych kalendarzach lub utworzyć równoważną datę w określonym kalendarzu.

Notatki dotyczące implementowania

Klasa pochodna musi obsługiwać CurrentEra po przekazaniu go jako parametru era . Jednym ze sposobów obsługi CurrentEra jest zastąpienie go wartością przechowywaną w pierwszym elemencie Eras tablicy właściwości, czyli wartością bieżącej ery kalendarza.

Zobacz też

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