Template:Century name from decade or year/doc

This is a documentation subpage for Template:Century name from decade or year.
It may contain usage information, categories and other content that is not part of the original template page.

This template employs intricate features of template syntax.

You are encouraged to familiarise yourself with its setup and parser functions before editing the template. If your edit causes unexpected problems, please undo it quickly, as this template may appear on a large number of pages.
You can conduct experiments, and should test all major changes, in either , the general template sandbox, or your user space before changing anything here.

This template is used on approximately 49,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before changing this template.

When supplied with a 1-, 2-, 3- or 4-digit year or decade, returns the name of the century.

Mostly used in categorisation.

Parameters change

The first parameter is required: either a 1-, 2-, 3-, or 4-digit year (e.g. 61, 905, 1839) or a 2-, 3-, or 4--digit decade (e.g. 60s, 900s, 1830s)
The second parameter is optional. The single word "dash" changes the output from "nth century" to "nth-century"
An optional "nomatch" parameter may be used to specify text to be return if the input cannot be processed. Default behaviour is return an empty string if there is no match

Usage change

{{Century name from decade or year|YYYY}}
{{Century name from decade or year|YYYY|dash}}
{{Century name from decade or year|YYY0s}}
{{Century name from decade or year|YYY0s|dash}}
{{Century name from decade or year|YYYY|nomatch=FAIL}}
{{Century name from decade or year|YYYY|dash|nomatch=FAIL}}
{{Century name from decade or year|YYY0s|nomatch=FAIL}}
{{Century name from decade or year|YYY0s|dash|nomatch=FAIL}}

Examples change

{{Century name from decade or year|8}} → 1st century
{{Century name from decade or year|63}} → 1st century
{{Century name from decade or year|421}} → 5th century
{{Century name from decade or year|1707}} → 18th century
{{Century name from decade or year|1514|dash}} → 16th-century
{{Century name from decade or year|0s}} → 1st century
{{Century name from decade or year|40s}} → 1st century
{{Century name from decade or year|550s}} → 6th century
{{Century name from decade or year|1920s}} → 20th century
{{Century name from decade or year|2030s|dash}} → 21st-century

Errors change

Empty or inappropriate parameters produce no output, unless the "nomatch" paremeter is set.

{{Century name from decade or year}} →
{{Century name from decade or year|7}} → 1st century
{{Century name from decade or year|123abc}} →
{{Century name from decade or year|French flying flamingoes flounce furiously}} →

With "nomatch"

{{Century name from decade or year|nomatch=FAILED}} → FAILED
{{Century name from decade or year|7|nomatch=Aaaaaaaaaargh}} → 1st century
{{Century name from decade or year|123abc|nomatch=garbage input}} → garbage input
{{Century name from decade or year|Fastidious French flying flamingoes flounce furiously|nomatch=NOMATCH}} → NOMATCH

TemplateData change

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Century name from decade or year in articles based on its TemplateData.

TemplateData for Century name from decade or year

Returns the name of the century for a 1-, 2-, 3- or 4-digit year or decade.

Template parameters
Parameter		Description	Type	Status
Year or decade	`1`	a 1-, 2-, 3- or 4-digit-year (e.g. '1957') or a 4-digit-decade (e.g. '1760s') Default	Number	optional
dash	`2`	If this parameter is dash, then the century number is followed by a dash rather than a space, i.e. '16th-century' instead of the default '16th century' Default	String	optional
No match text	`nomatch`	If the input is not a 1-, 2-, 3- or 4-digit year or decade, output the "nomatch" value. Defaults to blank.	String	optional