# @easepick/datetime 中文文档

规范地址：https://npmcn.com/package/%40easepick/datetime/

版本：1\.2\.1
npm 元数据更新时间：2023-02-22T18:20:42.147Z
中文译文更新时间：2026-11-13T03:39:18.320Z
软件包许可：GPL-2\.0-or-later

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

原始 npm 页面：https://www.npmjs.com/package/%40easepick/datetime
原文对照：https://npmcn.com/package/%40easepick/datetime/?lang=original
项目主页：https://easepick.com/
源码仓库：https://github.com/easepick/easepick

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

- 包体积（解压后）：22.6 kB，6 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2022-01-24T10:42:34.532Z
- 最新版本发布：2023-02-22T18:20:42.071Z
- 近 30 天下载量：70788（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：22（近 12 个月 0 个）

## 中文简介

日期时间对象 .

## 安装

```sh
npm install @easepick/datetime
```

也可以使用：`pnpm add @easepick/datetime`、`yarn add @easepick/datetime`、`bun add @easepick/datetime`

## README

# @ access/ 日期时间

[![npm version](https://badge.fury.io/js/@easepick%2Fdatetime.svg)](https://www.npmjs.com/package/@easepick/datetime)

> 如果您正在使用此软件包, 此软件包不需要安装 [@ access/ bundle](https://easepick.com/packages/bundle)。 。 。 .

日期时间库 `easepick`。 。 。 .

## 文档

[https://searpick.com/packages/datetime (中文(简体) )](https://easepick.com/packages/datetime)

## 日期时间 () 构造器

创建 JavaScript DateTime 实例,它代表时间中的单个时刻.  
使用 : `new DateTime(date, format, lang)`

| 参数 | 类型 | 默认值 | 说明 |
| --- | :-: | --- | --- |
| 日期 | 日期  
字符串  
编号 | 无效 | [日期](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date) 对象或日期字符串或数字(unix timestamp). |
| 格式 | 字符串 | "YYY-MM-DD" (英语) | 提供时需要 `date` 参数作为字符串。 匹配字符串值才能正确解析 . |
| 朗语 | 字符串 | "在美国" | 影响月份名称`MMM`, (中文(简体) ), `MMMM` 示众. |

您可以省略所有参数并调用 `new DateTime()`。这将创建一个 DateTime 对象代表当前日期.

## 方法

| 名称 | 参数 | 说明 |
| --- | :-: | --- |
| 获取 Week | \- 说吧 | 返回一周的日期 |
| 克隆 | \- 说吧 | 返回日期副本 |
| 到 JSDate 时 | \- 说吧 | 回返 [日期](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date) 对象. |
| 在箭头中 | (阵列,包容性) | 在通过的日期时间阵列中查找日期时间对象 . |
| 是贝特温 | (日期1、日期2、包容性) | 检查日期时间是否介于另外两个日期时间之间 . |
| 已经过去 | (日期,单位) | 检查日期时间是否在另一个日期时间之前 . `unit` 为: `day`, (中文(简体) ), `month`, (中文(简体) ), `year`。 。 。 . |
| 和以前一样 | (日期,单位) | 请检查access-dateTime是否在之前或与另一个DateTime相同. `unit` 为: `day`, (中文(简体) ), `month`。 。 。 . |
| 之后为 | (日期,单位) | 检查日期时间是否在另一个日期时间之后... `unit` 为: `day`, (中文(简体) ), `month`, (中文(简体) ), `year`。 。 。 . |
| 相同奥后 | (日期,单位) | 请检查dateTime是在之后还是与另一个DateTime相同. `unit` 为: `day`, (中文(简体) ), `month`。 。 。 . |
| 一样 | (日期,单位) | 检查日期时间是否与另一个日期时间相同 . `unit` 为: `day`, (中文(简体) ), `month`。 。 。 . |
| 添加 | (期限,单位) | 通过添加单位来改变原日期时间 . `unit` 为: `day`, (中文(简体) ), `month`。 。 。 . |
| 减去 | (期限,单位) | 将原日期时间通过去除单位来分解 . `unit` 为: `day`, (中文(简体) ), `month`。 。 。 . |
| 微调 | (日期,单位) | 在两个约会时间之间返回 diff . `unit` 为: `day`, (中文(简体) ), `month`。 。 。 . |
| 格式 | (格式, lang) (中文(简体) ) | 格式输出。 见 [符号格式](https://npmcn.com/package/%40easepick/datetime/#readme-tokens-format) 页:1 `format` 参数. `lang` 影响月份名称( e)`MMM`, (中文(简体) ), `MMMM` 示众. |

## 脚本格式

_托肯斯对案件很敏感._

|  | 脚本 | 产出 |
| --- | :-: | --- |
| 月份天数 | D级 | 12 二. 30 31 |
|  | 数字 | 01:02. 30 31 |
| 月数 | 联合国 | 一 二. 11 12 |
|  | 微调 | 01:02. 11 12 |
|  | 母亲 | 12月... 11月.. |
|  | 毫米 | 1月 -- -- 11月12日 |
| 年份 | 哟 | 70 71 29 30 |
|  | 哟 | 1970 1971. 2029 2030 (英语) |
| 小时(24小时) | 页:1 | ○一. 22 23 |
|  | 嘘 | 01:02. 22 23 |
| 分钟 | 页:1 | 12 -- 58 59 |
|  | 毫米 | 01 02... 58 61,58,58,501,502,502,501,502,501,502,501,501,501,501,501,502,501,501,501,501,501,501,502,501,501,501,501,501,501,501,501,501,501,501,501,501,601,501,501,501,501,601,501,501,501,501,501,601,501,601,58,58591,60,601,601,601,60,601,601,601,601,601,601,601,601,601,60,601,601,601,601,601,601,601,601,601,601,601,601,601,601,601,601,601,601 |
| 秒数 | 编号 | 12 -- 58 59 |
|  | 编号 | 01 02... 58 61,58,58,501,502,502,501,502,501,502,501,501,501,501,501,502,501,501,501,501,501,501,502,501,501,501,501,501,501,501,501,501,501,501,501,501,601,501,501,501,501,601,501,501,501,501,501,601,501,601,58,58591,60,601,601,601,60,601,601,601,601,601,601,601,601,601,60,601,601,601,601,601,601,601,601,601,601,601,601,601,601,601,601,601,601 |

## 常见问题

### @easepick/datetime 是什么？

日期时间对象 \.

### 如何安装 @easepick/datetime？

在项目目录运行 npm install @easepick/datetime，或使用 pnpm add / yarn add / bun add。

### @easepick/datetime 支持 TypeScript 吗？

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

### @easepick/datetime 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @easepick/datetime 可以商用吗？

@easepick/datetime 使用 GPL-2\.0-or-later 许可。强 Copyleft：分发包含该代码的软件时，整个作品需以兼容的 GPL 许可开源。仅在内部使用、不对外分发时不触发此义务。以上为概括，不构成法律意见，请以许可原文为准。

### @easepick/datetime 的下载量有多少？

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

### @easepick/datetime 还在维护吗？

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