TIMEVALUE |
Valeur de l'heure |
|---|---|
| Visual Basic | |
Syntaxe
| Function TimeValue(string As String) As String |
Paramètres
| Nom | Description |
|---|---|
| string | Ce paramètre permet d'indiquer l'expression contenant une chaîne de caractères à traiter. |
Description
Cette fonction permet de convertir une chaîne de caractères en une heure.
Remarques
- La fonction TimeValue est conçue pour extraire et convertir une chaîne représentant une heure en un format standard reconnu par Visual Basic. Elle est idéale pour normaliser des heures saisies de manière textuelle par l'utilisateur.
- Elle interprète automatiquement des formats horaires divers, comme "8:7:6" ou "8:7:6 pm", en les transformant en 08:07:06 ou 20:07:06. Cela facilite l'uniformisation des données sans avoir besoin d'analyse la chaîne manuellement.
- Lorsque la chaîne passée contient également une date, TimeValue ignore la partie date et ne conserve que l'heure. C'est donc une fonction très spécifique à l'extraction temporelle, contrairement à CDate qui convertirait l'ensemble.
- L'exemple montre une subtilité intéressante : TimeValue(#8:7:6#) retourne 08:07:06 malgré l'écriture apparemment similaire à "20:7:6", car le #...# force une interprétation en tant que littéral de type Date, non comme chaîne de texte.
- Cette fonction retourne une valeur de type Date, bien que le contenu se limite à une heure. Cela signifie qu'en arrière-plan, une date (souvent le 30 décembre 1899) est incluse, ce qui peut avoir un impact lors de calculs temporels.
- TimeValue est particulièrement utile pour valider et convertir des heures entrées par l'utilisateur dans des applications avec formulaires ou champs de saisie. Elle permet d'éviter les erreurs de format tout en assurant une conversion fiable.
- Si la chaîne fournie est mal formée ou invalide (ex : "25:61"), la fonction génère une erreur d'exécution. Il est donc recommandé de la coupler avec une gestion d'erreurs (comme On Error) pour éviter les plantages.
- TimeValue est complémentaire à TimeSerial, mais là où TimeSerial assemble une heure à partir de composants numériques, TimeValue déduit l'heure à partir d'une chaîne de caractères. Ensemble, elles couvrent la majorité des cas d'utilisation pour la gestion d'heures.
Exemple
Voici un exemple d'une utilisation typique de cette fonction :
on obtiendra le résultat suivant :
8:7:6 = 08:07:068:7:6 pm = 20:07:06
20:7:6 = 20:07:06
20:7:6 = 08:07:06
Dernière mise à jour : Lundi, le 19 novembre 2012