DATEADD |
Ajout de date |
|---|---|
| ASP 3.0 | |
Syntaxe
| Function DateAdd(interval,number,date) |
Paramètres
| Nom | Description | |
|---|---|---|
| interval | Ce paramètre permet d'indiquer le type d'intervalle de temps à ajouter : | |
| Valeur | Description | |
| "yyyy" | Cette valeur permet d'indiquer une année | |
| "q" | Cette valeur permet d'indiquer un trimestre | |
| "m" | Cette valeur permet d'indiquer un mois | |
| "y" | Cette valeur permet d'indiquer des jours dans l'année | |
| "d" | Cette valeur permet d'indiquer un jour | |
| "w" | Cette valeur permet d'indiquer un jour de semaine | |
| "ww" | Cette valeur permet d'indiquer une semaine de l'année | |
| "h" | Cette valeur permet d'indiquer l'heure | |
| "n" | Cette valeur permet d'indiquer les minutes | |
| "s" | Cette valeur permet d'indiquer les secondes | |
| number | Ce paramètre permet d'indiquer la quantité à appliquer à l'intervalle | |
| date | Ce paramètre permet d'indiquer la date sur laquelle il faut effectuer le calcul | |
Description
Cette fonction retourne une date avec une expression de temps ajouté.
Remarques
- La fonction DateAdd permet de manipuler facilement les dates en ajoutant (ou soustrayant, via des valeurs négatives) un intervalle spécifique à une date donnée. Cela la rend idéale pour des opérations comme le calcul d'une échéance, la gestion d'abonnements ou le contrôle de périodes.
- Le paramètre interval attend une chaîne de caractères abrégée qui précise le type d'ajout temporel à effectuer. Par exemple, "m" pour les mois, "d" pour les jours, ou "h" pour les heures. Ces codes doivent être respectés précisément pour éviter des erreurs d'exécution.
- Le deuxième paramètre, number, peut être positif ou négatif, ce qui permet d'ajouter ou de soustraire du temps. Cela rend la fonction très souple pour les calculs relatifs aux dates, comme la détermination de dates passées ou futures.
- La valeur retournée est une date complète, compatible avec les autres fonctions de traitement des dates. On peut ainsi chaîner DateAdd avec des fonctions comme FormatDateTime, DateDiff, ou Day/Month/Year pour une analyse plus précise.
- Un cas d'usage courant consiste à ajouter un nombre fixe de jours à la date du jour (Date()), ce qui est particulièrement utile pour créer des délais ou des alertes automatiques dans les systèmes web (ex. : "répondre dans 7 jours").
- L'intervalle "w" (jour de semaine) saute automatiquement les fins de semaines dans certaines implémentations, mais cela dépend du paramétrage régional et peut donc ne pas toujours fonctionner comme prévu, ce qui nécessite de tester dans l'environnement cible.
- DateAdd est souvent utilisé dans des systèmes de réservation, de gestion de calendrier ou de suivi de projet pour ajuster des dates en fonction d'événements planifiés ou de retards.
- Bien que simple à utiliser, DateAdd peut produire des résultats inattendus si l'on manipule des dates à la frontière de mois ou d'années (exemple : ajouter un mois au 31 janvier). Il est donc important de vérifier le comportement dans ces cas limites.
Exemple
Voici un exemple d'une utilisation typique de cette fonction :
- <%
- Response.Write "d=" & DateAdd("d",1,"2010-01-09") & "<br />"
- Response.Write "h=" & DateAdd("h",1,"2010-01-09 05:30:00") & "<br />"
- Response.Write "m=" & DateAdd("m",1,"2010-01-09") & "<br />"
- Response.Write "n=" & DateAdd("n",1,"2010-01-09 05:30:00") & "<br />"
- Response.Write "q=" & DateAdd("q",1,"2010-01-09") & "<br />"
- Response.Write "s=" & DateAdd("s",1,"2010-01-09 05:30:00") & "<br />"
- Response.Write "w=" & DateAdd("w",1,"2010-01-09") & "<br />"
- Response.Write "ww=" & DateAdd("ww",1,"2010-01-09") & "<br />"
- Response.Write "y=" & DateAdd("y",1,"2010-01-09") & "<br />"
- Response.Write "yyyy=" & DateAdd("yyyy",1,"2010-01-09") & "<br />"
- %>
on obtiendra le résultat suivant :
d=10/01/2010h=09/01/2010 06:30:00
m=09/02/2010
n=09/01/2010 05:31:00
q=09/04/2010
s=09/01/2010 05:30:01
w=10/01/2010
ww=16/01/2010
y=10/01/2010
yyyy=09/01/2011
Voir également
Articles - Les géants de l'informatique - Microsoft
Dernière mise à jour : Vendredi, le 10 octobre 2014