Tagastab tüübile Variant (Date) vastava kellaaja.
Süntaks
TimeValue(time)
Nõutav kellaajaargumenton tavaliselt stringiavaldis, mis tähistab kellaaega vahemikus 0:00:00–23:59:59 (k.a). Kellaaeg võib aga olla ka mis tahes avaldis, mis tähistab selle vahemiku kellaaega. Kui time sisaldab tühiväärtust, tagastatakse tühiväärtus .
Kommentaarid
Sisestada saate sobivaid 12- või 24-tunnisel kellaajal põhinevaid kellaaegu. Näiteks "2:24PM""14:24" on mõlemad sobivad ajaargumendid.
Kui argument time sisaldab kuupäevateavet, ei tagasta funktsioon TimeValue seda. Kui aga kellaaeg sisaldab sobimatut kuupäevateavet, 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.