Template:Century name from decade or year/doc

This is a documentation subpage for Template:Century name from decade or year.
It contains 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.
Remember that you can conduct experiments, and should test all improvements, in either the general Template sandbox or your user space before changing anything here.

This template is used on approximately 49,000 pages, so changes to it will be widely noticed. Please test any changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Please consider discussing changes on the talk page before implementing them.

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

Mostly used in categorisation.

Parameters

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

{{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

{{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

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

This is the TemplateData documentation for this template used by VisualEditor and other tools; see the monthly parameter usage report for this template.

TemplateData for Century name from decade or year

<templatedata> { "params": { "1": { "label": "Year or decade", "description": "a 1-, 2-, 3- or 4-digit-year (e.g. '1957') or a 4-digit-decade (e.g. '1760s') ", "type": "number", "default": "" }, "2": { "label": "dash", "description": "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'", "type": "string", "default": "" }, "nomatch": { "label": "No match text", "description": "If the input is not a 1-, 2-, 3- or 4-digit year or decade, output the \"nomatch\" value. Defaults to blank.", "type": "string" } }, "description": "Returns the name of the century for a 1-, 2-, 3- or 4-digit year or decade." } </templatedata>