ts-time-utils 3.0.0 → 4.0.1

package/dist/temporal.d.ts

@@ -0,0 +1,237 @@
+/**
+ * @fileoverview Temporal API compatibility layer
+ * Provides Temporal-like objects that work with native Date
+ * When Temporal ships natively, these become thin wrappers
+ */
+/**
+ * PlainDate - A date without time or timezone
+ * Mirrors Temporal.PlainDate
+ */
+export interface PlainDate {
+    readonly year: number;
+    readonly month: number;
+    readonly day: number;
+    readonly dayOfWeek: number;
+    readonly dayOfYear: number;
+    readonly weekOfYear: number;
+    readonly daysInMonth: number;
+    readonly daysInYear: number;
+    readonly monthsInYear: number;
+    readonly inLeapYear: boolean;
+    toString(): string;
+    toJSON(): string;
+    equals(other: PlainDate): boolean;
+    compare(other: PlainDate): number;
+    add(duration: DurationLike): PlainDate;
+    subtract(duration: DurationLike): PlainDate;
+    until(other: PlainDate): Duration;
+    since(other: PlainDate): Duration;
+    with(fields: Partial<{
+        year: number;
+        month: number;
+        day: number;
+    }>): PlainDate;
+    toDate(): Date;
+}
+/**
+ * PlainTime - A time without date or timezone
+ * Mirrors Temporal.PlainTime
+ */
+export interface PlainTime {
+    readonly hour: number;
+    readonly minute: number;
+    readonly second: number;
+    readonly millisecond: number;
+    toString(): string;
+    toJSON(): string;
+    equals(other: PlainTime): boolean;
+    compare(other: PlainTime): number;
+    add(duration: DurationLike): PlainTime;
+    subtract(duration: DurationLike): PlainTime;
+    with(fields: Partial<{
+        hour: number;
+        minute: number;
+        second: number;
+        millisecond: number;
+    }>): PlainTime;
+}
+/**
+ * PlainDateTime - A date and time without timezone
+ * Mirrors Temporal.PlainDateTime
+ */
+export interface PlainDateTime {
+    readonly year: number;
+    readonly month: number;
+    readonly day: number;
+    readonly hour: number;
+    readonly minute: number;
+    readonly second: number;
+    readonly millisecond: number;
+    readonly dayOfWeek: number;
+    readonly dayOfYear: number;
+    readonly weekOfYear: number;
+    toString(): string;
+    toJSON(): string;
+    equals(other: PlainDateTime): boolean;
+    compare(other: PlainDateTime): number;
+    add(duration: DurationLike): PlainDateTime;
+    subtract(duration: DurationLike): PlainDateTime;
+    until(other: PlainDateTime): Duration;
+    since(other: PlainDateTime): Duration;
+    with(fields: Partial<{
+        year: number;
+        month: number;
+        day: number;
+        hour: number;
+        minute: number;
+        second: number;
+        millisecond: number;
+    }>): PlainDateTime;
+    toPlainDate(): PlainDate;
+    toPlainTime(): PlainTime;
+    toDate(): Date;
+}
+/**
+ * ZonedDateTime - A date and time with timezone
+ * Mirrors Temporal.ZonedDateTime
+ */
+export interface ZonedDateTime {
+    readonly year: number;
+    readonly month: number;
+    readonly day: number;
+    readonly hour: number;
+    readonly minute: number;
+    readonly second: number;
+    readonly millisecond: number;
+    readonly timeZone: string;
+    readonly offset: string;
+    readonly epochMilliseconds: number;
+    toString(): string;
+    toJSON(): string;
+    equals(other: ZonedDateTime): boolean;
+    add(duration: DurationLike): ZonedDateTime;
+    subtract(duration: DurationLike): ZonedDateTime;
+    with(fields: Partial<{
+        year: number;
+        month: number;
+        day: number;
+        hour: number;
+        minute: number;
+        second: number;
+        millisecond: number;
+    }>): ZonedDateTime;
+    toPlainDate(): PlainDate;
+    toPlainTime(): PlainTime;
+    toPlainDateTime(): PlainDateTime;
+    toInstant(): Instant;
+    toDate(): Date;
+}
+/**
+ * Instant - A point in time (like Unix timestamp)
+ * Mirrors Temporal.Instant
+ */
+export interface Instant {
+    readonly epochMilliseconds: number;
+    readonly epochSeconds: number;
+    toString(): string;
+    toJSON(): string;
+    equals(other: Instant): boolean;
+    compare(other: Instant): number;
+    add(duration: DurationLike): Instant;
+    subtract(duration: DurationLike): Instant;
+    until(other: Instant): Duration;
+    since(other: Instant): Duration;
+    toZonedDateTime(timeZone: string): ZonedDateTime;
+    toDate(): Date;
+}
+/**
+ * Duration - A length of time
+ * Mirrors Temporal.Duration
+ */
+export interface Duration {
+    readonly years: number;
+    readonly months: number;
+    readonly weeks: number;
+    readonly days: number;
+    readonly hours: number;
+    readonly minutes: number;
+    readonly seconds: number;
+    readonly milliseconds: number;
+    readonly sign: -1 | 0 | 1;
+    readonly blank: boolean;
+    toString(): string;
+    toJSON(): string;
+    negated(): Duration;
+    abs(): Duration;
+    add(other: DurationLike): Duration;
+    subtract(other: DurationLike): Duration;
+    total(unit: DurationUnit): number;
+}
+export type DurationUnit = 'years' | 'months' | 'weeks' | 'days' | 'hours' | 'minutes' | 'seconds' | 'milliseconds';
+export interface DurationLike {
+    years?: number;
+    months?: number;
+    weeks?: number;
+    days?: number;
+    hours?: number;
+    minutes?: number;
+    seconds?: number;
+    milliseconds?: number;
+}
+/**
+ * Create a PlainDate from a Date object or components
+ */
+export declare function toPlainDate(date: Date): PlainDate;
+export declare function toPlainDate(year: number, month: number, day: number): PlainDate;
+/**
+ * Create a PlainTime from a Date object or components
+ */
+export declare function toPlainTime(date: Date): PlainTime;
+export declare function toPlainTime(hour: number, minute?: number, second?: number, millisecond?: number): PlainTime;
+/**
+ * Create a PlainDateTime from a Date object or components
+ */
+export declare function toPlainDateTime(date: Date): PlainDateTime;
+export declare function toPlainDateTime(year: number, month: number, day: number, hour?: number, minute?: number, second?: number, millisecond?: number): PlainDateTime;
+/**
+ * Create a ZonedDateTime from a Date object and timezone
+ */
+export declare function toZonedDateTime(date: Date, timeZone: string): ZonedDateTime;
+/**
+ * Create an Instant from a Date object or epoch milliseconds
+ */
+export declare function toInstant(date: Date): Instant;
+export declare function toInstant(epochMs: number): Instant;
+/**
+ * Create a Duration from components
+ */
+export declare function createDuration(fields?: DurationLike): Duration;
+/**
+ * Parse an ISO 8601 duration string
+ */
+export declare function parseDuration(str: string): Duration;
+/**
+ * Get current instant
+ */
+export declare function nowInstant(): Instant;
+/**
+ * Get current PlainDateTime in local timezone
+ */
+export declare function nowPlainDateTime(): PlainDateTime;
+/**
+ * Get current PlainDate in local timezone
+ */
+export declare function nowPlainDate(): PlainDate;
+/**
+ * Get current PlainTime in local timezone
+ */
+export declare function nowPlainTime(): PlainTime;
+/**
+ * Get current ZonedDateTime in specified timezone
+ */
+export declare function nowZonedDateTime(timeZone: string): ZonedDateTime;
+/**
+ * Convert Temporal-like object back to Date
+ */
+export declare function fromTemporal(temporal: PlainDate | PlainDateTime | ZonedDateTime | Instant): Date;
+//# sourceMappingURL=temporal.d.ts.map

package/dist/temporal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal.d.ts","sourceRoot":"","sources":["../src/temporal.ts"],"names":[],"mappings":"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"}