函数 howLongAgo

获取过去时间数

时间匹配顺序：年、季、月、周、天、时、分、秒

示例

const date = new Date('2023/4/7 00:00:00');
howLongAgo(date, { now: new Date('2023/4/7 00:00:20') }); // '20秒前'
howLongAgo(date, { now: new Date('2023/4/7 00:10:20') }); // '10分钟前'
howLongAgo(date, { now: new Date('2023/4/7 08:00:00') }); // '8小时前'
howLongAgo(date, { now: new Date('2023/4/10 00:00:00') }); // '3天前'

howLongAgo(date, { now: new Date('2023/4/15 00:00:00') }); // '1周前'
howLongAgo(date, { now: new Date('2023/5/6 00:00:00') }); // '4周前'

howLongAgo(date, { now: new Date('2023/5/7 00:00:00') }); // '1月前'
// 因为过去多少月是按天数算的，5月有31天，所以到6月6号已经是2月前了
howLongAgo(date, { now: new Date('2023/6/6 00:00:00') }); // '2月前'
howLongAgo(date, { now: new Date('2023/7/7 00:00:00') }); // '3月前'

// 按天数算的，5月有31天，一季按91.25(365/4)天算
howLongAgo(date, { now: new Date('2023/7/8 00:00:00') }); // '1季前'

howLongAgo(date, { now: new Date('2024/7/7 00:00:00') }); // '1年前'

// now比date小
howLongAgo(date, { now: new Date('2022/7/8 00:00:00') }); // '2023-04-07 00:00:00'
howLongAgo(date, { now: new Date('2022/7/8 00:00:00'), def: '--' }); // '--'
howLongAgo(date, { now: new Date('2022/7/8 00:00:00'), defaultFormat: 'yyyy' }); // '2023'

// 更换模板
const templates: Required<Parameters<typeof howLongAgo>>[1]['templates'] = {};

// 更换秒数模板
templates.second = '刚刚';
howLongAgo(date, { now: new Date('2023/4/7 00:00:20'), templates }); // '刚刚'

// 更换小时数模板
templates.hour = '${ago} hours ago';
howLongAgo(date, { now: new Date('2023/4/7 08:00:00'), templates }); // '8 hours ago'

// 更换周数模板
templates.week = '${ago}星期前';
howLongAgo(date, { now: new Date('2023/4/15 00:00:00'), templates }); // '1星期前'
howLongAgo(date, { now: new Date('2023/5/6 00:00:00'), templates }); // '4星期前'

// 去掉周数
templates.week = '~~';
howLongAgo(date, { now: new Date('2023/4/15 00:00:00'), templates }); // '8天前'
howLongAgo(date, { now: new Date('2023/5/6 00:00:00'), templates }); // '29天前'

// 去掉季节
templates.season = '~~';
howLongAgo(date, { now: new Date('2023/7/8 00:00:00'), templates }); // '3月前'

// ------- filter -------
// 使用filter替换季数
howLongAgo(date, {
  now: new Date('2023/10/8 00:00:00'),
  filter: (res, diff) =>
    res.endsWith('季前') ? ~~(diff / getTimePeriodConst().season) + ' seasons ago' : res,
}); // '2 seasons ago'

// 混合
howLongAgo(date, {
  now: new Date('2023/4/7 02:10:00'),
  filter: (res, diff) => {
    if (res.endsWith('小时前')) {
      const tpc = getTimePeriodConst();
      return `${~~(diff / tpc.hour)}小时${~~((diff % tpc.hour) / tpc.minute)}分钟前`;
    }
    return res;
  },
}); // '2小时10分钟前'
复制