Modèle:Date-

Documentation

Ce modèle utilise le module Date, un script écrit dans le langage de programmation Lua. Toute expérimentation devrait être conduite d'abord via une sous-page bac à sable. Voir le Projet:Scribunto si vous voulez en savoir plus.

1 Utilisation

Ce modèle sert à créer une date sans liens, en évitant les retours à la ligne indésirables et en ajoutant une balise <time> invisible contenant une date normalisée lisible par les bots.

2 Résumé des actions liées à l'emploi de ce format

Le modèle {{date-|jour mois année}} :

Contrôle le format de la date saisie ;
Gère la présentation typographique de la date et veille notamment à ce que les éléments de la date affichée soient séparés par des espaces insécables (ce qui évite les retours à la ligne non conformes aux conventions typographiques) ;
Rend les dates triables dans l'ordre chronologique dans les tableaux ;
Crée une balise <time> invisible contenant une date normalisée lisible par les bots, en cas de nécessité ;
Supprime l'affichage de « l’année seule » ou de « l’année et du mois » si cela est explicitement demandé par l’adjonction d’un signe « - » après « l'année » ou par l’adjonction d’un signe « - » après « l’année et après le mois » ;
Ne crée aucun des trois liens sur 1° l'année ; 2° le mois et l’année ; 3° le jour et le mois ; à la différence de ce que fait le modèle {{Date}}, ce qui améliore en conséquence la lisibilité de l’article et allège l’affichage de la page (le nombre de liens « bleus » étant réduit d’autant).

3 Paramètres

Ce modèle sert à créer une date sans liens.

Paramètres du modèle
Paramètre		Description	Type	Statut
Quantième	`1`	Date complète ou numéro du jour concerné dans le mois, en chiffres. Si le quantième est « 1 », vous pouvez au choix entrer « 1 » ou « 1er ».	Ligne	suggéré
Mois	`2`	Nom du mois en lettres minuscules ou en chiffres. Mettre une majuscule à la première lettre du mois uniquement en début de phrase lorsque le numéro du jour n’est pas spécifié.	Chaîne	suggéré
Année	`3`	Numéro de l’année en chiffres.	Nombre	suggéré
Âge	`âge` `age`	si égal à 'oui' ou non vide, permet d'afficher le temps écoulé (exprimé en « ans » entiers) entre cette date et aujourd’hui (i.e. entre la date fournie en argument et la date du jour présent). Par défaut non	Booléen	facultatif
Julien	`julien`	'oui' pour que la date soit considérée comme suivant le calendrier julien après le 14 octobre 1582. La date grégorienne est affichée suivie de la date julienne entre parenthèses. Par défaut non	Booléen	facultatif
Républicain	`républicain`	Affiche la conversion en date républicaine entre parenthèses ; ceci n'est possible que pour les dates entre le 22/9/1792 et le 22/9/1806, et entre le 23/9/1870 et le 22/9/1871. Cette date est liée si la valeur est « liens » Par défaut non Exemple oui	Booléen	facultatif
AvJC	`avJC`	'non' pour ne pas afficher 'av. J.-C.' après l'année si elle représente une année avant Jésus Christ. Utile pour éviter les répétitions. Par défaut oui	Booléen	facultatif
ApJC	`apJC`	affiche le texte « après J-C » (insécable, avec abréviation) pour les date ou il y a un doute possible	Booléen	facultatif

Avec le wikicode	Avec l’éditeur visuel
Cliquez sur « Modifier le code » et insérez la syntaxe suivante `{{Date-\|quantième mois année\|âge=\|julien=\|avJC=}}`	Cliquez sur modifier. L'éditeur visuel s'ouvre. Insérer Modèle Renseignez le modèle Date- dans le champ de recherche. Renseignez les champs concernés. Enregistrez. Autre solution, quand vous modifiez une page ou discutez avec Discussions structurées : Tapez `{{` Renseignez le modèle Date- dans le champ de recherche. Renseignez les champs concernés. Enregistrez. La plupart des modèles sont documentés directement dans l’éditeur visuel. Aide générale de l’éditeur visuel à propos des modèles.

4 Exemples

