Chinesezjc
c949deb1ca
The package API carried members and result types ahead of any caller. The span now publishes fromMilliseconds and decompose, the two entries dsh-time-context calls; the seconds constructor, the zero identity, the arithmetic and ordering operations, the millisecond getter, and the four fractional conversions land with the caller that needs them, recorded in the Agent Note and the README limitation. The package entry names its exports instead of re-exporting both modules, so the three result types and DurationParts, which no consumer names, are no longer part of the published surface. Every remaining new name has a named consumer: schedule imports the nine parser and bound names plus four rejection types, and canonicalizeTimeZone has seven consumer files.
45 lines
1.9 KiB
TypeScript
45 lines
1.9 KiB
TypeScript
/**
|
|
* Time vocabulary shared by the boundaries that accept a caller's zone or a
|
|
* wall-clock selector, plus one span type for elapsed and interval arithmetic.
|
|
*
|
|
* The library validates, canonicalizes, parses, and renders one canonical instant
|
|
* format; it produces no model-facing text and owns no failure vocabulary. A refusal that carries a
|
|
* reason is a discriminated result, and each caller maps that reason onto its
|
|
* own domain code and diagnostic. `canonicalClientTimeZone` is the wire-boundary
|
|
* form and answers a name or `undefined`; `formatFourDigitYearInstant` and
|
|
* `resolveLocalInstant` take already-validated values and answer a string or
|
|
* epoch milliseconds directly; `Duration` holds a span in milliseconds with no
|
|
* implicit numeric conversion.
|
|
* @module @deepseek-ai/dsh-util-time
|
|
*/
|
|
|
|
import { canonicalizeTimeZone } from './instant.ts'
|
|
|
|
export { Duration } from './duration.ts'
|
|
export {
|
|
MAX_FOUR_DIGIT_YEAR_MS,
|
|
MIN_FOUR_DIGIT_YEAR_MS,
|
|
canonicalizeTimeZone,
|
|
formatFourDigitYearInstant,
|
|
fourDigitYearEpoch,
|
|
isFourDigitYearInstant,
|
|
parseLocalCalendar,
|
|
parseOffsetInstant,
|
|
resolveLocalInstant,
|
|
} from './instant.ts'
|
|
export type { InstantRejection, LocalCalendarRejection, LocalCalendarTime, TimeZoneRejection } from './instant.ts'
|
|
|
|
/**
|
|
* Validate and canonicalize one caller-supplied IANA zone at a wire boundary.
|
|
*
|
|
* The canonical name is what a later reader needs: a zone identity is stored on
|
|
* durable records and resolved again by another process, so an alias accepted
|
|
* here would not compare equal to the zone a reader derives.
|
|
* @param value - the caller's reported zone name.
|
|
* @returns the canonical zone, or `undefined` when the name is unusable.
|
|
*/
|
|
export function canonicalClientTimeZone(value: string): string | undefined {
|
|
const resolved = canonicalizeTimeZone(value)
|
|
return resolved.kind === 'accepted' ? resolved.timeZone : undefined
|
|
}
|