@google-cloud/precise-date

中文文档
6.2.1发布于 2026/10/20Apache-2.0TypeScriptCommonJS零依赖近 30 天下载 6746.7万

用于精确约会功能和类的简单工具.

中文使用文档
文档目录8 节
  1. 安装软件包
  2. 使用软件包
  3. API 密码
  4. 精确时间( [时间] )
  5. 日期
  6. 版本
  7. 捐款
  8. 许可证
Google Cloud Platform logo

@google-cloud/ 确切日期

用于精确约会功能和类的简单工具.

安装软件包

你不需要直接安装这个软件包,因为它会 安装时作为依赖性安装 @google-cloud 软件包.

$ npm install --save @google-cloud/precise-date

使用软件包

PreciseDate 扩展本地 Date 对象,这样您就可以用它代替 或者当你需要纳米秒精确.

const {PreciseDate} = require('@google-cloud/precise-date');
const date = new PreciseDate('1547253035381101032');

date.toISOString();
// => 2019-01-12T00:30:35.381101032Z

date.toFullTimeString();
// => '1547253035381101032'

API 密码

精确时间( [时间] )

返回一个新的 date 举个例子.

时间

类型 : string BigInt Object<string, number> [number, number]

// from a full ISO string
date = new PreciseDate('2019-02-08T10:34:29.481145231Z');

// from a string representing nanoseconds
date = new PreciseDate('1549622069481320032');

// from a BigInt representing nanoseconds (requires Node >= 10.7)
date = new PreciseDate(1549622069481320032n);

// from an object containing `seconds` and `nanos` values
date = new PreciseDate({seconds: 1549622069, nanos: 481320032});

// from a tuple representing [seconds, nanos]
date = new PreciseDate([1549622069, 481320032]);

精确Date.parseFull(时间)

类似 Date.parse(),但这个选项接受与 PreciseDate 构造器和返回一个字符串,按照通用时间代表指定日期的纳米秒.

PreciseDate.parseFull('2019-02-08T10:34:29.481145231Z');
// => '1549622069481145231'

精确 Date. fullUTCString(. 日期字段)

类似 Date.UTC(),但也接受微秒和纳米秒参数. 返回一个表示自1970年1月1日00:00 UTC起纳米秒数的字符串.

日期字段

类型 : ...number

PreciseDate.fullUTCString(2019, 1, 8, 10, 34, 29, 481, 145, 231);
// => '1549622069481145231'

精确 Date. fullUTC(. 日期字段)

喜欢 PreciseDate.fullUTCString() 但返回一个本地 BigInt 而不是一个字符串. 需要节点...

日期字段

类型 : ...number

PreciseDate.fullUTC(2019, 1, 8, 10, 34, 29, 481, 145, 231);
// => 1549622069481145231n

日期

PreciseDate 举个例子.

日期。 get FullTimeString () 时间轴

根据通用时间返回以纳秒表示的指定日期的字符串.

日期. getFullTime ()

喜欢 date.getFullTimeString() 但返回一个本地 BigInt 而不是一个字符串. 需要节点...

日期. get 微秒( )

根据通用时间返回指定日期的微秒.

日期. getNanoseconds( )

根据通用时间返回指定日期的纳米秒.

日期. set 微秒(微秒)

根据通用时间设置指定日期的微秒。 根据通用时间返回指定日期中代表纳米秒的字符串.

微秒

类型 : number

日期. set Nano秒( 无秒)

根据通用时间设定指定日期的纳米秒。 根据通用时间返回指定日期中代表纳米秒的字符串.

纳秒

类型 : number

日期. setFull Time( 时间)

将时间设定为自1970年1月1日 UTC凌晨00:00起供给的纳秒数. 根据通用时间返回一个代表指定日期内纳米秒的字符串(有效的,该参数的值).

时间

类型 : number string BigInt

日期. to Struct () (中文(简体) )

根据通用时间返回一个代表指定日期的对象. 参见 google.protobuf.Timestamp 关于此格式的更多信息.

const {seconds, nanos} = date.toStruct();

date. to Tuple () (中文(简体) )

喜欢 date.toStruct() 但返回 seconds 财务报告和审定财务报表 nanos 像个拖累.

const [seconds, nanos] = date.toTuple();

版本

这个图书馆跟随 语义版本。 。 。 .

捐款

欢迎捐款! 见 贡献指南。 。 。 .

许可证

Apache 版本 2.0

见 自由主义

版本与发布记录

@google-cloud/precise-date 共发布 22 个版本,首次发布于 2019/02/25;过去 12 个月发布了 8 个版本。

版本发布日期距今
6.2.1latest2026/10/2027 天前
6.2.02026/10/131 个月前
6.1.02026/09/162 个月前
6.0.12026/08/242 个月前
6.0.02026/07/313 个月前
5.2.0legacy-182026/07/273 个月前

其他发布通道:legacy-8 → 1.0.3,legacy-10 → 2.0.4,legacy-14 → 4.0.0,legacy-18 → 5.2.0。

关于 @google-cloud/precise-date 的常见问题

@google-cloud/precise-date 是什么?

用于精确约会功能和类的简单工具.

如何安装 @google-cloud/precise-date?

在项目目录运行 npm install @google-cloud/precise-date,或使用 pnpm add / yarn add / bun add。

@google-cloud/precise-date 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@google-cloud/precise-date 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@google-cloud/precise-date 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@google-cloud/precise-date 可以商用吗?

@google-cloud/precise-date 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@google-cloud/precise-date 的下载量有多少?

根据 npm 官方下载统计,@google-cloud/precise-date 在 2026/10/17 – 2026/11/15 这 30 天内被下载 67,466,552 次,日均约 2,248,885 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@google-cloud/precise-date 还在维护吗?

最新版本 6.2.1 发布于 2026/10/20(27 天前);至今共发布 22 个版本,其中过去 12 个月发布了 8 个;首次发布于 2019/02/25。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。