1.6.0 โ€ข Published 8 months ago

@fetched/timeago v1.6.0

Weekly downloads
-
License
MIT
Repository
github
Last release
8 months ago

๐Ÿช„ TIMEAGO

Tiniest Timeago Toolbox. Supports {ago | in}. Batteries Included.

  • Localization โ€” English, Chinese, German, Spanish, French, Italian, Dutch, Japanese, Polish and Russian.
  • Prefix โ€” Add a prefix string.
  • Relative โ€” Use a relative date instead of the current time.
  • Deadline โ€” Specify a Date | string | number deadline after which a Date.toLocaleString() is displayed instead of the timeago format.
  • Seconds โ€” Set isSeconds to true if you pass a seconds timestamp. Defaults to false.
  • Close Dates - Set closeDates to true if you want to display Today/Tomorrow/Yesterday instead of the ago version. Works only for time differences between 6 hours and 1 day, other times are displayed as usual. Defaults to false.
  • Browser supported.
  • Node supported.

This package is inspired by Muffinman's blogpost. If you got some spare time, I highly recommed to check it out!

โœจ INSTALLING

Using NPM:

npm i @fetched/timeago

Using PNPM:

pnpm install @fetched/timeago

Using YARN:

yarn add @fetched/timeago

Using CDN

<script src="https://www.unpkg.com/@fetched/timeago/dist/index.umd.js"></script>

๐Ÿš€ USAGE

import { format } from '@fetched/timeago'

format(now)
// just now
format('2016-06-12')
// 7 years ago
format('2016-06-12', 'zh_CN')
// 7ๅนดๅ‰

๐ŸŒ‹ ROADMAP

  • Languages++
  • Realtime

๐Ÿ’ป DEVELOPING

Run all tests:

npm run test

Build package with microbundle for production:

npm run build

๐ŸŽจ CONTRIBUTING

Contributions for new languages are always welcome!

See examples for implementing a new language.

๐Ÿฅ‚ LICENSE

MIT License