Wikilivres

« Module:Date/Documentation » : différence entre les versions

Navigation interactive dans l’historique
← Modification précédenteModification suivante →
Contenu supprimé Contenu ajouté
VisuelWikicode
m correction modèle de protection
VVVF (discussion | contributions)
16 modifications
Aucun résumé des modifications
Ligne 1 :
<includeonly>{{protection}}</includeonly>
 
Attention, certaines fonctions de ce module sont utilisées par les modèles {{m|ouvrage}} et {{m|article}} ({{unité|100000|pages}}).
 
Ligne 6 ⟶ 5 :
=== Fonctions utilisables depuis un modèle ===
* <code>modeleDate(frame)</code> – affiche une date avec les liens les plus pertinents (précisions ci-dessous).
* <code>modeleInscriptionDate(frame)</code> – affiche une date correctement formatée, sans lien. lL'année est obligatoire. Paramètres nommés année, mois, jour. (utilisé par module Biblio)
* <code>dateISO(frame)</code> – similaire à modeleInscriptionDate mais la date est au format aaaa-mm-jj. Paramètres nommés année, mois, jour. Pour respecter l'[[ISO 8601]] qui définiedéfinit la date uniquement selon le [[calendrier grégorien]], cette fonction ne retourne rien pour les datedates avant 1583.
* <code>dateRepublicain(frame)</code> – affiche une date grégorienne au format républicain (sans liens). Paramètres 1=année, 2=mois, 3=jour.
* <code>modeleAge(frame)</code> - retourne l'ageâge (nombre d'année) depuis une date ou entre deux dates. Paramètres 1=année, 2=mois, 3=jour, 4=année, 5=mois, 6=jour.
* <code>erreurModuleData()</code> - retourne un message d'erreur si Module:Date/Data ne se charge pas correctement.
* <code>checkDataCat(frame)</code> - retourne une liste de pagepages annuelle et mensuelle pour facilitéfaciliter les mises à jour de Date/Data. Paramètres 1=cat, mois=liste de mois si 'oui', alias = liste tous les alias si 'oui'
 
=== fonctionFonctions utilisableutilisables depuis un autre module ===
* <code>nomDuMois( num )</code> – retourne le nom français du mois n° <code>num</code>.
* <code>valideMois( mois )</code> – retourne le nom français et le n° de <code>mois</code> (nom français, abrégé, anglais, ou nombre entre 1 et 12).
* <code>determinationMois( mois, frame )</code> - similaire à valideMois, mais le numéro du mois n'est pas limité (14 → février), et peut même être une expréssion si un objet frame est fourni ( 6 + 3 → septembre )
* <code>do_dayRank(arguments)</code> - Rang du jour dans l'année. Paramètre arguments = { année, mois, jour } ou { year = année, month = mois, day = jour }
* <code>isLeapYear(year)</code> - retourne true si year est une année bisextilebissextile dans le calendrier grégorien.
* <code>toRoman(number)</code> - transforme number en une chaine le représentant en « [[chiffres romains]] ».
* <code>age( an, mn, jn, ac, mc, jc )</code> - similaire à modeleAge, mais les paramètres ne sont pas dans une table
* <code>julianDay( year, month, day, hour, minute, second )</code> - retourne le [[jour julien]] de la date transmise, suivant le [[Calendrier grégorien proleptique|calendrier grégorien astronomique]] (avec année 0)
* <code>julianDayJulian( year, month, day, hour, minute, second )</code> - retourne le [[jour julien]] d'une date du [[Calendrier julien proleptique|calendrier julien astronomique]] (avec année 0)
* <code>jullianDayToGregorian( jd )</code> - retourne trois variablevariables année, mois, jour représentant la date du [[Calendrier grégorien proleptique|calendrier grégorien astronomique]] correspondant à ce jour julien.
* <code>jullianDayToJulian( jd )</code> - retourne trois variablevariables année, mois, jour représentant la date du [[Calendrier julien proleptique|calendrier julien]] correspondant à ce jour julien.
* <code>jullianToGregorian( year, month, day )</code> - transforme une date du calendrier julien en date du calendrier grégorien.
* <code>gregorianToJullian( year, month, day )</code> - transforme une date du calendrier grégorien en date du calendrier julien.
 
=== Modules externes dont ce module a besoin pour fonctionner ===
* <code>[[Module:Date/Data|Date/Data]]</code> - Base de donnée permettant de ne pas tester les pages que l'on sait existanteexistantes, ou n'existant pas.
* <code>[[Module:TableBuilder|TableBuilder]]</code> – Utilise <code>.insert</code> et <code>.concat</code> pour simplifier la syntaxe.
 
