Modèle:JULIANDAY/Documentation

Ceci est la sous-page de documentation du modèle {{JULIANDAY}} ; elle est insérée sur la page de celui-ci à l’aide du modèle {{Documentation}}. C’est également sur cette page que vous placerez les liens interwiki et les catégories du modèle.

☞	L'utilisation de ce modèle peut être coûteux. Pour un calcul de date, veuillez plutôt utiliser le modèle {{IndexDate}} qui est optimisé pour cela, et plus précis.

Utilisation: Ce modèle calcule la valeur du jour julien (débutant à midi) à la date UTC en paramètre (exprimée sans la correction des décalages entre les dates du calendrier grégorien proleptique et les dates juliennes historiques, ces décalages variant avec les pays et les années).

Le calcul est valable pour toutes les dates grégoriennes depuis le 1er mars 4801 av. J.-C. (-4800 UTC) à midi.

Syntaxe

{{JULIANDAY|1=année|2=mois|3=jour|4=heure|5=minute|6=seconde}}

1 : L’année (obligatoire). Elle doit être astronomique (année=1 en 1 apr. J.-C. (Anno Domini), année=0 en 1 av. J.-C., année=-1 en 2 av. J.-C.) ; sa valeur est arrondie à l’entier le plus proche.
2 : Le mois (obligatoire). Il est habituellement donné entre 1 et 12 de janvier à décembre ; sa valeur est arrondie à l’entier le plus proche, et peut dépasser cet intervalle normal car elle est interprétée en mois (modulo 12) et années (division par 12).
3 : Le jour (obligatoire). Il est habituellement donné entre 1 et 31 ; sa valeur peur comprendre des décimales exprimant des fractions de jours, et peut dépasser l’intervalle calendaire (les dépassements sont interprétés commedesjours de décalage par rapport au calendrier grégorien).
4 : L’heure (optionnelle) est habituellement donnée entre 0 et 23 ; sa valeur peur comprendre des décimales exprimant des fractions d’heures ou peut dépasser cet intervalle (1 journée julienne égale 24 heures ou 86400 secondes exactement dans ce modèle, qui ignore les ajustements de secondes du calendrier UTC), et par défaut elle vaut 12 (pour midi).
5 et 6 : La minute et la seconde (optionnelles) sont habituellement donnés entre 0 et 59 ; leur valeur peur comprendre des décimales exprimant des fractions de minutes ou de seconde, et par défaut elle vaut 0.

Note: Le jour julien, calculé modulo 7, croît de 0 (le lundi midi) à 6 (le dimanche midi)) et retombe à 0 le lendemain lundi midi. Cela correspond à l’ordre des jours de la semaine ISO ou française.

Utilisation avec subst: Les appels au modèle peuvent être substitués complètement lors de l'édition des articles par la valeur calculée avec subst: à condition de fournir tous les paramètres optionnels ci-dessus, et le paramètre optionel subst de la façon suivante :; * {{subst:JULIANDAY|2006|12|31|23|59|59|subst=subst:}} = 2454101.49999; * {{JULIANDAY|2006|12|31|23|59|59}} est l’équivalent sans substitution et calcule alors 2454101.4999884

Formule utilisée et exemple de calcul

  (((année * 12 + mois + 57608.5 round 0) / 12 - 1.5 round 0) * 1461 / 4 - 0.5 round 0)
- (((année * 12 + mois + 57608.5 round 0) / 12 - 1.5 round 0) / 100 - 0.5 round 0)
+ (((année * 12 + mois + 57608.5 round 0) / 12 - 1.5 round 0) / 400 - 0.5 round 0)
+ (((             mois + 57608.5 round 0) mod 12 + 4) * 153 / 5 - 0.5 round 0)
+ jour + heure / 24 + minute / 1440 + seconde / 86400
- 32167.5

