Module:Durée/Documentation

Documentation du module [voir] [modifier] [purger]
Ceci est la page de documentation du module Scribunto dont le code écrit en Lua est dans la page Module:Durée [historique].
Cette page n’est pas destinée à être visualisée directement. Les liens utilisant des pseudo-variables peuvent paraître rompus (en rouge) ; ne pas les remplacer par des noms de pages codés en dur ni des URL.

Utilisation modifier

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 modifier

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

ou

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

Paramètres modifier

  • Les trois premiers paramètres permettent d'indiquer la date la plus ancienne.
  • Les trois derniers paramètres 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 modifier

Code wiki Rendu
{{Durée|1|1|2000}}
24 ans, 4 mois et 19 jours
{{Durée|6|4|1977}}
47 ans, 1 mois et 14 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}}
292 mois
{{Durée|1|1|2000|en mois=oui|masquer texte=oui}}
292
{{Durée|1|1|2000|en jours=oui}}
8 906 jours
{{Durée|1|1|2000|en jours=oui|masquer texte=oui}}
8 906
{{Durée|1|1|2000|en jours=oui|raw=oui}}
8906

Template Data modifier

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ètreDescriptionTypeÉtat
jour11

Jour de la première date

Nombreobligatoire
mois12

Mois de la première date

Nombreobligatoire
année13

Année de la première date

Nombreobligatoire
jour24

Jour de la deuxième date

Par défaut
numéro du jour actuel
Nombresuggéré
mois25

Mois de la deuxième date

Par défaut
numéro du mois actuel
Nombresuggéré
année26

Année de la deuxième date

Par défaut
année actuelle
Nombresuggéré
en joursen jours

Affiche le résultat en jours uniquement (voir aussi {{Durée en jours}})

Valeurs suggérées
oui
Chaînefacultatif
en moisen mois

Affiche le résultat en mois uniquement (voir aussi {{Durée en mois}})

Valeurs suggérées
oui
Chaînefacultatif
en annéesen années

Affiche le résultat en années uniquement

Valeurs suggérées
oui
Chaînefacultatif
masquer textemasquer 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înefacultatif
rawraw 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înefacultatif