TIMEVALUE

Syntaxe

Paramètres

Description

Cette fonction permet de convertir une chaîne de caractères en une heure.

Remarques

• La fonction convertit une chaîne de caractères en une heure : La fonction TimeValue analyse une chaîne contenant une représentation valide d'une heure et la convertit en une valeur de type Date/Heure. Le résultat peut ensuite être utilisé dans des calculs ou des comparaisons temporelles. Cette fonction est particulièrement utile lorsque les heures proviennent d'une saisie utilisateur ou d'un fichier texte.
• La chaîne doit représenter une heure valide : Le paramètre fourni doit contenir une heure que Microsoft Access est capable d'interpréter. Par exemple, des valeurs telles que "08:30", "14:45:10" ou "9:15 PM" sont généralement reconnues selon les paramètres régionaux du système. Si la chaîne est invalide, une erreur est générée.
• Le résultat est une valeur de type Date/Heure : Bien que seule l'heure soit extraite, TimeValue retourne une valeur du type Date/Heure utilisé par Microsoft Access. Cette valeur peut être manipulée avec les fonctions Hour, Minute, Second, DateDiff ou Format. Elle est donc compatible avec l'ensemble des fonctions temporelles du langage.
• La partie date est ignorée lorsqu'elle est présente : Si la chaîne contient à la fois une date et une heure, TimeValue ne conserve généralement que la composante horaire. La partie correspondant à la date est ignorée dans le résultat. Cette caractéristique permet d'extraire facilement une heure à partir d'une date complète.
• Le format reconnu dépend des paramètres régionaux : L'interprétation de la chaîne est influencée par les paramètres régionaux de Windows. Les formats d'heure sur 12 heures ou sur 24 heures, ainsi que les séparateurs utilisés, peuvent varier selon la configuration du système. Il est donc conseillé d'utiliser un format cohérent lors des échanges de données entre différentes machines.
• Elle est très utile lors de l'importation de données : Les fichiers texte, CSV ou les données provenant d'autres applications contiennent souvent des heures sous forme de texte. TimeValue permet de convertir rapidement ces chaînes en véritables valeurs temporelles exploitables dans Access. Cette fonction facilite ainsi le traitement des données importées.
• Elle est disponible dans les requêtes et dans le code VBA : La fonction TimeValue peut être utilisée dans les requêtes SQL, les formulaires, les états, les macros ainsi que dans les modules VBA. Elle permet d'effectuer directement la conversion d'une chaîne en heure dans une expression Access. Son comportement est identique dans tous les contextes d'utilisation.
• Elle est souvent combinée avec d'autres fonctions de date et d'heure : Après conversion, la valeur retournée peut être exploitée avec Hour, Minute, Second, TimeSerial, DateAdd ou DateDiff. Cette combinaison permet de réaliser des calculs de durée, des comparaisons ou des affichages personnalisés. Elle est très courante dans les applications de gestion des horaires.
• Il est conseillé de vérifier les données avant la conversion : Lorsque les chaînes proviennent d'une saisie utilisateur, il est préférable d'utiliser IsDate afin de vérifier qu'elles représentent bien une date ou une heure valide. Cette précaution permet d'éviter les erreurs d'exécution lors de l'appel à TimeValue. Elle améliore la robustesse des applications Access.
• La fonction est compatible avec toutes les versions modernes de Microsoft Access : La fonction TimeValue est disponible depuis les premières versions de Microsoft Access intégrant VBA et son fonctionnement est demeuré stable au fil des années. Elle est compatible avec Access 2000, Access XP, Access 2003, Access 2007, Access 2010, Access 2013, Access 2016 ainsi qu'avec Microsoft 365. Cette stabilité garantit que les applications utilisant cette fonction continueront de fonctionner correctement lors des migrations vers des versions plus récentes d'Access.

Exemple

Voici un exemple de comment utiliser la fonction TimeValue dans Microsoft Access :

Exemple de code VBA

La fonction TimeValue peut être utilisée dans le code VBA de Microsoft Access.

Par exemple :

Dans cet exemple, la variable appelée LTime contiendrait désormais la valeur 18:30:12.