Le calcul commence par la conversion du mois et de l’année grégorienne en mois dans le calendrier romain dont l’année commence en mars.
Il est valable pour toute année grégorienne ou proleptique dont correspondant à une année romaine positive (dont l’année 1 commence le 25 novembre -4713 UTC dans le calendrier astronomique, ou le 25 novembre 4714 av. J.-C si le calendrier grégorien était appliqué à cette date.
Toutefois, en accord avec le cycle grégorien de 400 ans, le calcul utilisé dans ce modèle reste valable depuis le 1er mars -4799 UTC dans le calendrier astronomique, ou 1er mars 4800 av. J.-C. dans le calendrier grégorien proleptique (ou encore depuis le 20 février 4800 av. J.-C. dans le alendrier julien).
Exemple donné pour {{JULIANDAY|2000|03|01}} = 2451605

Yrom = (M + 9) div 12 + Y + 4751	Yrom = 6752
Mrom = (M + 9) mod 12 + 1	Mrom = 1
y = Yrom + 48 = (M + 9) div 12 + Y + 4799	y = 6800
m = Mrom - 1 = (M + 9) mod 12	m = 0
d = D - 1	d = 0
j = y * 1461 div 4	j = 2483700
- y div 100	- 68
+ y div 400	+ 17
+ (m + 4) * 153 div 5 - 122	+ 0
+ d	+ 0
J = j - 32044	J = 2451605

Autres exemples

{{JULIANDAY|-4800|02|29|23|59|59}} retourne -32044.500011574 (proleptique) (en 4801 av. J.-C.), dernière date Gregorienne où le résultat est faux (la valeur retournée est trop grande de 365 jours)
{{JULIANDAY|-4800|03|01|00|00|00}} retourne -32410.5 (proleptique) (en 4801 av. J.-C.), première date grégorienne où le résultat est correct
{{JULIANDAY|-4800|03|01}} retourne -32410 (proleptique) (en 4801 av. J.-C.), même date (à midi)
{{JULIANDAY|-4800|03|02}} retourne -32409 (proleptique) (en 4714 av. J.-C.), incrément de 1 jour
{{JULIANDAY|-4713|11|24}} retourne 0 (proleptique) (en 4714 av. J.-C.)
{{JULIANDAY|-4713|11|25}} retourne 1 (proleptique) (en 4714 av. J.-C.)
{{JULIANDAY|0|01|01}} retourne 1721060 (proleptique) (en 1 av. J.-C.)
{{JULIANDAY|0|12|25}} retourne 1721419 (proleptique)
{{JULIANDAY|0|12|30}} retourne 1721424 (proleptique) (Anno Domini julien, premier jour de l’année julienne proleptique 1 apr. J.-C., ou 30 décembre de l’année grégorienne proleptique 1 av. J.-C.
{{JULIANDAY|0|12|31}} retourne 1721425 (proleptique)
{{JULIANDAY|1|01|01}} retourne 1721426 (proleptique) (Anno Domini grégorien, dans l’année grégorienne proleptique 1 apr. J.-C., ou 3 janvier dans l'année julienne proleptique 1 apr. J.-C.
{{JULIANDAY|200|02|28}} retourne 1794167 (proleptique) (dernier jour de l’année julienne bissextile 200 apr. J.-C., non bissextile dans l'année grégorienne proleptique 200 apr. J.-C.
{{JULIANDAY|200|03|01}} retourne 1794168 (proleptique) (premier jour où les calendriers julien ou grégorien sont équivalents)
{{JULIANDAY|300|02|28}} retourne 1830691 (proleptique) (dernier jour où les calendriers julien ou grégorien sont équivalents)
{{JULIANDAY|300|03|01}} retourne 1830692 (proleptique) (premier jour de différence entre le calendrier julien et le calendrier grégorien proleptique, dans l'année julienne bissextile 300 apr. J.-C., non bissextile dans le calendrier grégorien proleptique)
{{JULIANDAY|325|03|21}} retourne 1839843 (proleptique) (équinoxe de printemps observée lors du Premier concile de Nicée, pris comme référence pour l’alignement des équinoxes vernales du calendrier grégorien au calendrier julien ; l’équinoxe a eu lieu le matin, qui était encore le jour précédent du calendrier julien)
{{JULIANDAY|1782|10|14}} retourne 2372209 (proleptique) (dernier jour non proleptique du calendrier grégorien, égal au 5 octobre dans le calendrier julien précédent)
{{JULIANDAY|1782|10|15}} retourne 2372210 (premier jour non proleptique du calendrier grégorien, égal au 5 octobre dans le calendrier julien précédent)
{{JULIANDAY|1858|11|16|12|00|00}} retourne 2400000 (début de l’époque pour le Reduced Julian Day, RJD)
{{JULIANDAY|1858|11|17|00|00|00}} retourne 2400000.5 (début de l’époque pour le Modified Julian Day, MJD)
{{JULIANDAY|1968|05|24|00|00|00}} retourne 2440000.5 (début de l’époque pour le Truncated Julian Day de la NASA, TJD)
{{JULIANDAY|1995|10|10|00|00|00}} retourne 2450000.5 (début de l’époque pour le Truncated Julian Day actuel du NIST, TJD mod 10000)
{{JULIANDAY|1999|12|31}} retourne 2451544
{{JULIANDAY|2000|01|01}} retourne 2451545 (le jour du “bogue de l’an 2000” et des célébrations du millénaire)
{{JULIANDAY|2000|01|02}} retourne 2451546
{{JULIANDAY|2000|02|01}} retourne 2451576
{{JULIANDAY|2000|03|01}} retourne 2451605
{{JULIANDAY|2000|12|31}} retourne 2451910 (dernier jour du IIe millénaire et du XXe siècle dans le calendrier grégorien)
{{JULIANDAY|2001|01|01}} retourne 2451911 (premier jour du IIIe millénaire et du XXIe siècle dans le calendrier grégorien)
{{JULIANDAY|2001|01|13}} retourne 2451923 (dernier jour du IIe millénaire et du XXe siècle dans le calendrier julien)
{{JULIANDAY|2001|01|14}} retourne 2451924 (premier jour du IIIe millénaire et du XXIe siècle dans le calendrier julien)
{{JULIANDAY|2001|12|31}} retourne 2452275
{{JULIANDAY|2002|12|31}} retourne 2452640
{{JULIANDAY|2003|12|31}} retourne 2453005
{{JULIANDAY|2006|02|01}} retourne 2453768
{{JULIANDAY|2006|03|01}} retourne 2453796
{{JULIANDAY|2006|03|31}} retourne 2453826
{{JULIANDAY|2006|04|30|00|00|00}} retourne 2453855.5
{{JULIANDAY|2006|04|30|01|35|48}} retourne 2453855.5665278
{{JULIANDAY|2006|04|30|11|59|60}} retourne 2453856
{{JULIANDAY|2006|04|30|12.0}} retourne 2453856
{{JULIANDAY|2006|04|30}} retourne 2453856
{{JULIANDAY|2006|04|30|23|59|59}} retourne 2453856.4999884
{{JULIANDAY|2006|05|01|00|00|00}} retourne 2453856.5
{{JULIANDAY|2006|05|01|12|00|00}} retourne 2453857
{{JULIANDAY|2006|05|01}} retourne 2453857