TIMESERIAL |
Heure en série |
|---|---|
| Access 2019, Access 2016, Access 2013, Access 2010, Access 2007, Access 2003, Access XP, Access 2000 | Microsoft Access |
Syntaxe
| TimeSerial(hour,minute,second) |
Paramètres
| Nom | Description |
|---|---|
| hour | Ce paramètre permet d'indiquer l'heure |
| minute | Ce paramètre permet d'indiquer les minutes |
| second | Ce paramètre permet d'indiquer les secondes |
Description
Cette fonction permet de créer une heure à partir de paramètre de temps.
Remarques
- La fonction construit une heure à partir de ses composantes : La fonction TimeSerial permet de créer une valeur de type Heure en utilisant séparément les heures, les minutes et les secondes. Elle retourne une valeur Date/Heure représentant l'heure correspondante. Cette approche est souvent plus pratique que la manipulation de chaînes de caractères.
- Les trois paramètres sont numériques : Les paramètres hour, minute et second doivent contenir des valeurs numériques représentant respectivement les heures, les minutes et les secondes. Ils peuvent être des constantes, des variables ou le résultat d'une expression. Cette souplesse facilite la création dynamique d'heures dans les applications.
- La fonction normalise automatiquement les dépassements : TimeSerial accepte des valeurs qui dépassent les limites habituelles des heures, des minutes ou des secondes. Par exemple, 75 minutes seront automatiquement converties en 1 heure et 15 minutes. Cette normalisation évite au développeur de devoir effectuer lui-même les calculs de retenue.
- Elle peut également gérer des valeurs négatives : Les paramètres peuvent contenir des valeurs négatives, qui sont automatiquement ajustées par Access. Par exemple, une valeur négative pour les secondes ou les minutes provoquera un emprunt sur l'unité supérieure. Cette fonctionnalité simplifie certains calculs temporels complexes.
- Elle retourne une valeur de type Date/Heure : Même si seuls les éléments de l'heure sont fournis, le résultat est une valeur Date/Heure reconnue par Microsoft Access. Cette valeur peut être utilisée dans des calculs, des comparaisons ou être affichée avec différents formats. Elle est donc compatible avec toutes les autres fonctions de gestion des dates et des heures.
- Elle est souvent utilisée avec Hour, Minute et Second : Il est fréquent d'extraire les composantes d'une heure avec Hour, Minute et Second, puis de reconstruire une nouvelle heure à l'aide de TimeSerial. Cette technique permet de modifier uniquement certaines composantes tout en conservant les autres. Elle est très utile dans les traitements temporels.
- Elle est disponible dans les requêtes et dans le code VBA : La fonction TimeSerial peut être utilisée dans les requêtes SQL, les formulaires, les états, les macros ainsi que dans les modules VBA. Elle permet de construire directement une heure dans une expression Access. Son comportement est identique dans tous les contextes d'utilisation.
- Elle facilite les calculs d'horaires : TimeSerial est particulièrement utile pour créer des horaires, des heures de rendez-vous ou des plages de travail à partir de valeurs calculées. Elle permet de manipuler les composantes du temps sans avoir à effectuer de concaténation de chaînes. Cette approche est plus fiable et plus facile à maintenir.
- Elle est complémentaire de DateSerial et Now : Alors que DateSerial construit une date à partir de l'année, du mois et du jour, TimeSerial construit une heure à partir des heures, des minutes et des secondes. Les deux fonctions peuvent être combinées pour créer une date et une heure complètes. Elles sont fréquemment utilisées avec Now, Date et Time dans les applications Access.
- La fonction est compatible avec toutes les versions modernes de Microsoft Access : La fonction TimeSerial est disponible depuis les premières versions de Microsoft Access intégrant VBA et son fonctionnement est demeuré stable au fil des années. Elle est compatible avec Access 2000, Access XP, Access 2003, Access 2007, Access 2010, Access 2013, Access 2016 ainsi qu'avec Microsoft 365. Cette stabilité garantit que les applications utilisant cette fonction continueront de produire des résultats cohérents lors des migrations vers des versions plus récentes d'Access.
Exemple
Voyons comment utiliser la fonction TimeSerial dans Microsoft Access :
TimeSerial (14, 6, 30)
Résultat: 2:06:30 PM
TimeSerial (20 - 8, 6, 30)
Résultat: 12:06:30 PM
TimeSerial (8, 6-2, 14)
Résultat: 8:04:14 AM
TimeSerial (7, -15, 50)
Résultat: 6:45:50 AM
Exemple de code VBA
La fonction TimeSerial peut être utilisée dans le code VBA de Microsoft Access.
Par exemple :
Dim LTime As Date
LTime = TimeSerial (23, 5, 31)
Dans cet exemple, la variable appelée LTime contiendrait désormais la valeur «23:05:31».
Dernière mise à jour : Mardi, le 28 juillet 2015