Description
Take the sign of secondCoordinate-firstCoordinate and reverse it when increasingIsLater is false.
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.
Take the sign of secondCoordinate-firstCoordinate and reverse it when increasingIsLater is false.
When to use this tool
Use Calendar Era Order Sign when you need a documented calendar convention or source-coordinate comparison.
How to use the tool and how it works
- Enter firstCoordinate, secondCoordinate, increasingIsLater. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read chronologicalOrder. Use the output convention below.
Take the sign of secondCoordinate-firstCoordinate and reverse it when increasingIsLater is false.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| firstCoordinate | First Coordinate | Required. Finite number. |
| secondCoordinate | Second Coordinate | Required. Finite number. |
| increasingIsLater | Increasing Is Later | Required. Boolean. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| chronologicalOrder | Chronological Order | Required. Safe integer. |
{
"input": {
"firstCoordinate": 10,
"secondCoordinate": 12,
"increasingIsLater": true
},
"output": {
"chronologicalOrder": 1
}
}Limitations and assumptions
- The result is -1, zero, or +1 under the supplied chronological orientation; no calendar conversion or historical relationship is independently determined.
- 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
- Chronology Era Zero Label
Return validLabel when hasYearZero or yearLabel is nonzero.
- Chronology Event Interval Width
Require latest at least earliest and subtract for width.