RandomUser34: 1 revision imported

2026-10-12T00:03:24Z

1 revision imported

← Older revision		Revision as of 00:03, 12 October 2026
(No difference)

WP>Jonesey95: add standard TD section header

2026-10-05T13:55:21Z

add standard TD section header

New page

{{documentation subpage}}
{{Lua|Module:Age|Module:Date}}
This template calculates the date/time difference between two dates. 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 ==
{{Template shortcuts|t-int}}
*<code>{{time interval|''date1''|''date2''|''options''}}</code>

There are two positional arguments: ''date1'' and ''date2''. The default for each is the current date and time.

The result displays text representing the time interval from ''date1'' to ''date2'' (''date2'' − ''date1'').

Dates are [[Coordinated Universal Time|UTC]]—local times and time zones are not supported.

Dates are checked for validity. For example, 29 February 2000 is accepted, but 29 February 1900 is not a valid date.

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

Examples:
*<code><nowiki>{{time interval|1 Jan 2001|March 4, 2002}}</nowiki></code> → {{time interval|1 Jan 2001|March 4, 2002}}
*<code><nowiki>{{time interval|1 Jan 2001|March 4, 2002|abbr=on}}</nowiki></code> → {{time interval|1 Jan 2001|March 4, 2002|abbr=on}}
*<code><nowiki>{{time interval|B.C.E. 1 Feb 120|28 FEB 1900}}</nowiki></code> → {{time interval|B.C.E. 1 Feb 120|28 FEB 1900}}

== Parameters ==
{| class="wikitable"
! Parameter !! Description
|-
| <code>abbr=off</code> || Unit names in full (default): year, month, day, hour, minute.
|-
| <code>abbr=on</code> || Units shown as a single letter with no space between number and unit: y, m, d, h, m.
|-
| <code>disp=age</code> || If no <code>show</code> has been entered, years are displayed if the age is above 3 years, years and months from 1 to 3 years, or months and days for under 1 year. Sets <code>sep=space</code> by default. This is compatible with {{tl|age for infant}}.
|-
| <code>disp=raw</code> || Display numbers only with <code>sep=space</code>.
|-
| <code>duration=on</code> || Period is a duration (has an extra day to include the end date).
|-
| <code>format=commas</code> || Numbers over 999 are formatted with commas.
|-
| <code>format=raw</code> || Use a hyphen (-) to indicate a negative date difference instead of a minus (−); a hyphen may allow the result to be used in a calculation.
|-
| <code>sep=comma</code> || Separator between items is a comma: 1 year, 2 months, 3 days. The default is 1 year, 2 months and 3 days.
|-
| <code>sep=,</code> || Same as <code>sep=comma</code>.
|-
| <code>sep=serialcomma</code> || Use a [[serial comma]]: 1 year, 2 months, and 3 days.
|-
| <code>sep=space</code> || Use a space: 1 year 2 months 3 days.
|-
| <code>sc=y</code> || Change the default separator to use a serial comma. Also accepts <code>sc=yes</code> and <code>sc=on</code>.
|-
| <code>show=y</code> || years
|-
| <code>show=ym</code> || years and months
|-
| <code>show=ymd</code> || years, months and days (default)
|-
| <code>show=ymw</code> || years, months and weeks
|-
| <code>show=ymwd</code> || years, months, weeks and days
|-
| <code>show=yd</code> || years and days
|-
| <code>show=m</code> || months
|-
| <code>show=md</code> || months and days
|-
| <code>show=w</code> || weeks
|-
| <code>show=wd</code> || weeks and days
|-
| <code>show=d</code> || days
|-
| <code>show=dh</code> || days and hours
|-
| <code>show=dhm</code> || days, hours and minutes
|-
| <code>show=dhms</code> || days, hours, minutes and seconds
|-
| <code>show=ymdh</code> || ymd + hours
|-
| <code>show=ymdhm</code> || ymd + hours and minutes
|-
| <code>show=ymwdh</code> || ymwd + hours
|-
| <code>show=ymwdhm</code> || ymwd + hours and minutes
|-
| <code>show=h</code> || hours (result would be 48 hours for a difference of 2 days)
|-
| <code>show=hm</code> || hours and minutes
|-
| <code>show=hms</code> || hours, minutes and seconds
|-
| <code>show=M</code> || minutes (uppercase <code>M</code> because <code>m</code> is months)
|-
| <code>show=s</code> || seconds
|-
| <code>round=on</code> || Round the least-significant unit specified with the <code>show=</code> parameter.
|-
| <code>round=months</code> || Round to nearest month using <code>show=ym</code>.
|-
| <code>round=weeks</code> || Round to nearest week using <code>show=ymw</code>.
|-
| <code>round=days</code> || Round to nearest day using <code>show=ymd</code>.
|-
| <code>round=hours</code> || Round to nearest hour using <code>show=ymdh</code>.
|-
| <code>sortable=on</code> || Output a hidden sort key based on the number of days in the date difference (includes a fraction of a day to handle time differences).
|-
| <code>sortable=off</code> || No sort key (default).
|-
| <code>sortable=debug</code> || Output a visible sort key for testing.
|}

