时间格式化工具

时间格式化工具

一个客户端模组,可将Discord时间戳格式化为你的本地时间。

工具

TimeFormatter

MIT License

一个简单的客户端 Minecraft 模组,可自动查找聊天中的 Discord 风格时间戳并对其进行格式化,将其转换为你当地的时间。

特性

  • 仅客户端可用:无需在服务器端安装。它可在你加入的任何服务器上工作。格式化功能仅在安装了此模组时可用。
  • 自动格式化:检测聊天消息中形如 <t:1672531200> 的时间戳。
  • 字面发送(不考虑时区):如果在聊天中发送形如 <<t:1672531200>> 的时间戳,它会被替换为匹配的字面文本(前提是不会超出 256 字符限制),从而对所有人可见。
  • 本地时间转换:所有时间戳都会被转换并以你计算机的本地时区显示。
  • 多种格式:支持 Discord 所有标准时间戳格式样式。
  • 相对时间:可相对显示时间,例如“5 分钟前”或“2 小时后”。

工作原理

该模组会检查传入的聊天消息中形如 <t:TIMESTAMP:STYLE>(或 <<t:TIMESTAMP:STYLE>>)的时间戳。

  • TIMESTAMP:Unix 时间戳(以秒为单位)。你也可以使用特殊值 yesterday、now 和 tomorrow 来表示相应的时间。
  • STYLE:可选的一个字符,用于控制输出格式。如果不提供样式,则默认为 f(短日期/时间)。

支持的样式

样式 示例输出 描述
t 14:30 短时间
T 14:30:00 长时间
d 31/12/2023 短日期
D December 31, 2023 长日期
f December 31, 2023 at 14:30 短日期/时间(默认)
F Sunday, December 31, 2023 at 14:30 长日期/时间
R 5 minutes ago 相对时间

示例

假设另一位处于 UTC 时区的玩家在聊天中发送以下消息:

The server event will start at <t:1704067200:F>.

而你处于 GMT+1 时区,你将看到:

The server event will start at Monday, January 1, 2024 at 01:00.

然而,如果该 UTC 时区的玩家在聊天中发送这条消息:

My date and time is <<t:1704067200:F>>.

所有人(甚至未安装此模组的玩家)都将看到:

The server event will start at Monday, January 1, 2024 at 01:00.

安装

这是一个 Fabric 模组,需要 Fabric API。

  1. 下载最新版本。
  2. 将下载的 .jar 文件放入你的 .minecraft/mods 文件夹。
  3. 使用 Fabric Loader 启动游戏。

从源码构建

  1. 克隆仓库:git clone https://github.com/m3z0id/TimeFormatter.git
  2. 进入项目目录:cd TimeFormatter
  3. 使用 Gradle 构建项目:./gradlew build -Pmc=<Minecraft Version> -Pyarn=<Yarn Version> -Papi=<Fabric API Version> -Padventure=<Koryo Adventure Fabric Version>
  4. 编译后的 .jar 文件将位于 build/libs/ 目录中。

许可证

本项目采用 MIT 许可证。更多详情请参阅 LICENSE 文件。