← Back to Documentation

Time API

⚠️ Experimental - Pre-Release

The Time API provides methods for time-based operations, including delta time for frame-independent movement and timing utilities.

Methods

Time.get_delta()float

Returns the time elapsed since the last frame in seconds. Use this for frame-independent movement and animations.

@script Player extends Sprite2D    var speed = 100.0     fn update() {        var delta = Time.get_delta()        self.transform.position.x += speed * delta    }

Time.sleep_msec(milliseconds: int)

Sleeps for the specified number of milliseconds. Blocks execution.

Time.sleep_msec(1000)  // Sleep for 1 second

Time.get_unix_time_msec()int

Returns the current Unix timestamp in milliseconds since January 1, 1970.

var timestamp = Time.get_unix_time_msec()
Console.print("Current time: " + timestamp)

Usage Example

@script Enemy extends Sprite2D    var speed = 50.0    var rotation_speed = 90.0     fn update() {        var delta = Time.get_delta()         // Move forward        self.transform.position.x += speed * delta         // Rotate        self.transform.rotation += rotation_speed * delta    }