Permalink
72 lines (65 sloc) 2.12 KB
title version signature
Relative Time Thresholds
2.7.0
moment.relativeTimeThreshold(unit); // getter moment.relativeTimeThreshold(unit, limit); // setter

duration.humanize has thresholds which define when a unit is considered a minute, an hour and so on. For example, by default more than 45 seconds is considered a minute, more than 22 hours is considered a day and so on. To change those cutoffs use moment.relativeTimeThreshold(unit, limit) where unit is one of ss, s, m, h, d, M.

unit meaning usage
ss a few seconds least number of seconds to be considered seconds. Must be set after setting the `s` unit or without setting the `s` unit.
s seconds least number of seconds to be considered a minute.
m minutes least number of minutes to be considered an hour.
h hours least number of hours to be considered a day.
d days least number of days to be considered a month.
M months least number of months to be considered a year.
  // Retrieve existing thresholds
  moment.relativeTimeThreshold('ss'); // 44
  moment.relativeTimeThreshold('s');  // 45
  moment.relativeTimeThreshold('m');  // 45
  moment.relativeTimeThreshold('h');  // 22
  moment.relativeTimeThreshold('d');  // 26
  moment.relativeTimeThreshold('M');  // 11

  // Set new thresholds
  moment.relativeTimeThreshold('ss', 3);
  moment.relativeTimeThreshold('s', 40);
  moment.relativeTimeThreshold('m', 40);
  moment.relativeTimeThreshold('h', 20);
  moment.relativeTimeThreshold('d', 25);
  moment.relativeTimeThreshold('M', 10);

Note: Retrieving thresholds was added in 2.8.1.

Note: Retrieving and setting ss threshold was added in 2.18.0.