View source for Template:Diff days/doc

{{Documentation subpage}}
{{lua|Module:diff days}}
This template calculates the date/time difference between two dates in days shown in decimal form. Dates in the Gregorian calendar from 9999 BCE to 9999 CE are supported. The calendar is proleptic—it is assumed to apply at all times with no irregularities.

== Syntax ==

*<code>&#123;{diff days|{{var|date1}}|{{var|date2}}|precision=}}</code>
There are two positional arguments: {{var|date1}} and {{var|date2}}; both are required

The result displays text representing the time interval from ''date1'' to ''date2''  ({{var|date2}} − {{var|date1}}) in decimal notation of {{para|precision}} which defaults to 3; {{para|precision}} accepts an integer from 0 to 99.

{{var|date1}} and {{var|date2}} are timezone agnostic when timezone not specified; {{var|date1}} and {{var|date2}} may have timezone specifiers:
:<code><nowiki>{{diff days|2022-03-16 12:00:00UTC|2022-03-16 12:00:00UTC}}</nowiki></code> → {{diff days|2022-03-16 12:00:00UTC|2022-03-16 12:00:00UTC}}
:<code><nowiki>{{diff days|2022-03-16 12:00:00UTC|2022-03-16 12:00:00PST}}</nowiki></code> → {{diff days|2022-03-16 12:00:00UTC|2022-03-16 12:00:00PST}}

Each date can include an era or a time, and a variety of formats are accepted. Examples of valid dates are:
:1900-02-01
:1900-2-1
:1900-02-01 14:45
:1 FEB 1900
:February 1, 1900
:February 1 1900 14:45
:2:45 pm February 1 1900
:1 February 1900 2:45 p.m.
:BC 1 Feb 120
*<code><nowiki>{{diff days|2021-04-09 07:42:41|2021-10-17 04:35:44}}</nowiki></code> → {{diff days|2021-04-09 07:42:41|2021-10-17 04:35:44}}
If the result is to include a specific no. of decimal places, add another parameter {{para|precision}} which defaults to 3 and accepts any integer from 0 to 99:
*<code><nowiki>{{diff days|2021-04-09 07:42:41|2021-10-17 04:35:44|precision=5}}</nowiki></code> → {{diff days|2021-04-09 07:42:41|2021-10-17 04:35:44|precision=5}}
<includeonly>{{Sandbox other||
<!-- Categories below this line -->
[[Category:Date mathematics templates]]
[[Category:Date-computing templates]]
}}</includeonly>