MonthlyTimelineEntry: {
    month: number;
    age: number;
    currentBalance: number;
    cumulativeContributions: number;
    cumulativeInterest: number;
    monthlyInterestEarned: number;
    currentAnnualReturn: number;
    currentMonthlyReturn: number;
    currentEquityWeight?: number;
}

Represents the detailed state of the account at the end of a specific month. Used for timeline visualization and detailed analysis.

Type declaration

  • month: number

    Month number in the simulation (1-based). Month 1 is the first month, month 12 is the end of the first year, etc.

  • age: number

    User's age at the end of this month. Increments by 1/12 each month from the starting age.

  • currentBalance: number

    Total account balance at the end of this month. Includes initial balance, all contributions, and compound interest.

  • cumulativeContributions: number

    Cumulative total of all contributions made up to and including this month.

  • cumulativeInterest: number

    Cumulative total of all interest earned up to and including this month.

  • monthlyInterestEarned: number

    Amount of interest earned during this specific month.

  • currentAnnualReturn: number

    Annual return rate that was used for this month's calculation. This is the rate determined by the glidepath strategy for the user's age this month.

  • currentMonthlyReturn: number

    Monthly return rate that was applied during this month. Converted from annual rate using: (1 + annualRate)^(1/12) - 1

  • Optional currentEquityWeight?: number

    Current equity allocation weight for this month. Only present for allocation-based and custom waypoints with equityWeight valueType. Undefined for fixed-return glidepaths.

Example

const entry: MonthlyTimelineEntry = {
month: 120,
age: 39.92,
currentBalance: 125750.50,
cumulativeContributions: 120000,
cumulativeInterest: 5750.50,
monthlyInterestEarned: 825.33,
currentAnnualReturn: 0.085,
currentMonthlyReturn: 0.006825,
currentEquityWeight: 0.75 // Only present for allocation-based modes
};

Generated using TypeDoc