Code	Restitution
`{{Date-\|14 février 2001}}`	14 février 2001
`{{Date-\|14/02/2001}}`	14 février 2001
`{{Date-\|14-02-2001}}`	14 février 2001
`{{Date-\|2001-02-14}}`	14 février 2001
`{{Date-\|14 February 2001}}`	14 février 2001
`{{Date-\|1er janvier 537}}`	1^er janvier 537
`{{Date-\|février 2001}}`	février 2001
`{{Date-\|Février 2001}}`	Février 2001
`{{Date-\|February 2001}}`	Février 2001
`{{Date-\|25/3/1990-}} au {{Date-\|8/4/1990}}`	25 mars au 8 avril 1990
`{{Date-\|14/02/2001\|âge=oui}}`	14 février 2001 (23 ans)
`{{Date-\|25 octobre 1917\|julien=oui}}`	25 octobre 1917 (7 novembre dans le calendrier grégorien)
`{{Date-\|21 janvier 1793\|républicain=oui}}`	21 janvier 1793
`{{Date-\|10 novembre 1799\|républicain=lien}}`	10 novembre 1799
`{{Date-\|14 mars -44}}`	14 mars 44 av. J.-C.
`{{Date-\|14 mars 44 avJC}}`	14 mars 44 av. J.-C.
`{{Date-\|14 mars -44\|avJC=non}}`	14 mars 44
`{{Date-\|14 mars 44 avJC\|avJC=non}}`	14 mars 44
`{{Date-\|19 août 14\|apJC=oui}}`	19 août 14

Code	Restitution
`{{Date-\|14\|février\|2001}}`	14 février 2001
`{{Date-\|1er\|janvier\|537}}`	1^er janvier 537
`{{Date-\|\|février\|2001}}`	février 2001
`{{Date-\|\|Février\|2001}}`	Février 2001
`{{Date-\|\|February\|2001}}`	Février 2001
`du {{Date-\|25\|3\|1990-}} au {{Date-\|8\|4\|1990}}`	du 25 mars au 8 avril 1990
`{{Date-\|14\|02\|2001\|âge=oui}}`	14 février 2001 (23 ans)
`{{Date-\|25\|octobre\|1917\|julien=oui}}`	25 octobre 1917 (7 novembre dans le calendrier grégorien)
`{{Date-\|21\|janvier\|1793\|républicain=oui}}`	21 janvier 1793
`{{Date-\|10\|novembre\|1799\|républicain=lien}}`	10 novembre 1799
`{{Date-\|14\|mars\|-44}}`	14 mars 44 av. J.-C.
`{{Date-\|14\|mars\|44 avJC}}`	14 mars 44 av. J.-C.
`{{Date-\|14\|mars\|-44\|avJC=non}}`	14 mars 44
`{{Date-\|14\|mars\|44 avJC\|avJC=non}}`	14 mars 44
`{{Date-\|19\|août\|14\|apJC=oui}}`	19 août 14

5 Notes

Il est possible de masquer l'année en ajoutant un tiret (« - ») à la fin du paramètre. Cela permet d'avoir la date ISO complète dans la balise time (pour les robots), sans pour autant répéter l'année dans le texte.

les {{Date-|25 mars 1990-}} et {{Date-|8 avril 1990}} donne : les 25 mars et 8 avril 1990
les {{Date-|25|mars|1990-}} et {{Date-|8|avril|1990}} donne : les 25 mars et 8 avril 1990

Il est aussi possible de masquer le mois de la même façon :

du {{Date-|25 mars- 1990-}} au {{Date-|30 mars 1990}} donne : du 25 au 30 mars 1990
du {{Date-|25|mars-|1990-}} au {{Date-|30|mars|1990}} donne : du 25 au 30 mars 1990

Le paramètre compact qui permet l'abréviation du mois ne doit pas être utilisé dans un texte mais peut l'être dans un tableau où la place est restreinte^[1].

6 Notes et références

↑ Lexique des règles typographiques en usage à l’Imprimerie nationale, France, Imprimerie nationale, 2002 (réimpr. 2007, 2008, 2011, 2014), 6^e éd. (1^re éd. 1971), 196 p. (ISBN 978-2-7433-0482-9), p. 63 : « On n'abrège qu'exceptionnellement le nom des mois, par exemple, faute de place, dans les tableaux comportant des colonnes étroites : 10 déc. 1963 ou 10-12-1963 » « On n'abrège pas un millésime ».

La documentation de ce modèle est incluse depuis sa sous-page de documentation (modifier | historique).
Veuillez placer les catégories dans la sous-page /Documentation.

[1] Lexique des règles typographiques en usage à l’Imprimerie nationale, France, Imprimerie nationale, 2002 (réimpr. 2007, 2008, 2011, 2014), 6^e éd. (1^re éd. 1971), 196 p. (ISBN 978-2-7433-0482-9), p. 63 : « On n'abrège qu'exceptionnellement le nom des mois, par exemple, faute de place, dans les tableaux comportant des colonnes étroites : 10 déc. 1963 ou 10-12-1963 » « On n'abrège pas un millésime ».

[1]