Skip to content

PlainDate ​

PlainDate representa uma data de calendário sem hora ou fuso horário. Suas operações são imutáveis.

API ​

  • plainDateFrom(value: string): Result<PlainDate, TemporalError> analisa uma data ISO.
  • plainDateFromFields(fields: PlainDate): Result<PlainDate, TemporalError> valida os campos da data.
  • plainDateToString(value: PlainDate): Result<string, TemporalError> formata a data como YYYY-MM-DD.
  • plainDateEquals(left, right): boolean compara datas por valor.
  • plainDateAddDays, plainDateAddMonths e plainDateAddYears retornam Result<PlainDate, TemporalError> após adicionar unidades de calendário com sinal.
  • plainDateAddDuration e plainDateSubtractDuration retornam Result<PlainDate, TemporalError> após aplicar uma Duration.
  • plainDateWith(value, fields): Result<PlainDate, TemporalError> retorna uma data com campos substituídos.
  • plainDateUntil e plainDateSince retornam diferenças em Result<Duration, TemporalError>.
  • plainDateUntilWithOptions e plainDateSinceWithOptions aceitam largestUnit, smallestUnit, roundingIncrement e roundingMode.
  • plainDateDayOfWeek e plainDateDayOfYear retornam consultas do calendário em Result<u32, TemporalError>, e plainDateDaysUntil retorna 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