Description
Require nonempty rulerLabel and source plus positive regnalYear, then format a source-qualified regnal-year label.
Archival records often contain bounded dates, editions, and source identifiers. Arithmetic on supplied coordinates can check consistency while leaving historical interpretation and authenticity unresolved.
Require nonempty rulerLabel and source plus positive regnalYear, then format a source-qualified regnal-year label.
When to use this tool
Use Regnal Year Source Label when you need a precise date-span or source-record bookkeeping step.
How to use the tool and how it works
- Enter rulerLabel, regnalYear, source. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read label. Use the output convention below.
Require nonempty rulerLabel and source plus positive regnalYear, then format a source-qualified regnal-year label.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| rulerLabel | Ruler Label | Required. Text; maximum UTF-16 length 8192. |
| regnalYear | Regnal Year | Required. Safe integer; minimum 1. |
| source | Supplied source label; not independently verified. | Required. Text; maximum UTF-16 length 8192. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| label | Formatted label for the supplied components under the convention above. | Required. Text; maximum UTF-16 length 8192. |
{
"input": {
"rulerLabel": "Ruler A",
"regnalYear": 7,
"source": "Charter 12"
},
"output": {
"label": "Ruler A, regnal year 7 [Charter 12]"
}
}Limitations and assumptions
- This does not convert to a civil year, verify accession, resolve co-regencies, or authenticate historical chronology.
- Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
- Numeric calculations use binary floating point unless exact decimal-integer arithmetic is explicitly stated. No hidden measurement tolerance or decimal rounding is added; nonfinite or out-of-contract results are rejected. Numeric signed-zero results are exported as zero.
Alternative or Complementary methods
Consult the original catalog and documented calendar or dating convention when historical interpretation matters.
References
Similar or alternative tools
- Japanese Era Year Gannen Token
Format the first year with 元年 and later years as the number followed by 年.
- European Charter Indiction Source Token
Require indiction from one through 15 and nonempty sourceId, then format indiction number [sourceId].