Tagastab tüübile Variant (Date) vastava kellaaja.
Süntaks
TimeValue ( time )
Nõutav argumenttime on tavaliselt stringavaldis, mis tähistab kellaaega vahemikus 0:00:00–23:59:59 (k.a). Siiski võib time olla ka mis tahes avaldis, mida kasutatakse selles vahemikus oleva kellaaja tähistamiseks. Kui time sisaldab väärtust Null, tagastatakse Null.
Kommentaarid
Sisestada saate sobivaid 12- või 24-tunnisel kellaajal põhinevaid kellaaegu. Näiteks saate argumendina time kasutada nii kellaaega "2:24PM" kui ka "14:24".
Juhul kui argument time sisaldab kuupäeva, siis funktsioon TimeValue vastavat väärtust ei tagasta. Ent kui argument time sisaldab sobimatut kuupäeva, ilmneb tõrge.
Päringu näited
Avaldis |
Tulemid |
SELECT TimeValue([DateTime]) AS Expr1 FROM ProductSales; |
Tagastab välja "KuupäevKellaaeg" kellaajaväärtused ilma kuupäevateabeta ja kuvatakse veerus Avaldis1. |
SELECT TimeValue([DateTime]) AS JustTime FROM ProductSales; |
Tagastab välja "KuupäevKellaaeg" kellaajaväärtused ilma kuupäevateabeta ja kuvatakse veerus JustTime. |
VBA näide
Märkus.: Järgmised näited kujutavad selle funktsiooni kasutamist rakenduse Visual Basic for Applications (VBA) moodulis. Lisateabe saamiseks VBA-ga töötamise kohta valige välja Otsing kõrval kuvatavast ripploendist väärtus Tootearendusmaterjal ja sisestage otsinguväljale üks või mitu sõna.
Selles näites kasutatakse funktsiooni TimeValue stringi teisendamiseks kellaajaks. Kuupäevaliteraale saate kasutada ka muutujale Variant või Date kellaaja määramiseks (nt MyTime = #4:35:17 PL#).
Dim MyTime
MyTime = TimeValue("4:35:17 PM") ' Return a time.