Modèle:Durée/Documentation

Utilisation

Ce modèle sert à indiquer la durée entre deux dates en années, mois et jours. Il peut servir de clé de tri dans un tableau triable.

Syntaxe

{{durée|<jour1>|<mois1>|<année1>}}

ou

{{durée|<jour1>|<mois1>|<année1>|<jour2>|<mois2>|<année2>}}

Paramètres

• Les trois premiers paramètres permettent d'indiquer la date la plus ancienne.
• Les trois paramètres suivants permettent d'indiquer la date la plus récente. Si rien n'est indiqué dans les trois derniers paramètres, les valeurs seront celles actuelles.
• Variantes : Il est possible d'afficher la durée en nombre de jours (paramètre en jours=oui), en nombre de mois (paramètre en mois=oui), ou en n'affichant que les années (paramètre en années=oui). Lorsque l'un de ces paramètres est utilisé, il est possible de n'afficher que la valeur sans le texte (paramètre masquer texte=oui), ou d'afficher la valeur brute non formatée pour permettre d'utiliser le résultat dans un calcul (paramètre raw=oui).

Exemples

Code wiki	Rendu
{{Durée|1|1|2000}}	24 ans, 9 mois et 17 jours
{{Durée|6|4|1977}}	47 ans, 6 mois et 12 jours
{{Durée|2|12|1998|3|11|2001}}	2 ans, 11 mois et 1 jour
{{Durée|1|1|2000|1|2|2001}}	1 an et 1 mois
{{Durée|1|1|2010|2|1|2011}}	1 an et 1 jour
{{Durée|1|1|2000|3|1|2000}}	2 jours
{{Durée|1|1|2000|1|2|2000}}	1 mois
{{Durée|1|1|2000|1|1|2008}}	8 ans
{{Durée|1|1|2000|en années=oui}}	24 ans
{{Durée|1|1|2000|en années=oui|masquer texte=oui}}	24
{{Durée|1|1|2000|en mois=oui}}	297 mois
{{Durée|1|1|2000|en mois=oui|masquer texte=oui}}	297
{{Durée|1|1|2000|en jours=oui}}	9 057 jours
{{Durée|1|1|2000|en jours=oui|masquer texte=oui}}	9 057
{{Durée|1|1|2000|en jours=oui|raw=oui}}	9057

Template Data

Sert à indiquer la durée entre deux dates en années, mois et jours. La deuxième date, si elle n'est pas fournie, est implicitement celle d'aujourd'hui.

Paramètres du modèle

Paramètre		Description	Type	État
jour date 1	1	Jour de la première date	Nombre	obligatoire
mois date 1	2	Mois de la première date	Nombre	obligatoire
année date 1	3	Année de la première date	Nombre	obligatoire
jour date 2	4	Jour de la deuxième date Par défaut numéro du jour actuel	Nombre	suggéré
mois date 2	5	Mois de la deuxième date Par défaut numéro du mois actuel	Nombre	suggéré
année date 2	6	Année de la deuxième date Par défaut année actuelle	Nombre	suggéré
en jours	en jours	Affiche le résultat en jours uniquement (voir aussi {{Durée en jours}}) Valeurs suggérées oui	Chaîne	facultatif
en mois	en mois	Affiche le résultat en mois uniquement (voir aussi {{Durée en mois}}) Valeurs suggérées oui	Chaîne	facultatif
en années	en années	Affiche le résultat en années uniquement Valeurs suggérées oui	Chaîne	facultatif
en années et jours	en années et jours	Affiche le résultat en années suivi du nombre de jours dans l'année en cours Valeurs suggérées oui	Chaîne	facultatif
masquer texte	masquer texte	Masque le texte ''jours'', ''mois'' ou ''ans'' après la durée. Utilisable uniquement si l'un des paramètres ''en jours'', ''en mois'' ou ''en années'' est activé. Le texte reste formaté (notamment, les chiffres sont groupés par trois). Valeurs suggérées oui	Chaîne	facultatif
raw	raw brut	Retourne la valeur numérique brute non formatée pour permettre l'utilisation du résultat dans un calcul. Uniquement utilisable avec les paramètres "en jours", "en mois" ou "en années" Valeurs suggérées oui	Chaîne	facultatif