Geeft een variant (datum) als resultaat die de tijd bevat voor een specifiek uur, een specifieke minuut en een specifieke seconde.
Syntaxis
TimeSerial ( uur, minuut, seconde )
Waarschuwing Zorg ervoor dat de argumenten zich in het juiste bereik van waarden bevinden. Een ongeldig argument kan leiden tot een onjuist resultaat.
De syntaxis van de functie TimeSerial bevat deze argumenten:
Argument |
Beschrijving |
uur |
Vereist. Variant (Geheel getal). Een getal tussen 0 (12:00 A.M.) en 23 (11:00 P.M.) of een numerieke expressie. |
minuut |
Vereist. Variant (Geheel getal). Een numerieke expressie. |
seconde |
Vereist. Variant (Geheel getal). Een numerieke expressie. |
Opmerkingen
Om een tijd op te geven, zoals 11:59:59, moet het bereik van getallen voor elk argument van TimeSerial bestaan uit waarden uit het normale bereik voor de eenheid; dus 0-23 voor uren en 0-59 voor minuten en seconden. U kunt echter ook relatieve tijden opgeven voor elk argument met behulp van een numerieke expressie die een aantal uren, minuten of seconden vóór of na een bepaalde tijd vertegenwoordigt. In het volgende voorbeeld worden expressies gebruikt in plaats van absolute tijdwaarden. De functie TimeSerial retourneert een tijd die overeenkomt met 15 minuten vóór (-15) zes uur voor twaalf uur 's middags (12 - 6), oftewel 05:45:00.
TimeSerial(12 - 6, -15, 0)
Wanneer een argument het normale bereik voor dat argument overschrijdt, wordt de waarde verwerkt als de eerstvolgende grotere eenheid. Als u bijvoorbeeld 75 minuten opgeeft, wordt dit geëvalueerd als één uur en 15 minuten. Als een argument buiten het bereik-32.768 tot 32.767 ligt, treedt er een fout op. Als de tijd die is opgegeven met de drie argumenten tot gevolg heeft dat de datum buiten het acceptabele bereik van datums valt, treedt er een fout op.
Queryvoorbeeld
Expression |
Resultaten |
SELECT TimeSerial(18;12,10) AS NewTime FROM ProductVerkoop GROUP BY TimeSerial(18;12,10); |
Retourneert de 'Tijd' die bestaat uit opgegeven uur, minuut en seconde die zijn ingevoerd in de argumenten van de functie en wordt weergegeven in de kolom NewTime. Resultaat: "18:12:10". |
VBA-voorbeeld
Opmerking: In de volgende voorbeelden wordt het gebruik van deze functie in een VBA-module (Visual Basic for Applications) toegelicht. Meer informatie over het werken met VBA vindt u door in de vervolgkeuzelijst naast Zoeken de optie Referentie voor ontwikkelaars te selecteren en een of meer termen in het zoekvenster te typen.
In dit voorbeeld wordt de functie TimeSerial gebruikt om een tijd te retourneren voor de uren, minuten en seconden die zijn opgegeven.
Dim MyTime
MyTime = TimeSerial(16, 35, 17) ' MyTime contains serial representation of 4:35:17 PM.