Skip to content

Main content

Historical Date Double Year Token Tool

Expand a supplied four-digit/slash/two-or-four-digit double-year token without converting a historical calendar.

Loading tool…

Description

Parse a four-digit nonzero-leading first year, slash, and a two- or four-digit second 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.

Parse a four-digit nonzero-leading first year, slash, and a two- or four-digit second year.

When to use this tool

Use Historical Date Double Year Token when you need a documented calendar convention or source-coordinate comparison.

How to use the tool and how it works

  1. Enter token. Use the units and conventions below.
  2. Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
  3. Read firstYear, secondYear, consecutive. Inspect consecutive before interpreting the associated values.

Parse a four-digit nonzero-leading first year, slash, and a two- or four-digit second year. Expand a two-digit suffix into the same century or the next when needed, then report whether years are consecutive.1

Input fieldMeaning and unitsAccepted input
tokenText in the explicitly supported lexical grammar.Required. Text; maximum UTF-16 length 8192.
Output fieldInterpretationReturned shape
firstYearFirst YearRequired. Safe integer.
secondYearSecond YearRequired. Safe integer.
consecutiveConsecutiveRequired. Boolean.
json
{
  "input": {
    "token": "1699/00"
  },
  "output": {
    "firstYear": 1699,
    "secondYear": 1700,
    "consecutive": true
  }
}

Limitations and assumptions

  • A match does not require consecutiveness; the parser does not resolve old-style/new-style calendars, historical year starts, or an authoritative date interpretation.
  • 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.

Alternative or Complementary methods

Consult the source calendar and authoritative date information for actual observance, conversion, or historical dating.

References

  1. Calculation and input contract: history/historical-date-double-year-token — tool.io

Similar or alternative tools