Instant
Instant representa um ponto absoluto na linha do tempo com segundos com sinal e um resto de nanossegundos não negativo.
Quando o Tyrus serializa um Instant como JSON, usa a string ISO 8601 em UTC retornada por instantToString, inclusive em respostas HTTP. O OpenAPI descreve esse valor como type: "string" com format: "date-time", correspondente a valores como 2026-09-05T18:32:52.54345Z.
API
instantNow(): Instantlê o relógio nativo atual.instantFrom(value: string): Result<Instant, TemporalError>analisa um instante ISO.instantFromEpochMilliseconds(milliseconds: i64): Result<Instant, TemporalError>cria um instante a partir de milissegundos desde o Unix Epoch.instantToEpochMilliseconds(value: Instant): Result<i64, TemporalError>converte um instante para milissegundos desde o epoch.instantToString(value: Instant): Result<string, TemporalError>formata um instante como texto ISO UTC.instantAddDurationeinstantSubtractDurationretornamResult<Instant, TemporalError>e aplicam durações de tamanho fixo; unidades de calendário são rejeitadas.instantToZonedDateTime(value: Instant, timeZone: TimeZone): ZonedDateTimeassocia um instante a um fuso IANA versionado no repositório.
tyrus
import { Duration, Instant, TemporalError, TimeZone, ZonedDateTime, instantAddDuration, instantFrom, instantFromEpochMilliseconds, instantNow, instantToEpochMilliseconds, instantToString, instantToZonedDateTime, timeZone } from "tyrus:temporal";
export const example = (): void => {
const now: Instant = instantNow();
const parsed: Instant = match instantFrom("2026-07-09T15:30:00Z") { Ok(value) => value, Err(error) => { printError(error.code); return; } };
const epoch: Instant = match instantFromEpochMilliseconds(0) { Ok(value) => value, Err(error) => { printError(error.code); return; } };
const milliseconds: i64 = match instantToEpochMilliseconds(epoch) { Ok(value) => value, Err(error) => { printError(error.code); return; } }; // 0
const text: string = match instantToString(epoch) { Ok(value) => value, Err(error) => { printError(error.code); return; } }; // "1970-01-01T00:00:00Z"
const second: Duration = { years: 0, months: 0, weeks: 0, days: 0, hours: 0, minutes: 0, seconds: 1, milliseconds: 0, microseconds: 0, nanoseconds: 0 };
const later: Instant = match instantAddDuration(epoch, second) { Ok(value) => value, Err(error) => { printError(error.code); return; } };
const paris: TimeZone = match timeZone("Europe/Paris") { Ok(value) => value, Err(error) => { printError(error.code); return; } };
const zoned: ZonedDateTime = instantToZonedDateTime(parsed, paris);
};