MINECRAFT

DATE CLOCK

22:41:26

Night

GAME STATS

DayDay 448,245

Game TimeDay 448245, 22:41:26

Total Ticks10,757,902,691

Real World6/1/2026, 3:18:54 PM

TICK → TIME

Ticks

ResultDay 0, 00:00:00

GAME TIME → TICK

Game Time

HOUR → CLOCK

Hour (0–23)

TICKS REFERENCE

TICKS	HUMAN TIME	GAME TIME
0	0d 00:00:00	Day 0, 00:00:00
1,000	0d 00:00:50	Day 0, 01:00:00
6,000	0d 00:05:00	Day 0, 06:00:00
12,000	0d 00:10:00	Day 0, 12:00:00
18,000	0d 00:15:00	Day 0, 18:00:00
24,000	0d 00:20:00	Day 1, 00:00:00
48,000	0d 00:40:00	Day 2, 00:00:00
72,000	0d 01:00:00	Day 3, 00:00:00

WHAT IS A TICK?

A tick is Minecraft's fundamental unit of time. The game engine processes every event — mob movement, redstone circuits, block updates — exactly once per tick. Under normal conditions the server runs at 20 ticks per second (TPS).

Inspired by the Unix epoch (seconds since January 1, 1970), this library anchors its own epoch at May 16, 2009 — the release date of Minecraft Classic. Every real-world moment can therefore be expressed as a unique tick offset from that date.

Because Minecraft has no native concept of months or years, elapsed time is expressed using only days, hours, minutes, and seconds:

Days 14, 12:32:11

TICK CONVERSION

Since 1 tick = 50 ms of real time, every larger unit is a fixed multiple:

20 ticks=1 second(20 × 1)

1,200 ticks=1 minute(20 × 60)

72,000 ticks=1 hour(20 × 3,600)

1,728,000 ticks=1 day(20 × 86,400)

To break a tick count into human time: divide by 1,728,000 for days → remainder by 72,000 for hours → remainder by 1,200 for minutes → remainder by 20 for seconds.

HOW TO USE

Install the package:

npm install @jondotsoy/date-minecraft

Import and use:

import { DateMinecraft } from "@jondotsoy/date-minecraft";

// From a tick number
const a = new DateMinecraft(6000);
console.log(a.hour);    // 12
console.log(a.minute);  // 0
console.log(a.toLocaleString()); // "Day 0, 12:00:00"

// From a time string
const b = new DateMinecraft("18:00");
console.log(b.tick);    // 18000

// Ticks since Minecraft's launch (May 16, 2009)
const ticks = DateMinecraft.now();
const current = new DateMinecraft(ticks);

// Get ticks per day constant
console.log(DateMinecraft.TICKS_PER_DAY); // 24000