== modeleDate( frame ) ==
=== Paramètres ===
* <code>1</code> - jour ou vide - numérique, exeptionexception possible pour 1er ou {{1er}}.
* <code>2</code> - mois ou jour - numérique ou nom français ou anglais, éventuellement une abréviation courante.
* <code>3</code> - année ou mois - Un nombre sera considéré comme année. Les années sont considérées comme suivant le calendrier grégorien depuis le 14 octobre 1582 (sauf si julien = 'oui') et le calendrier julien auparavant, sans année 0.
* <code>4</code> - qualificatif ou année - texte correspondant à une page type « en photographie » pour « [[2008 en photographie]] »
* <code>5</code> - qualificatif
* <code>age</code> ou <code>âge</code> - non vide pour afficher l'ageâge (aucun ageâge n'est affiché pour les datedates dans le futur)
* <code>julien</code> - 'oui' pour que la date soit considérée suivant le calendrier julien après le 14 otobreoctobre 1582. La date sera affichéaffichée suivant les deux calendriercalendriers.
* <code>avJC</code> - 'non' pour ne pas affichéafficher 'av. J.-C.' après l'année si elle représente une année anvantavant Jésus ChirstChrist. Utile pour éviter les répétitions.
 
* <code>paramètres page</code> - Si un modèle {{m|date}} contient ce paramètre, et les paramètreparamètres <code>julien</code>, <code>avJC</code> et <code>qualificatif</code> seront appliquéappliqués à toutes les dates de la page, sauf si une autre valeur de ces paramètres est indiquée. Le modèle date qui contient ce paramètre n'a pas besoin d'être affiché par le module Date, et peut être en commentaire dans la page. La page doit être purgée pour que ce paramètre soit pris en compte.
* <code>qualificatif</code> - qualificatif aà appliquer sur toute la page. Ne fonctionne qu'en liaison avec le paramètre <code>paramétresparamètres page</code>
 
=== Fonctionnement ===
 
* Le modèle cherche à afficher la date avec des liens vers les pages lièliées au qualificatif. sS'il n'y a pas de page liéliée au qualificatif un lien sera fait vers la page générale.▼
=== fonctionnement ===
* le premier paramètre est vide et le troisième correspond à un mois (texte uniquement), tous les paramètres sont considérés comme décalédécalés et l'année ne sera pas affichée.▼
▲* Le modèle cherche à afficher la date avec des liens vers les pages liè au qualificatif. s'il n'y a pas de page lié au qualificatif un lien sera fait vers la page générale.
* S'il n'y a pas de page spécifique pour ce mois-année, le mois sera affiché lièlié avec le jour à l'éphéméride. Priorité est donnédonnée à l'éphéméride du qualificatif sur le lien mois-année sans qualificatif.▼
▲* le premier paramètre est vide et le troisième correspond à un mois (texte uniquement), tous les paramètres sont considérés comme décalé et l'année ne sera pas affichée.
▲* S'il n'y a pas de page spécifique pour ce mois-année, le mois sera affiché liè avec le jour à l'éphéméride. Priorité est donné à l'éphéméride du qualificatif sur le lien mois-année sans qualificatif.
* Le modèle s'aide de la base de donnée [[Module:Date/Data|Date/Data]] pour éviter d'utiliser la fonction mw.title (équivalent du parser #ifexist:).
* Cette base permet de remplacer le qualificatif par une catégorie plus générique. Si le qualificatif est « en tennis », l'éphéméride et la page mensuelle sera lièliée au qualificatif « en sport ».
 
* pour éviter de répéter le même qualificatif sur toute les dates de la page, il suffit d'avoir quelque part dans le texte de la page, même en commentaire mais pas amené par un modèle, le texte <code>{{Date|paramètres page= |qualificatif= mon qualificatif}}</code>. le modèle peut contenir d'autre paramètres. Seul le premier modèle date contenant ce paramètre sera pris en compte.
 
=== Fonction modeleDate ===
{|class="wikitable alternance" style="text-align:center;"
Ligne 155 ⟶ 154 :
| 1 / 0
|-
| date négative, paramètre pour cahéecacher av. J.-C.
| <nowiki>13|octobre|-63|avJC=non</nowiki>
| {{#invoke:Date|modeleDate|13|octobre|-63|avJC=non}}
Ligne 231 ⟶ 230 :
|-
| date du calendrier julien
|<nowiki>14{{1er}}|octobre|2001|julien=oui</nowiki>
| {{#invoke:Date|modeleDate|141|octobre|2001|julien=oui}}
|
|-
Ligne 247 ⟶ 246 :
 
==== Comparaison avec {{m|date de naissance}} ====
* Lesles fonctions couteusescoûteuses sont les mêmemêmes que cellecelles du modèle Date
* sans l'ageâge, voir comparaison avec {{m|Date}}
{|class="wikitable alternance" style="text-align:center;"
|-
Ligne 295 ⟶ 294 :
 
==== Comparaison avec {{m|date sport}} ====
* lorsqu'il n'y a pas de qualificatif, « en sport » etest ajouté pour tester le module.
{|class="wikitable alternance" style="text-align:center;"
|-
Ligne 318 ⟶ 317 :
| 3 / 1
|-
| avec qualificatif et ageâge
|<nowiki>12|2|1980|en gymnastique|âgeage=oui</nowiki>
| {{date sport|12|2|1980|en gymnastique|âgeage=oui}}
| {{#invoke:Date|modeleDate|12|2|1980|en gymnastique|âgeage=oui}}
| 2 / 0
|-
Ligne 354 ⟶ 353 :
| 3 / 2
|}
 
 
<includeonly>
Récupérée de « https://fr.wikibooks.org/wiki/Module:Date/Documentation »