FORMATDATETIME |
Format date et heure |
|---|---|
| ASP 3.0 | |
Syntaxe
| Function FormatDateTime(date,format) |
Paramètres
| Nom | Description | |
|---|---|---|
| date | Ce paramètre permet d'indiquer la date à traiter | |
| format | Ce paramètre permet d'indiquer le format à retourner : | |
| Valeur | Description | |
| 0 | Cette valeur permet d'indiquer qu'il faut retourner une date de format «mm/jj/aa» et l`heure si spécifié au format «hh:mm:ss PM/AM». C'est la valeur par défaut. | |
| 1 | Cette valeur permet d'indiquer qu'il faut retourner une date de format «jourdesemaine, nomdumois, année» | |
| 2 | Cette valeur permet d'indiquer qu'il faut retourner une date de format «mm/dd/yy». | |
| 3 | Cette valeur permet d'indiquer qu'il faut retourner une date de format «hh:mm:ss PM/AM» | |
| 4 | Cette valeur permet d'indiquer qu'il faut retourner l'heure de format «hh:mm». | |
Description
Cette fonction retourne une expression formaté selon un format de date.
Remarques
- La fonction FormatDateTime permet de formater une date ou une heure de manière standardisée, selon différents styles prédéfinis. Cela évite d'avoir à construire manuellement des formats personnalisés en concaténant des morceaux de date. Elle est particulièrement utile pour afficher des données temporelles dans une interface utilisateur claire et cohérente.
- Le paramètre format accepte des valeurs numériques de 0 à 4, chacune correspondant à un style bien défini. Par exemple, 0 affiche une date courte avec heure en format 12 heures, alors que 1 génère une date longue très lisible. Cela permet d'adapter facilement la présentation au contexte (tableau de données, rapport, fiche détaillée...).
- Le format 1, retournant une date du type "Wednesday, March 12, 2025", est très utile pour une lecture naturelle par les utilisateurs. Il est souvent utilisé dans les pages publiques ou les rapports où l'élégance de l'affichage est importante. Cela permet aussi une meilleure localisation pour les utilisateurs anglophones.
- Le format 2 donne une date concise sous la forme mm/dd/yy, ce qui est souvent utilisé dans les interfaces techniques ou administratives. Cependant, ce format peut prêter à confusion à l'international, notamment en Europe où le jour précède généralement le mois. Il convient donc de faire attention au public cible avant de choisir ce style.
- Le format 3 retourne uniquement l'heure, avec les secondes et l'indication AM/PM, ce qui est utile pour les systèmes fonctionnant sur des cycles horaires précis. Par exemple, pour un système de pointage ou de planification d'événements. Il permet de mettre l'accent uniquement sur l'aspect temporel sans afficher la date.
- Le format 4 est encore plus minimaliste : il affiche uniquement l'heure en heures et minutes, sans les secondes ni indication AM/PM. C'est idéal pour des contextes où la précision à la minute suffit, comme un agenda simplifié ou un horaire de transport. Cela épure l'affichage sans perte d'information essentielle.
- Lorsque le paramètre format n'est pas précisé, la valeur par défaut 0 est utilisée, ce qui donne une date au format court accompagnée de l'heure si disponible. Ce comportement par défaut est généralement suffisant pour la majorité des usages classiques. Cependant, il peut être nécessaire de forcer un autre format pour mieux contrôler la présentation selon les besoins.
- FormatDateTime permet de s'assurer que les dates et heures sont affichées dans un format uniforme, ce qui est essentiel dans les interfaces utilisateurs multilingues ou multi-pays. Toutefois, il est important de noter que la sortie reste en anglais par défaut, sauf si le serveur est configuré pour un paramétrage régional différent. Cela peut nécessiter une adaptation complémentaire pour un affichage localisé en français.
Exemple
Voici un exemple d'une utilisation typique de cette fonction :
- <%
- Response.Write "0=" & FormatDateTime("2010-01-09",0) & "<br />"
- Response.Write "1=" & FormatDateTime("2010-01-09",1) & "<br />"
- Response.Write "2=" & FormatDateTime("2010-01-09",2) & "<br />"
- Response.Write "3=" & FormatDateTime("2010-01-09",3) & "<br />"
- Response.Write "4=" & FormatDateTime("2010-01-09",4) & "<br />"
- %>
on obtiendra le résultat suivant :
0=09/01/20101=samedi 9 janvier 2010
2=09/01/2010
3=00:00:00
4=00:00
Voir également
Articles - Les géants de l'informatique - Microsoft
Dernière mise à jour : Vendredi, le 10 octobre 2014