Formats de date/heure définis par l'utilisateur (fonction Format)

Article
09/12/2008

Mise à jour : novembre 2007

Le tableau suivant montre les caractères que vous pouvez utiliser pour créer des formats de date/heure définis par l'utilisateur : Ces caractères de format respectent la casse, alors que ça n'était pas le cas dans les versions précédentes de Visual Basic.

Caractère	Description
(:)	Séparateur d'heure. Dans certains paramètres régionaux, d'autres caractères peuvent être utilisés pour représenter le séparateur d'heure. Le séparateur d'heure sépare les heures, les minutes et les secondes lorsque les valeurs d'heure sont mises en forme. Le caractère réel utilisé comme séparateur d'heure dans le résultat mis en forme est déterminé par la valeur de la culture actuelle de votre application.
(/)	Séparateur de date. Dans certains paramètres régionaux, d'autres caractères peuvent être utilisés pour représenter le séparateur de date. Le séparateur de date sépare le jour, le mois et l'année lorsque les valeurs de date sont mises en forme. Le caractère réel utilisé comme séparateur de date dans le résultat mis en forme est déterminé par la culture actuelle de votre application.
(%)	Utilisé pour indiquer que le caractère suivant doit être lu comme un format d'une seule lettre sans tenir compte des lettres de fin. Utilisé également pour indiquer qu'un format d'une seule lettre est lu comme un format défini par l'utilisateur. Consultez ce qui suit pour des détails supplémentaires.
d	Affiche le jour sous la forme d'un nombre sans zéro non significatif (par exemple, 1). Utilisez %d s'il s'agit du seul caractère dans le format numérique défini par l'utilisateur.
dd	Affiche le jour sous la forme d'un nombre avec un zéro non significatif (par exemple, 01).
ddd	Affiche le jour sous la forme d'une abréviation (par exemple, Sun).
dddd	Affiche le jour sous la forme d'un nom complet (par exemple, Sunday).
M	Affiche le mois sous la forme d'un nombre sans zéro non significatif (par exemple, janvier correspond à 1). Utilisez %M s'il s'agit du seul caractère dans le format numérique défini par l'utilisateur.
MM	Affiche le mois sous la forme d'un nombre avec un zéro non significatif (par exemple, 01/12/01).
MMM	Affiche le mois sous la forme d'une abréviation (par exemple, Jan).
MMMM	Affiche le mois sous la forme d'un nom de mois complet (par exemple, January).
gg	Affiche la chaîne de période/ère (par exemple, A.D.).
h	Affiche l'heure sous la forme d'un nombre sans zéros non significatifs en utilisant l'horloge au format 12 heures (par exemple, 1:15:15 PM). Utilisez %h s'il s'agit du seul caractère dans le format numérique défini par l'utilisateur.
hh	Affiche l'heure sous la forme d'un nombre avec des zéros non significatifs en utilisant l'horloge au format 12 heures (par exemple, 01:15:15 PM).
H	Affiche l'heure sous la forme d'un nombre sans zéros non significatifs en utilisant l'horloge au format 24 heures (par exemple, 1:15:15). Utilisez %H s'il s'agit du seul caractère dans le format numérique défini par l'utilisateur.
HH	Affiche l'heure sous la forme d'un nombre avec des zéros non significatifs en utilisant l'horloge au format 24 heures (par exemple, 01:15:15).
m	Affiche les minutes sous la forme d'un nombre sans zéros non significatifs (par exemple, 12:1:15). Utilisez %m s'il s'agit du seul caractère dans le format numérique défini par l'utilisateur.
mm	Affiche les minutes sous la forme d'un nombre avec des zéros non significatifs (par exemple, 12:01:15).
s	Affiche les secondes sous la forme d'un nombre sans zéros non significatifs (par exemple, 12:15:5). Utilisez %s s'il s'agit du seul caractère dans le format numérique défini par l'utilisateur.
ss	Affiche les secondes sous la forme d'un nombre avec des zéros non significatifs (par exemple, 12:15:05).
f	Affiche les fractions de secondes. Par exemple, ff affiche les centièmes de secondes, tandis que ffff affiche les dizaines de milliers de secondes. Vous pouvez utiliser jusqu'à 7 symboles f dans un format défini par l'utilisateur. Utilisez %f s'il s'agit du seul caractère dans le format numérique défini par l'utilisateur.
t	Utilise l'horloge au format 12 heures et affiche la lettre A majuscule pour toutes les heures avant midi ; affiche la lettre P majuscule pour toutes les heures entre midi et 11:59 P.M. Utilisez %t s'il s'agit du seul caractère dans le format numérique défini par l'utilisateur.
tt	Pour les paramètres régionaux qui utilisent l'horloge au format 12 heures, affiche AM en majuscules pour toutes les heures avant midi ; affiche PM en majuscules pour toutes les heures entre midi et 11:59 P.M. Pour les paramètres régionaux qui utilisent l'horloge au format 24 heures, n'affiche rien.
y	Affiche l'année sous la forme d'un nombre (0-9) sans zéros non significatifs. Utilisez %y s'il s'agit du seul caractère dans le format numérique défini par l'utilisateur.
yy	Affiche l'année sous un format numérique à deux chiffres avec un zéro non significatif, le cas échéant.
yyy	Affiche l'année sous un format numérique à quatre chiffres.
yyyy	Affiche l'année sous un format numérique à quatre chiffres.
z	Affiche le décalage horaire sous la forme d'un nombre sans zéro non significatif (par exemple, -8). Utilisez %z s'il s'agit du seul caractère dans le format numérique défini par l'utilisateur.
zz	Affiche le décalage horaire sous la forme d'un nombre avec un zéro non significatif (par exemple, -08).
zzz	Affiche le décalage horaire complet (par exemple, -08:00).

Pour plus d'informations sur les informations de culture actuelles de l'application, consultez Comment les informations de culture affectent les chaînes dans Visual Basic.

Exemple

Voici des exemples de formats de date et d'heure définis par l'utilisateur pour December 7, 1958, 8:50 PM, 35 seconds :

Format	Affiche
M/d/yy	12/7/58
d-MMM	7-Dec
d-MMMM-yy	7-December-58
d MMMM	7 December
MMMM yy	December 58
hh:mm tt	08:50 PM
h:mm:ss t	8:50:35 P
H:mm	20:50
H:mm:ss	20:50:35
M/d/yyyy H:mm	12/7/1958 20:50

Notes du développeur sur Smart Device

La résolution de l'heure minimale pour un périphérique est déterminée par le fabricant du périphérique. Si la résolution d'heure pour le périphérique est assez approximative, le caractère de mise en forme f retourne 0 en cas d'exécution sur ce périphérique.