std/time

Time operations and formatting.

Struct: `Time`

Represents a point in time or duration.

struct Time {
public:
    sec: int64;
    nsec: int64;
}

import "std/time";

let time = new Time(1234567890, 0);

Creates a Time with the specified seconds and nanoseconds.

Get the current time.

let now = Time::now();
println(now.sec);

Format the time as a string using format specifiers.

let time = Time::now();
let formatted = time.format("%Y-%m-%d %H:%M:%S");
println(formatted);  // e.g., "2026-01-06 14:30:45"

Format Specifiers:

%Y - Year (e.g., 2026)
%m - Month (01-12)
%d - Day (01-31)
%H - Hour (00-23)
%M - Minute (00-59)
%S - Second (00-59)

Convert to ISO 8601 format.

let time = Time::now();
let iso = time.to_iso_string();
println(iso);  // e.g., "2026-01-06T14:30:45"

Sleep for the duration represented by this Time.

let duration = new Time(2, 0);  // 2 seconds
duration.sleep();
println("2 seconds passed");

Note: This is a blocking sleep operation.

Calculate elapsed time since another time.

let start = Time::now();
// ... do work ...
let end = Time::now();
let duration = end.elapsed(start);
println(duration.sec);  // Seconds elapsed