Alex: Created page with "{{documentation}} The '''JulianDay''' template computes the number of the Julian day starting at noon on the date given in parameter (in the Gregorian calendar, without any Julian correction for proleptic Gregorian dates where the calendar was not effectively applied). '''Note:''' The result is valid for all proleptic Gregorian calendar dates starting on 1 March 4801 BC..."

2024-10-16T23:33:44Z

Created page with "{{documentation}} The '''JulianDay''' template computes the number of the Julian day starting at noon on the date given in parameter (in the Gregorian calendar, without any Julian correction for proleptic Gregorian dates where the calendar was not effectively applied). '''Note:''' The result is valid for all proleptic Gregorian calendar dates starting on 1 March 4801 BC..."

New page

{{documentation}}

The '''JulianDay''' template computes the number of the [[Wikipedia:Julian day|Julian day]] starting at noon on the date given in parameter (in the [[Wikipedia:Gregorian calendar|Gregorian calendar]], without any Julian correction for [[Wikipedia:Proleptic Gregorian calendar|proleptic Gregorian dates]] where the calendar was not effectively applied).

'''Note:''' The result is valid for all proleptic Gregorian calendar dates starting on 1 March 4801 BC at midnight.

==Uses==
This template can be used to calculate differences between 2 dates, and is used in [[:Template:DateDiff]].

==Syntax==
<nowiki>{{JULIANDAY|year|month|day|hour|minute|second}}</nowiki>

* The ''year'' (required) must be astronomical (''year''=1 in 1 AD (''[[Wikipedia:Anno Domini|Anno Domini]]''), ''year''=0 in 1 BC, ''year''=-1 in 2 BC).
* The ''month'' (optional, default value 1) is expressed between 1 and 12 from January to December (but offsets are possible for computing other years).
* The ''year'' and ''month'' are first converted into a number of months, then rounded to the nearest integer to compute the actual year and month used for computing dates.
* The ''day'' (optional, default value 1) is normally between 1 and 31 (but offsets are possible for computing other months). Decimals are possible for fractions of day.
* The ''hour'' (optional, default value 12) is normally between 0 and 23 (but offsets are possible for computing other days). Note that Julian days begin at noon (hour = 12) and thus hours 0-11 of a solar day are one Julian day earlier than hours 12-23. The value may extend outside of the normal range and is considered as additional number of julian days (a Julian day is 24 hours or 86,400 seconds exactly, ignoring any adjustment of leap seconds within the UTC calendar). Decimals are possible for fractions of hour.
* The ''minute'' and ''second'' (optional, default value 0) are normally between 0 and 59 (but offsets are possible for computing other hours). Decimals are possible for fractions of minute or second.
* All parameters can be any valid numeric expression which is evaluated before computing.

===Note===
The julian day, when computed modulo 7, grows from 0 (on Monday at noon) to 6 (on Sunday at noon)) and falls back to 0 (on next Monday). This corresponds to the order of days in the ISO week.

