Age

Age calculations and birthday utilities

Edit and run examples against `ts-time-utils@4.4.1` in your browser.

Age & Birthday

Calculate ages and work with birthdays

index.ts

import { calculateAge, getLifeStage, getNextBirthday, getDaysUntilBirthday } from 'ts-time-utils/age';

const birthDate = new Date('1990-05-15');

// Calculate detailed age
const age = calculateAge(birthDate);
console.log(`Age: ${age.years} years, ${age.months} months, ${age.days} days`);
// "Age: 35 years, 4 months, 2 days"

console.log(`Total months: ${age.totalMonths}`);
console.log(`Total days: ${age.totalDays}`);

// Get life stage
console.log(getLifeStage(new Date('2024-01-15'))); // "infant"
console.log(getLifeStage(new Date('2018-01-15'))); // "child"
console.log(getLifeStage(new Date('2010-01-15'))); // "teen"
console.log(getLifeStage(new Date('1990-01-15'))); // "adult"
console.log(getLifeStage(new Date('1940-01-15'))); // "senior"

// Next birthday
const nextBday = getNextBirthday(birthDate);
console.log('Next birthday:', nextBday.toDateString());

// Days until birthday
const daysLeft = getDaysUntilBirthday(birthDate);
console.log(`Days until birthday: ${daysLeft}`);

// Check if birthday is today
const today = new Date();
const isBirthdayToday = calculateAge(birthDate, today).months === 0
  && calculateAge(birthDate, today).days === 0;
console.log('Birthday today?', isBirthdayToday);

Console

Press Run to execute the example.