Logo
Time Formatter
ModMIT

Time Formatter

A client-side mod which formats Discord Timestamps to your local time.

558
Downloads
2
Followers
4 months ago
Updated
📦
30
Versions
utilityfabric
Download Latestv1.2.0+mc1.21.10View on Modrinth

📖About Time Formatter

TimeFormatter

MIT License

A simple client-side Minecraft mod that automatically finds and formats Discord-style timestamps in chat, converting them to your local time.

Features

  • Client-Side Only: No server-side installation is required. It works on any server you join. The formatting works only with the mod installed.
  • Automatic Formatting: Detects timestamps like <t:1672531200> in chat messages.
  • Literal Sending (not timezone aware): If a timestamp like <<t:1672531200>> is sent in the chat, it will get replaced by a matching literal assuming it won't overflow the 256 character limit, thus visible to everyone.
  • Local Time Conversion: All timestamps are converted and displayed in your computer's local time zone.
  • Multiple Formats: Supports all of Discord's standard timestamp formatting styles.
  • Relative Time: Can display time relatively, such as "5 minutes ago" or "in 2 hours".

How It Works

The mod checks incoming chat messages for timestamps like <t:TIMESTAMP:STYLE> (or <<t:TIMESTAMP:STYLE>>).

  • TIMESTAMP: A Unix timestamp (in seconds). You can also use the special values yesterday, now and tomorrow to represent the respective time.
  • STYLE: An optional single character that controls the output format. If you don't provide a style, it defaults to f (Short Date/Time).

Supported Styles

Style Example Output Description
t 14:30 Short Time
T 14:30:00 Long Time
d 31/12/2023 Short Date
D December 31, 2023 Long Date
f December 31, 2023 at 14:30 Short Date/Time (Default)
F Sunday, December 31, 2023 at 14:30 Long Date/Time
R 5 minutes ago Relative Time

Example

If another player let's say in the UTC timezone sends the following message in chat:

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

And you're in the GMT+1 timezone, you'll see:

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

However, if the player in UTC sends this message in chat:

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

Everyone (even players without this mod) will see this:

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

Installation

This is a Fabric mod and requires the Fabric API.

  1. Download the latest version.
  2. Place the downloaded .jar file into your .minecraft/mods folder.
  3. Launch the game using the Fabric Loader.

Building from Source

  1. Clone the repository: git clone https://github.com/m3z0id/TimeFormatter.git
  2. Navigate into the project directory: cd TimeFormatter
  3. Build the project using Gradle: ./gradlew build -Pmc=<Minecraft Version> -Pyarn=<Yarn Version> -Papi=<Fabric API Version> -Padventure=<Koryo Adventure Fabric Version>
  4. The compiled .jar file will be located in the build/libs/ directory.

License

This project is licensed under the MIT License. See the LICENSE file for more details.