Skip to content

PlainDate ​

PlainDate representa una fecha de calendario sin hora ni zona horaria. Sus operaciones son inmutables.

API ​

  • plainDateFrom(value: string): Result<PlainDate, TemporalError> analiza una fecha ISO.
  • plainDateFromFields(fields: PlainDate): Result<PlainDate, TemporalError> valida los campos de la fecha.
  • plainDateToString(value: PlainDate): Result<string, TemporalError> formatea la fecha como YYYY-MM-DD.
  • plainDateEquals(left, right): boolean compara fechas por valor.
  • plainDateAddDays, plainDateAddMonths y plainDateAddYears devuelven Result<PlainDate, TemporalError> después de sumar unidades de calendario con signo.
  • plainDateAddDuration y plainDateSubtractDuration devuelven Result<PlainDate, TemporalError> después de aplicar una Duration.
  • plainDateWith(value, fields): Result<PlainDate, TemporalError> devuelve una fecha con campos reemplazados.
  • plainDateUntil y plainDateSince devuelven diferencias como Result<Duration, TemporalError>.
  • plainDateUntilWithOptions y plainDateSinceWithOptions aceptan largestUnit, smallestUnit, roundingIncrement y roundingMode.
  • plainDateDayOfWeek y plainDateDayOfYear devuelven consultas del calendario en Result<u32, TemporalError>, y plainDateDaysUntil devuelve Result<i64, TemporalError>.
tyrus
import { Duration, PlainDate, plainDateAddDays, plainDateFrom, plainDateSince, plainDateSubtractDuration, plainDateToString, plainDateUntil, plainDateUntilWithOptions, plainDateWith } from "tyrus:temporal";

const date: PlainDate = match plainDateFrom("2026-07-09") { Ok(value) => value, Err(error) => { printError(error.code); return; } };
const text: string = match plainDateToString(date) { Ok(value) => value, Err(error) => { printError(error.code); return; } }; // "2026-07-09"
const next: PlainDate = match plainDateAddDays(date, 1) { Ok(value) => value, Err(error) => { printError(error.code); return; } };
const holiday: PlainDate = match plainDateWith(date, { year: 2026, month: 12, day: 25 }) { Ok(value) => value, Err(error) => { printError(error.code); return; } };
const duration: Duration = { years: 0, months: 0, weeks: 0, days: 1, hours: 0, minutes: 0, seconds: 0, milliseconds: 0, microseconds: 0, nanoseconds: 0 };
const difference: Duration = match plainDateUntil(date, next) { Ok(value) => value, Err(error) => { printError(error.code); return; } };
const elapsed: Duration = match plainDateSince(next, date) { Ok(value) => value, Err(error) => { printError(error.code); return; } };
const previous: PlainDate = match plainDateSubtractDuration(date, duration) { Ok(value) => value, Err(error) => { printError(error.code); return; } };
const rounded: Duration = plainDateUntilWithOptions(date, next, "days", "days", 1, "trunc"); // 1 day