Modèle:Date rapide/Documentation

Utilisation

Ce modèle est une alternative au modèle {{Date}}, qui est moins dispendieuse en ressources serveurs.

Son utilisation peut être envisagée lorsque l'article effectue plusieurs centaines d'inclusions du modèle de date, par exemple si l'article sert à lister les épisodes d'une longue série de feuilletons télévisés.

En contrepartie, ce modèle comporte certaines limitations :

• L'existence de la page n'est pas vérifiée pour les liens internes générés. Si la page n'existe pas, il y aura un lien rouge.

• Cela peut se produire sur la partie [[mois année|mois]] (telle que : décembre). Ce problème ne devrait pas être rencontré avec les dates à partir de 1995. En revanche, les dates avant 1995 risqueront d'avoir un lien rouge. Quant aux dates dans le futur, elles auront très probablement un lien rouge.
• Le problème peut également se produire sur la partie [[année qualification|année]] (telle que : 2199).

• Le 4^e paramètre (la qualification optionnelle : « au cinéma », « en musique », etc.) n'est appliqué que sur la partie « année » de la date.

Remarque : Depuis la création de ce modèle en 2010, les performances du modèle {{Date}} ont significativement été améliorées (via un codage en Lua et une base de données locale). L'utilisation de {{date rapide}} n'est justifiée qu'en cas de centaines, voire milliers d'inclusions. Dans la plupart des cas, préférez {{date}}, qui est plus court et offre davantage de possibilités.

Syntaxe

{{Date rapide|quantième|mois|année|qualification}}

quantième

Le quantième (autrement dit, le jour du mois), en chiffres. Si le quantième est « 1 », vous pouvez au choix entrer « 1 » ou « 1er » : il s’affichera toujours « 1^er ».
Ce paramètre est facultatif : vous pouvez le laisser vide.

mois

Le nom du mois, en toutes lettres et en minuscules. Mettre une majuscule à la première lettre du mois uniquement en début de phrase lorsque le numéro d’ordre du jour n’est pas spécifié.

année

L’année, en chiffres.

qualification

Le domaine de l'éphéméride : « au cinéma », « en musique », etc.
Ce paramètre est facultatif : vous pouvez le laisser vide.

Exemples

Code	Restitution
{{Date rapide|14|octobre|2001}}	14 octobre 2001
{{Date rapide|14|octobre|1842}}	14 octobre 1842
{{Date rapide|1er|janvier|537}}	1er janvier 537
{{Date rapide|14|octobre|2001|en musique}}	14 octobre 2001
{{Date rapide||octobre|2001}}	octobre 2001
{{Date rapide||Octobre|2001|en sport}}	Octobre 2001
{{Date rapide||Octobre|1845|en sport}}	Octobre 1845
{{Date rapide|1|octobre|2005|dans les chemins de fer}}	1er octobre 2005

Templatedata

Ce modèle est une alternative au modèle {{Date}} moins dispendieuse en ressources serveurs.

Paramètres du modèle

La mise en forme sur une seule ligne est préférée pour ce modèle.

Paramètre		Description	Type	État
Jour	1	Le quantième (autrement dit, le jour du mois), en chiffres. Si le quantième est « 1 », vous pouvez au choix entrer « 1 » ou « 1er » : il s’affichera toujours « 1er ». Ce paramètre est facultatif : vous pouvez le laisser vide. Exemple 3	Ligne de texte	suggéré
Mois	2	Le nom du mois, en toutes lettres et en minuscules. Mettre une majuscule à la première lettre du mois uniquement en début de phrase lorsque le numéro d’ordre du jour n’est pas spécifié. Valeurs suggérées janvier février mars avril mai juin juillet août septembre octobre novembre décembre Exemple mars	Ligne de texte	obligatoire
Année	3	L’année, en chiffres Exemple 1954	Ligne de texte	obligatoire
Qualification	4	Le domaine de l'éphéméride associé à cette date. Ce paramètre est facultatif : vous pouvez le laisser vide. Exemple « au cinéma », « en musique », etc.	Ligne de texte	suggéré

Note technique

Le principe de ce modèle est de n'effectuer aucun appel à la fonction #ifexist de MediaWiki. Cette fonction sert à tester l'existence d'une page, mais elle affecte les performances lorsqu'elle est appelée des centaines de fois pour générer la page.

Voir aussi

• Catégorie:Page avec trop d'appels dispendieux de fonctions parseurs