HOUR

Syntaxe

Paramètres

Description

Cette fonction retourne l'heure d'une journée. La fonction HOUR renvoie un nombre entier compris entre 0 et 23, inclus, représentant l'heure de la journée.

Remarques

• L'exemple suivant utilise la fonction Hour pour obtenir l'heure à partir de l'heure actuelle :
1. Dim MyTime, MyHour
2. MyTime = Now
3. MyHour = Hour(MyTime) ' MyHour contient le nombre représentant l'heure actuelle.


• La fonction HOUR permet d'extraire la composante horaire d'une valeur de type DateTime. Elle retourne un entier compris entre 0 et 23, ce qui correspond à un format horaire sur 24 heures, très pratique pour effectuer des comparaisons temporelles précises.
• Cette fonction est utile dans tous les cas où l'on souhaite analyser ou filtrer des données selon une heure précise, comme dans des applications de gestion de plannings, de journaux d'événements ou de systèmes d'alerte conditionnés par l'heure.
• Le paramètre fourni à la fonction peut être n'importe quelle expression convertible en date, comme une variable de type Date, le résultat de la fonction Now, ou encore une chaîne de caractères formatée correctement. Cela lui donne une grande flexibilité d'utilisation.
• Si la valeur fournie contient Null, la fonction retourne également Null. Il est donc conseillé de vérifier la validité de la date avant d'appeler Hour, afin d'éviter des erreurs d'exécution ou des résultats inattendus dans des calculs ultérieurs.
• L'instruction Dim MyHour = Hour(Now) est un exemple courant permettant d'obtenir l'heure actuelle du système. Cette utilisation est très fréquente dans les scripts de journalisation, les rapports ou les vérifications d'horaires en temps réel.
• Comme la fonction retourne un entier, elle est facilement utilisable dans des structures de contrôle telles que If ou Select Case, pour exécuter des blocs de code à certains moments de la journée, par exemple :
1. If Hour(Now) >= 18 Then
2.     MsgBox "Il est temps de fermer."
3. End If


• HOUR est souvent combinée avec les fonctions MINUTE et SECOND pour obtenir une analyse complète d'une heure précise, permettant de reconstituer l'ensemble des composantes d'une horodatation, ou de la formater manuellement selon les besoins.
• Dans une boucle ou une tâche planifiée, la fonction HOUR peut être utilisée pour contrôler les fréquences ou les intervalles d'exécution d'une action, rendant le code plus dynamique et sensible au contexte temporel sans nécessiter de bibliothèques externes.

Exemples

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

on obtiendra le résultat suivant :

Voici un exemple montrant comment exploiter la fonction avec le temps courant :