Template:Years or months ago

Template documentation[view] [edit] [history] [purge]

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 September 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
9}}	2 years ago
9}}	1 year ago
7}}	2 months ago
8}}	1 month ago
9}}	0 months ago
10}}	1 month's time
11}}	2 months' time
9}}	1 year's time
9}}	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)

The above documentation is transcluded from Template:Years or months ago/doc. (edit | history)
Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages.
Add categories to the /doc subpage. Subpages of this template.