Template:Time interval/doc
 | これはTemplate:Time intervalの解説サブページです。 使用方法、カテゴリ、およびその他テンプレート自体に含まれない情報を収容しています。 |
 | Luaモジュールを使用しています: |
ここに概要や目的
Syntax
[編集]{{time interval|date1|date2|options}}
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 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:
{{time interval|1 Jan 2001|March 4, 2002}}→ 1年, 2ヶ月 and 3日{{time interval|1 Jan 2001|March 4, 2002|abbr=on}}→ 1年 2ヶ月 3日{{time interval|B.C.E. 1 Feb 120|28 FEB 1900}}→ 2019年 and 27日
Parameters
[編集]| Parameter | Description |
|---|---|
abbr=off | Unit names in full (default): year, month, day, hour, minute. |
abbr=on | Units shown as a single letter with no space between number and unit: y, m, d, h, m. |
disp=age | If no show 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 sep=space by default. This is compatible with {{age for infant}}. |
disp=raw | Display numbers only with sep=space. |
duration=on | Period is a duration (has an extra day to include the end date). |
format=commas | Numbers over 999 are formatted with commas. |
format=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. |
sep=comma | Separator between items is a comma: 1 year, 2 months, 3 days. The default is 1 year, 2 months and 3 days. |
sep=, | Same as sep=comma. |
sep=serialcomma | Use a serial comma: 1 year, 2 months, and 3 days. |
sep=space | Use a space: 1 year 2 months 3 days. |
sc=y | Change the default separator to use a serial comma. Also accepts sc=yes and sc=on. |
show=y | years |
show=ym | years and months |
show=ymd | years, months and days (default) |
show=ymw | years, months and weeks |
show=ymwd | years, months, weeks and days |
show=yd | years and days |
show=m | months |
show=md | months and days |
show=w | weeks |
show=wd | weeks and days |
show=d | days |
show=dh | days and hours |
show=dhm | days, hours and minutes |
show=dhms | days, hours, minutes and seconds |
show=ymdh | ymd + hours |
show=ymdhm | ymd + hours and minutes |
show=ymwdh | ymwd + hours |
show=ymwdhm | ymwd + hours and minutes |
show=h | hours (result would be 48 hours for a difference of 2 days) |
show=hm | hours and minutes |
show=hms | hours, minutes and seconds |
round=on | Round the least-significant unit specified with the show= parameter. |
round=months | Round to nearest month using show=ym. |
round=weeks | Round to nearest week using show=ymw. |
round=days | Round to nearest day using show=ymd. |
round=hours | Round to nearest hour using show=ymdh. |
sortable=on | 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). |
sortable=off | No sort key (default). |
sortable=debug | Output a visible sort key for testing. |