Skip to content

PlainTime ​

PlainTime representa una hora sin fecha ni zona horaria. La suma atraviesa la medianoche y conserva la precisión de nanosegundos.

API ​

  • plainTimeFrom(value: string): Result<PlainTime, TemporalError> analiza un texto de reloj ISO.
  • plainTimeFromFields(fields: PlainTime): Result<PlainTime, TemporalError> valida los campos de la hora.
  • plainTimeToString(value: PlainTime): Result<string, TemporalError> formatea la hora.
  • plainTimeEquals(left, right): boolean compara horas por valor.
  • plainTimeAddSeconds y plainTimeAddNanoseconds devuelven Result<PlainTime, TemporalError> después de sumar unidades con signo y envolver el reloj.
  • plainTimeAddDuration y plainTimeSubtractDuration devuelven Result<PlainTime, TemporalError> después de aplicar una Duration de reloj.
  • plainTimeUntil y plainTimeSince devuelven diferencias como Result<Duration, TemporalError>.
  • plainTimeUntilWithOptions y plainTimeSinceWithOptions devuelven Result<Duration, TemporalError> y aceptan largestUnit, smallestUnit, roundingIncrement y roundingMode.
  • plainTimeSecondsUntil y plainTimeNanosecondsUntil devuelven diferencias escalares como Result<i64, TemporalError>.
tyrus
import { Duration, PlainTime, plainTimeAddNanoseconds, plainTimeFrom, plainTimeNanosecondsUntil, plainTimeSince, plainTimeSubtractDuration, plainTimeToString, plainTimeUntil, plainTimeUntilWithOptions } from "tyrus:temporal";

const time: PlainTime = match plainTimeFrom("14:30:15.500") { Ok(value) => value, Err(error) => { printError(error.code); return; } };
const text: string = match plainTimeToString(time) { Ok(value) => value, Err(error) => { printError(error.code); return; } }; // "14:30:15.5"
const shiftedTime: PlainTime = match plainTimeAddNanoseconds(time, 750_000_000) { Ok(value) => value, Err(error) => { printError(error.code); return; } };
const nanoseconds: i64 = match plainTimeNanosecondsUntil(time, shiftedTime) { Ok(value) => value, Err(error) => { printError(error.code); return; } }; // 750000000
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: PlainTime = match plainTimeSubtractDuration(shiftedTime, duration) { Ok(value) => value, Err(error) => { printError(error.code); return; } };
const difference: Duration = match plainTimeUntil(time, shiftedTime) { Ok(value) => value, Err(error) => { printError(error.code); return; } };
const elapsed: Duration = match plainTimeSince(shiftedTime, time) { Ok(value) => value, Err(error) => { printError(error.code); return; } };
const rounded: Duration = match plainTimeUntilWithOptions(time, shiftedTime, "hours", "minutes", 15, "halfExpand") { Ok(value) => value, Err(error) => { printError(error.code); return; } }; // 0h 45m