FORMATDATETIME |
Format date et heure |
|---|---|
| Visual Basic | |
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
- L'exemple suivant utilise la fonction FormatDateTime pour formater l'expression en tant que date longue et l'affecter à MyDateTime :
- Function GetCurrentDate
- ' FormatDateTime formats Date en date longue
- GetCurrentDate = FormatDateTime(Date, 1)
- End Function
- La fonction FormatDateTime est une méthode pratique pour appliquer des formats prédéfinis aux dates et heures, sans avoir à construire manuellement une chaîne de format. Elle simplifie donc le traitement des affichages temporels dans les interfaces utilisateur ou les rapports.
- Le paramètre format accepte des valeurs numériques de 0 à 4, chacune correspondant à un format précis de date ou d'heure. Cette structure facilite la sélection rapide d'un affichage courant, comme une date courte (2) ou une heure complète avec secondes (3), sans devoir retenir une syntaxe complexe.
- Le format par défaut (valeur 0) est particulièrement utile car il combine date et heure dans un style courant, ce qui est idéal pour une sortie rapide, lisible, et surtout standardisée pour les applications de gestion ou de suivi temporel.
- Le format 1, qui retourne une date longue avec le nom du jour et du mois, est particulièrement adapté aux présentations ou aux documents destinés à être lus par des utilisateurs finaux, car il est plus expressif que les formats numériques.
- Même si FormatDateTime ne permet pas autant de personnalisation que la fonction Format, elle est plus rapide à mettre en oeuvre pour des cas d'usage courants, ce qui en fait un excellent outil pour les développeurs recherchant simplicité et efficacité.
- Le format 4, qui affiche uniquement l'heure sans les secondes, est utile dans des situations où la précision temporelle n'est pas essentielle, comme pour des rendez-vous, des journaux d'activité ou des interfaces allégées.
- La fonction accepte comme paramètre une date déjà convertie ou une chaîne représentant une date valide. Elle est donc flexible au niveau des données d'entrée, ce qui permet de l'utiliser aussi bien avec des constantes qu'avec des résultats issus de calculs ou de saisies utilisateur.
- Enfin, FormatDateTime est particulièrement utile dans un contexte multilingue, car elle s'appuie sur les paramètres régionaux du système pour afficher les noms des jours et des mois dans la langue appropriée. Cela en fait un bon choix pour des logiciels à portée internationale.
Exemple
Voici un exemple d'une utilisation typique de cette fonction :
- Sub Main()
- MsgBox "0=" & FormatDateTime("2010-01-09",0) & vbCrLf & _
- "1=" & FormatDateTime("2010-01-09",1) & vbCrLf & _
- "2=" & FormatDateTime("2010-01-09",2) & vbCrLf & _
- "3=" & FormatDateTime("2010-01-09",3) & vbCrLf & _
- "4=" & FormatDateTime("2010-01-09",4)
- End Sub
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
Dernière mise à jour : Lundi, le 19 novembre 2012