Skip to content

ZonedDateTime ​

ZonedDateTime combina un instante absoluto con una zona horaria IANA versionada en el repositorio. El parsing exige el identificador IANA entre corchetes y lo conserva al formatear.

API ​

  • zonedDateTimeFrom(value: string): Result<ZonedDateTime, TemporalError> analiza una fecha y hora ISO con zona.
  • zonedDateTimeToInstant(value): Result<Instant, TemporalError> elimina la proyección de calendario.
  • zonedDateTimeToString(value): Result<string, TemporalError> formatea el valor con su zona.
  • zonedDateTimeEquals(left, right): boolean compara los valores zonificados completos.
  • zonedDateTimeAddDuration(value, duration): Result<ZonedDateTime, TemporalError> aplica una duración.
  • zonedDateTimeUntil(start, end): Result<Duration, TemporalError> devuelve una diferencia con signo.
  • zonedDateTimeFormat(value, pattern): Result<string, TemporalError> acepta yyyy, MM, dd, HH, mm y 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"
};