==TemplateData==
{{TemplateData header}}

<templatedata>
{
"params": {
"1": {
"label": "Start date",
"description": "The first day of the period for which duration will be calculated",
"example": "1 October 1999",
"type": "date",
"required": true
},
"2": {
"label": "End date",
"description": "The last day of the period for which duration will be calculated",
"example": "2 August 2026",
"type": "date",
"required": true
},
"abbr": {
"label": "Abbreviation",
"description": "Show unit names as full (year, month, day, hour, minute) or single characters (y, m, d, h, m)",
"type": "string",
"suggestedvalues": [
"on",
"off"
],
"default": "off"
},
"disp": {
"label": "Display options",
"description": "With \"age\" years are displayed if the age is above 3 years, years and months from 1 to 3 years, or months and days for under 1 year. With \"raw\" to show numbers only",
"type": "string",
"suggestedvalues": [
"age",
"raw"
]
},
"duration": {
"label": "Duration",
"description": "Period is a duration (has an extra day to include the end date)",
"type": "string",
"suggestedvalues": [
"on"
],
"autovalue": "on"
},
"format": {
"label": "Format",
"description": "With \"commas\", numbers over 999 are formatted with commas. With \"raw\", Use a hyphen (-) to indicate a negative date difference instead of a minus (−); a hyphen may allow the result to be used in a calculation.",
"type": "string",
"suggestedvalues": [
"commas",
"raw"
]
},
"sep": {
"label": "Separator",
"description": "Separator between items. With \"comma\": 1 year, 2 months, 3 days. The default is 1 year, 2 months and 3 days.",
"type": "string",
"suggestedvalues": [
",",
"comma",
"serialcomma",
"space"
]
},
"show": {
"label": "Show units",
"description": "Which units to display. y=years, m=months, w=weeks, d=days, h=hours, M=minutes, s=seconds",
"type": "string",
"suggestedvalues": [
"y",
"ym",
"ymd",
"ymw",
"ymwd",
"yd",
"m",
"md",
"w",
"wd",
"d",
"dh",
"dhm",
"dhms",
"ymdh",
"ymdhm",
"h",
"hm",
"hms",
"M",
"s"
]
},
"round": {
"label": "Rounding",
"description": "with \"on\": round the least-significant unit specified with the show parameter.; with \"months\", \"weeks\", \"days\", \"hours\" round to that time period",
"example": "weeks",
"type": "string",
"suggestedvalues": [
"on",
"months",
"weeks",
"days",
"hours"
]
},
"sortable": {
"label": "Sortable",
"description": "Output a hidden sort key for sortable tables based on the number of days in the date difference (includes a fraction of a day to handle time differences).",
"type": "string",
"suggestedvalues": [
"on",
"off"
],
"autovalue": "on"
}
},
"description": "Calculates the date/time difference between two dates",
"format": "inline"
}
</templatedata>

<includeonly>{{Sandbox other||

[[Category:Time, date and calendar templates]]
[[Category:Date-computing templates]]
}}</includeonly>

Template:Time interval/doc - Revision history

RandomUser34: 1 revision imported

WP>Jonesey95: add standard TD section header