简介
@mapbox/timespace 是一个 JavaScript 库，它提供了在地理空间中管理时间范围的功能，包括但不限于计算时间范围内的点、线、面、点密度等。它可以用于 Web 和 Node.js 环境中。
安装
你可以使用 npm 直接在你的项目中安装 @mapbox/timespace。命令如下：
npm install @mapbox/timespace --save
快速开始
你可以轻松地运用 @mapbox/timespace 的功能。以下是一个基本的使用示例：
import * as timespace from '@mapbox/timespace';
// 创建一个时间范围对象
const tr = new timespace.TimeRange({
start: '2020-09-01T00:00:00Z',
end: '2020-09-02T00:00:00Z'
});
// 计算出中点
console.log(tr.getCenter());这段代码将打印出时间范围的中点，也就是 2020-09-01T12:00:00.000Z。
API 文档
TimeRange
TimeRange 代表一个时间范围。其构造函数接受一个对象类型参数，包含两个必需的属性 start 和 end，分别代表时间范围的起始和结束时间。
const tr = new timespace.TimeRange({
start: '2020-09-01T00:00:00Z',
end: '2020-09-02T00:00:00Z'
});TimeRange.getStart()
返回时间范围的起始时间。
const start = tr.getStart(); // '2020-09-01T00:00:00Z'
TimeRange.getEnd()
返回时间范围的结束时间。
const end = tr.getEnd(); // '2020-09-02T00:00:00Z'
TimeRange.getDuration()
返回时间范围的总持续时间。
const duration = tr.getDuration(); // 86400000 (ms)
TimeRange.getCenter()
返回时间范围的中点时间。
const center = tr.getCenter(); // '2020-09-01T12:00:00.000Z'
TimeRange.contains(other)
如果一个时间范围被当前时间范围包含，则返回 true，否则返回 false。
const other = new timespace.TimeRange({
start: '2020-09-01T06:00:00Z',
end: '2020-09-01T18:00:00Z'
});
const contains = tr.contains(other); // trueTimeUnits
TimeUnits 提供了用于处理时间单位的功能。可以通过以下方式引入：
import { TimeUnits } from '@mapbox/timespace';TimeUnits.toMilliseconds(time, units)
将给定时间转换为毫秒。参数 time 是一个数字，代表时间的数量，参数 units 是一个字符串，代表时间的单位。此方法返回一个数字，代表毫秒数。
const ms = TimeUnits.toMilliseconds(10, 'minutes'); // 600000 (ms)
TimeUnits.fromMilliseconds(ms, units)
将给定的毫秒数转换为指定的时间单位。参数 ms 是一个数字，代表毫秒数，参数 units 是一个字符串，代表目标时间单位。此方法返回一个数字，代表相应的时间数。
const minutes = TimeUnits.fromMilliseconds(600000, 'minutes'); // 10 (minutes)
Timespans
Timespans 提供了处理时间范围的工具方法。可以通过以下方式引入：
import { Timespans } from '@mapbox/timespace';Timespans.overlap(a, b)
如果两个时间范围有重叠，则返回 true，否则返回 false。
-- -------------------- ---- ------- ----- - - --- --------------------- ------ ----------------------- ---- ---------------------- --- ----- - - --- --------------------- ------ ----------------------- ---- ---------------------- --- ----- ------- - -------------------- --- -- ----
Timespans.intersection(a, b)
返回两个时间范围相交的部分，如果两个时间范围没有交集则返回 null。
-- -------------------- ---- ------- ----- - - --- --------------------- ------ ----------------------- ---- ---------------------- --- ----- - - --- --------------------- ------ ----------------------- ---- ---------------------- --- ----- ------------ - ------------------------- --- -- - ------ ----------------------- ---- ---------------------- -
Timespans.add(a, b)
返回两个时间范围的总时间范围。
-- -------------------- ---- ------- ----- - - --- --------------------- ------ ----------------------- ---- ---------------------- --- ----- - - --- --------------------- ------ ----------------------- ---- ---------------------- --- ----- ------ - ---------------- --- -- - ------ ----------------------- ---- ---------------------- -
结论
@mapbox/timespace 是一个非常棒的库，它提供了处理时间范围的功能。它易于使用，同时也提供了丰富的 API。如果你需要在地理空间中处理时间范围，那么你可以尝试使用 @mapbox/timespace。
参考
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60066bcb967216659e244729