DATEPART |
Partie de la date |
|---|---|
| ASP 3.0 | |
Syntaxe
| Function DatePart(interval,date[,firstdayofweek[,firstweekofyear]]) ) |
Paramètres
| Nom | Description | ||
|---|---|---|---|
| interval | Ce paramètre permet d'indiquer le type d'intervalle de temps à retourner : | ||
| 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 | ||
| date | Ce paramètre permet d'indiquer la date sur laquelle il faut effectuer le calcul | ||
| firstdayofweek | Ce paramètre optionnel permet d'indiquer le premier jour de la semaine. Les valeurs possibles sont : | ||
| Valeur | Constante | Description | |
| 0 | vbUseSystemDayOfWeek | Cette valeur permet d'indiquer qu'il faut utiliser le NLS (National Language Support) | |
| 1 | vbSunday | Cette valeur permet d'indiquer qu'il faut utiliser le Dimanche. C'est la valeur par défaut. | |
| 2 | vbMonday | Cette valeur permet d'indiquer qu'il faut utiliser le Lundi. | |
| 3 | vbTuesday | Cette valeur permet d'indiquer qu'il faut utiliser le Mardi. | |
| 4 | vbWednesday | Cette valeur permet d'indiquer qu'il faut utiliser le Mercredi. | |
| 5 | vbThursday | Cette valeur permet d'indiquer qu'il faut utiliser le Jeudi. | |
| 6 | vbFriday | Cette valeur permet d'indiquer qu'il faut utiliser le Vendredi. | |
| 7 | vbSaturday | Cette valeur permet d'indiquer qu'il faut utiliser le Samedi. | |
| firstweekofyear | Ce paramètre optionnel permet d'indiquer le premier jour de l'année. Les valeurs possibles sont : | ||
| Valeur | Constante | Description | |
| 0 | vbUseSystem | Cette valeur permet d'indiquer qu'il faut utiliser le NLS (National Language Support) | |
| 1 | vbFirstJan1 | Cette valeur permet d'indiquer qu'il faut commencer avec la semaine du premier 1 janvier. C'est la valeur par défaut. | |
| 2 | vbFirstFourDays | Cette valeur permet d'indiquer qu'il faut commencer dans les 4 derniers jours de la semaine de la nouvelle année. | |
| 3 | vbFirstFullWeek | Cette valeur permet d'indiquer qu'il faut commencer dans la premier semaine complète de la nouvelle année. | |
Description
Cette fonction permet de demander la valeur numérique d'une partie de la date spécifié.
Remarques
- La fonction DatePart permet d'extraire une partie spécifique d'une date, comme l'année, le mois, le jour, l'heure,..., sous forme de valeur numérique. C'est un outil puissant pour analyser ou filtrer des données temporelles dans un script ASP.
- Le paramètre interval détermine la composante de la date à retourner. Il faut utiliser une chaîne abrégée, comme "yyyy" pour l'année ou "m" pour le mois. Une erreur de frappe dans ce paramètre entraînera un comportement inattendu ou une erreur d'exécution.
- Cette fonction est particulièrement utile lorsqu'on veut effectuer des groupements temporels, comme tous les enregistrements du même mois, du même jour de la semaine ou de la même semaine de l'année. Cela permet d'organiser et de présenter les données de façon plus lisible.
- Les paramètres firstdayofweek et firstweekofyear, bien que facultatifs, deviennent essentiels lorsque l'on travaille avec les intervalles "w" ou "ww", pour assurer que les calculs de semaines soient cohérents avec la logique métier ou régionale.
- DatePart retourne toujours un entier correspondant à la partie extraite. Par exemple, DatePart("m", Date()) retourne 4 en avril. Cela permet des comparaisons ou des tris directs sans conversion supplémentaire, ce qui allège les traitements dans le code.
- Lorsque l'on utilise l'intervalle "w" pour le jour de la semaine, le jour retourné dépend du premier jour de la semaine défini. Ainsi, un même jour pourrait avoir des valeurs différentes selon que la semaine commence le dimanche ou le lundi.
- En combinant DatePart avec Now() ou Date(), on peut facilement identifier si un événement se produit aujourd'hui, ce mois-ci, ou cette année, en comparant simplement la valeur retournée à la date système actuelle.
- DatePart est très utile dans des contextes d'affichage personnalisé, par exemple pour afficher uniquement le numéro de la semaine dans un calendrier ou pour créer des filtres dynamiques (exemple : tous les enregistrements du "3e trimestre").
Exemple
Voici un exemple d'une utilisation typique de cette fonction :
- <%
- Response.Write "d=" & DatePart("d","2010-01-09") & "<br />"
- Response.Write "h=" & DatePart("h","2010-01-09 05:30:00") & "<br />"
- Response.Write "m=" & DatePart("m","2010-01-09") & "<br />"
- Response.Write "n=" & DatePart("n","2010-01-09 05:30:00") & "<br />"
- Response.Write "q=" & DatePart("q","2010-01-09") & "<br />"
- Response.Write "s=" & DatePart("s","2010-01-09 05:30:00") & "<br />"
- Response.Write "w=" & DatePart("w","2010-01-09") & "<br />"
- Response.Write "ww=" & DatePart("ww","2010-01-09") & "<br />"
- Response.Write "y=" & DatePart("y","2010-01-09") & "<br />"
- Response.Write "yyyy=" & DatePart("yyyy","2010-01-09") & "<br />"
- %>
on obtiendra le résultat suivant :
d=9h=5
m=1
n=30
q=1
s=0
w=7
ww=2
y=9
yyyy=2010
Voir également
Articles - Les géants de l'informatique - Microsoft
Dernière mise à jour : Vendredi, le 10 octobre 2014