Palauttaa variantin (päivämäärän), joka sisältää tietyn ajan.
Syntaksi
TimeSerial(tunti, minuutti, sekunti)
Varoitus Varmista, että argumentit ovat oikealla arvoalueella. Virheellinen argumentti voi johtaa virheelliseen tulokseen.
TimeSerial-funktion syntaksilla on seuraavat argumentit:
| Argumentti | Kuvaus |
|---|---|
| tunti | Pakollinen. Variantti (kokonaisluku). Luku väliltä 0 (12.00) ja 23 (23.00) tai numeerinen lauseke. |
| minuutti | Pakollinen. Muuttuja (kokonaisluku). Mikä tahansa numeerinen lauseke. |
| sekunti | Pakollinen. Muuttuja (kokonaisluku). Mikä tahansa numeerinen lauseke. |
Huomautuksia
Kun määrität ajan, kuten 11.59.59, kunkin TimeSerial-argumentin numeroalueen on oltava kyseisen yksikön normaalilla alueella, eli tuntien kohdalla 0–23 ja minuuttien ja sekuntien kohdalla 0–59. Voit kuitenkin myös määrittää kullekin argumentille suhteelliset ajat käyttämällä mitä tahansa numeerista lauseketta, joka edustaa tiettyä aikaa edeltäviä tai sen jälkeisiä tunteja, minuutteja tai sekunteja. Seuraavassa esimerkissä käytetään lausekkeita absoluuttisten ajan numeroiden sijaan.
TimeSerial-funktio palauttaa ajan 15 minuutiksi ennen (-15) kuutta tuntia ennen keskipäivää (12 - 6) tai 5:45:00.
TimeSerial(12 - 6, -15, 0)
Jos jokin argumenteista ylittää kyseisen argumentin normaalin alueen, se muutetaan seuraavaan suurempaan yksikköön tarpeen mukaan. Jos määrität esimerkiksi 75 minuuttia, se arvioidaan yhdeksi tunniksi ja 15 minuutiksi. Jos jokin yksittäinen argumentti on alueen -32 768–32 767 ulkopuolella, virhe ilmenee. Jos kolmen argumentin määrittämä aika aiheuttaa sen, että päivämäärä on hyväksyttävän päivämääräalueen ulkopuolella, virhe ilmenee.
Esimerkki kyselystä
| Lauseke | Tulokset |
|---|---|
| VALITSE TimeSerial(18,12,10) NewTime FROM ProductSales GROUP BY TimeSerial(18,12,10); | Palauttaa "Time" -arvon, joka koostuu määritetystä tunnista, minuutista ja sekunnista, jotka on kirjoitettu funktion argumentteihin ja joka näkyy NewTime-sarakkeessa. Tulos: "18:12:10". |
VBA-esimerkki
Huomautus
Seuraavissa esimerkeissä kerrotaan, kuinka tätä funktiota käytetään Visual Basic for Applications (VBA) -moduulissa. Jos haluat lisätietoja VBA:n käytöstä, valitse Sovelluskehittäjän opasHaku-kentän viereisestä luettelosta ja anna yksi tai useampi hakuehto hakukenttään.
Tässä esimerkissä TimeSerial-funktiolla palautetaan määritetyn tunti-, minuutti- ja sekuntiarvon mukainen kellonaika.
Dim MyTime
MyTime = TimeSerial(16, 35, 17)
' MyTime contains serial representation of 4:35:17 PM.