HOUR |
Heure |
|---|---|
| ASP 3.0 | |
Syntaxe
| Function HOUR(ByVal n As DateTime) As Integer |
Paramètres
| Nom | Description |
|---|---|
| n | Ce paramètre permet d'indiquer la date à traiter |
Description
Cette fonction retourne l'heure d'une journée.
Remarques
- La fonction Hour permet d'extraire uniquement la composante « heure » d'une date complète, représentée sous forme de type DateTime. Elle retourne un entier compris entre 0 et 23, correspondant à l'heure dans le format 24 heures. Cela est particulièrement utile pour analyser ou filtrer des événements selon le moment de la journée.
- Hour est idéale pour effectuer des tris ou des regroupements temporels dans des traitements horaires. Par exemple, on peut regrouper des accès utilisateurs ou des actions selon les heures de la journée pour analyser des pics d'activité. Cela facilite la création de tableaux de bord ou de statistiques de fréquentation.
- Cette fonction est souvent utilisée conjointement avec d'autres fonctions temporelles telles que Minute, Second, Day ou DatePart. Cela permet d'obtenir une analyse détaillée et complète de l'horodatage d'un événement. Elle fait partie des outils standards de manipulation des dates et heures dans ASP 3.0.
- Le paramètre n doit être une variable ou une valeur de type DateTime. Si la date fournie est incorrecte ou vide, une erreur d'exécution peut survenir. Il est donc recommandé de valider ou vérifier l'existence de la date avant d'utiliser cette fonction.
- Le format de l'heure retournée ne dépend pas du format affiché de la date d'origine. Par exemple, qu'elle soit saisie en format français (jj/mm/aaaa) ou anglo-saxon (mm/dd/yyyy), seule la composante heure est extraite. Cela garantit une cohérence dans le traitement des heures, indépendamment du format régional.
- La valeur retournée ne comporte pas les minutes ni les secondes, ce qui rend la fonction utile pour des regroupements globaux mais pas pour des calculs précis. Si une précision plus fine est nécessaire, il faut également utiliser les fonctions Minute(n) et Second(n). Cela permet de reconstruire une heure complète au besoin.
- Elle est particulièrement utile dans le cadre de systèmes d'enregistrement ou de planification, pour déterminer le créneau horaire d'un événement. Par exemple, dans un agenda ou un planning automatisé, on peut colorier ou prioriser des événements selon l'heure de la journée. Cela permet une organisation temporelle fine et intuitive des données.
Exemples
Voici un exemple d'une utilisation typique de cette fonction :
on obtiendra le résultat suivant :
8:13:14 AM =812:34 =12
23:12 =23
11:34am =11
11:34pm =23
Voici un exemple montrant comment exploiter la fonction avec le temps courant :
Voir également
Articles - Les géants de l'informatique - Microsoft
Dernière mise à jour : Vendredi, le 10 octobre 2014