Nothing Special   »   [go: up one dir, main page]
Wikipédia

Modèle:Date

 Documentation[voir] [modifier] [historique] [purger]

Ce modèle à risque est inclus sur un très grand nombre de pages et ne peut pas être modifié.

Cette protection ne constitue pas obligatoirement une approbation de la version actuelle. Vous pouvez proposer une modification en page de discussion. Lorsqu'un compromis sera trouvé en page de discussion, vous pourrez demander la modification auprès des administrateurs (voir le journal des protections).

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 sa sous-page bac à sable. Voir le projet Scribunto si vous voulez en savoir plus.

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 évitant des retours à la ligne indésirables ;
  • comprenant éventuellement des wikiliens, quand un domaine est renseigné ou quand le paramètre liens est utilisé[1] ;
  • en ajoutant une balise <time> invisible contenant une date normalisée lisible par les bots.
Note
  1. ↑ Depuis août 2023, le modèle {{date}} n'ajoute plus systématiquement de liens par défaut, à la suite d'une consultation communautaire (explications).

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 ;
  4. Rend les dates triables dans l’ordre chronologique dans les tableaux ;
  5. Supprime l’affichage de l’année et éventuellement du mois, si cela est explicitement demandé par l’adjonction d’un signe « - » après l'un et éventuellement l'autre ;
  6. Crée trois liens sur l’année, le mois et l’année, ou le jour et le mois, si un domaine est précisé ou si le paramètre liens est renseigné.

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=|liens=}}

Syntaxe alternative : 

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

Syntaxe alternative complète : 

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

Paramètres

Insère une date avec une mise en forme appropriée. On peut : 1) soit entrer la date complète dans le champ « Jour / date complète » (recommandé) ; 2) soit renseigner certains des champs « Jour », « Mois » (obligatoire si le jour est renseigné) et « Année ».

Paramètres du modèle[Modifier les données du modèle]

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

ParamètreDescriptionTypeÉtat
Jour / date complète1

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ᵉʳ ».

Exemple
« 30 », « 30 janvier 2020 »
Ligne de textesuggéré
Mois / domaine de l'éphéméride2

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 ».

Exemple
1) « janvier » ; 2) « en aéronautique »
Ligne de textefacultatif
Année3

Numéro de l’année en chiffres. Les nombres négatifs sont considérés comme des années avant Jésus-Christ 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 ».

Exemple
2020
Nombrefacultatif
Domaine de l'éphéméride4

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.

Exemple
en aéronautique
Ligne de textefacultatif
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.

Par défaut
non
Exemple
oui
Booléenfacultatif
Utiliser le calendrier julienjulien

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.

Par défaut
non
Exemple
oui
Booléenfacultatif
Afficher la date républicaineré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 », « liens »
Ligne de textefacultatif
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.

Par défaut
oui
Exemple
non
Booléenfacultatif
Afficher « apr. J.-C. »apJC

Affiche le texte « apr. J.-C. » après l'année pour les dates où un doute serait possible.

Par défaut
non
Exemple
oui
Booléenfacultatif
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. ».

Par défaut
non
Exemple
oui
Booléenfacultatif
Forcer les liensliens

Force l'activation des liens sur la date

Par défaut
non
Booléenfacultatif

Exemples

