Skip to content

PlainDateTime ​

PlainDateTime combina un PlainDate y un PlainTime sin zona horaria. La aritmética atraviesa la medianoche y conserva el calendario civil.

API ​

  • plainDateTimeFrom(value: string): Result<PlainDateTime, TemporalError> analiza texto de fecha y hora ISO.
  • plainDateTimeFromFields(fields: PlainDateTime): Result<PlainDateTime, TemporalError> valida campos compuestos.
  • plainDateTimeToString(value): Result<string, TemporalError> formatea texto ISO con T.
  • plainDateTimeEquals compara valores, mientras que plainDateTimeWith, plainDateTimeAddDuration y plainDateTimeSubtractDuration devuelven Result<PlainDateTime, TemporalError>.
  • plainDateTimeUntil y plainDateTimeSince devuelven duraciones con signo como Result<Duration, TemporalError>.
  • plainDateTimeUntilWithOptions y plainDateTimeSinceWithOptions devuelven Result<Duration, TemporalError> y aceptan largestUnit, smallestUnit, roundingIncrement y roundingMode.
tyrus
import { Duration, PlainDateTime, TemporalError, plainDateTimeAddDuration, plainDateTimeFrom, plainDateTimeToString, plainDateTimeUntil, plainDateTimeUntilWithOptions } from "tyrus:temporal";

export const example = (): void => {
    const value: PlainDateTime = match plainDateTimeFrom("2026-07-09T23:30:00") { Ok(result) => result, Err(error) => { printError(error.code); return; } };
    const text: string = match plainDateTimeToString(value) { Ok(result) => result, Err(error) => { printError(error.code); return; } }; // "2026-07-09T23:30:00"
    const duration: Duration = { years: 0, months: 0, weeks: 0, days: 0, hours: 1, minutes: 0, seconds: 0, milliseconds: 0, microseconds: 0, nanoseconds: 0 };
    const next: PlainDateTime = match plainDateTimeAddDuration(value, duration) { Ok(result) => result, Err(error) => { printError(error.code); return; } }; // 2026-07-10T00:30:00
    const difference: Duration = match plainDateTimeUntil(value, next) { Ok(result) => result, Err(error) => { printError(error.code); return; } };
    const rounded: Duration = match plainDateTimeUntilWithOptions(value, next, "hours", "minutes", 30, "halfExpand") { Ok(result) => result, Err(error) => { printError(error.code); return; } }; // 1h 00m
};