{
 "kind": "tool",
 "slug": "timeago-js",
 "path": "tools/timeago-js/",
 "name": "timeago.js",
 "maker": null,
 "density": "basic",
 "crumbs": [
  [
   "Tools",
   "tools/"
  ],
  [
   "Utilities",
   "tools/utilities/"
  ]
 ],
 "lead": "Tiny library (<2KB) to format dates as relative time strings like '3 hours ago' with i18n.",
 "chips": [
  {
   "label": "Utilities",
   "path": "tools/utilities/"
  },
  {
   "label": "NPM"
  }
 ],
 "primary": {
  "label": "Copy install command",
  "copy": "npm install timeago.js"
 },
 "links": [
  {
   "label": "GitHub",
   "href": "https://github.com/hustcc/timeago.js"
  },
  {
   "label": "Website",
   "href": "https://github.com/hustcc/timeago.js#readme"
  }
 ],
 "track": "New versions, deprecation and license changes on your dashboard",
 "verdicts": [
  {
   "key": "license",
   "label": "License",
   "value": "MIT",
   "status": "yes",
   "sub": "Use it in paid apps",
   "quote": null,
   "note": "License from npm.",
   "src": "https://github.com/hustcc/timeago.js"
  },
  {
   "key": "maint",
   "label": "Maintained",
   "value": "Maintained",
   "status": "yes",
   "sub": "Last change Nov 12, 2026",
   "note": "Latest GitHub release Nov 12, 2026. ",
   "src": "https://github.com/hustcc/timeago.js"
  },
  {
   "key": "pop",
   "label": "Used by agents' projects",
   "value": "7 projects",
   "status": "info",
   "sub": "#148 of 406 in its category",
   "note": "Dependency in 7 public GitHub projects set up for AI coding agents that we scanned (0.1%).",
   "src": null
  },
  {
   "key": "agent",
   "label": "Agent access",
   "value": "Install only",
   "status": "info",
   "sub": null,
   "note": "Agent skills for this library in the skills catalog; community skills are written by others, read them before you install.",
   "src": null
  }
 ],
 "vfoot": "From the package registry and GitHub, checked daily.",
 "blocks": [
  {
   "id": "overview",
   "nav": "Overview",
   "h2": "What timeago.js does",
   "parts": [
    {
     "t": "prose",
     "text": "Tiny library (<2KB) to format dates as relative time strings like '3 hours ago' with i18n."
    }
   ]
  },
  {
   "id": "popularity",
   "nav": "Popularity",
   "h2": "timeago.js popularity",
   "parts": [
    {
     "t": "stats",
     "items": [
      {
       "n": "43",
       "of": "/ 100",
       "l": "Gid Score, #2638 overall"
      },
      {
       "n": "437K",
       "l": "downloads a week, npm"
      },
      {
       "n": "5,368",
       "l": "GitHub stars"
      },
      {
       "n": "7",
       "l": "agent projects use it"
      }
     ]
    },
    {
     "t": "small",
     "text": "Gid Score measures public popularity and activity, not quality.",
     "link": "How the Gid Score is calculated",
     "path": "tools/top/"
    }
   ]
  },
  {
   "id": "usage",
   "nav": "How it is used",
   "h2": "How timeago.js is used",
   "parts": [
    {
     "t": "list",
     "items": [
      "timeago.js joined the catalog on its public numbers (436,524 downloads a week on npm and 5,368 GitHub stars), not on our project count: it is a dependency in 10 public GitHub projects of our scan, 7 of them set up for AI coding agents.",
      "The most used alternative in our scan is date-fns (652 projects).",
      "Projects that use it most often also use dotenv (90.0%), Lucide React (80.0%), Sonner (80.0%)."
     ]
    },
    {
     "t": "h3",
     "text": "Often used with"
    },
    {
     "t": "rows",
     "rows": [
      {
       "l": "In 90.0% of its projects",
       "v": "dotenv",
       "path": "tools/dotenv/"
      },
      {
       "l": "In 80.0% of its projects",
       "v": "Lucide React",
       "path": "tools/lucide-react/"
      },
      {
       "l": "In 80.0% of its projects",
       "v": "Sonner",
       "path": "tools/sonner/"
      },
      {
       "l": "In 100.0% of its projects",
       "v": "React",
       "path": "tools/react/"
      },
      {
       "l": "In 70.0% of its projects",
       "v": "Framer Motion",
       "path": "tools/framer-motion/"
      },
      {
       "l": "In 70.0% of its projects",
       "v": "Recharts",
       "path": "tools/recharts/"
      },
      {
       "l": "In 90.0% of its projects",
       "v": "Tailwind CSS",
       "path": "tools/tailwindcss/"
      },
      {
       "l": "In 60.0% of its projects",
       "v": "date-fns",
       "path": "tools/date-fns/"
      }
     ]
    }
   ]
  },
  {
   "id": "more",
   "nav": null,
   "spy_as": "usage",
   "h2": "More about timeago.js",
   "parts": [
    {
     "t": "more",
     "items": [
      {
       "title": "Funding",
       "path": "tools/funding/",
       "items": [
        "Own page: https://paypal.me/hustcc",
        "Own page: https://atool.vip"
       ]
      },
      {
       "title": "More in Utilities",
       "path": "tools/utilities/",
       "items": [
        {
         "text": "clsx",
         "path": "tools/clsx/"
        },
        {
         "text": "PyYAML",
         "path": "tools/pyyaml/"
        },
        {
         "text": "uuid",
         "path": "tools/uuid/"
        },
        {
         "text": "yaml",
         "path": "tools/yaml/"
        },
        {
         "text": "js-yaml",
         "path": "tools/js-yaml/"
        },
        {
         "text": "glob",
         "path": "tools/glob/"
        },
        {
         "text": "Lodash",
         "path": "tools/lodash/"
        },
        {
         "text": "tqdm",
         "path": "tools/tqdm/"
        }
       ]
      }
     ]
    }
   ]
  },
  {
   "id": "alternatives",
   "nav": "Alternatives",
   "h2": "Alternatives",
   "parts": [
    {
     "t": "alts",
     "items": [
      {
       "name": "timeago.js",
       "me": true,
       "facts": [
        "MIT",
        "Gid 43",
        "437K/wk"
       ]
      },
      {
       "name": "date-fns",
       "why": "Modern JavaScript date utility library with comprehensive formatting functions.",
       "path": "tools/date-fns/",
       "facts": [
        "MIT",
        "Gid 85",
        "12M/wk"
       ]
      },
      {
       "name": "Day.js",
       "why": "2KB immutable date/time library with modern API as lightweight Moment.js alternative.",
       "path": "tools/dayjs/",
       "facts": [
        "MIT",
        "Gid 81",
        "11M/wk"
       ]
      }
     ],
     "more": "Compare timeago.js with another tool",
     "more_path": "tools/compare/"
    }
   ]
  },
  {
   "id": "start",
   "nav": "Get started",
   "h2": "Get started",
   "parts": [
    {
     "t": "install",
     "intro": "Install it.",
     "code": "npm install timeago.js"
    },
    {
     "t": "gap",
     "text": "No step-by-step start for timeago.js yet: we have not written its hand-checked card."
    }
   ]
  }
 ],
 "glance": [
  [
   "Package",
   "npm timeago.js"
  ],
  [
   "Category",
   "Utilities"
  ],
  [
   "License",
   "MIT"
  ],
  [
   "Gid Score",
   "43.2"
  ],
  [
   "Rank in category",
   "#148 of 406"
  ],
  [
   "GitHub",
   "hustcc/timeago.js"
  ],
  [
   "Last change",
   "Nov 12, 2026"
  ]
 ],
 "good": [],
 "checked_line": "From the package registry, GitHub and our scan of public agent projects; numbers update daily."
}