Skip to content

ZonedDateTime ​

ZonedDateTime combina um instante absoluto com um fuso horário IANA versionado no repositório. O parsing exige o identificador IANA entre colchetes e o preserva ao formatar.

API ​

  • zonedDateTimeFrom(value: string): Result<ZonedDateTime, TemporalError> analisa uma data e hora ISO com fuso.
  • zonedDateTimeToInstant(value): Result<Instant, TemporalError> remove a projeção de calendário.
  • zonedDateTimeToString(value): Result<string, TemporalError> formata o valor com seu fuso.
  • zonedDateTimeEquals(left, right): boolean compara os valores zonados completos.
  • zonedDateTimeAddDuration(value, duration): Result<ZonedDateTime, TemporalError> aplica uma duração.
  • zonedDateTimeUntil(start, end): Result<Duration, TemporalError> retorna uma diferença com sinal.
  • zonedDateTimeFormat(value, pattern): Result<string, TemporalError> aceita yyyy, MM, dd, HH, mm e ss.
tyrus
import { Duration, Instant, TemporalError, ZonedDateTime, zonedDateTimeAddDuration, zonedDateTimeEquals, zonedDateTimeFormat, zonedDateTimeFrom, zonedDateTimeToInstant, zonedDateTimeToString, zonedDateTimeUntil } from "tyrus:temporal";

export const example = (): void => {
    const meeting: ZonedDateTime = match zonedDateTimeFrom("2026-07-09T14:30:00-03:00[America/Sao_Paulo]") { Ok(value) => value, Err(error) => { printError(error.code); return; } };
    const instant: Instant = match zonedDateTimeToInstant(meeting) { Ok(value) => value, Err(error) => { printError(error.code); return; } };
    const text: string = match zonedDateTimeToString(meeting) { Ok(value) => value, Err(error) => { printError(error.code); return; } }; // "2026-07-09T14:30:00-03:00[America/Sao_Paulo]"
    const duration: Duration = { years: 0, months: 0, weeks: 0, days: 0, hours: 1, minutes: 0, seconds: 0, milliseconds: 0, microseconds: 0, nanoseconds: 0 };
    const later: ZonedDateTime = match zonedDateTimeAddDuration(meeting, duration) { Ok(value) => value, Err(error) => { printError(error.code); return; } };
    const same: boolean = zonedDateTimeEquals(meeting, meeting); // true
    const difference: Duration = match zonedDateTimeUntil(meeting, later) { Ok(value) => value, Err(error) => { printError(error.code); return; } };
    const formatted: string = match zonedDateTimeFormat(later, "yyyy-MM-dd HH:mm") { Ok(value) => value, Err(error) => { printError(error.code); return; } }; // "2026-07-09 15:30"
};