DateAndTime.TimeSerial(Int32, Int32, Int32) Metoda

Definice

Obor názvů:

Microsoft.VisualBasic

Sestavení:

Microsoft.VisualBasic.Core.dll

Zdroj:

DateAndTime.vb

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 -> DateTime

Public Function TimeSerial (Hour As Integer, Minute As Integer, Second As Integer) As DateTime

Parametry

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

DateTime

Date Hodnota představující zadanou hodinu, minutu a sekundu s informacemi o datu nastavenými vzhledem k 1. lednu roku 1.

Výjimky

ArgumentException

Argument je mimo rozsah -2 147 483 648 až 2 147 483 647

ArgumentOutOfRangeException

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)  

Viz také

• DateSerial(Int32, Int32, Int32)
• DateValue(String)
• Hour(DateTime)
• Minute(DateTime)
• Now
• Second(DateTime)
• TimeValue(String)