Reusables

A TypeScript utility for converting timestamps into human-readable relative time strings

Installation

npx shadcn@latest add "https://reusables.vercel.app/r/time-ago"

Basic usage with default options:

const time = timeAgo(date)
// "2 hours ago"

Enhanced formatting with options:

const time = formatTimeAgo(date, {
  short: true,
  maxUnits: 2,
})
// "2h 30m ago"

Simple Time Ago

just now

8/8/2025, 9:58:27 AM

Enhanced Time Ago

Short Format

Max Units

just now

8/8/2025, 9:58:27 AM

Prop	Type	Default
`date`	`Date \| string \| number`	-