Reign Title Era Name to Calendar Years Converter

Convert actual caller verified CE reign record and one-based reign-year ordinal, retaining outside-span flag; caller already resolves accession/new-year conventions, no invented era dates, BCE/year-zero/lunisolar conversion.

Description

Reign ordinals can be translated using an explicit first calendar year.

Reign ordinals can be translated using an explicit first calendar year. The last known year provides a separate range check.^[1]

Enter nonempty unique reign IDs, aligned integer first/last CE years 1–2199 with last≥first, exact query ID and ordinal 1–1000. Return year and inclusive within-reign flag; computed year must remain 1–2199.

When to use Reign Title Era Name to Calendar Years Converter

Use Reign Title Era Name to Calendar Years Converter when you need to evaluate the supplied records under the calculation and evidence rules below. A year beyond the reign returns false rather than disappearing. BCE, accession, lunar-calendar and era conventions are excluded.

Prepare the measured coin evidence or explicitly verified catalog and prices requested. Keep measurement conditions, units and currency consistent.

How to use Reign Title Era Name to Calendar Years Converter and understand its results

Prepare the measured coin evidence or explicitly verified catalog and prices requested. Keep measurement conditions, units and currency consistent.
Enter callerReignRecordIds, callerVerifiedReignFirstCeYears, callerVerifiedReignLastCeYears, queryReignRecordId, observedReignYearNumber using the field table and calculation rules, then run the tool.
Read callerConvertedCalendarCeYear, withinCallerVerifiedReignSpan. The explanation below defines the units, signs, ordering and any flags or placeholder values.
If the tool reports an input issue, correct the values and run it again. Apply the stated assumptions when interpreting a successfully returned result.

Input field	Meaning	Value type; see rules below	Requirement
callerReignRecordIds	Caller reign record ids	list of string	Required
callerVerifiedReignFirstCeYears	Caller verified reign first ce years	list of number	Required
callerVerifiedReignLastCeYears	Caller verified reign last ce years	list of number	Required
queryReignRecordId	Query reign record id	string	Required
observedReignYearNumber	Observed reign year number	number	Required

calendarYear=firstYear+ordinal−1

Units, indexing, boundary conditions and exceptional cases are defined in the calculation rules above.

Output field	Meaning	Value type
callerConvertedCalendarCeYear	Caller converted calendar ce year	number
withinCallerVerifiedReignSpan	Within caller verified reign span	boolean

json

{
  "input": {
    "callerReignRecordIds": [
      "a",
      "b"
    ],
    "callerVerifiedReignFirstCeYears": [
      1700,
      1750
    ],
    "callerVerifiedReignLastCeYears": [
      1710,
      1760
    ],
    "queryReignRecordId": "a",
    "observedReignYearNumber": 3
  },
  "output": {
    "callerConvertedCalendarCeYear": 1702,
    "withinCallerVerifiedReignSpan": true
  }
}

Limitations and assumptions

A year beyond the reign returns false rather than disappearing. BCE, accession, lunar-calendar and era conventions are excluded.

Numeric inputs, where present, must be finite. Follow the calculation-specific rules for overflow, underflow and exceptional cases. Numeric lists are limited to 10,000 entries; string lists to 128 strings of at most 128 characters each. The rules above may impose smaller limits. Extremely large text inputs are rejected. Missing required fields, extra fields, wrong value types and violations of the calculation rules are input errors. A successfully returned false flag is an evaluated outcome; its meaning is explained above.

Alternative or Complementary methods

Use Year Set Birthday Coin Finder: Birthday-year sets depend on a particular catalog and stock record. A dated coin need not have been issued in every country or remain available. For a complementary task, use Edge Reeding Ridge Count Tool: A ridge survey records angular positions around an edge. The closing interval is meaningful only for a declared complete circumference.

References

Reign Title Era Name to Calendar Years Converter — tool.io

Similar or alternative tools

Year Set Birthday Coin Finder
Birthday-year sets depend on a particular catalog and stock record. A dated coin need not have been issued in every country or remain available.
Edge Reeding Ridge Count Tool
A ridge survey records angular positions around an edge. The closing interval is meaningful only for a declared complete circumference.