Skip to content

PlainTime ​

PlainTime representa um horário sem data ou fuso horário. A adição atravessa a meia-noite e preserva a precisão de nanossegundos.

API ​

  • plainTimeFrom(value: string): Result<PlainTime, TemporalError> analisa um texto de relógio ISO.
  • plainTimeFromFields(fields: PlainTime): Result<PlainTime, TemporalError> valida os campos do horário.
  • plainTimeToString(value: PlainTime): Result<string, TemporalError> formata o horário.
  • plainTimeEquals(left, right): boolean compara horários por valor.
  • plainTimeAddSeconds e plainTimeAddNanoseconds retornam Result<PlainTime, TemporalError> após adicionar unidades com sinal e fazer o horário circular.
  • plainTimeAddDuration e plainTimeSubtractDuration retornam Result<PlainTime, TemporalError> após aplicar uma Duration de relógio.
  • plainTimeUntil e plainTimeSince retornam diferenças em Result<Duration, TemporalError>.
  • plainTimeUntilWithOptions e plainTimeSinceWithOptions retornam Result<Duration, TemporalError> e aceitam largestUnit, smallestUnit, roundingIncrement e roundingMode.
  • plainTimeSecondsUntil e plainTimeNanosecondsUntil retornam diferenças escalares em 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