简介
time-referenced-accumulator 是一个用于计算时间序列的 npm 包。它可以方便地对一段时间内的数据进行累加，并且支持以时间为单位进行统计。time-referenced-accumulator 可以帮助我们更方便地进行统计数据的处理，并且减少了一些繁琐的工作。在前端开发中，我们可以使用它来方便地处理一些时间序列数据，如页面访问量、用户在线时长等等。
安装
你可以在 npm 上找到 time-referenced-accumulator，可以通过以下命令进行安装：
npm install time-referenced-accumulator
使用
time-referenced-accumulator 提供了两个类：TimeReferencedAccumulator 和 TimeInterval。其中 TimeReferencedAccumulator 是主要的累加器类，而 TimeInterval 则是用于表示时间范围的类。下面是一个使用示例：
-- -------------------- ---- ------- ----- - -------------------------- ------------ - - --------------------------------------- ----- ----------- - --- ---------------------------- -- -- ---- - - - - -- ---- - - - - ------- ------------------------- ------------------- --- ------------------------- ------------------- --- ------------------------- ------------------- --- ------------------------- ------------------- --- ------------------------- ------------------- --- ------------------------- ------------------- --- ------------------------- ------------------- --- -- --------- ----- -------- - --- -------------- ----- - --- --- ------ - ----- ----- - -- -------------------------------- - ---------------------------------------------- ----- ----------- -
输出结果为：
2022-01-01: 1 2022-01-02: 2 2022-01-03: 3 2022-01-04: 4 2022-01-05: 5 2022-01-06: 6 2022-01-07: 7
在这个示例中，我们使用 TimeReferencedAccumulator 统计了 2022 年 1 月 1 日到 2022 年 1 月 7 日每天的访问量，并使用 TimeInterval 以天为单位进行了统计。通过遍历返回的结果，我们可以得到每天的访问量。
API
TimeReferencedAccumulator
constructor()
构造函数，创建一个新的 TimeReferencedAccumulator 实例。
increment(time, value)
将指定时间的值进行累加。如果该时间点不存在，则会自动创建一个新的时间点。
参数：
time:Date，用于标识值的时间点。value:number，要累加的值。
getValue(time)
获取指定时间的累加值。如果该时间点不存在，则返回 0。
参数：
time:Date，用于标识值的时间点。
返回值：
number，该时间点的累加值。
getPeriodSum(from, to?)
获取指定时间范围内的累加值。
参数：
from:Date，表示时间范围的起始时间。to?:Date，表示时间范围的结束时间。如果未指定，则默认为当前时间。
返回值：
number，指定时间范围内的累加值。
getSeries(interval, from?, to?)
获取指定时间范围内的时间序列。
参数：
interval:TimeInterval，指定时间的间隔。from?:Date，表示时间范围的起始时间。如果未指定，则默认为存储数据中的最早时间。to?:Date，表示时间范围的结束时间。如果未指定，则默认为当前时间。
返回值：
Iterable<{time: Date, value: number}>，表示指定时间范围内的时间序列，其中time表示时间点，value表示该时间点的累加值。
TimeInterval
constructor(timeUnit)
构造函数，创建一个新的 TimeInterval 实例。
参数：
timeUnit:object，指定时间单位的对象。目前支持的时间单位包括：years、months、weeks、days、hours、minutes、seconds、milliseconds。例如，要以 1 天为单位进行统计，需要传递{ days: 1 }。
isInInterval(time)
判断指定的时间是否在该 TimeInterval 中。
参数：
time:Date，用于比较的时间。
返回值：
boolean，表示指定的时间是否在该 TimeInterval 中。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/600671cc30d092702382284f