Template:JD/doc

From MattWiki
Jump to: navigation, search

This template converts date elements, or date and time elements, into a Julian date timestamp. It interprets all dates starting at 15 October 1582 in the Gregorian calendar, otherwise it uses the Julian calendar that was valid until 4 October 1582.

Syntax:
{{JD|year|[month]|[day]|[hour]|[minute]|[second]}}
{{JD}}
  • If the year parameter is missing, all other parameters are ignored, and their default is the current UTC date and time, as set on the server.
  • Otherwise, all parameters for the date and time must be specified as valid numeric expressions.
  • The default day and month are 1.
  • The computed year and month parameters are first converted into a rounded number of months since 01 December 1 AD and then converted to the actual year and month. For this prior computing, the day parameter and time parameters are ignored.
  • The default hour is 12 (for noon). Note that 24-hours format is used, so an hour parameter lower than 12 indicates the previous day in the old Julian day counting system, where days started at noon.
  • The default minute or second is 0.
  • Any date whose actual month and year are before October 1582, or are October 1582 but the computed day parameter is before the 15th at noon, will be interpreted as dates in the Julian calendar.
Example:
  • It is JD 2458076.0736111 now.
  • {{JD|1582|10|05|11|59|59}} returns 2299160.9999884 (this is the last valid instant of a Julian date before the Gregorian change, before noon, so actually it is still 4 October with the old date counting where days start at noon).
  • {{JD|1582|10|15|12|00|00}} returns 2299161 (this is the first instant of a Gregorian date, on 15 October at noon, i.e. 5 October at noon in the previous Julian calendar).
  • {{JD|1582|10|15|11|59|59}} returns 2299170.9999884 (this is still a date of the Julian calendar after the Gregorian change, and it is actually still the 14th of October before noon with the Julian calendar and the old Julian day counting system, or the 24th of October before noon with the proleptic Gregorian calendar and the old Julian day counting system where dates still changed at noon).
  • {{JD|1582|10|25|11|59|59}} returns 2299170.9999884 (this is still the same instant in the Gregorian calendar).

Note: the results may seem wrong, but they are not. The interpretation is given by comparing the Julian and Gregorian dates, so read twice the description of the third example; the exact calendar shift occurred between examples 1 and 2, and the 4th example is unambiguously in the Gregorian calendar.

See also: