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 s informacemi o datu nastaveném vzhledem k 1. lednu 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
Required. Celočíselné výrazy od 0 do 23. Hodnoty mimo tento rozsah jsou však přijímány také.
- Minute
- Int32
Required. Celočíselné výrazy od 0 do 59. Hodnoty mimo tento rozsah jsou však přijímány také. Hodnota Minute se přidá do počítané hodiny, takže záporná hodnota určuje minuty před danou hodinou.
- Second
- Int32
Required. Celočíselné výrazy od 0 do 59. Hodnoty mimo tento rozsah jsou však přijímány také. Hodnota Second se přidá k počítané minutě, takže záporná hodnota určuje sekundy před danou minutou.
Návraty
Hodnota Date představující zadanou hodinu, minutu a sekundu s informacemi o datu nastaveném vzhledem k lednu 1 roku 1.
Výjimky
Argument je mimo rozsah -2 147 483 648 až 2 147 483 647
Počítaná doba je menší než záporná 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 polednem nebo 8:45:00.
Dim alarmTime As Date = TimeSerial(12 - 3, -15, 0)
Pokud některý z těchto hodnot překročí MinuteSecond 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 obsahuje komponenty kalendářních dat.
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ůsobují, že počítaná doba překročí 24 hodin, den se podle potřeby zvýší. V následujícím příkladu hodnoty Hour a Minute výsledek v kombinovaném čase delším než 24 hodin.
MsgBox(TimeSerial(23, 75, 0))
' The preceding statement displays "1/2/0001 12:15:00 AM".
Pokud jsou hodnoty argumentů výsledkem záporného počítaného času, jsou informace o datu nastaveny na 1/1/0001 a informace o čase se upraví tak, aby byly v rozmezí 00:00:00 a 23:59:59. Pokud je však počítaná doba kratší než záporná 24 hodin, dojde k ArgumentOutOfRangeException 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 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)
