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 Controleer of de argumenten in het juiste waardebereik staan. 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 V.M.) en 23 (11:00 N.M.), inclusief, 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 () zes uur voor de-15 middag (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.
Voorbeeld van een query
| Expressie | Resultaten |
|---|---|
| SELECT TimeSerial(18,12,10) AS NewTime FROM ProductSales GROUP BY TimeSerial(18,12,10); | Geeft als resultaat de 'tijd' die bestaat uit de opgegeven uren, minuten en seconden die zijn ingevoerd in de argumenten van de functie en wordt weergegeven in de kolom Nieuwtijd. Resultaat: '6:12:10 PM'. |
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.