/time

{
    "title": "<code>/time</code>",
    "rows": [
        {
            "field": "\n* 2 ‌<sup class=\"noprint nowrap Inline-Template \" title=\"\">[<i><span title=\"This statement only applies to Java Edition\">(link to Java Edition article, displayed as JE)  only</span></i>]</sup>\n* 1 ‌<sup class=\"noprint nowrap Inline-Template \" title=\"\">[<i><span title=\"This statement only applies to Bedrock Edition\">(link to Bedrock Edition article, displayed as BE)  only</span></i>]</sup>",
            "label": "(link to Permission level article, displayed as Permission level<br>required)"
        },
        {
            "field": "(link to Options article, displayed as Cheat) only‌<sup class=\"noprint nowrap Inline-Template \" title=\"\">[<i><span title=\"This statement only applies to Bedrock Edition\">(link to Bedrock Edition article, displayed as BE)  only</span></i>]</sup>",
            "label": "(link to Commands#Restrictions article, displayed as Restrictions)"
        }
    ],
    "invimages": [],
    "images": []
}

Changes or queries the world's game time.

Usage

There are four types of time involved in this command:

• Gametime - The total number of game ticks that have elapsed in the world.
• Daylight cycle time (aka. internal daytime) - The total number of game ticks that have elapsed during the daylight cycle. It does not elapse when the game rule doDaylightCycle is false.
• Daytime - The number of game ticks that have elapsed since sunrise on current day. It is the result of dividing the daylight cycle time modulo 24,000.
• Day - The number of days that have elapsed during the daylight cycle. It is the result of floor division by 24,000 of the daylight cycle time.

In Java Edition, if the world is frozen by the /tick command, the four times above do not elapse.

/time set ... command in Java Edition always directly sets the daylight cycle time to the specified number. But in Bedrock Edition, when time: TimeSpec is specified, it increases the daylight cycle time to meet the specified time: TimeSpec.

For example:

in Java Edition, when executing /time set day or /time set 1000, the daylight cycle time is set to 1000, so the "day" value returns to 0.

In Bedrock Edition, when executing /time set 1000, the daylight cycle time is also set to 1000. But, for /time set day, if now the daylight cycle time is 25001 (1 day + 1001 ticks), after executing /time set day, it won't become 1000 or 25000, since it only increases the daylight cycle time when using time: TimeSpec. In fact, it turns into 49000 (2 days + 1000 ticks), and the "day" value becomes 2. If now the daylight cycle time is 25000 (1 day + 1000 ticks), after executing /time set day, it remains unchanged.

Syntax

• Java Edition

time add <time>

Adds <time> to the in-game daytime.

time query (daytime|gametime|day)

Queries current time.

time set (day|night|noon|midnight)

time set <time>

Sets the daylight cycle time.

• Bedrock Edition

time add <amount: int>

Adds <time> to the daylight cycle time.

time query <daytime|gametime|day>

Queries current time.

time set <amount: int>

time set <time: TimeSpec>

Sets the daylight cycle time.

Arguments

JE: <time>: time
BE: amount: int: int

Specifies the time to add or set.

In Java Edition, it must be a single-precision floating-point number suffixed with a unit. It must be not less than 0 gameticks. Units include:

• d: an in-game day, 24000 gameticks;
• s: a second, 20 gameticks;
• t (default and omitable): a single gametick; the default unit.

The time is set to the closest integer after unit conversion to gametick. For example. .5d is same as 12000 gameticks.
In Bedrock Edition it must be a [Int] 32-bit integer number.

daytime|gametime|day

Specifies the time to query. Must be daytime, gametime or day.

JE: day|night|noon|midnight
BE: time: TimeSpec: enum

Specifies the time to set.

Must be day, night, noon, midnight, sunrise‌, or sunset‌.

• day = 1,000
• night = 13,000
• noon = 6,000
• midnight = 18,000
• sunrise = 23,000‌
• sunset = 12,000‌

Result

Output

Examples

• To set the daylight cycle time to 1,000: time set 1000
• To add one day to the daylight cycle time: time add 24000
• To change/reset in-game day count to desired number: time set <desired day number*24000+time of day in ticks>; to change day count to day 472 at noon (6000): time set 11334000

History

Navigation