DateAndTime.TimeSerial(Int32, Int32, Int32) Metódus
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Date Egy megadott órát, percet és másodpercet képviselő értéket ad vissza, amely az 1. év január 1-jei dátuminformációihoz van állítva.
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 DateTimeParaméterek
- Hour
- Int32
Kötelező. Egész kifejezés 0 és 23 között. A tartományon kívüli értékeket azonban a rendszer elfogadja.
- Minute
- Int32
Kötelező. Egész kifejezés 0 és 59 között. A tartományon kívüli értékeket azonban a rendszer elfogadja. Az érték Minute hozzáadódik a számított órához, így a negatív érték az óra előtti perceket adja meg.
- Second
- Int32
Kötelező. Egész kifejezés 0 és 59 között. A tartományon kívüli értékeket azonban a rendszer elfogadja. A program hozzáadja a Second számított perc értékét, így a negatív érték másodpercekkel az adott perc előtt van megadva.
Válaszok
Egy Date megadott órát, percet és másodpercet képviselő érték, amely az 1. év január 1-jével kapcsolatos dátuminformációval rendelkezik.
Kivételek
Az argumentum a -2 147 483 648 és 2 147 483 647 közötti tartományon kívül esik
A számított idő kisebb, mint a negatív 24 óra.
Példák
Az alábbi példa a függvényt használja a TimeSerial megadott órára, percre és másodpercre vonatkozó idő visszaadására.
Dim thisTime As Date
thisTime = TimeSerial(16, 35, 17)
Megjegyzések
Az alábbi példa negatív, nulla és pozitív argumentumértékeket mutat be. A TimeSerial függvény 15 perccel a dél előtt három órával vagy 8:45:00 óra előtt visszaadott időt adja vissza.
Dim alarmTime As Date = TimeSerial(12 - 3, -15, 0)
Ha vagy MinuteSecond meghaladja a normál tartományt, a rendszer a következő nagyobb egységre alkalmazza a megfelelő módon. Ha például 75 percet ad meg, az egy óra és 15 perc lesz kiértékelve.
TimeSerial csökkenti az összes másodperc modulo 86 400, ami a másodpercek száma egy nap. Ezért a visszaadott idő mindig 00:00:00 és 23:59:59 között van.
Az Date adattípus dátumösszetevőket tartalmaz.
TimeSerial mindet 1 értékre állítja, így a visszaadott érték az 1. év első napját jelöli. Ha azonban az argumentumok értéke miatt a számított idő meghaladja a 24 órát, a nap szükség szerint növekszik. Az alábbi példában az értékek HourMinute több mint 24 óra összesített időt eredményeznek.
MsgBox(TimeSerial(23, 75, 0))
' The preceding statement displays "1/2/0001 12:15:00 AM".
Ha az argumentumok értékei negatív számított időt eredményeznek, a dátumadatok értéke 0001.01.01., az időadatok pedig 00:00:00 és 23:59:59 között lesznek. Ha azonban a számított idő kevesebb, mint 24 óra negatív, ArgumentOutOfRangeException hiba történik.
Mivel minden Date értéket egy System.DateTime struktúra támogat, a metódusok további lehetőségeket biztosítanak az Date értékek összeállításához. Használhatja például az egyik túlterhelt konstruktort DateTime egy változó feltöltéséhez Date az összetevők kívánt kombinációjával. Az alábbi példa 1978. május 6-ra állítja newDateTime a hajnali 8:30 előtti egytized másodpercet:
Dim newDateTime As Date = New Date(1978, 5, 6, 8, 29, 59, 900)