Skip to content

Main content

Historical Price Unit Reference Flag Tool

Flag supplied price-unit comparability without inventing a historical unit conversion.

Loading tool…

Description

Compare them literally and set comparable when they match or conversionKnown is true.

Historical money records depend on a denomination system, period, source, and conversion basis. Exact minor-unit arithmetic can preserve a recorded amount, while a supplied conversion factor does not establish purchasing power or a market exchange rate.

Compare them literally and set comparable when they match or conversionKnown is true.

When to use this tool

Use Historical Price Unit Reference Flag when you need to preserve, format, or convert a supplied historical money component under its stated convention.

How to use the tool and how it works

  1. Enter recordedUnit, referenceUnit, conversionKnown. 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 sameUnit, comparable. Inspect sameUnit, comparable before interpreting the associated values.

Require nonempty recordedUnit and referenceUnit. Compare them literally and set comparable when they match or conversionKnown is true.1

Input fieldMeaning and unitsAccepted input
recordedUnitRecorded UnitRequired. Text; maximum UTF-16 length 8192.
referenceUnitReference UnitRequired. Text; maximum UTF-16 length 8192.
conversionKnownConversion KnownRequired. Boolean.
Output fieldInterpretationReturned shape
sameUnitSame UnitRequired. Boolean.
comparableComparableRequired. Boolean.
json
{
  "input": {
    "recordedUnit": "bushel-local",
    "referenceUnit": "bushel-standard",
    "conversionKnown": false
  },
  "output": {
    "sameUnit": false,
    "comparable": false
  }
}

Limitations and assumptions

  • The flag does not supply or apply a conversion, verify currency equivalence, or establish purchasing-power comparability across periods.
  • 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 original denomination and source record, and retain exact strings when large amounts must remain precise.

References

  1. Calculation and input contract: history/historical-price-unit-reference-flag — tool.io

Similar or alternative tools