TIMEVALUE

Syntaxe

Paramètres

Description

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

Remarques

• La fonction TimeValue est utilisée pour convertir une chaîne de caractères représentant une heure en une valeur horaire de type Date. Cela permet de prendre une heure au format texte et de la transformer en un objet Date, ce qui permet ensuite de la manipuler plus facilement pour des calculs ou comparaisons.
• Le paramètre string de la fonction TimeValue attend une chaîne de caractères valide représentant une heure. La chaîne doit être dans un format reconnu, tel que "hh:mm:ss" ou "hh:mm", pour que la fonction puisse l'interpréter correctement et la convertir en un objet Date valide.
• La fonction est particulièrement utile lorsque les heures sont entreposées sous forme de texte dans une base de données ou lorsqu'elles proviennent de sources externes comme des formulaires utilisateurs. TimeValue permet de garantir que ces chaînes de texte sont transformées en heures utilisables dans le code ASP.
• Un point important à noter est que si la chaîne de caractères ne correspond pas à un format horaire valide, la fonction renverra une erreur. Il est donc recommandé de valider ou de formater les chaînes de caractères avant d'utiliser TimeValue pour éviter des erreurs d'exécution dans le script.
• La fonction TimeValue permet de traiter des heures en isolant la partie horaire d'une chaîne de texte. Par exemple, une chaîne contenant une date et une heure, comme "2025-05-01 14:30:00", pourra être convertie en heure uniquement, comme "14:30:00", en extrayant cette partie avec la fonction TimeValue.
• Une fois l'heure convertie en valeur de type Date, elle peut être utilisée pour effectuer des calculs temporels, comme l'ajout ou la soustraction de temps. Par exemple, on peut ajouter des minutes à l'heure convertie ou effectuer des comparaisons entre différentes heures dans le script.
• TimeValue est très pratique dans les applications de planification ou de gestion d'événements où les heures sont souvent saisies par les utilisateurs sous forme de texte. Cette fonction simplifie le traitement des données temporelles et assure la cohérence des formats d'heure dans toute l'application.
• Enfin, il est important de rappeler que TimeValue n'inclut pas la date dans le résultat, seulement l'heure. Ainsi, si la chaîne contient également une date, cette date sera ignorée lors de la conversion. Si vous avez besoin d'une valeur complète Date, il vous faudra utiliser une fonction supplémentaire pour inclure la date.

Exemple

Voici un exemple d'une utilisation typique de cette fonction :

on obtiendra le résultat suivant :

Voir également

Articles - Les géants de l'informatique - Microsoft