Module:Date/Documentation

Attention, certaines fonctions de ce module sont utilisées par les modèles {{ouvrage}} et {{article}} (100 000 pages).

Utilisation

Fonctions utilisables depuis un modèle

• modeleDate(frame) – affiche une date avec les liens les plus pertinents (précisions ci-dessous).
• modeleInscriptionDate(frame) – affiche une date correctement formatée, sans lien. l'année est obligatoire. Paramètres nommés année, mois, jour. (utilisé par module Biblio)
• dateISO(frame) – 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éfinie la date uniquement selon le calendrier grégorien, cette fonction ne retourne rien pour les date avant 1583.
• dateRepublicain(frame) – affiche une date grégorienne au format républicain (sans liens). Paramètres 1=année, 2=mois, 3=jour.
• modeleAge(frame) - retourne l'age (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.
• erreurModuleData() - retourne un message d'erreur si Module:Date/Data ne se charge pas correctement.
• checkDataCat(frame) - retourne une liste de page annuelle et mensuelle pour facilité les mises à jour de Date/Data. Paramètres 1=cat, mois=liste de mois si 'oui', alias = liste tous les alias si 'oui'

fonction utilisable depuis un autre module

• nomDuMois( num ) – retourne le nom français du mois n° num.
• valideMois( mois ) – retourne le nom français et le n° de mois (nom français, abrégé, anglais, ou nombre entre 1 et 12).
• determinationMois( mois, frame ) - 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 )
• do_dayRank(arguments) - Rang du jour dans l'année. Paramètre arguments = { année, mois, jour } ou { year = année, month = mois, day = jour }
• isLeapYear(year) - retourne true si year est une année bisextile dans le calendrier grégorien.
• toRoman(number) - transforme number en une chaine le représentant en « chiffres romains ».
• age( an, mn, jn, ac, mc, jc ) - similaire à modeleAge, mais les paramètres ne sont pas dans une table
• julianDay( year, month, day, hour, minute, second ) - retourne le jour julien de la date transmise, suivant le calendrier grégorien astronomique (avec année 0)
• julianDayJulian( year, month, day, hour, minute, second ) - retourne le jour julien d'une date du calendrier julien astronomique (avec année 0)
• jullianDayToGregorian( jd ) - retourne trois variable année, mois, jour représentant la date du calendrier grégorien astronomique correspondant à ce jour julien.
• jullianDayToJulian( jd ) - retourne trois variable année, mois, jour représentant la date du calendrier julien correspondant à ce jour julien.
• jullianToGregorian( year, month, day ) - transforme une date du calendrier julien en date du calendrier grégorien.
• gregorianToJullian( year, month, day ) - transforme une date du calendrier grégorien en date du calendrier julien.

Modules externes dont ce module a besoin pour fonctionner

• Date/Data - Base de donnée permettant de ne pas tester les pages que l'on sait existante, ou n'existant pas.
• TableBuilder – Utilise .insert et .concat pour simplifier la syntaxe.

modeleDate( frame )

Paramètres

• 1 - jour ou vide - numérique, exeption possible pour 1er ou 1^er.
• 2 - mois ou jour - numérique ou nom français ou anglais, éventuellement une abréviation courante.
• 3 - 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.
• 4 - qualificatif ou année - texte correspondant à une page type « en photographie » pour « 2008 en photographie »
• 5 - qualificatif
• age ou âge - non vide pour afficher l'age (aucun age n'est affiché pour les date dans le futur)
• julien - 'oui' pour que la date soit considérée suivant le calendrier julien après le 14 otobre 1582. La date sera affiché suivant les deux calendrier.
• avJC - 'non' pour ne pas affiché 'av. J.-C.' après l'année si elle représente une année anvant Jésus Chirst. Utile pour éviter les répétitions.

• paramètres page - Si un modèle {{date}} contient ce paramètre, et les paramètre julien, avJC et qualificatif seront appliqué à 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.
• qualificatif - qualificatif a appliquer sur toute la page. Ne fonctionne qu'en liaison avec le paramètre paramétres page

fonctionnement

• 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.
• 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 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è 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 . 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 comparée aux modèles existant

Comparaison avec {{date}}

