DATESERIAL |
Date en série |
|---|---|
| Access 2019, Access 2016, Access 2013, Access 2010, Access 2007, Access 2003, Access XP, Access 2000 | Microsoft Access |
Syntaxe
| DateSerial(year,month,day) |
Paramètres
| Nom | Description | |
|---|---|---|
| year | Ce paramètre permet d'indiquer l'année | |
| month | Ce paramètre permet d'indiquer le mois : | |
| Valeur | Description | |
| 1 | Cette valeur permet d'indiquer le mois de Janvier | |
| 2 | Cette valeur permet d'indiquer le mois de Février | |
| 3 | Cette valeur permet d'indiquer le mois de Mars | |
| 4 | Cette valeur permet d'indiquer le mois d'Avril | |
| 5 | Cette valeur permet d'indiquer le mois de Mai | |
| 6 | Cette valeur permet d'indiquer le mois de Juin | |
| 7 | Cette valeur permet d'indiquer le mois de Juillet | |
| 8 | Cette valeur permet d'indiquer le mois d'Août | |
| 9 | Cette valeur permet d'indiquer le mois de Septembre | |
| 10 | Cette valeur permet d'indiquer le mois d'Octobre | |
| 11 | Cette valeur permet d'indiquer le mois de Novembre | |
| 12 | Cette valeur permet d'indiquer le mois de Décembre | |
| day | Ce paramètre permet d'indiquer le jour (valeur entre 1 et 31) | |
Description
Cette fonction permet de créer une date à partir de paramètre de temps.
Remarques
- La fonction construit une date à partir de ses composantes : La fonction DateSerial permet de créer une valeur de type Date/Heure en fournissant séparément l'année, le mois et le jour. Contrairement à une conversion de texte avec CDate, il n'est pas nécessaire de respecter un format régional particulier. Cette méthode est plus fiable lorsqu'une date est calculée à partir de valeurs numériques.
- Les paramètres sont tous de type numérique : La fonction attend trois valeurs numériques correspondant respectivement à l'année, au mois et au jour. Ces valeurs peuvent être des constantes, des variables, des champs de table ou le résultat d'expressions mathématiques. Cette souplesse facilite la génération dynamique de dates dans les applications Access.
- La fonction ajuste automatiquement les valeurs hors limites : L'un des principaux avantages de DateSerial est sa capacité à normaliser automatiquement les dates. Par exemple, DateSerial(2026, 13, 1) retourne le 1er janvier 2027, tandis que DateSerial(2026, 0, 15) retourne le 15 décembre 2025. Cette fonctionnalité simplifie les calculs de dates sans nécessiter de traitements supplémentaires.
- Les jours dépassant la fin du mois sont également pris en charge : Si le paramètre day dépasse le nombre de jours du mois indiqué, Access reporte automatiquement l'excédent sur le mois suivant. Par exemple, DateSerial(2026, 2, 35) produit une date située au début du mois de mars. Cette gestion automatique évite au développeur d'avoir à vérifier manuellement la longueur de chaque mois.
- La fonction tient compte des années bissextiles : DateSerial applique les règles du calendrier grégorien utilisées par Windows. Elle reconnaît automatiquement les années bissextiles et accepte donc le 29 février lorsqu'il est valide. Cette prise en charge garantit des résultats cohérents pour les calculs calendaires complexes.
- Elle est idéale pour construire des dates calculées : Dans de nombreuses applications Access, les différentes composantes d'une date sont entreposées séparément ou calculées individuellement. DateSerial permet alors de les regrouper afin d'obtenir une véritable valeur Date/Heure. Cette approche est souvent plus simple et plus sûre que la concaténation de chaînes de caractères.
- Elle est fréquemment utilisée avec les fonctions Year, Month et Day : Il est courant d'extraire les composantes d'une date grâce aux fonctions Year, Month et Day, puis de construire une nouvelle date avec DateSerial. Cette combinaison permet par exemple de calculer le premier jour d'un mois, le dernier jour d'une année ou une date anniversaire. Ces traitements sont très fréquents dans les applications de gestion.
- La fonction est disponible dans les requêtes et dans le code VBA : DateSerial peut être utilisée aussi bien dans les requêtes SQL que dans les formulaires, les états, les macros et les modules VBA. Elle permet ainsi de générer des dates directement dans des expressions calculées sans devoir écrire une procédure spécifique. Son comportement est identique dans tous ces environnements.
- Elle évite les problèmes liés aux formats régionaux : Contrairement aux chaînes de caractères représentant une date, les paramètres numériques de DateSerial ne dépendent pas du format de date configuré dans Windows. Cela réduit les risques d'interprétation incorrecte entre le format jour/mois/année et le format mois/jour/année. Cette caractéristique en fait une méthode recommandée pour créer des dates dans les applications destinées à plusieurs pays.
- La fonction est compatible avec toutes les versions modernes de Microsoft Access : La fonction DateSerial est présente depuis les premières versions de Microsoft Access 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 la portabilité des applications utilisant cette fonction sur les différentes générations d'Access.
Exemple
Voici un exemple de comment utiliser la fonction DateSerial dans Microsoft Access :
DateSerial (2004, 6, 30)
Résultat: '6/30/2004'
DateSerial (2004-1, 6, 30)
Résultat: '6/30/2003'
DateSerial (2004, 6-2, 14)
Résultat: '4/14/2004'
Exemple de code VBA
La fonction DateSerial peut être utilisée dans le code VBA de Microsoft Access.
Par exemple :
Dim LDate As Date
LDate = DateSerial (2004, 5, 31)
Dans cet exemple, la variable appelée LDate contiendrait désormais la valeur «31/05/2004».
Dernière mise à jour : Mardi, le 28 juillet 2015