Template:Date/Documentation

Utilisation

Ce modèle sert à créer une date :

• respectant les règles de typographie (pas de césure entre les parties de la date) donc en évitant des retours à la ligne indésirables ;
• avec des wikiliens (contrairement au modèle {{Date-}}) ;
• en ajoutant une balise <time> invisible contenant une date normalisée lisible par les bots.

La syntaxe est identique à celle du modèle Date-.

Actions liées à l'emploi de ce format

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

1. contrôle le format de la date saisie ;
2. 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) ;
3. crée une balise <time> invisible contenant une date normalisée lisible par les bots, en cas de nécessité ;
4. rend les dates triables dans l’ordre chronologique dans les tableaux ;
5. 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 » ;
6. crée trois liens sur 1° l’année ; 2° le mois et l’année ; 3° le jour et le mois ; ce que ne fait pas le modèle {{Date-}}.

Syntaxe

Syntaxe privilégiée (sans barre verticale entre les parties de la date) :

{{Date|jour mois année}}

Syntaxe privilégiée complète :

{{Date|jour mois année|qualification|âge=|julien=|républicain=|avJC=|apJC=|compact=}}

Syntaxe alternative :

{{Date|jour|mois|année}}

Syntaxe alternative complète :

{{Date|jour|mois|année|qualification|âge=|julien=|républicain=|avJC=|apJC=|compact=}}

Paramètres

Insère une date avec liens internes. Deux choix possibles : 1) Saisir la date complète dans le champ « Jour / date complète » (recommandé) ; 2) Saisir la date dans les trois champs « Jour », « Mois » et « Année ». Pour ne pas créer de liens sur la date, utiliser le modèle « date- ».

Template parameters

This template prefers inline formatting of parameters.

Parameter		Description	Type	Status
Jour / date complète	1	Choix 1) Saisir uniquement le numéro du jour concerné ; Choix 2) Saisir la date complète. Si uniquement le jour est indiqué, le mois et l'année doivent êtres saisis dans les champs « Mois » et « Année ». Remarque : si le jour est « 1 », vous pouvez au choix entrer « 1 » ou « 1er », cela sera affiché « 1ᵉʳ ». Example « 30 », « 30 janvier 2020 »	Line	suggested
Mois / domaine de l'éphéméride	2	Choix 1) Nom du mois en lettres minuscules ou en chiffres. Mettre une majuscule à la première lettre du mois uniquement en début de phrase si le jour n’est pas spécifié. Ce champ ne doit pas être utilisé si une date complète est saisie dans le champ « Jour / date complète » ; Choix 2) Domaine de l'éphéméride, utilisé automatiquement dans les liens pour l’année, le mois et/ou le jour, lorsque les pages correspondantes existent. Il s'agit de pages nommées sous la forme « 2016 en aéronautique ». Ce champ est à utiliser à la place du champ « Domaine de l'éphéméride ». Example 1) « janvier » ; 2) « en aéronautique »	Line	optional
Année	3	Numéro de l’année en chiffres. Les nombres négatifs sont considérés comme des années avant J.-C. dans un calendrier sans année 0 (-44 est interprété comme 44 av. J.-C.). Ce champ ne doit pas être utilisé si une date complète est déjà saisie dans le champ « Jour / date complète ». Example 2020	Number	optional
Domaine de l'éphéméride	4	Domaine de l’éphéméride, utilisé automatiquement dans les liens pour l’année, le mois et/ou le jour, lorsque les pages correspondantes existent. Il s'agit de pages nommées sous la forme « 2016 en aéronautique ». Ce champ ne doit pas être utilisé avec une date complète dans le champ « Jour / date complète » ; dans ce cas utiliser le champ « Mois / domaine de l'éphéméride » à la place. Example en aéronautique	Line	optional
Afficher l'âge	âge age	Définir à « oui » pour afficher le temps écoulé (exprimé en « ans » entiers) entre la date indiquée et aujourd’hui. Supprimer le champ pour ne plus afficher l'âge. Default non Example oui	Boolean	optional
Utiliser le calendrier julien	julien	Saisir « oui » pour que la date soit considérée comme suivant le calendrier julien après le 14 octobre 1582. La date grégorienne avec liens est affichée suivie de la date julienne entre parenthèses. Default non Example oui	Boolean	optional
Afficher la date républicaine	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 ». Default non Example « oui », « liens »	Line	optional
Afficher « av. J.-C. »	avJC	Définir à « 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. Default oui Example non	Boolean	optional
Afficher « apr. J.-C. »	apJC	Affiche le texte « apr. J.-C. » après l'année pour les dates où un doute serait possible. Default non Example oui	Boolean	optional
Afficher mois abrégé	compact	Affiche le mois sous forme abrégée pour réduire la taille du texte. Utile notamment dans des tableaux manquant de place. Les abréviations utilisées sont les suivantes : « janv. », « fév. », « mars », « avr. », « mai », « juin », « juill. », « août », « sept. », « oct. », « nov. » et « déc. ». Default non Example oui	Boolean	optional

