Modèle:JULIANDAY/Documentation

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 Modèle:1er mars -4800 dans le calendrier astronomique (4801 av. J.-C.), à zéro heure.
Note :
Le jour julien, calculé modulo 7, croît de 0 (à partir de lundi midi) à 6 (à partir de dimanche midi) et retombe à 0 le lendemain lundi midi. Cela correspond à l’ordre des jours de la semaine ISO ou française. Ce modèle permet donc de facilement calculer le jour de la semaine correspondant à une date donnée au format calendaire, à condition de fixer l’heure à midi lors de l’appel de ce modèle, c’est-à-dire de l’appeler sans préciser l’heure et en ne passant que des éléments de date entiers.
Syntaxe :
{{JULIANDAY|1=année|2=mois|3=jour|4=heure|5=minute|6=seconde}}
  • 1=année (obligatoire) : l’année doit être au format 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.) ; des fractions d’années sont autorisées avec une précision limitée à 1/12 (0,25 en mars, 0,5 en juillet, 0,75 en septembre, etc.) selon le découpage non linéaire des 12 mois de l’année calendaire (les fractions en excès étant ignorées). Pour les dates avant notre ère, l’année donnée devrait être supérieure ou égale à -4799 (donc à partir de 4800 av. J.-C.), mais ce modèle ne le teste pas et peut retourner un résultat erroné lors des deux premiers mois de -4800 et dans les années antérieures (voir un exemple dans le tableau ci-dessous).
  • 2=mois (facultatif) : le mois 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), ou dépasser cet intervalle pour faire des calculs de dates demandant d’ajouter ou retrancher un nombre quelconque de mois. Par défaut, il vaut 1 (pour janvier).
  • 3=jour (facultatif) : le jour 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 comme des jours de décalage par rapport au calendrier grégorien), ou dépasser cet intervalle pour faire des calculs de dates demandant d’ajouter ou retrancher un nombre quelconque de jours. Par défaut, il vaut 1 (pour le 1er du mois).
  • 4=heure (facultatif) : l’heure 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 86 400 secondes exactement dans ce modèle, qui ignore les ajustements d’une ou deux secondes en plus ou en moins dans le calendrier coordonnée UTC et qui peuvent survenir tous les 6 mois de façon irrégulière), ou dépasser cet intervalle pour faire des calculs de dates demandant d’ajouter ou retrancher un nombre quelconque d’heures. Par défaut, elle vaut 12 (pour midi).
  • 5=minute (facultatif) : la minute est habituellement donnée entre 0 et 59 ; sa valeur peut comprendre des décimales exprimant des fractions de minutes ou de seconde, ou dépasser cet intervalle pour faire des calculs de dates demandant d’ajouter ou retrancher un nombre quelconque de minutes. Par défaut, elle vaut 0.
  • 6=seconde (facultatif) : la seconde est habituellement donnée entre 0 et 59 ; sa valeur peut comprendre des décimales exprimant des fractions de minutes ou de seconde, ou dépasser cet intervalle pour faire des calculs de dates demandant d’ajouter ou retrancher un nombre quelconque de secondes. Par défaut, elle vaut 0.
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 optionnel 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
Exemples :
Code Valeur retournée Note
{{JULIANDAY|-4800|02|29|23|59|59}} -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}} -32410.5 (proleptique) en 4801 av. J.-C., première date grégorienne où le résultat est correct
{{JULIANDAY|-4800|03|01}} -32410 (proleptique) en 4801 av. J.-C., même date (à midi)
{{JULIANDAY|-4800|03|02}} -32409 (proleptique) en 4714 av. J.-C., incrément de 1 jour
{{JULIANDAY|-4713|11|24|00|00|00}} -0.5 (proleptique) en 4714 av. J.-C., « jour julien ajusté » zéro, à zéro heure (AJD = 0)
{{JULIANDAY|-4713|11|24}} 0 (proleptique) en 4714 av. J.-C., date de référence des « jours juliens » traditionnels, à midi (JD=0)
{{JULIANDAY|-4713|11|25}} 1 (proleptique) en 4714 av. J.-C., fin du premier « jour julien » traditionnel
{{JULIANDAY|-0000|01|01}} 1721060 (proleptique) en 1 av. J.-C.
{{JULIANDAY|-0000|12|25}} 1721419 (proleptique)
{{JULIANDAY|-0000|12|30}} 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|-0000|12|31}} 1721425 (proleptique)
{{JULIANDAY|0001|01|01}} 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|0200|02|28}} 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|0200|03|01}} 1794168 (proleptique) premier jour où les calendriers julien ou grégorien sont équivalents
{{JULIANDAY|0300|02|28}} 1830691 (proleptique) dernier jour où les calendriers julien ou grégorien sont équivalents
{{JULIANDAY|0300|03|01}} 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|0325|03|21}} 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|1582|10|14}} 2299160 (proleptique) dernier jour non proleptique du calendrier grégorien (égal au 4 octobre dans le calendrier julien précédent) (LD = 0)
{{JULIANDAY|1582|10|15}} 2299161 premier jour d’entrée en application du calendrier grégorien (égal au 5 octobre 1582 dans le calendrier julien précédent), aussi appelé premier « jour lilien » (LD = 1)
{{JULIANDAY|1858|11|16|12|00|00}} 2400000 début de l’époque pour le Reduced Julian Day, RJD
{{JULIANDAY|1858|11|17|00|00|00}} 2400000.5 début de l’époque pour le Modified Julian Day, MJD
{{JULIANDAY|1968|05|24|00|00|00}} 2440000.5 début de l’époque pour le Truncated Julian Day de la NASA, TJD
{{JULIANDAY|1995|10|10|00|00|00}} 2450000.5 début de l’époque pour le Truncated Julian Day actuel du NIST, TJD mod 10000
{{JULIANDAY|1999|12|31}} 2451544  
{{JULIANDAY|2000|01|01}} 2451545 le jour du « bogue de l’an 2000 » et des célébrations du millénaire
{{JULIANDAY|2000|01|02}} 2451546  
{{JULIANDAY|2000|02|28}} 2451603  
{{JULIANDAY|2000|03|01}} 2451605 lendemain du précédent (année 2000 non bissextile)
{{JULIANDAY|2000|12|31}} 2451910 dernier jour du [[IIe millénaire|Modèle:Mi-]] et du XXe siècle dans le calendrier grégorien
{{JULIANDAY|2001|01|01}} 2451911 premier jour du Modèle:Mi- et du XXIe siècle dans le calendrier grégorien
{{JULIANDAY|2001|01|13}} 2451923 dernier jour du [[IIe millénaire|Modèle:Mi-]] et du XXe siècle dans le calendrier julien
{{JULIANDAY|2001|01|14}} 2451924 premier jour du Modèle:Mi- et du XXIe siècle dans le calendrier julien
{{JULIANDAY|2001|12|31}} 2452275 (à midi)
{{JULIANDAY|2002|01|00|12|00|00}} 2452275 identique au précédent (date non renormalisée)
{{JULIANDAY|2002|01|100.5}} 2452375.5 100,5 jours après le précédent (date non renormalisée), identique au suivant
{{JULIANDAY|2002|04|11|00|00|00}} 2452375.5 date normalisée (à zéro heure)
{{JULIANDAY|2002|04|11}} 2452376 12 heures après le précédent (à midi)
{{JULIANDAY|2002|12|31}} 2452640  
{{JULIANDAY|2003|12|31}} 2453005 365 jours après le précédent (année 2003 non bissextile)
{{JULIANDAY|2006|02|01}} 2453065 veille du suivant (année 2004 bissextile)
{{JULIANDAY|2006|03|30}} 2453095 lendemain du précédent, identique au suivant (année 2004 bissextile)
{{JULIANDAY|2006|03|01}} 2453066  
{{JULIANDAY|2006|02|01}} 2453795 veille du suivant (année 2006 non bissextile)
{{JULIANDAY|2006|02|01}} 2453796 lendemain du précédent, identique au suivant (année 2006 non bissextile)
{{JULIANDAY|2006|03|01}} 2453796  
{{JULIANDAY|2006|03|31}} 2453826 12 heures avant le suivant (à midi)
{{JULIANDAY|2006|04|30|00|00|00}} 2453855.5 (à zéro heure)
{{JULIANDAY|2006|04|30|01|35|48}} 2453855.5665278  
{{JULIANDAY|2006|04|30|11|59|60}} 2453856 identique au suivant (seconde non renormalisée)
{{JULIANDAY|2006|04|30|12.0}} 2453856 heure décimale, identique au suivant
{{JULIANDAY|2006|04|30|12|00}} 2453856 heure normalisée (sexagésimale)
{{JULIANDAY|2006|04|30}} 2453856 identique au précédent (à midi)
{{JULIANDAY|2006|04|30|23|59|59}} 2453856.4999884 1 seconde avant le suivant
{{JULIANDAY|2006|05|01|00|00|00}} 2453856.5 12 heures avant le suivant
{{JULIANDAY|2006|05|01|12|00|00}} 2453857  
{{JULIANDAY|2006|05|01}} 2453857 identique au précédent
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 Modèle:1er mars -4800 UTC dans le calendrier astronomique, ou Modèle:1er mars 4801 av. J.-C. dans le calendrier grégorien proleptique (ou encore depuis le 20 février 4801 av. J.-C. dans le calendrier julien qui n’est pas utilisé ici).
  • Exemple donné pour {{JULIANDAY|2000|03|01}} = 2451605 (à midi)
