@citation-js/date

中文文档
0.5.1发布于 2021/12/02MITCommonJS零依赖近 30 天下载 35.2万

日期解析器和格式

中文使用文档
文档目录4 节
  1. 安装
  2. 使用
  3. 投入
  4. API 密码

安装

npm install @citation-js/date

使用

let { parse, format } = require('@citation-js/date')

parse('2000-12-31')
// { 'date-parts': [[2000, 12, 31]] }

format({ 'date-parts': [[2000, 12, 31]] }, '/')
// '2000/12/31'

投入

支持的格式 :

  • Epoch 时间( 数字形式)
  • YYYY-MM-DD
  • [+-]YYYYYY[Y...]-MM-DD
  • [DDD, ]DD MMM YYYY
  • M[M]/D[D]/YY[YY] (1) 国家
  • D[D] M[M] Y[Y...] (2,1项)
  • [-]Y[Y...] M[M] D[D] (二)
  • D[D] MMM Y[Y...] (二)
  • [-]Y[Y...] MMM D[D] (二)
  • M[M] [-]Y[Y...] (3,5) (简体中文)
  • [-]Y[Y...] M[M] (3, 4, 5) (中文(简体) )
  • MMM [-]Y[Y...] (3,5) (简体中文)
  • [-]Y[Y...] MMM (3,5) (简体中文)
  • [-]Y[Y...] 第5条:

一般来说,格式支持后行部分,这些部分不予考虑.

  1. 当前一种格式与后一种格式相重叠时 首选项
  2. ","","-"和"/"都作为分隔符支持
  3. 非辅助字符的任何序列都作为 分隔符
  4. 只有当年份大于月份时才假定此格式
  5. 此格式不支持后端部件

API 密码

parse(String date[, String endDate]) -> Object

  • String date: 任何日期
  • String endDate 选项: 任何日期; 添加后,第一个参数作为 范围开始日期.

format(Object date[, String delimiter = '-']) -> String

  • Object date: 任何日期
  • String delimiter 选项: 按分隔符分隔部件

这里, Object date (CSL-JSON 日期格式)可以有以下属性:

  • date-parts: 有一两个日期的数组, 每个日期为 [年、 月、 日] 的数组, 最后两个部分是可选的
  • raw: 原始日期

版本与发布记录

@citation-js/date 共发布 7 个版本,首次发布于 2018/07/24;过去 12 个月发布了 0 个版本。

版本发布日期距今
0.5.1latest2021/12/024 年前
0.5.02021/05/205 年前
0.4.42019/04/277 年前
0.4.32019/01/057 年前
0.4.22018/12/257 年前
0.4.12018/08/278 年前

关于 @citation-js/date 的常见问题

@citation-js/date 是什么?

日期解析器和格式

如何安装 @citation-js/date?

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

@citation-js/date 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/citation-js__date 是否存在。

@citation-js/date 支持 ESM 还是 CommonJS?

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

@citation-js/date 需要什么版本的 Node.js?

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

@citation-js/date 可以商用吗?

@citation-js/date 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@citation-js/date 的下载量有多少?

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

@citation-js/date 还在维护吗?

最新版本 0.5.1 发布于 2021/12/02(4 年前);至今共发布 7 个版本,其中过去 12 个月发布了 0 个;首次发布于 2018/07/24。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。