Exemples

Code	Restitution
{{Date|14 octobre 2001}}	14 octobre 2001
{{Date|14/10/1842}}	14/10/1842
{{Date|1er janvier 537}}	1er janvier 537
{{Date|14-10-2001|en musique}}	14 October 2001
{{Date|octobre 2001}}	octobre 2001
{{Date|Octobre 2001|en sport}}	Octobre 2001
{{Date|Octobre 1845|en sport}}	Octobre 1845
{{Date|1 octobre 2005|dans les chemins de fer}}	1 octobre 2005
{{Date|25 mars 1990-}} et {{Date|8 avril 1990}}	25 mars 1990- et 8 avril 1990
{{Date|2001-10-14|âge=oui}}	14 October 2001
{{Date|29 février 1700|julien=oui}}	29 février 1700
{{Date|25 octobre 1917|julien=oui}}	25 octobre 1917
{{Date|10 février 1800|julien=oui}}	10 février 1800
{{Date|1 avril 1912|julien=oui}}	1 avril 1912
{{Date|25 décembre 1916|julien=oui}}	25 décembre 1916
{{Date|25 décembre 1916|julien=oui|âge=oui}}	25 décembre 1916
{{Date|21 janvier 1793|républicain=oui}}	21 janvier 1793
{{Date|10 novembre 1799|républicain=liens}}	10 novembre 1799
{{Date|14 mars -44}}	14 March 2024
{{Date|14 mars 44 av. J.-C.}}	14 mars 44 av. J.-C.
{{Date|14 mars 44 avJC}}	14 mars 44 avJC
{{Date|14 mars -44|avJC=non}}	14 March 2024
{{Date|14 mars 44 avJC|avJC=non}}	14 mars 44 avJC
{{Date|Mars -44|avJC=non}}	Mars -44
{{Date|19 août 14|apJC=oui}}	19 août 14
{{Date|14 octobre 2001|compact=oui}}	14 octobre 2001

Avec la syntaxe alternative

Code	Restitution
{{Date|14|octobre|2001}}	14
{{Date|14|10|1842}}	14
{{Date|1er|janvier|537}}	1er
{{Date|14|octobre|2001|en musique}}	14
{{Date||octobre|2001}}	25 December
{{Date||Octobre|2001|en sport}}	25 December
{{Date||Octobre|1845|en sport}}	25 December
{{Date|1|octobre|2005|dans les chemins de fer}}	1
{{Date|25|mars|1990-}} et {{Date|8|avril|1990}}	25 et 8
{{Date|14|octobre|2001|âge=oui}}	14
{{Date|29|février|1700|julien=oui}}	29
{{Date|25|octobre|1917|julien=oui}}	25
{{Date|10|février|1800|julien=oui}}	10
{{Date|1|avril|1912|julien=oui}}	1
{{Date|25|décembre|1916|julien=oui}}	25
{{Date|25|décembre|1916|julien=oui|âge=oui}}	25
{{Date|21|janvier|1793|républicain=oui}}	21
{{Date|10|novembre|1799|républicain=liens}}	10
{{Date|14|mars|-44}}	14
{{Date|14|mars|44 av. J.-C.}}	14
{{Date|14|mars|-44|avJC=non}}	14
{{Date|14|mars|44 av. J.-C.|avJC=non}}	14
{{Date||Mars|-44}}	25 December
{{Date|19|août|14|apJC=oui}}	19
{{Date|14|octobre|2001|compact=oui}}	14

Notes

Il est possible de masquer l’année en ajoutant un tiret (« - ») à la fin du paramètre. Cela permet d’avoir le lien contenant l’année sur le mois et 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 1990- et 8 avril 1990
• les {{Date|25|mars|1990-}} et {{Date|8|avril|1990}} donne : les 25 et 8

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

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

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<ref> : « 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 ».</ref>. Les abréviations normalisées sont décrites à « Mois – Abréviations ».

Notes et références

<references responsive="1" group=""></references>

Voir aussi

• {{Existe depuis}}
• {{s}}, {{s2}}, {{sp}}, {{s mini}} et leurs variantes, pour afficher un ou des siècles
• {{millénaire}}, {{mi}} et leurs variantes, pour afficher des millénaires