Description
Use exact integer subtraction to return event minus declaredRetirementYear, retirement minus cohortOriginYear, and event minus cohort origin as decimal strings.
Longitudinal ageing research links observations to people, waves, and sources. A person may appear in multiple records, so distinct-person coverage and record counts answer different questions and require explicit duplicate rules.
Use exact integer subtraction to return event minus declaredRetirementYear, retirement minus cohortOriginYear, and event minus cohort origin as decimal strings.
When to use this tool
Use Retirement Event Origin Gap when you need a record-coverage or source-support diagnostic in ageing research.
How to use the tool and how it works
- Enter eventYear, declaredRetirementYear, cohortOriginYear. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read fromRetirementDecimal, retirementFromCohortDecimal, eventFromCohortDecimal. Use the output convention below.
Use exact integer subtraction to return event minus declaredRetirementYear, retirement minus cohortOriginYear, and event minus cohort origin as decimal strings.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| eventYear | Event Year | Required. Safe integer. |
| declaredRetirementYear | Declared Retirement Year | Required. Safe integer. |
| cohortOriginYear | Cohort Origin Year | Required. Safe integer. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| fromRetirementDecimal | From Retirement Decimal | Required. Text; maximum UTF-16 length 8192. |
| retirementFromCohortDecimal | Retirement From Cohort Decimal | Required. Text; maximum UTF-16 length 8192. |
| eventFromCohortDecimal | Event From Cohort Decimal | Required. Text; maximum UTF-16 length 8192. |
{
"input": {
"eventYear": 2020,
"declaredRetirementYear": 2010,
"cohortOriginYear": 1950
},
"output": {
"fromRetirementDecimal": "10",
"retirementFromCohortDecimal": "60",
"eventFromCohortDecimal": "70"
}
}Limitations and assumptions
- Signed year coordinates are supplied rather than actual dates; exact differences do not verify retirement status, cohort definition, legal eligibility, or life-history accuracy.
- 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
Review the original study design, identifiers, and missing-data definitions. Use the full longitudinal dataset for inference rather than treating a local coverage flag as evidence of representativeness.
References
Similar or alternative tools
- Life Event Age Interval Width
Subtract birth for youngest and oldest age and return event-interval width.
- Life History Event Calendar Anchor Gap
Add recalledOffset to anchorYear for impliedYear and subtract that implied year from recalledYear for disagreementYears.