DATESERIAL |
Date en série |
|---|---|
| ASP 3.0 | |
Syntaxe
| Function 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 DateSerial permet de construire une date valide à partir de trois éléments distincts : l'année, le mois et le jour. Cela en fait un outil idéal pour créer dynamiquement des dates à partir de données numérales, souvent issues de formulaires ou de calculs.
- Contrairement à la saisie d'une date littérale, DateSerial garantit un formatage uniforme de la date, quelle que soit la configuration régionale du serveur. Cela permet d'éviter les erreurs de confusion entre les formats anglo-saxons (MM/JJ/AAAA) et européens (JJ/MM/AAAA).
- L'un des avantages de DateSerial est sa souplesse avec les valeurs hors plage. Par exemple, si vous passez 13 comme mois, la fonction renverra une date du mois de janvier de l'année suivante. Cela permet de faire des calculs sans craindre une erreur de dépassement.
- La fonction est particulièrement utile pour générer des intervalles de dates ou initialiser des plages, comme une date de début de mois (DateSerial(2025, 4, 1)) ou de fin d'année (DateSerial(2025, 12, 31)), ce qui est très pratique pour les filtres temporels.
- DateSerial accepte aussi des valeurs négatives pour les jours ou mois, et effectue un ajustement logique. Par exemple, DateSerial(2025, 1, -1) retourne le 30 décembre 2024. Cela peut simplifier certains calculs de date sans devoir recourir à des fonctions comme DateAdd.
- Il est essentiel que les arguments de DateSerial soient de type entier. Toute tentative de passer une chaîne ou un type incorrect peut provoquer une erreur d'exécution, ce qui nécessite une validation préalable des données reçues.
- En ASP 3.0, DateSerial est très utile dans des scripts générant des rapports automatisés, car il permet de créer des points fixes dans le temps, à comparer avec des données de base ou la date système via DateDiff, DatePart ou autres.
- Couplée avec des boucles, la fonction DateSerial permet de générer des séquences de dates, par exemple pour construire un calendrier, un planificateur, ou des titres de section mensuels. Cela rend son usage très fréquent dans des contextes de gestion du temps ou de publication.
Exemple
Voici un exemple d'une utilisation typique de cette fonction :
- <%
- Response.Write "2010,01,09=" & DateSerial(2010,01,09) & "<br />"
- Response.Write "2011,12,03=" & DateSerial(2011,12,03) & "<br />"
- Response.Write "12,12,03=" & DateSerial(12,12,03) & "<br />"
- %>
on obtiendra le résultat suivant :
2010,01,09=09/01/20102011,12,03=03/12/2011
12,12,03=03/12/2012
Voir également
Articles - Les géants de l'informatique - Microsoft
Dernière mise à jour : Vendredi, le 10 octobre 2014