Description
Return conversionDay-referenceDay, amount times applied rate, and amount times applied-minus-reference rate.
Cross-country monetary comparisons require an explicit currency, price basis, and population scope. Exchange rates, price indexes, and purchasing-power adjustments are different transformations and should not be substituted without stating their meaning.
Return conversionDay-referenceDay, amount times applied rate, and amount times applied-minus-reference rate.
When to use this tool
Use International Grant Exchange Rate Date Gap when you need a monetary comparison using caller-supplied conversion or price factors.
How to use the tool and how it works
- Enter referenceDay, conversionDay, amount, appliedRate, referenceRate. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read ageDays, converted, referenceValueGap. Use the output convention below.
Require positive appliedRate and referenceRate. Return conversionDay-referenceDay, amount times applied rate, and amount times applied-minus-reference rate.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| referenceDay | Reference Day | Required. Safe integer. |
| conversionDay | Conversion Day | Required. Safe integer. |
| amount | Amount | Required. Finite number. |
| appliedRate | Applied Rate | Required. Finite number; strictly above 0. |
| referenceRate | Reference Rate | Required. Finite number; strictly above 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| ageDays | Age Days | Required. Safe integer. |
| converted | Converted | Required. Finite number. |
| referenceValueGap | Reference Value Gap | Required. Finite number. |
{
"input": {
"referenceDay": 100,
"conversionDay": 110,
"amount": 1000,
"appliedRate": 1.2,
"referenceRate": 1.1
},
"output": {
"ageDays": 10,
"converted": 1200,
"referenceValueGap": 99.99999999999987
}
}Limitations and assumptions
- Rates must share target-per-source currency orientation and time coordinates use days; no live rate, official conversion date, entitlement, or financial recommendation is supplied.
- 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
Use the appropriate official dataset and its methodology for the comparison. Align price year, currency, household basis, and purchasing-power convention before aggregating or interpreting values.
References
Similar or alternative tools
- Transnational Project Local Cost Price Factor
Rebase signed localCost by base/local index, convert currency, then apply one plus overhead fraction.
- Global Indicator Vintage Age
Return observationYear-sourceYear, flag a future source year, and serialize source, indicator, and sourceYear as provenanceKey.