Vir l'source éd Modèle:Date-/Documentation

{{Sous-page de documentation}}
{{Modèle utilisant les modules Lua|Module:Date}}
{{Raccourci de modèle|d-}}
{{Modèle obsolète |nouveau=Date |raison=car le modèle Date ne crée plus de liens internes par défaut. }}

== Utilisation ==
Ce modèle sert à créer une date sans liens (contrairement au modèle {{m|Date}}), en évitant les retours à la ligne indésirables et en ajoutant une balise <code><nowiki><time></nowiki></code> invisible contenant une date normalisée lisible par les bots. La syntaxe est identique à celle du [[Modèle:Date|modèle Date]].

{{ancre|Résumé}}
== Résumé des actions liées à l'emploi de ce format ==
Le modèle <code><nowiki>{{date-|jour mois année}}</nowiki></code> :
# 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 [[espace insécable|espaces insécables]] (ce qui évite les retours à la ligne non conformes aux [[Wikipédia:Conventions typographiques#Nombres et espaces|conventions typographiques]]) ;
# Rend les dates triables dans l’ordre chronologique dans les tableaux ;
# Crée une balise <code><nowiki><time></nowiki></code> 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 {{m|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).

== Paramètres ==
<templatedata>
{
	"description": "Insère une date sans liens internes.",
	"params": {
		"1": {
			"label": "Jour / date complète",
			"description": "Deux possibilités : 1) Saisir uniquement le numéro du jour concerné. 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ᵉʳ ».",
			"type": "line",
			"suggested": true,
			"example": "« 1 », « 1 janvier 2020 »"
		},
		"2": {
			"label": "Mois",
			"description": "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é. Ce champ ne doit pas être utilisé si une date complète est déjà saisie dans le champ « Jour / date complète ».",
			"type": "line",
			"example": "« janvier », « 1 »"
		},
		"3": {
			"label": "Année",
			"description": "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 ».",
			"type": "number",
			"example": "2020"
		},
		"âge": {
			"type": "boolean",
			"aliases": [
				"age"
			],
			"description": "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.",
			"required": false,
			"label": "Afficher l'âge",
			"example": "oui",
			"default": "non"
		},
		"julien": {
			"type": "boolean",
			"description": "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",
			"label": "Utiliser le calendrier julien",
			"example": "oui"
		},
		"avJC": {
			"type": "boolean",
			"description": "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",
			"label": "Afficher « av. J.-C. »",
			"example": "non"
		},
		"compact": {
			"description": "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. ».",
			"example": "oui",
			"type": "boolean",
			"label": "Afficher mois abrégé",
			"default": "non"
		},
		"apJC": {
			"description": "Affiche le texte « apr. J.-C. » après l'année pour les dates où un doute serait possible.",
			"type": "boolean",
			"label": "Afficher « apr. J.-C. »",
			"example": "oui",
			"default": "non"
		},
		"républicain": {
			"description": "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 ».",
			"example": "« oui », « liens »",
			"type": "line",
			"default": "non",
			"label": "Afficher la date républicaine"
		}
	},
	"format": "inline",
	"paramOrder": [
		"1",
		"2",
		"3",
		"âge",
		"julien",
		"républicain",
		"avJC",
		"apJC",
		"compact"
	]
}
</templatedata>

== Exemples ==
{| class="wikitable sortable"
! Code !! Restitution
|-
| <code><nowiki>{{Date-|14 février 2001}}</nowiki></code> || {{Date-|14 février 2001}}
|-
| <code><nowiki>{{Date-|14/02/2001}}</nowiki></code> || {{Date-|14/02/2001}}
|-
| <code><nowiki>{{Date-|14-02-2001}}</nowiki></code> || {{Date-|14-02-2001}}
|-
| <code><nowiki>{{Date-|2001-02-14}}</nowiki></code> || {{Date-|2001-02-14}}
|-
| <code><nowiki>{{Date-|14 February 2001}}</nowiki></code> || {{Date-|14 February 2001}}
|-
| <code><nowiki>{{Date-|1er janvier 537}}</nowiki></code> || {{Date-|1er janvier 537}}
|-
| <code><nowiki>{{Date-|février 2001}}</nowiki></code> || {{Date-|février 2001}}
|-
| <code><nowiki>{{Date-|Février 2001}}</nowiki></code> || {{Date-|Février 2001}}
|-
| <code><nowiki>{{Date-|February 2001}}</nowiki></code> || {{Date-|February 2001}}
|-
| <code><nowiki>{{Date-|25/3/1990-}} au {{Date-|8/4/1990}}</nowiki></code> || {{Date-|25/3/1990-}} au {{Date-|8/4/1990}}
|-
| <code><nowiki>{{Date-|14/02/2001|âge=oui}}</nowiki></code> || {{Date-|14/02/2001|âge=oui}}
|-
| <code><nowiki>{{Date-|25 octobre 1917|julien=oui}}</nowiki></code> || {{Date-|25 octobre 1917|julien=oui}}
|-
| <code><nowiki>{{Date-|21 janvier 1793|républicain=oui}}</nowiki></code> || {{Date-|21 janvier 1793|républicain=oui}}
|-
| <code><nowiki>{{Date-|10 novembre 1799|républicain=liens}}</nowiki></code> || {{Date-|10 novembre 1799|républicain=liens}}
|-
| <code><nowiki>{{Date-|14 mars -44}}</nowiki></code> || {{Date-|14 mars -44}}
|-
| <code><nowiki>{{Date-|14 mars 44 av. J.-C.}}</nowiki></code> || {{Date-|14 mars 44 av. J.-C.}}
|-
| <code><nowiki>{{Date-|14 mars 44 avJC}}</nowiki></code> || {{Date-|14 mars 44 avJC}}
|-
| <code><nowiki>{{Date-|14 mars -44|avJC=non}}</nowiki></code> || {{Date-|14 mars -44|avJC=non}}
|-
| <code><nowiki>{{Date-|14 mars 44 avJC|avJC=non}}</nowiki></code> || {{Date-|14 mars 44 avJC|avJC=non}}
|-
| <code><nowiki>{{Date-|19 août 14|apJC=oui}}</nowiki></code> || {{Date-|19 août 14|apJC=oui}}
|}

