@DATEFMT[date,format] - Formate une date/heure dans un format personnalisé.
date - La date à formater (au format aaaa-mm-jj hh:mm:ss). Si date est *, @DATEFMT prend par défaut la date et l'heure actuelles. Les dates valables vont du 1er janvier 1970 (1970-1-1) au 31 décembre 3000 (3000-12-31). L'heure doit être au format 24 heures. Si vous omettez l'heure, @DATEFMT sera formaté à 00:00:00.
format - Le format personnalisé à utiliser. (Notez que les % devront normalement être doublés ou échappés pour éviter que TCC ne les développe avant que @DATEFMT ne les voie). Les options de formatage sont les suivantes :
Code |
Chaîne de remplacement |
%a |
Nom abrégé du jour de la semaine dans la locale |
%A |
Nom complet du jour de la semaine dans la locale |
%b |
Nom abrégé du mois dans la locale |
%B |
Nom complet du mois dans la locale |
%c |
Représentation de la date et de l'heure dans le "C Locale" - équivalent à "%a %b %e %T %Y" |
%C |
L'année divisée par 100 et tronquée en un entier, sous forme de nombre décimal (00-99) |
%d |
Le jour du mois sous forme de nombre décimal (01 - 31) |
%D |
Équivalent à %m/%d/%y |
%e |
Jour du mois sous forme de nombre décimal (1 - 31), où les chiffres simples sont précédés d'un espace |
%F |
Équivalent à%Y-%m-%d |
%g |
Les deux derniers chiffres de l'année hebdomadaire ISO 8601 (00 - 99) |
%G |
L'année basée sur la semaine ISO 8601 sous forme de nombre décimal |
%h |
Nom abrégé du mois (équivalent à %b) |
%H |
Heure au format 24 heures (00 - 23) |
%I |
Heure au format 12 heures (01 - 12) |
%j |
Jour de l'année en nombre décimal (001 - 366) |
%m |
Mois en nombre décimal (01 - 12) |
%M |
Minute sous forme de nombre décimal (00 - 59) |
%n |
Un caractère de retour à la ligne (\n) |
%p |
L'indicateur A.M./P.M. de la région pour l'horloge de 12 heures |
%r |
L'heure de l'horloge 12 heures de la région |
%R |
Équivalent à %H:%M |
%S |
Seconde sous forme de nombre décimal (00 - 59) |
%t |
Un caractère de tabulation horizontale (\t) |
%T |
Équivalent à%H:%M:%S, le format de l'heure ISO 8601 |
%u |
Le jour de la semaine ISO 8601 sous forme de nombre décimal (1 - 7 ; lundi est 1) |
%U |
Numéro de semaine de l'année sous forme de nombre décimal (00 - 53), le premier dimanche étant le premier jour de la semaine 1 |
%V |
Numéro de semaine ISO 8601 sous forme de nombre décimal (00 - 53) |
%w |
Jour de la semaine sous forme de nombre décimal (0 - 6 ; le dimanche est 0) |
%W |
Numéro de semaine de l'année sous forme de nombre décimal (00 - 53), le premier lundi étant le premier jour de la semaine 1 |
%x |
Représentation de la date pour la locale |
%X |
Représentation de l'heure pour la région |
%y |
Année sans siècle, en nombre décimal (00 - 99) |
%Y |
Année avec siècle, en nombre décimal |
%z |
Décalage par rapport à l'UTC au format ISO 8601 ; pas de caractères si le fuseau horaire est inconnu |
%Z |
Le nom ou l'abréviation du fuseau horaire de la locale, en fonction des paramètres du registre ; aucun caractère si le fuseau horaire est inconnu. |
%% |
Signe de pourcentage |
Les caractères qui ne commencent pas par un % sont affichés sans modification.
Le drapeau# peut précéder n'importe quel code de formatage. Dans ce cas, la signification du code de formatage est modifiée comme suit :
Format code |
Meaning |
%#a, %#A, %#b, %#B, %#g, %#G, %#h, %#n, %#p, %#t, %#u, %#w, %#X, %#z, %#Z, %#% |
L' indicateur# est ignoré. |
%#c |
Représentation longue de la date et de l'heure, adaptée à la locale. Par exemple : "Tuesday, February 25, 2020, 12:41:29". |
%#x |
Représentation longue de la date, adaptée aux paramètres locaux. Par exemple : "Tuesday, February 25, 2020". |
%#d, %#D, %#e, %#F, %#H, %#I, %#j, %#m, %#M, %#r, %#R, %#S, %#T, %#U, %#V, %#W, %#y, %#Y |
Supprimez les zéros ou les espaces en tête (le cas échéant). |
La semaine ISO 8601 et l'année basée sur la semaine produite par %V, %g et %G utilisent une semaine qui commence le lundi, où la semaine 1 est la semaine qui contient le 4 janvier, qui est la première semaine qui comprend au moins quatre jours de l'année. Si le premier lundi de l'année est le 2, le 3 ou le 4, les jours précédents font partie de la dernière semaine de l'année précédente. Pour ces jours, %V est remplacé par 53, et %g et %G sont remplacés par les chiffres de l'année précédente.