Skip to content

Main content

Immigrant Earnings Arrival Cohort Label Tool

Preserve an explicit arrival-cohort and earnings-period label without assigning migration status or estimating earnings.

Loading tool…

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

  1. Enter recordId, suppliedArrivalCohort, earningsPeriod. 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 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 fieldMeaning and unitsAccepted input
recordIdRecord IdRequired. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192.
suppliedArrivalCohortSupplied Arrival CohortRequired. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192.
earningsPeriodEarnings PeriodRequired. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192.
Output fieldInterpretationReturned shape
tokenTokenRequired. Text; maximum UTF-16 length 8192.
json
{
  "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

  1. Calculation and input contract: demographic-economics/immigrant-earnings-arrival-cohort-label — tool.io

Similar or alternative tools