Description
Return suppliedFirstYear+regnalYear-1 and a JSON-array key retaining source, era, and regnal year.
Calendar coordinates depend on an era, origin, day-start rule, and sometimes an arithmetic rather than observational convention. A supplied coordinate difference does not resolve those choices.
Return suppliedFirstYear+regnalYear-1 and a JSON-array key retaining source, era, and regnal year.
When to use this tool
Use Regnal Year Era Token when you need a documented calendar convention or source-coordinate comparison.
How to use the tool and how it works
- Enter era, source, regnalYear, suppliedFirstYear. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read nominalYear, sourceKey. Use the output convention below.
Require positive integer regnalYear. Return suppliedFirstYear+regnalYear-1 and a JSON-array key retaining source, era, and regnal year.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| era | Era | Required. Text; maximum UTF-16 length 8192. |
| source | Caller-supplied source label; not independently verified. | Required. Text; maximum UTF-16 length 8192. |
| regnalYear | Regnal Year | Required. Safe integer; minimum 1. |
| suppliedFirstYear | Supplied First Year | Required. Safe integer. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| nominalYear | Nominal Year | Required. Safe integer. |
| sourceKey | JSON-array serialization retaining the supplied source and identifying components. | Required. Text; maximum UTF-16 length 8192. |
{
"input": {
"era": "era-A",
"source": "register-2",
"regnalYear": 5,
"suppliedFirstYear": 1700
},
"output": {
"nominalYear": 1704,
"sourceKey": "[\"register-2\",\"era-A\",5]"
}
}Limitations and assumptions
- This is a nominal supplied-origin mapping without accession-day boundaries, calendar conversion, source authentication, or historical dating verification.
- 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 source calendar and authoritative date information for actual observance, conversion, or historical dating.
References
Similar or alternative tools
- Historical Date Double Year Token
Parse a four-digit nonzero-leading first year, slash, and a two- or four-digit second year.
- Chronology Era Zero Label
Return validLabel when hasYearZero or yearLabel is nonzero.