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. Muuttuja (kokonaisluku). Luku väliltä 0 (0.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 määrittää myös suhteellisen ajan kullekin argumentti-argumentille käyttämällä mitä tahansa numeerista lauseketta, joka vastaa jotakin tunti-, minuutti- tai sekuntimäärää ennen tiettyä aikaa tai tietyn ajan jälkeen. Seuraavassa esimerkissä käytetään lausekkeita absoluuttisten ajan numeroiden sijaan. TimeSerial-funktio palauttaa ajan, joka on 15 minuuttia ennen (-15) kuutta tuntia ennen keskipäivää (12 - 6) eli 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 MyTimeMyTime = TimeSerial(16, 35, 17) ' MyTime contains serial representation of 4:35:17 PM.