Conversion de l’année et du mois en années romaines (débutant en mars 4750 av. J.-C.) Yrom = (M + 9) div 12 + Y + 4751 Yrom = 6752
Mrom = (M + 9) mod 12 + 1 Mrom = 1
Conversion en années, mois et jours relatifs
depuis le Modèle:1er mars d’une année de référence
pour le calcul des années bissextiles (depuis 4801 av. J.-C.)
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
Calcul calendaire effectif. Ajoute :
  • le nombre de jours dans les années juliennes relatives (1 461 jours exactement tous les 4 ans)
j = y * 1461 div 4 j = 2483700
  • la correction spécifiquement grégorienne pour les années séculaires,
  − y div 100   − 68
  + y div 400   + 17
  • le nombre de jours dans les mois relatifs passés depuis mars,
  + (m + 4) * 153 div 5 - 122   + 0
  • le nombre de jours dans le mois relatif,
  + d   + 0
  • et la fraction de jour due à l’heure, positive ou négative (avant ou après midi).
  + (heure - 12) / 24 + minute / 86400 + seconde   + 0
Décalage pour l’époque julienne traditionnelle, qui débute exactement
le Modèle:1er janvier -4712 (4713 av. J.-C.) selon le calendrier julien proleptique ou
le 24 novembre -4713 (4714 av. J.-C.) dans le calendrier grégorien proleptique
JD = j - 32044 JD = 2451605
Voir aussi