# @11ty/parse-date-strings 中文文档

规范地址：https://npmcn.com/package/%4011ty/parse-date-strings/

版本：2\.0\.6
npm 元数据更新时间：2025-12-02T21:00:22.932Z
中文译文更新时间：2026-11-06T00:58:54.539Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%4011ty/parse-date-strings
原文对照：https://npmcn.com/package/%4011ty/parse-date-strings/?lang=original
项目主页：https://www.11ty.dev/
源码仓库：https://github.com/11ty/parse-date-strings

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：7.7 kB，3 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：0 个
- 首次发布：2025-07-21T21:59:37.959Z
- 最新版本发布：2025-12-02T21:00:22.505Z
- 近 30 天下载量：7598（2026-10-04 至 2026-11-02，npm 官方下载统计）
- 已发布版本数：8（近 12 个月 1 个）

## 中文简介

在"十一"核心中解析内容日期字符串.

## 安装

```sh
npm install @11ty/parse-date-strings
```

也可以使用：`pnpm add @11ty/parse-date-strings`、`yarn add @11ty/parse-date-strings`、`bun add @11ty/parse-date-strings`

## README

# `@11ty/parse-date-strings`

特征 :

-   零依赖性极小 [RFC 9557 (英语)](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Temporal/PlainDateTime#rfc_9557_format)\- 兼容的日期解析库。 日期字符串也可以由 `Temporal.PlainDate.from`, (中文(简体) ), `Temporal.Instant.from`,或 `Temporal.PlainDateTime.from` 筹备更广泛的 [临时 API](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Temporal) 支助.
    -   替代品: [`temporal-polyfill`](https://github.com/fullcalendar/temporal-polyfill) 或者说 [`js-temporal/temporal-polyfill`](https://github.com/js-temporal/temporal-polyfill)
-   无效的字符串丢出错误 .
-   时区注释 :
    -   当时区未知时默认为世界协调时( UTC)_没有_ (当地时间). 这符合"十一"中之前的行为,并且这个特性保持了构建和部署服务器的一致性.
    -   支助 `+00`, (中文(简体) ), `+00:00`, (中文(简体) ), `-00`,或 `-00:00` 样式时区偏移(`:` 分隔符是可选的)
-   标记符 :
    -   _要求数_ (单位:千美元) `T` 或者说 `t` 或者说 (空格)带有日期时间字符串的分隔符
    -   日期的限定符(`-`)和时间(`:`)是可选的

不支持( 对于 RFC 9557 兼容性) :

-   独立时间格式为 _没有_ 支持( 必须是日期或日期时间)
-   [ISO 每周日期语法](https://en.wikipedia.org/wiki/ISO_week_date) 实值 _没有_ 支持( 例如). `YYYY-W01-1`(中文(简体) )
-   年份语法为 _没有_ 支持( 例如). `YYYY-001`, (中文(简体) ), `YYYY-365`(中文(简体) )
-   小数小时或分数(如:. `T14.6` 或者说 `T10:30.6`已经 _没有_ 已支持。 小数秒(如毫秒)是支持的(当然).

## 使用量

```
npm install @11ty/parse-date-strings
```

```js
import { parse } from "@11ty/parse-date-strings

// `parse` returns JavaScript Date

parse("2000-01-01") instanceof Date
// true

parse("2000-01-01").toUTCString()
// "Mon, 01 Jan 2001 00:00:00 GMT"
```

## 比较

### `luxon`

与 [卢克逊 `fromISO`](https://moment.github.io/luxon/#/parsing?id=iso-8601) (在"十一·v.x"至"v3"中使用):

```
2016-05-25
20160525
2016-05-25T09
2016-05-25T09:24
2016-05-25T09:24:15
2016-05-25T09:24:15.123
2016-05-25T0924
2016-05-25T092415
2016-05-25T092415.123
2016-05-25T09:24:15,123

# No YYYY or YYYYMM syntax
2016                      # Dropped
2016-05                   # Dropped
201605                    # Dropped

# No ISO week date syntax
2016-W21-3                # Dropped
2016W213                  # Dropped
2016-W21-3T09:24:15.123   # Dropped
2016W213T09:24:15.123     # Dropped

# No day of year syntax (e.g. 200th day of the year)
2016-200                  # Dropped
2016200                   # Dropped
2016-200T09:24:15.123     # Dropped

# No implied current day (time-only syntax)
09:24                     # Dropped
09:24:15                  # Dropped
09:24:15.123              # Dropped
09:24:15,123              # Dropped
```

## 常见问题

### @11ty/parse-date-strings 是什么？

在"十一"核心中解析内容日期字符串\.

### 如何安装 @11ty/parse-date-strings？

在项目目录运行 npm install @11ty/parse-date-strings，或使用 pnpm add / yarn add / bun add。

### @11ty/parse-date-strings 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/11ty\_\_parse-date-strings 是否存在。

### @11ty/parse-date-strings 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @11ty/parse-date-strings 需要什么版本的 Node\.js？

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

### @11ty/parse-date-strings 可以商用吗？

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

### @11ty/parse-date-strings 的下载量有多少？

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

### @11ty/parse-date-strings 还在维护吗？

最新版本 2\.0\.6 发布于 2025/12/03（11 个月前）；至今共发布 8 个版本，其中过去 12 个月发布了 1 个；首次发布于 2025/07/22。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。