Code Restitution
  • {{Date|14 janvier 2024}}
  • {{Date|2024-01-14}}
  • {{Date|14/01/2024}}
{{Date|14/10/1842}}
{{Date|1er janvier 537}}
{{Date|2024-01-14|en musique}}
{{Date|1 octobre 2005|dans les chemins de fer}}
{{Date|janvier 2024}}
{{Date|Janvier 2024|en sport}}
{{Date|2024}}
{{Date|25 mars 1990-}} et {{Date|8 avril 1990}} et
{{Date|2001-10-14|âge=oui}} (23 ans)
{{Date|29 février 1700|julien=oui}} 29 février 1700 ( dans le calendrier grégorien)
{{Date|25 octobre 1917|julien=oui}} 25 octobre 1917 ( dans le calendrier grégorien)
{{Date|10 février 1800|julien=oui}} 10 février 1800 ( dans le calendrier grégorien)
{{Date|1 avril 1912|julien=oui}} 1er avril 1912 ( dans le calendrier grégorien)
{{Date|25 décembre 1916|julien=oui}} 25 décembre 1916 ( dans le calendrier grégorien)
{{Date|25 décembre 1916|julien=oui|âge=oui}} 25 décembre 1916 ( dans le calendrier grégorien) (107 ans)
{{Date|21 janvier 1793|républicain=oui}} (2 pluviôse de l'an I)
{{Date|10 novembre 1799|républicain=liens}} (19 brumaire de l'an VIII)
{{Date|14 mars -44}}
{{Date|14 mars 44 av. J.-C.}}
{{Date|14 mars 44 avJC}}
{{Date|14 mars -44|avJC=non}}
{{Date|14 mars 44 avJC|avJC=non}}
{{Date|Mars -44|avJC=non}}
{{Date|19 août 14|apJC=oui}}
{{Date|14 janvier 2024|compact=oui}}
{{Date|14 janvier 2024|liens=oui}}

Avec la syntaxe alternative

Code Restitution
{{Date|14|janvier|2024}}
{{Date|14|10|1842}}
{{Date|1er|janvier|537}}
{{Date|14|janvier|2024|en musique}}
{{Date|1|octobre|2005|dans les chemins de fer}}
{{Date||janvier|2024}}
{{Date||Janvier|2024|en sport}}
{{Date|||2024}}
les {{Date|13|mai-|2017-}} et {{Date|14|mai|2017}} les et
{{Date|25|mars|1990-}} et {{Date|8|avril|1990}} et
{{Date|14|octobre|2001|âge=oui}} (23 ans)
{{Date|29|février|1700|julien=oui}} 29 février 1700 ( dans le calendrier grégorien)
{{Date|25|octobre|1917|julien=oui}} 25 octobre 1917 ( dans le calendrier grégorien)
{{Date|10|février|1800|julien=oui}} 10 février 1800 ( dans le calendrier grégorien)
{{Date|1|avril|1912|julien=oui}} 1er avril 1912 ( dans le calendrier grégorien)
{{Date|25|décembre|1916|julien=oui}} 25 décembre 1916 ( dans le calendrier grégorien)
{{Date|25|décembre|1916|julien=oui|âge=oui}} 25 décembre 1916 ( dans le calendrier grégorien) (107 ans)
{{Date|21|janvier|1793|républicain=oui}} (2 pluviôse de l'an I)
{{Date|10|novembre|1799|républicain=liens}} (19 brumaire de l'an VIII)
{{Date|14|mars|-44}}
{{Date|14|mars|44 av. J.-C.}}
{{Date|14|mars|-44|avJC=non}}
{{Date|14|mars|44 av. J.-C.|avJC=non}}
{{Date||Mars|-44}}
{{Date|19|août|14|apJC=oui}}
{{Date|14|janvier|2024|compact=oui}}
{{Date|14|janvier|2024|liens=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 <time> (pour les robots), sans pour autant répéter l’année dans le texte.

  • les {{Date|25 mars 1990-|liens=oui}} et {{Date|8 avril 1990|liens=oui}} donne : les et
  • les {{Date|25|mars|1990-}} et {{Date|8|avril|1990}} donne : les et

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 au
  • du {{Date|25 mars- 1990-}} au {{Date|30 mars 1990}} donne : du au
  • du {{Date|25|mars-|1990-}} au {{Date|30|mars|1990}} donne : du au

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

Notes et références

  1. ↑ Lexique des règles typographiques en usage à l’Imprimerie nationale, France, Imprimerie nationale, (réimpr. 2007, 2008, 2011, 2014), 6e éd. (1re é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 ».

Voir aussi

v · m
Modèles liés au temps
Modèles de date
Modèles d'âge
Modèles de durée

La documentation de ce modèle est générée par le modèle {{Documentation}}.
Elle est incluse depuis sa sous-page de documentation. Veuillez placer les catégories sur cette page-là.
Les éditeurs peuvent travailler dans le bac à sable (modifier) et la page de test (modifier).
Voir les statistiques d'utilisation du modèle sur l'outil wstat.

Ce document provient de « https://fr.wikipedia.org/w/index.php?title=Modèle:Date&oldid=114381173 ».