Syntaxe
|
Time( Hour, Minute, Second [, Milliseconds ] )
|
Paramètres
| Nom |
Description |
| Hour |
Ce paramètre spécifie la composante des heures de la valeur temporelle. Il doit être un nombre entier. |
| Minute |
Ce paramètre spécifie la composante des minutes de la valeur temporelle. |
| Second |
Ce paramètre spécifie la composante des secondes de la valeur temporelle. |
| Milliseconds |
Ce paramètre, facultatif, spécifie la composante des millisecondes de la valeur temporelle. |
Description
Cette fonction permet de créer une valeur de temps à partir de composants individuels (heure, minute, seconde).
Remarques
- La fonction Time est idéale pour générer des horaires précis à la volée : Elle permet de composer dynamiquement une valeur de type heure à partir
de données numériques. Cette construction est particulièrement utile lorsqu'on veut générer un horaire personnalisé sans passer par un champ de date/heure existant.
- Elle permet une séparation claire entre les composantes temporelles : Contrairement à des formats horaires encodés sous forme de texte, la fonction
Time autorise une manipulation indépendante des heures, minutes, secondes et millisecondes, ce qui simplifie les calculs et les ajustements de temps.
- Le paramètre facultatif Milliseconds offre une précision accrue : Lorsque des opérations nécessitent un niveau de détail supérieur à la seconde (par
exemple dans des calculs de performances ou de chronométrage), le quatrième paramètre permet d'affiner le temps généré, ce que peu de fonctions font nativement.
- Elle facilite la comparaison et le tri de valeurs temporelles : Une valeur générée avec Time peut facilement être comparée à d'autres heures, ce
qui permet des filtres logiques du type If(Time(14, 0, 0) < Now(), "Après-midi", "Matinée"). Cela améliore la logique conditionnelle dans les interfaces
utilisateur.
- Utile pour des interfaces de saisie manuelle d'horaires : Quand les utilisateurs doivent spécifier des horaires à partir de menus déroulants (pour heure,
minute,...), la fonction Time permet de reconstruire une valeur cohérente et valide à partir de ces sélections, tout en évitant les erreurs de format.
- Combinable avec d'autres fonctions de date pour créer des datetime complets : Bien que Time ne produise qu'une heure, on peut l'associer à une date
fixe avec la fonction DateAdd ou DateValue pour créer des valeurs complètes de type datetime, très pratiques pour la planification ou la gestion de
rendez-vous.
- Un bon outil pour le calcul de durées par différence entre deux horaires : En construisant deux horaires avec Time, on peut soustraire l'un de l'autre pour
obtenir une durée en heures. Cela permet par exemple de déterminer le temps écoulé entre deux événements ou la durée d'une activité.
- Peut produire des résultats inattendus si les paramètres sont mal validés : Il est important de s'assurer que les valeurs passées sont bien des entiers
valides. Par exemple, passer une heure supérieure à 23 ou une minute supérieure à 59 pourrait entraîner des erreurs ou des comportements non souhaités selon
l'implémentation.
Dernière mise à jour : Jeudi, le 1 Mai 2025