motif testé	chaine testée	Modèle Date	Module	fonctions couteuses modèle / module
date récente	14|octobre|2001	14 octobre 2001	14 octobre 2001	1 / 0
date ancienne (1700 - 1943), jour =1	1|octobre|1842	1er octobre 1842	1er octobre 1842	1 / 1
date très ancienne (<1700), jour = 1er	1er|janvier|537	1er janvier 537	1er janvier 537	1 / 0
qualificatif qui n'est pas dans la base	14|octobre|2010|en animation asiatique	14 octobre 2010	14 octobre 2010	4 / 1
date ancienne, qualificatif qui n'est pas dans la base	14|octobre|1842|en animation asiatique	14 octobre 1842	14 octobre 1842	4 / 2
avec qualificatif	14|Octobre|2001|en astronautique	14 octobre 2001	14 octobre 2001	3 / 0
avec qualificatif avec éphémérides	14|octobre|2005|dans les chemins de fer	14 octobre 2005	14 octobre 2005	4 / 0
pas de jour	|octobre|2001	octobre 2001	octobre 2001	1 / 0
pas de jour avec qualificatif	|Octobre|2001|en astronautique	Octobre 2001	Octobre 2001	3 / 0
qualificatif avec page annuelle qui pourrait exister	14|octobre|2006|en Égypte	14 octobre 2006	14 octobre 2006	4 / 1
qualificatif avec page mensuelle existante	14|octobre|2008|en France	14 octobre 2008	14 octobre 2008	3 / 0
qualificatif avec page mensuelle qui pourrait exister	14|octobre|2012|en France	14 octobre 2012	14 octobre 2012	4 / 1
qualificatif avec page annuelle et mensuelle qui pourrait exister	14|octobre|2012|en économie	14 octobre 2012	14 octobre 2012	4 / 2
date ancienne avec qualificatif	14|octobre|1845|en aéronautique	14 octobre 1845	14 octobre 1845	4 / 1
décalage	|25|octobre|2006			3 / 0
décalage et qualificatif	|25|octobre|2006|en sport			3 / 0
date négative	13|octobre|-63	13 octobre 63 av. J.-C.	13 octobre 63 av. J.-C.	1 / 0
date av. J.-C; (orthographe de la page)	{{1er}}|octobre|63 av av. J.-C.	1er octobre 63 av. J.-C.	1er octobre 63 av. J.-C.	1 / 0
date avJC (orthographe abrégée)	13|octobre|63 avJC	13 octobre 63 av. J.-C.	13 octobre 63 av. J.-C.	1 / 0
date négative, paramètre pour cahée av. J.-C.	13|octobre|-63|avJC=non	13 octobre 63	13 octobre 63	1 / 0
année invalide	14|octobre|2001 en sport			1 / 0
jour + mois avec majuscule	14|Octobre|2001	14 octobre 2001	14 octobre 2001	1 / 0
mois en abrégé	14|oct.|2001	14 octobre 2001	14 octobre 2001	1 / 0
mois en chiffre	14|10|2001	14 octobre 2001	14 octobre 2001	1 / 0
mois invalide	14|otcobre|2001			1 / 0
jour invalide	jeudi 14|octobre|2001	14 octobre 2001	14 octobre 2001	1 / 0
jour invalide (trop grand pour le mois)	31|septembre|2001			1 / 0
uniquement l’année	||2001	2001	2001	1 / 0
uniquement l’année avec qualificatif	||2001|en littérature	2001	2001	1 / 0
sans année	14|octobre	14 octobre	14 octobre	0 / 0
jour uniquement	14	14	14	0 / 0
mois uniquement	|Octobre	Octobre	Octobre	0 / 0
décalage sans jour	||Octobre|2001			0 / 0
sans argument				0 / 0
date du calendrier julien	14|octobre|2001|julien=oui		27 octobre (14 octobre) 2001
date du calendrier julien fin déc.	25|dec|2001|julien=oui		7 janvier 2002 (25 décembre 2001)
date de naissance	14|octobre|2001|age=oui		14 octobre 2001

Comparaison avec {{date de naissance}}

• Les fonctions couteuses sont les même que celle du modèle Date
• sans l'age, voir comparaison avec {{Date}}

motif testé	chaine testée	Modèle Date de naissance	Module
simple	1|8|2006|âge=oui	1er août 2006	1er août 2006
avec qualificatif	1|août|2006|en Suisse|age=oui	1er août 2006	1er août 2006
date ancienne	2|1|598|age=oui	2 janvier 598	2 janvier 598
l'an dernier	2|1|2012|age=oui	2 janvier 2012	2 janvier 2012
cette année	2|1|2013|age=oui	2 janvier 2013	2 janvier 2013
l'an prochain	2|1|2014|age=oui	2 janvier 2014	2 janvier 2014
sans jour	|8|2006|âge=oui	août 2006	août 2006
annee seule	||2006|âge=oui	2006	2006

Comparaison avec {{date sport}}

• lorsqu'il n'y a pas de qualificatif, « en sport » et ajouté pour tester le module.

motif testé	chaine testée	Modèle Date sport	Module	fonctions couteuses modèle / module
simple	1|2|1980	1er février 1980	1er février 1980	1 / 0
avec qualificatif	12|2|1980|en gymnastique	12 février 1980	12 février 1980	2 / 0
qualificatif avec page possible pour cette année	12|2|1977|en gymnastique	12 février 1977	12 février 1977	3 / 1
avec qualificatif et age	12|2|1980|en gymnastique|âge=oui	12 février 1980	12 février 1980	2 / 0
date ancienne	12|2|1843	12 février 1843	12 février 1843	1 / 0
date récente avec page mensuelle	12|2|2006	12 février 2006	12 février 2006	1 / 0
date récente avec page mensuelle et qualif	12|2|2006|en gymnastique	12 février 2006	12 février 2006	2 / 0
date trop récente sans page mensuelle	1|8|2013	1er août 2013	1er août 2013	1 / 1
date trop récente sans page mensuelle et qualif avec page annuelle possible	1|8|2013|en gymnastique	1er août 2013	1er août 2013	3 / 2