Teeny-tiny relative date formatting


License
BSD-2-Clause
Install
npm install timerel@5.8.0

Documentation

timerel

timerel formats dates to short english relative format 5 mins ago and does so around 11 times faster than its competition.

Usage

import {timerel} from "timerel";

console.log(timerel(Date.now() - 1e6));
// => 16 mins ago

API

timerel(date, opts?)

  • date String, Number or Date: The date to format.

Options

  • now String, Number or Date: The date to compare to. Default: Date.now().
  • noAffix Boolean: Whether to omit ago and in affixes. Default: false.
  • times Array: A custom time table that overrides the built-in one.
  • nowThreshold Number: Number of milliseconds below which to output "now". Default: 2000.
  • nowString String: String to output for now. Default: "now".
  • unknownString String: String to output for invalid dates. Default: String(date).
  • aliases Boolean: Use aliases like "yesterday" instead of "1 day ago". Default: false.
  • aliasesMap Object: A custom aliases object to use instead of the built-in one.
  • longUnits Boolean: Use minutes/secoonds instead of mins/secs. Default: false.

© silverwind, distributed under BSD licence