Description
Preserve an explicit arrival-cohort and earnings-period label.
Demographic economic terms depend on age-window boundaries, population scope, household equivalence units and supplied fiscal assumptions. A worker-share change is not an estimated demographic dividend, and endpoint survivors times duration differ from integrated life-table person-years. Local pension or subsidy calculations do not determine actual eligibility or entitlement.
Preserve an explicit arrival-cohort and earnings-period label.
When to use this tool
Use Immigrant Earnings Arrival Cohort Label when you already have recordId, suppliedArrivalCohort, earningsPeriod and need to preserve an explicit arrival-cohort and earnings-period label.
How to use the tool and how it works
- Enter recordId, suppliedArrivalCohort, earningsPeriod. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read token. Use the output convention below.
Enter recordId, suppliedArrivalCohort, earningsPeriod using the field constraints below. Encode these values, in exactly that order, as a JSON array and return the serialized array as text in token. String values are preserved without trimming or external terminology lookup.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| recordId | Record Id | Required. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192. |
| suppliedArrivalCohort | Supplied Arrival Cohort | Required. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192. |
| earningsPeriod | Earnings Period | Required. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| token | Token | Required. Text; maximum UTF-16 length 8192. |
{
"input": {
"recordId": "R17",
"suppliedArrivalCohort": "2010-2014",
"earningsPeriod": "2025"
},
"output": {
"token": "[\"R17\",\"2010-2014\",\"2025\"]"
}
} Limitations and assumptions
- The result records supplied values without assigning migration status or estimating earnings. Sources and asserted relationships are not independently authenticated.
- 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
Use complete population, cohort, labor and fiscal records with the chosen equivalence and exposure definitions. Review applicable benefit rules and estimate the appropriate model for policy analysis; one supplied allocation or accounting ratio does not establish behavior or economic effects.
References
Similar or alternative tools
- Cohort Survival Person Years Term
Calculate supplied surviving-cohort and person-year terms.
- Cohort Budget Age Weight
Calculate a cohort budget from supplied population and per-person allocation.