Template:Years or months ago
 | This template is used on approximately 100,000 pages. To avoid major disruption and server load, any changes should be tested in the template's /sandbox or /testcases subpages, or in your own user subpage. The tested changes can be added to this page in a single edit. Consider discussing changes on the talk page before implementing them. |
Template:Years or months ago displays the number of years (or months if less than 1 year) between a specified year/month date and the current year/month. It will also work correctly when only the year is given. Optionally, a second year/month date can be specified to be used instead of the current year/month.
This was designed as a supporting template for Template:Start date and age, to be used when the specified date does not include the day of the month. The formatting of the output was designed to be similar to Template:Time ago.
Usage
For years or months before or after current date:
{{Years or months ago|year|month}}{{Years or months ago|year}}
For years or months between two dates:
{{Years or months ago|year1|month1|year2|month2}}
Examples
The following examples use July 2025 as the current month and year. If that is not correct, click the Purge link at the top of this documentation (or here) to update the page.
Year and month
| Template | Output |
|---|---|
{{Years or months ago|2023|7}}
|
2 years ago |
{{Years or months ago|2024|7}}
|
1 year ago |
{{Years or months ago|2025|5}}
|
2 months ago |
{{Years or months ago|2025|6}}
|
1 month ago |
{{Years or months ago|2025|7}}
|
0 months ago |
{{Years or months ago|2025|8}}
|
1 month's time |
{{Years or months ago|2025|9}}
|
2 months' time |
{{Years or months ago|2026|7}}
|
1 year's time |
{{Years or months ago|2027|7}}
|
2 years' time |
Year only (no month)
| Template | Output |
|---|---|
{{Years or months ago|2023}}
|
2 years ago |
{{Years or months ago|2024}}
|
1 year ago |
{{Years or months ago|2025}}
|
0 years ago |
{{Years or months ago|2026}}
|
1 year's time |
{{Years or months ago|2027}}
|
2 years' time |
See also
- Template:Time ago – displays elapsed time (with same singular or plural text as this template)
- Template:Age – displays elapsed time in years (number only, future dates generate negative number)