==Examples==
* <nowiki>{{</nowiki>JulianDay<nowiki>|-4800|2|29|23|59|59}}</nowiki> returns {{JulianDay|-4800|2|29|23|59|59}} (''proleptic'') (in ''year 4801 BC''), last Gregorian date where the result is '''false''' (the returned JD is too large by 365 days)
* <nowiki>{{</nowiki>JulianDay<nowiki>|-4800|3|1|0|0|0}}</nowiki> returns {{JulianDay|-4800|3|1|0|0|0}} (''proleptic'') (in ''year 4801 BC''), first Gregorian date where the result is correct
* <nowiki>{{</nowiki>JulianDay<nowiki>|-4800|3|1}}</nowiki> returns {{JulianDay|-4800|3|1}} (''proleptic'') (in ''year 4801 BC''), same date at noon
* <nowiki>{{</nowiki>JulianDay<nowiki>|-4800|3|2}}</nowiki> returns {{JulianDay|-4800|3|2}} (''proleptic'') (in ''year 4714 BC''), tests the 1 day increment
* <nowiki>{{</nowiki>JulianDay<nowiki>|-4713|11|24}}</nowiki> returns {{JulianDay|-4713|11|24}} (''proleptic'') (in ''year 4714 BC'')
* <nowiki>{{</nowiki>JulianDay<nowiki>|-4713|11|25}}</nowiki> returns {{JulianDay|-4713|11|25}} (''proleptic'') (in ''year 4714 BC'')
* <nowiki>{{</nowiki>JulianDay<nowiki>|0|1|1}}</nowiki> returns {{JulianDay|0|1|1}} (''proleptic'') (in ''year 1 BC'')
* <nowiki>{{</nowiki>JulianDay<nowiki>|0|12|25}}</nowiki> returns {{JulianDay|0|12|25}} (''proleptic'')
* <nowiki>{{</nowiki>JulianDay<nowiki>|0|12|30}}</nowiki> returns {{JulianDay|0|12|30}} (''proleptic'') (Julian ''Anno Domini'', first day in proleptic Julian year 1 AD, or December 30 in proleptic Gregorian year 1 BC)
* <nowiki>{{</nowiki>JulianDay<nowiki>|0|12|31}}</nowiki> returns {{JulianDay|0|12|31}} (''proleptic'')
* <nowiki>{{</nowiki>JulianDay<nowiki>|1|1|1}}</nowiki> returns {{JulianDay|1|1|1}} (''proleptic'') (Gregorian ''Anno Domini'', in proleptic Gregorian year 1 AD, or January 3 in proleptic Julian year 1 AD)
* <nowiki>{{</nowiki>JulianDay<nowiki>|200|2|28}}</nowiki> returns {{JulianDay|200|2|28}} (''proleptic'') (last day of Julian leap year 200 AD, not leap in the proleptic Gregorian calendar)
* <nowiki>{{</nowiki>JulianDay<nowiki>|200|3|1}}</nowiki> returns {{JulianDay|200|3|1}} (''proleptic'') (first day where the Julian and proleptic Gregorian calendars are '''equivalent''')
* <nowiki>{{</nowiki>JulianDay<nowiki>|300|2|28}}</nowiki> returns {{JulianDay|300|2|28}} (''proleptic'') (last day where the Julian and proleptic Gregorian calendars are '''equivalent''')
* <nowiki>{{</nowiki>JulianDay<nowiki>|300|3|1}}</nowiki> returns {{JulianDay|300|3|1}} (''proleptic'') (first day of difference between the Julian and proleptic Gregorian calendars, in leap Julian year 300 AD, not leap in the proleptic Gregorian calendar)
* <nowiki>{{</nowiki>JulianDay<nowiki>|325|3|21}}</nowiki> returns {{JulianDay|325|3|21}} (''proleptic'') (spring equinox observed at the Christian [[Wikipedia:First Council of Nicaea|First Council of Nicaea]], taken as a reference for aligning the Julian calendar to the proleptic Gregorian)
* <nowiki>{{</nowiki>JulianDay<nowiki>|1782|10|14}}</nowiki> returns {{JulianDay|1782|10|14}} (''proleptic'') (last proleptic Gregorian day, actually the 4th of October in the Julian calendar)
* <nowiki>{{</nowiki>JulianDay<nowiki>|1782|10|15}}</nowiki> returns {{JulianDay|1782|10|15}} (first non proleptic Gregorian day, equals the 5th of October in the previous Julian calendar)
* <nowiki>{{</nowiki>JulianDay<nowiki>|1858|11|16|12|00|00}}</nowiki> returns {{JulianDay|1858|11|16|12|00|00}} (start of epoch for the [[Wikipedia:Julian day#Alternatives|Reduced Julian Day]], RJD)
* <nowiki>{{</nowiki>JulianDay<nowiki>|1858|11|17|00|00|00}}</nowiki> returns {{JulianDay|1858|11|17|00|00|00}} (start of epoch for the [[Wikipedia:Julian day#Alternatives|Modified Julian Day]], MJD)
* <nowiki>{{</nowiki>JulianDay<nowiki>|1968|05|24|00|00|00}}</nowiki> returns {{JulianDay|1968|05|24|00|00|00}} (start of epoch for the [[Wikipedia:NASA|NASA]]'s [[Wikipedia:Julian day#Alternatives|Truncated Julian Day]], TJD)
* <nowiki>{{</nowiki>JulianDay<nowiki>|1995|10|10|00|00|00}}</nowiki> returns {{JulianDay|1995|10|10|00|00|00}} (start of epoch for the current [[Wikipedia:NIST|NIST]]'s [[Wikipedia:Julian day#Alternatives|Truncated Julian Day]], TJD mod 10000)
* <nowiki>{{</nowiki>JulianDay<nowiki>|1999|12|31}}</nowiki> returns {{JulianDay|1999|12|31}}
* <nowiki>{{</nowiki>JulianDay<nowiki>|2000|1|1}}</nowiki> returns {{JulianDay|2000|1|1}} (the “[[Wikipedia:Year 2000 problem|Y2K bug]]'s day” and millennium celebrations)
* <nowiki>{{</nowiki>JulianDay<nowiki>|2000|1|2}}</nowiki> returns {{JulianDay|2000|1|2}}
* <nowiki>{{</nowiki>JulianDay<nowiki>|2000|2|1}}</nowiki> returns {{JulianDay|2000|2|1}}
* <nowiki>{{</nowiki>JulianDay<nowiki>|2000|3|1}}</nowiki> returns {{JulianDay|2000|3|1}}
* <nowiki>{{</nowiki>JulianDay<nowiki>|2000|12|31}}</nowiki> returns {{JulianDay|2000|12|31}} (last day of the 2nd millennium and of the 20th century in the Gregorian calendar)
* <nowiki>{{</nowiki>JulianDay<nowiki>|2001|1|1}}</nowiki> returns {{JulianDay|2001|1|1}} (first day of the 3rd millennium and of the 21st century in the Gregorian calendar)
* <nowiki>{{</nowiki>JulianDay<nowiki>|2001|12|31}}</nowiki> returns {{JulianDay|2001|12|31}}
* <nowiki>{{</nowiki>JulianDay<nowiki>|2002|12|31}}</nowiki> returns {{JulianDay|2002|12|31}}
* <nowiki>{{</nowiki>JulianDay<nowiki>|2003|12|31}}</nowiki> returns {{JulianDay|2003|12|31}}
* <nowiki>{{</nowiki>JulianDay<nowiki>|2006|2|1}}</nowiki> returns {{JulianDay|2006|2|1}}
* <nowiki>{{</nowiki>JulianDay<nowiki>|2006|3|1}}</nowiki> returns {{JulianDay|2006|3|1}}
* <nowiki>{{</nowiki>JulianDay<nowiki>|2006|3|31}}</nowiki> returns {{JulianDay|2006|3|31}}
* <nowiki>{{</nowiki>JulianDay<nowiki>|2006|4|30|0|0|0}}</nowiki> returns {{JulianDay|2006|4|30|0|0|0}}
* <nowiki>{{</nowiki>JulianDay<nowiki>|2006|4|30|01|35|48}}</nowiki> returns {{JulianDay|2006|4|30|01|35|48}}
* <nowiki>{{</nowiki>JulianDay<nowiki>|2006|4|30|11|59|60}}</nowiki> returns {{JulianDay|2006|4|30|11|59|60}}
* <nowiki>{{</nowiki>JulianDay<nowiki>|2006|4|30|12.0}}</nowiki> returns {{JulianDay|2006|4|30|12.0}}
* <nowiki>{{</nowiki>JulianDay<nowiki>|2006|4|30}}</nowiki> returns {{JulianDay|2006|4|30}}
* <nowiki>{{</nowiki>JulianDay<nowiki>|2006|4|30|23|59|59}}</nowiki> returns {{JulianDay|2006|4|30|23|59|59}}
* <nowiki>{{</nowiki>JulianDay<nowiki>|2006|5|1|00|00|00}}</nowiki> returns {{JulianDay|2006|5|1|00|00|00}}
* <nowiki>{{</nowiki>JulianDay<nowiki>|2006|5|1|12|00|00}}</nowiki> returns {{JulianDay|2006|5|1|12|00|00}}
* <nowiki>{{</nowiki>JulianDay<nowiki>|2006|5|1}}</nowiki> returns {{JulianDay|2006|5|1}}

==See also==
* [[:Template:DateDiff]]

<noinclude>[[Category:Template documentation|{{PAGENAME}}]]</noinclude>

Template:JulianDay/doc - Revision history