{| class="wikitable sortable"
! Code !! Restitution
|-
| <code><nowiki>{{Date-|14|février|2001}}</nowiki></code> || {{Date-|14|février|2001}}
|-
| <code><nowiki>{{Date-|1er|janvier|537}}</nowiki></code> || {{Date-|1er|janvier|537}}
|-
| <code><nowiki>{{Date-||février|2001}}</nowiki></code> || {{Date-||février|2001}}
|-
| <code><nowiki>{{Date-||Février|2001}}</nowiki></code> || {{Date-||Février|2001}}
|-
| <code><nowiki>{{Date-||February|2001}}</nowiki></code> || {{Date-||February|2001}}
|-
| <code><nowiki>les {{Date-|13|mai-|2017-}} et {{Date-|14|mai|2017}}</nowiki></code> || les {{date-|13|mai-|2017-}} et {{date-|14|mai|2017}}
|-
| <code><nowiki>du {{Date-|25|3|1990-}} au {{Date-|8|4|1990}}</nowiki></code> || du {{Date-|25|3|1990-}} au {{Date-|8|4|1990}}
|-
| <code><nowiki>{{Date-|14|02|2001|âge=oui}}</nowiki></code> || {{Date-|14|02|2001|âge=oui}}
|-
| <code><nowiki>{{Date-|25|octobre|1917|julien=oui}}</nowiki></code> || {{Date-|25|octobre|1917|julien=oui}}
|-
| <code><nowiki>{{Date-|21|janvier|1793|républicain=oui}}</nowiki></code> || {{Date-|21|janvier|1793|républicain=oui}}
|-
| <code><nowiki>{{Date-|10|novembre|1799|républicain=liens}}</nowiki></code> || {{Date-|10|novembre|1799|républicain=liens}}
|-
| <code><nowiki>{{Date-|14|mars|-44}}</nowiki></code> || {{Date-|14|mars|-44}}
|-
| <code><nowiki>{{Date-|14|mars|44 avJC}}</nowiki></code> || {{Date-|14|mars|44 avJC}}
|-
| <code><nowiki>{{Date-|14|mars|-44|avJC=non}}</nowiki></code> || {{Date-|14|mars|-44|avJC=non}}
|-
| <code><nowiki>{{Date-|14|mars|44 avJC|avJC=non}}</nowiki></code> || {{Date-|14|mars|44 avJC|avJC=non}}
|-
| <code><nowiki>{{Date-|19|août|14|apJC=oui}}</nowiki></code> || {{Date-|19|août|14|apJC=oui}}
|}

== 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 <code><nowiki><time></nowiki></code> (pour les robots), sans pour autant répéter l’année dans le texte.
* <code><nowiki>les {{Date-|25 mars 1990-}} et {{Date-|8 avril 1990}}</nowiki></code> donne : les {{Date-|25 mars 1990-}} et {{Date-|8 avril 1990}}
* <code><nowiki>les {{Date-|25|mars|1990-}} et {{Date-|8|avril|1990}}</nowiki></code> donne : les {{Date-|25|mars|1990-}} et {{Date-|8|avril|1990}}

Il est aussi possible de masquer le mois de la même façon :
* <code><nowiki>du {{Date-|25 mars- 1990-}} au {{Date-|30 mars 1990}}</nowiki></code> donne : du {{Date-|25 mars- 1990-}} au {{Date-|30 mars 1990}}
* <code><nowiki>du {{Date-|25|mars-|1990-}} au {{Date-|30|mars|1990}}</nowiki></code> donne : du {{Date-|25|mars-|1990-}} au {{Date-|30|mars|1990}}

Le paramètre <code><nowiki>compact</nowiki></code> 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>{{Ouvrage|titre=[[Référence:Lexique des règles typographiques en usage à l'Imprimerie nationale|Lexique des règles typographiques en usage à l’Imprimerie nationale]] |éditeur=[[Imprimerie nationale]] |année=2002 |réimpression=2007, 2008, 2011, 2014 |numéro d'édition=6 |année première édition=1971 |lieu=France |pages totales=196 |ISBN=978-2-7433-0482-9 |passage=63}} : « On n’abrège qu’exceptionnellement le nom des mois, par exemple, faute de place, dans les tableaux comportant des colonnes étroites : {{nobr|10 déc. 1963}} ''ou'' {{nobr|10-12-1963}} » « On n’abrège pas un millésime ».</ref>. Les abréviations normalisées sont décrites à « [[Mois#Abréviations|Mois – Abréviations]] ».

== Notes et références ==
{{Références}}

== Voir aussi ==
* {{m|Existe depuis}}

{{Palette Modèles liés au temps}}

<includeonly>
{{DEFAULTSORT:Date, 02}}
[[Catégorie:Modèle de date]]
</includeonly>