# @eartharoid/dtf 中文文档

规范地址：https://npmcn.com/package/%40eartharoid/dtf/

版本：2\.0\.1
npm 元数据更新时间：2022-04-05T06:22:20.339Z
中文译文更新时间：2026-11-14T14:41:17.191Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：10.9 kB，5 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2020-05-03T18:26:03.830Z
- 最新版本发布：2021-09-27T21:09:08.213Z
- 近 30 天下载量：2012（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：5（近 12 个月 0 个）

## 中文简介

简单的日期和时间.

## 安装

```sh
npm install @eartharoid/dtf
```

也可以使用：`pnpm add @eartharoid/dtf`、`yarn add @eartharoid/dtf`、`bun add @eartharoid/dtf`

## README

# 数据f

![GitHub Workflow Status](https://img.shields.io/github/workflow/status/eartharoid/dtf/lint-and-test?label=Test&logo=github&style=flat-square)

简单和有些地方化的时间戳格式.

> 请注意,在某些情况下,特别是如果想要使用标准格式和其他地块,使用内置格式可能更好 [`Date`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toLocaleString) 或者说 [`Intl`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/DateTimeFormat) 函数.

## 安装

安装 npm/ pnpm/ yarn :

`npm i @eartharoid/dtf`

## 使用量

```js
const DTF = require('@eartharoid/dtf');
const dtf = new DTF();

// a new `Date` will be created
const timestamp = dtf.fill('DD/MM/YYYY HH:mm:ss');
console.log(timestamp); // => `13/07/2021 14:44:51`

// custom `Date` and use UTC time
const timestamp = dtf.fill('DD/MM/YYYY HH:mm:ss', new Date(), true);
console.log(timestamp); // => `13/07/2021 13:44:51`

```

见 [DTF# 填补](https://npmcn.com/package/%40eartharoid/dtf/#readme-dtffillformat-date-utc)。 。 。 .

### 占位符

| 占位符 | 说明 | 示例 |
| --- | --- | --- |
| `YYYY` | 全年数字 | 2021 (英语) |
| `YY` | 短年数 | 21国 |
| `MMMM` | 全月名称 | 7月(半天会议) |
| `MMM` | 短月名称 | 朱尔 |
| `MM` | 零加数月数 | 07号 |
| `M` | 非添加月号 | 第7条 |
| `DDDD` | 全日名称 | 星期二 |
| `DDD` | 短日名称 | 图 |
| `DD` | 零添加日期编号 | 第13条 |
| `D_` | 其正文后缀所遵循的日期 | 第十三届 |
| `D` | 非添加日期编号 | 第13条 |
| `HH` | 24小时零加码 | 页:1 |
| `hh` | 12小时零加码 | 第02条 |
| `h` | 非加码 12小时 | 2个 |
| `mm` | 零加分数 | 第 18 条 |
| `m` | 非加分数 | 第 18 条 |
| `ss` | 零加法第二个数字 | 09个 |
| `s` | 非加法第二个号码 | 第9条 |
| `SSS` | 零加毫秒数 | 638号 |
| `AMPM` | 早上还是下午 | 首相 |

### API 密码

#### `new DTF(locale?)`

> 创建一个新的 DTF 实例 .

-   `locale?` - 那个 [语言](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl#locale_identification_and_negotiation) 此 DTF 实例( 默认为 `'en'`(中文(简体) )

#### `DTF#locale`

> 此 DTF 实例的地址 .

#### `DTF#fill(format?, date?, utc?)`

> 使用当前日期或时间戳填入给定或默认时间戳格式 `Date` 提供.

-   `format?` - 那个 [占位符](https://npmcn.com/package/%40eartharoid/dtf/#readme-placeholders) 字符串( 默认为 `'HH:mm:ss'`(中文(简体) )
-   `date?` - 那个 `Date` 用于填充占位符的对象(默认为新建) `Date` 对象)
-   `utc?` - 使用UTC时间? (默认为 `false`(中文(简体) )

#### `DTF#AMPM(date?, utc?)`

> 回返 `'AM'` 或者说 `'PM'` 基于时间

-   `date?` - 使用的日期(默认为新日期) `Date` 对象)
-   `utc?` - 使用UTC时间? (默认为 `false`(中文(简体) )

#### `DTF#suffix(number)`

> 附录 `st`, (中文(简体) ), `nd`, (中文(简体) ), `rd`,或 `th` 转到给定的英语语言号码。 我不知道它对其他地方有什么影响.

-   `number` - 将正文后缀附加到

#### `DTF#convert24To12(h)`

> 将一个24h的数字转换为12h.

-   `h` - 24小时号码

## 支助

[![Discord support server](https://discordapp.com/api/guilds/451745464480432129/widget.png?style=banner4)](https://go.eartharoid.me/discord)

## 捐赠

[![ko-fi](https://www.ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/eartharoid)

**或者说 [赞助我](https://github.com/sponsors/eartharoid)。 。 。 .**

## 许可证

[麻省理工学院许可证](https://github.com/eartharoid/dtf/blob/master/LICENSE)。 。 。 .

2021年 艾萨克·桑德斯

## 常见问题

### @eartharoid/dtf 是什么？

简单的日期和时间\.

### 如何安装 @eartharoid/dtf？

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

### @eartharoid/dtf 支持 TypeScript 吗？

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

### @eartharoid/dtf 支持 ESM 还是 CommonJS？

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

### @eartharoid/dtf 可以商用吗？

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

### @eartharoid/dtf 的下载量有多少？

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

### @eartharoid/dtf 还在维护吗？

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