DateAndTime.TimeSerial(Int32, Int32, Int32) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Date Vrátí hodnotu představující zadanou hodinu, minutu a sekundu, přičemž informace o datu jsou nastaveny vzhledem k datu 1. ledna roku 1.
public:
static DateTime TimeSerial(int Hour, int Minute, int Second);public static DateTime TimeSerial (int Hour, int Minute, int Second);static member TimeSerial : int * int * int -> DateTimePublic Function TimeSerial (Hour As Integer, Minute As Integer, Second As Integer) As DateTimeParametry
- Hour
- Int32
Povinná hodnota. Celočíselný výraz od 0 do 23. Přijaty jsou však i hodnoty mimo tento rozsah.
- Minute
- Int32
Povinná hodnota. Celočíselný výraz od 0 do 59. Přijaty jsou však i hodnoty mimo tento rozsah. Hodnota se Minute přičítá k počítané hodině, takže záporná hodnota určuje minuty před danou hodinou.
- Second
- Int32
Povinná hodnota. Celočíselný výraz od 0 do 59. Přijaty jsou však i hodnoty mimo tento rozsah. Hodnota se Second přičítá k počítané minutě, takže záporná hodnota určuje sekundy před danou minutou.
Návraty
Date Hodnota představující zadanou hodinu, minutu a sekundu s informacemi o datu nastavenými vzhledem k 1. lednu roku 1.
Výjimky
Argument je mimo rozsah -2 147 483 648 až 2 147 483 647
Vypočtený čas je menší než záporných 24 hodin.
Příklady
Následující příklad používá TimeSerial funkci k vrácení času pro zadanou hodinu, minutu a sekundu.
Dim thisTime As Date
thisTime = TimeSerial(16, 35, 17)
Poznámky
Následující příklad ukazuje záporné, nulové a kladné hodnoty argumentů. Funkce TimeSerial vrátí čas představující 15 minut před třemi hodinou před polednem nebo 8:45:00.
Dim alarmTime As Date = TimeSerial(12 - 3, -15, 0)
Pokud nebo MinuteSecond překročí svůj normální rozsah, použije se podle potřeby na další větší jednotku. Pokud například zadáte 75 minut, vyhodnotí se jako jedna hodina a 15 minut.
TimeSerial snižuje celkový počet sekund modulo 86 400, což je počet sekund za den. Vrácený čas je proto vždy mezi 00:00:00 a 23:59:59.
Datový Date typ zahrnuje komponenty data.
TimeSerial nastaví všechny tyto hodnoty na 1, takže vrácená hodnota představuje první den roku 1. Pokud však hodnoty argumentů způsobí, že vypočítaný čas překročí 24 hodin, den se podle potřeby navyšuje. V následujícím příkladu hodnoty Hour a Minute mají za následek souhrnnou dobu delší než 24 hodin.
MsgBox(TimeSerial(23, 75, 0))
' The preceding statement displays "1/2/0001 12:15:00 AM".
Pokud hodnoty argumentů mají za následek záporný vypočítaný čas, nastaví se informace o datu na 1/1/0001 a informace o čase se upraví tak, aby byly mezi 00:00:00 a 23:59:59. Pokud je však vypočtený čas menší než záporných 24 hodin, ArgumentOutOfRangeException dojde k chybě.
Vzhledem k tomu, že každá Date hodnota je podporována strukturou System.DateTime , její metody poskytují další možnosti při sestavení Date hodnoty. Můžete například použít jeden z přetížených DateTime konstruktorů k naplnění Date proměnné pomocí požadované kombinace součástí. Následující příklad nastaví newDateTime hodnotu 6. května 1978 v desetinu sekundy před 8:30 ráno:
Dim newDateTime As Date = New Date(1978, 5, 6, 8, 29, 59, 900)
