Template:DATEDIFF2/doc
This is a documentation subpage for Template:DATEDIFF2. It contains usage information, categories and other content that is not part of the original template page. |
Contents
Description
For dates from 1 January 1970 onward only!
This template returns the difference in days (possibly with decimals) between two dates in the Gregorian calendar. The return value is positive if date2
comes after date1
, and is negative if date2
comes before date1
(i.e. the template computes date2 - date1
). This template is identical to {{DATEDIFF}}, except that it requires only that up to two parameters be inputted instead of up to twelve since it makes use of the #time:
parser function.
Usage
If two dates supplied, the template calculates the difference between them, in days. If only one date is supplied, then the supplied date is calculated against the current date. If no dates are supplied, the template calculates the number of days from the start of the Julian epoch to the current date. If an invalid date is supplied, then the text is returned unaltered.
The inputted dates may be in any format understood by the #time:
parser function. E.g., July 18, 2008
, 18 July 2008
and 2008-07-18
are all valid. Hours, minutes and seconds can likewise be inputted.
This template can be used for dates from 1 January 1970 onward only.
Examples
Code | Output |
---|---|
{{DATEDIFF2|18 July 2008|2008-07-16}}
|
-2 |
{{DATEDIFF2|July 16, 2008 8PM|2008-07-18 8:00:00}}
|
1.5 |
{{DATEDIFF2|2008-07-18}}
|
5974.1229745001 |
{{DATEDIFF2|{{#time:c}}}}
|
should always equal zero |
{{DATEDIFF2}}
|
739612.1229745 |
{{DATEDIFF2|invalid}}
|
invalid |
See also
- Template:DATEDIFF (backlinks edit)
- Template:JULIANDAY (backlinks edit) - used internally by this template.
- Template:MONTHDIFF2 (backlinks edit)