@eartharoid/dtf

中文文档
2.0.1发布于 2021/09/28MITTypeScriptCommonJS零依赖近 30 天下载 2012

简单的日期和时间.

中文使用文档
文档目录7 节
  1. 安装
  2. 使用量
  3. 占位符
  4. API 密码
  5. 支助
  6. 捐赠
  7. 许可证

数据f

GitHub Workflow Status

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

请注意,在某些情况下,特别是如果想要使用标准格式和其他地块,使用内置格式可能更好 Date 或者说 Intl 函数.

安装

安装 npm/ pnpm/ yarn :

npm i @eartharoid/dtf

使用量

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# 填补。 。 。 .

占位符

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

API 密码

new DTF(locale?)

创建一个新的 DTF 实例 .

  • locale? - 那个 语言 此 DTF 实例( 默认为 'en'(中文(简体) )

DTF#locale

此 DTF 实例的地址 .

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

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

  • format? - 那个 占位符 字符串( 默认为 '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

捐赠

ko-fi

或者说 赞助我。 。 。 .

许可证

麻省理工学院许可证。 。 。 .

2021年 艾萨克·桑德斯

版本与发布记录

@eartharoid/dtf 共发布 5 个版本,首次发布于 2020/05/04;过去 12 个月发布了 0 个版本。

版本发布日期距今
2.0.1latest2021/09/285 年前
2.0.02021/07/135 年前
1.0.82020/10/046 年前
1.0.72020/08/076 年前
1.0.62020/05/046 年前

关于 @eartharoid/dtf 的常见问题

@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 和提交记录判断。