fix: DateTime -> XDate

packages/date/src/Locale.ts

@@ -1,4 +1,4 @@
-import {DateConfig} from "./interface.js";
+import {XDateConfig} from "./interface.js";
 
 function normalizeLocale(locale: string): string {
     if (/^[a-z]{2}_.+$/.test(locale)) {
@@ -8,7 +8,7 @@ function normalizeLocale(locale: string): string {
     return locale;
 }
 
-export function getDefaultConfig(): DateConfig {
+export function getDefaultConfig(): XDateConfig {
     const system = Intl.DateTimeFormat().resolvedOptions();
     const timeZone = process.env.TZ ?? process.env.TIMEZONE ?? system.timeZone;
     const locale = normalizeLocale(process.env.LANG ?? process.env.LANGUAGE ?? system.locale);
@@ -21,7 +21,7 @@ export function getDefaultConfig(): DateConfig {
     return {locale, timeZone, weekBegins};
 }
 
-const config: DateConfig = getDefaultConfig();
+const config: XDateConfig = getDefaultConfig();
 
 export function setLocale(locale: string | string[]): void {
     const [supported] = Intl.DateTimeFormat.supportedLocalesOf(locale);

packages/date/src/XDate.ts

@@ -0,0 +1,53 @@
+import {assert} from "@bunt/assert";
+import {XDateMutation} from "./XDateMutation.js";
+import {XDateIntervalKind} from "./interface.js";
+
+export class XDate {
+    readonly #date: Date;
+
+    constructor(date: string | number | Date = new Date()) {
+        this.#date = new Date(date);
+        assert(this.#date.getTime() > 0);
+    }
+
+    public get date(): Date {
+        return new Date(this.#date);
+    }
+
+    public static from(date: string | number | Date = new Date()): XDate {
+        return new this(date);
+    }
+
+    public getTime(): number {
+        return this.#date.getTime();
+    }
+
+    public getDate(): Date {
+        return this.date;
+    }
+
+    public toString(): string {
+        return this.date.toString();
+    }
+
+    public begins(kind: Exclude<XDateIntervalKind, "ms">): XDate {
+        return new XDate(XDateMutation.begins(kind, this.getTime()));
+    }
+
+    public ends(kind: Exclude<XDateIntervalKind, "ms">): XDate {
+        return new XDate(XDateMutation.ends(kind, this.getTime()));
+    }
+
+    public mutate(...mutations: [XDateIntervalKind, number][]): XDate {
+        return new XDate(XDateMutation.mutate(this.getTime(), ...mutations));
+    }
+
+    public set(...intervals: [XDateIntervalKind, number][]): XDate {
+        return new XDate(XDateMutation.set(this.getTime(), ...intervals));
+    }
+}
+
+/**
+ * @deprecated
+ */
+export const DateTime = XDate;

packages/date/src/DateTimeMutation.ts → packages/date/src/XDateMutation.ts

@@ -1,35 +1,35 @@
 import {isFunction} from "@bunt/is";
 import {assert} from "@bunt/assert";
-import {DateTimeKind, TimeMutateFn} from "./interface.js";
+import {XDateIntervalKind, XTimeMutateFn} from "./interface.js";
 import begins from "./mutators/begins.js";
 import ends from "./mutators/ends.js";
 import mutators from "./mutators/mutators.js";
 import setters from "./mutators/setters.js";
 
-export class DateTimeMutation {
-    public static begins(kind: Exclude<DateTimeKind, "ms">, time: number): number {
+export class XDateMutation {
+    public static begins(kind: Exclude<XDateIntervalKind, "ms">, time: number): number {
         assert(kind in begins);
 
         return begins[kind](time);
     }
 
-    public static ends(kind: Exclude<DateTimeKind, "ms">, time: number): number {
+    public static ends(kind: Exclude<XDateIntervalKind, "ms">, time: number): number {
         assert(kind in begins);
 
         return ends[kind](time);
     }
 
-    public static set(time: number, ...intervals: [DateTimeKind, number][]): number {
+    public static set(time: number, ...intervals: [XDateIntervalKind, number][]): number {
         return this.apply(setters, time, intervals);
     }
 
-    public static mutate(time: number, ...mutations: [DateTimeKind, number][]): number {
+    public static mutate(time: number, ...mutations: [XDateIntervalKind, number][]): number {
         return this.apply(mutators, time, mutations);
     }
 
-    protected static apply(map: Map<DateTimeKind, TimeMutateFn>,
+    protected static apply(map: Map<XDateIntervalKind, XTimeMutateFn>,
         time: number,
-        values: [DateTimeKind, number][]): number {
+        values: [XDateIntervalKind, number][]): number {
         for (const [interval, value] of values) {
             const fn = map.get(interval);
             assert(isFunction(fn));
@@ -39,3 +39,8 @@ export class DateTimeMutation {
         return time;
     }
 }
+
+/**
+ * @deprecated
+ */
+export const DateTimeMutation = XDateMutation;

packages/date/src/index.ts

@@ -1,4 +1,4 @@
-export * from "./DateTime.js";
-export * from "./DateTimeMutation.js";
+export * from "./XDate.js";
+export * from "./XDateMutation.js";
 export * from "./Locale.js";
 export * from "./interface.js";

packages/date/src/interface.ts

@@ -1,4 +1,4 @@
-export type DateTimeKind =
+export type XDateIntervalKind =
     "ms"
     | "sec"
     | "min"
@@ -8,16 +8,16 @@ export type DateTimeKind =
     | "week"
     | "year";
 
-export type TimeMutateFn = (date: number, value: number) => number;
+export type XTimeMutateFn = (date: number, value: number) => number;
 
-export enum TimeMultiply {
+export enum XTimeMultiply {
     SEC = 1000,
     MIN = SEC * 60,
     HOUR = MIN * 60,
     DAY = HOUR * 24,
 }
 
-export type DateConfig = {
+export type XDateConfig = {
     locale: string;
     timeZone: string;
     weekBegins: number;

packages/date/src/mutators/mutators.ts

@@ -1,30 +1,30 @@
-import {DateTimeKind, TimeMultiply, TimeMutateFn} from "../interface.js";
+import {XDateIntervalKind, XTimeMultiply, XTimeMutateFn} from "../interface.js";
 
-const hour: TimeMutateFn = (time, value) => time + (value * TimeMultiply.HOUR);
-const day: TimeMutateFn = (time, value) => time + (value * TimeMultiply.DAY);
+const hour: XTimeMutateFn = (time, value) => time + (value * XTimeMultiply.HOUR);
+const day: XTimeMutateFn = (time, value) => time + (value * XTimeMultiply.DAY);
 
-const week: TimeMutateFn = (time, value) => {
+const week: XTimeMutateFn = (time, value) => {
     const date = new Date(time);
 
     return date.setDate(date.getDate() + (value * 7));
 };
 
-const month: TimeMutateFn = (time, value) => {
+const month: XTimeMutateFn = (time, value) => {
     const date = new Date(time);
 
     return date.setMonth(date.getMonth() + value);
 };
 
-const year: TimeMutateFn = (time, value) => {
+const year: XTimeMutateFn = (time, value) => {
     const date = new Date(time);
 
     return date.setFullYear(date.getFullYear() + value);
 };
 
-export default new Map<DateTimeKind, TimeMutateFn>([
+export default new Map<XDateIntervalKind, XTimeMutateFn>([
     ["ms", (time: number, value: number): number => time + value],
-    ["sec", (time: number, value: number): number => time + (value * TimeMultiply.SEC)],
-    ["min", (time: number, value: number): number => time + (value * TimeMultiply.MIN)],
+    ["sec", (time: number, value: number): number => time + (value * XTimeMultiply.SEC)],
+    ["min", (time: number, value: number): number => time + (value * XTimeMultiply.MIN)],
     ["hour", hour],
     ["day", day],
     ["week", week],

packages/date/src/mutators/setters.ts

@@ -1,12 +1,12 @@
-import {DateTimeKind, TimeMutateFn} from "../interface.js";
+import {XDateIntervalKind, XTimeMutateFn} from "../interface.js";
 
-const hour: TimeMutateFn = (time, value) => new Date(time).setHours(value);
-const day: TimeMutateFn = (time, value) => new Date(time).setDate(value);
-const week: TimeMutateFn = (time, value) => new Date(time).setDate(value);
-const month: TimeMutateFn = (time, value) => new Date(time).setDate(value);
-const year: TimeMutateFn = (time, value) => new Date(time).setFullYear(value);
+const hour: XTimeMutateFn = (time, value) => new Date(time).setHours(value);
+const day: XTimeMutateFn = (time, value) => new Date(time).setDate(value);
+const week: XTimeMutateFn = (time, value) => new Date(time).setDate(value);
+const month: XTimeMutateFn = (time, value) => new Date(time).setDate(value);
+const year: XTimeMutateFn = (time, value) => new Date(time).setFullYear(value);
 
-export default new Map<DateTimeKind, TimeMutateFn>([
+export default new Map<XDateIntervalKind, XTimeMutateFn>([
     ["ms", (time: number, value: number): number => new Date(time).setMilliseconds(value)],
     ["sec", (time: number, value: number): number => new Date(time).setSeconds(value)],
     ["min", (time: number, value: number): number => new Date(time).setMinutes(value)],