Renvoie une donnée de type Variante (Date) contenant l’heure.
Syntaxe
TimeValue(time)
L’argument d’heurerequise est normalement une expression de chaîne représentant une heure comprise entre 0:00:00 (12:00:00 A.M.) et 23:59:59 (11:59:59 PM), inclus. Toutefois, heure peut également être n’importe quelle expression qui représente une heure comprise dans cette plage. Si l’heure contient Null, Null est renvoyé.
Remarques
Vous pouvez entrer des heures valides en utilisant une horloge de 12 heures ou de 24 heures. Par exemple, "2:24PM" et "14:24" sont tous deux des arguments de temps valides.
Si l’argument time contient des informations de date, TimeValue ne les renvoie pas. Toutefois, si l’heure inclut des informations de date non valides, une erreur se produit.
Exemples de requête
| Expression | Résultats |
|---|---|
| SELECT TimeValue([DateTime]) AS Expr1 FROM ProductSales ; | Renvoie les valeurs horaires du champ « DateTime » sans les informations de date et s’affiche dans la colonne Expr1. |
| SELECT TimeValue([DateTime]) AS JustTime FROM ProductSales ; | Renvoie les valeurs horaires du champ « DateTime » sans les informations de date et s’affiche dans la colonne JustTime. |
Exemple de VBA
Remarque
Les exemples suivants illustrent l’utilisation de cette fonction dans un module Visual Basic pour Applications (VBA). Pour plus d’informations sur l’utilisation de VBA, sélectionnez Référence développeur dans la liste déroulante en regard de Rechercher , puis entrez un ou plusieurs termes dans la zone de recherche.
Cet exemple utilise la fonction TimeValue pour convertir une chaîne en heure. Vous pouvez également utiliser des littéraux de date pour affecter directement une heure à une variable Variant ou Date , par exemple, MyTime = #4:35:17 PM#.
Dim MyTime
MyTime = TimeValue("4:35:17 PM") ' Return a time.