@digitalwalletcorp/utils 0.11.0 → 0.13.0

package/lib/{date-time.d.cts → zoned-date-time.d.cts}

@@ -1,6 +1,6 @@
 import { DateInput, DateUnit, Duration, ParseDateOptions, TimeUnit } from './date-util.cjs';
 /** set で変更する日時の要素。month は1〜12 */
-export interface DateTimeFields {
+export interface ZonedDateTimeFields {
     year?: number;
     month?: number;
     day?: number;
@@ -12,7 +12,7 @@ export interface DateTimeFields {
 /**
  * 日時を文字列にするときのオプション
  */
-export interface DateTimeFormatOptions {
+export interface ZonedDateTimeFormatOptions {
     /** 月名・曜日名に使うロケール。既定は 'en-US' */
     locale?: string;
 }
@@ -21,7 +21,7 @@ export interface DateTimeFormatOptions {
  * 演算メソッドは自身を変更せず、結果を新しいインスタンスで返す
  * インスタンスごとにタイムゾーンを持ち、startOf / endOf / set や各要素の参照はそのタイムゾーンで計算する
  */
-export declare class DateTime {
+export declare class ZonedDateTime {
     /**
      * 日時演算インスタンス
      */
@@ -32,21 +32,21 @@ export declare class DateTime {
      * タイムゾーンの指定が不正な場合は RangeError をスローする
      *
      * @param {string} [timezone] IANA名。既定は 'UTC'
-     * @returns {DateTime}
+     * @returns {ZonedDateTime}
      */
-    static now(timezone?: string): DateTime;
+    static now(timezone?: string): ZonedDateTime;
     /**
      * 値を日時として解釈する
      * 生成したインスタンスは inputTimezone のタイムゾーンを持つ
-     * DateTime を渡した場合、inputTimezone を省略すると渡した DateTime のタイムゾーンを引き継ぐ
+     * ZonedDateTime を渡した場合、inputTimezone を省略すると渡した ZonedDateTime のタイムゾーンを引き継ぐ
      * duration / startOf / endOf はそのタイムゾーンで計算する
      * 解釈できない値、null / undefined / 空文字は null を返す。タイムゾーンの指定が不正な場合は RangeError をスローする
      *
      * @param {DateInput} value
      * @param {ParseDateOptions} [options]
-     * @returns {DateTime | null}
+     * @returns {ZonedDateTime | null}
      */
-    static parse(value: DateInput, options?: ParseDateOptions): DateTime | null;
+    static parse(value: DateInput, options?: ParseDateOptions): ZonedDateTime | null;
     /** 年 */
     get year(): number;
     /** 月(1〜12) */
@@ -74,108 +74,108 @@ export declare class DateTime {
      * 負の値を指定すると減算になる
      *
      * @param {Duration} duration
-     * @returns {DateTime}
+     * @returns {ZonedDateTime}
      */
-    plus(duration: Duration): DateTime;
+    plus(duration: Duration): ZonedDateTime;
     /**
      * 期間を減算した結果を返す
      *
      * @param {Duration} duration
-     * @returns {DateTime}
+     * @returns {ZonedDateTime}
      */
-    minus(duration: Duration): DateTime;
+    minus(duration: Duration): ZonedDateTime;
     /**
      * 指定した単位の最初の時点に切り捨てた結果を返す(month なら月初の00:00:00.000)
      * week は月曜始まりで切り捨てる
      *
      * @param {DateUnit} unit
-     * @returns {DateTime}
+     * @returns {ZonedDateTime}
      */
-    startOf(unit: DateUnit): DateTime;
+    startOf(unit: DateUnit): ZonedDateTime;
     /**
      * 指定した単位の最後の時点に切り上げた結果を返す(month なら月末の23:59:59.999)
      * week は日曜終わりで切り上げる
      *
      * @param {DateUnit} unit
-     * @returns {DateTime}
+     * @returns {ZonedDateTime}
      */
-    endOf(unit: DateUnit): DateTime;
+    endOf(unit: DateUnit): ZonedDateTime;
     /**
      * 指定した要素を変更した結果を返す
      * 範囲外の値や整数でない値を指定した場合は RangeError をスローする
      * day を指定せずに year / month を変更し、日がその月に無い場合は月末日にする(1月31日に { month: 2 } なら2月末日)
      *
-     * @param {DateTimeFields} fields
-     * @returns {DateTime}
+     * @param {ZonedDateTimeFields} fields
+     * @returns {ZonedDateTime}
      */
-    set(fields: DateTimeFields): DateTime;
+    set(fields: ZonedDateTimeFields): ZonedDateTime;
     /**
      * 同じ時刻を別のタイムゾーンで表した結果を返す
      * タイムゾーンの指定が不正な場合は RangeError をスローする
      *
      * @param {string} timezone IANA名
-     * @returns {DateTime}
+     * @returns {ZonedDateTime}
      */
-    setZone(timezone: string): DateTime;
+    setZone(timezone: string): ZonedDateTime;
     /**
      * 自身 − other を unit の単位で返す
      * 両方を自身のタイムゾーンで unit の始まりに切り捨ててから差を取るため、暦の上での差になる(23:00 と翌 01:00 の days は 1)
      *
-     * @param {DateTime} other
+     * @param {ZonedDateTime} other
      * @param {TimeUnit} unit
      * @returns {number}
      */
-    diff(other: DateTime, unit: TimeUnit): number;
+    diff(other: ZonedDateTime, unit: TimeUnit): number;
     /**
      * 時刻を比較する。タイムゾーンが異なっていても同じ時刻なら等しい
      *
-     * @param {DateTime} other
+     * @param {ZonedDateTime} other
      * @returns {-1 | 0 | 1} 自身が前なら-1、等しければ0、後なら1
      */
-    compareTo(other: DateTime): -1 | 0 | 1;
+    compareTo(other: ZonedDateTime): -1 | 0 | 1;
     /**
      * 同じ時刻か判定する
      *
-     * @param {DateTime} other
+     * @param {ZonedDateTime} other
      * @returns {boolean}
      */
-    eq(other: DateTime): boolean;
+    eq(other: ZonedDateTime): boolean;
     /**
      * 自身が前の時刻か判定する
      *
-     * @param {DateTime} other
+     * @param {ZonedDateTime} other
      * @returns {boolean}
      */
-    lt(other: DateTime): boolean;
+    lt(other: ZonedDateTime): boolean;
     /**
      * 自身が前か同じ時刻か判定する
      *
-     * @param {DateTime} other
+     * @param {ZonedDateTime} other
      * @returns {boolean}
      */
-    lte(other: DateTime): boolean;
+    lte(other: ZonedDateTime): boolean;
     /**
      * 自身が後の時刻か判定する
      *
-     * @param {DateTime} other
+     * @param {ZonedDateTime} other
      * @returns {boolean}
      */
-    gt(other: DateTime): boolean;
+    gt(other: ZonedDateTime): boolean;
     /**
      * 自身が後か同じ時刻か判定する
      *
-     * @param {DateTime} other
+     * @param {ZonedDateTime} other
      * @returns {boolean}
      */
-    gte(other: DateTime): boolean;
+    gte(other: ZonedDateTime): boolean;
     /**
      * 自身のタイムゾーンで、指定した書式の文字列にする
      *
      * @param {string} outputFormat
-     * @param {DateTimeFormatOptions} [options]
+     * @param {ZonedDateTimeFormatOptions} [options]
      * @returns {string}
      */
-    format(outputFormat: string, options?: DateTimeFormatOptions): string;
+    format(outputFormat: string, options?: ZonedDateTimeFormatOptions): string;
     /**
      * 自身のタイムゾーンで、ISO形式の文字列にする
      *

package/lib/{date-time.d.ts → zoned-date-time.d.ts}

@@ -1,6 +1,6 @@
 import { DateInput, DateUnit, Duration, ParseDateOptions, TimeUnit } from './date-util';
 /** set で変更する日時の要素。month は1〜12 */
-export interface DateTimeFields {
+export interface ZonedDateTimeFields {
     year?: number;
     month?: number;
     day?: number;
@@ -12,7 +12,7 @@ export interface DateTimeFields {
 /**
  * 日時を文字列にするときのオプション
  */
-export interface DateTimeFormatOptions {
+export interface ZonedDateTimeFormatOptions {
     /** 月名・曜日名に使うロケール。既定は 'en-US' */
     locale?: string;
 }
@@ -21,7 +21,7 @@ export interface DateTimeFormatOptions {
  * 演算メソッドは自身を変更せず、結果を新しいインスタンスで返す
  * インスタンスごとにタイムゾーンを持ち、startOf / endOf / set や各要素の参照はそのタイムゾーンで計算する
  */
-export declare class DateTime {
+export declare class ZonedDateTime {
     /**
      * 日時演算インスタンス
      */
@@ -32,21 +32,21 @@ export declare class DateTime {
      * タイムゾーンの指定が不正な場合は RangeError をスローする
      *
      * @param {string} [timezone] IANA名。既定は 'UTC'
-     * @returns {DateTime}
+     * @returns {ZonedDateTime}
      */
-    static now(timezone?: string): DateTime;
+    static now(timezone?: string): ZonedDateTime;
     /**
      * 値を日時として解釈する
      * 生成したインスタンスは inputTimezone のタイムゾーンを持つ
-     * DateTime を渡した場合、inputTimezone を省略すると渡した DateTime のタイムゾーンを引き継ぐ
+     * ZonedDateTime を渡した場合、inputTimezone を省略すると渡した ZonedDateTime のタイムゾーンを引き継ぐ
      * duration / startOf / endOf はそのタイムゾーンで計算する
      * 解釈できない値、null / undefined / 空文字は null を返す。タイムゾーンの指定が不正な場合は RangeError をスローする
      *
      * @param {DateInput} value
      * @param {ParseDateOptions} [options]
-     * @returns {DateTime | null}
+     * @returns {ZonedDateTime | null}
      */
-    static parse(value: DateInput, options?: ParseDateOptions): DateTime | null;
+    static parse(value: DateInput, options?: ParseDateOptions): ZonedDateTime | null;
     /** 年 */
     get year(): number;
     /** 月(1〜12) */
@@ -74,108 +74,108 @@ export declare class DateTime {
      * 負の値を指定すると減算になる
      *
      * @param {Duration} duration
-     * @returns {DateTime}
+     * @returns {ZonedDateTime}
      */
-    plus(duration: Duration): DateTime;
+    plus(duration: Duration): ZonedDateTime;
     /**
      * 期間を減算した結果を返す
      *
      * @param {Duration} duration
-     * @returns {DateTime}
+     * @returns {ZonedDateTime}
      */
-    minus(duration: Duration): DateTime;
+    minus(duration: Duration): ZonedDateTime;
     /**
      * 指定した単位の最初の時点に切り捨てた結果を返す(month なら月初の00:00:00.000)
      * week は月曜始まりで切り捨てる
      *
      * @param {DateUnit} unit
-     * @returns {DateTime}
+     * @returns {ZonedDateTime}
      */
-    startOf(unit: DateUnit): DateTime;
+    startOf(unit: DateUnit): ZonedDateTime;
     /**
      * 指定した単位の最後の時点に切り上げた結果を返す(month なら月末の23:59:59.999)
      * week は日曜終わりで切り上げる
      *
      * @param {DateUnit} unit
-     * @returns {DateTime}
+     * @returns {ZonedDateTime}
      */
-    endOf(unit: DateUnit): DateTime;
+    endOf(unit: DateUnit): ZonedDateTime;
     /**
      * 指定した要素を変更した結果を返す
      * 範囲外の値や整数でない値を指定した場合は RangeError をスローする
      * day を指定せずに year / month を変更し、日がその月に無い場合は月末日にする(1月31日に { month: 2 } なら2月末日)
      *
-     * @param {DateTimeFields} fields
-     * @returns {DateTime}
+     * @param {ZonedDateTimeFields} fields
+     * @returns {ZonedDateTime}
      */
-    set(fields: DateTimeFields): DateTime;
+    set(fields: ZonedDateTimeFields): ZonedDateTime;
     /**
      * 同じ時刻を別のタイムゾーンで表した結果を返す
      * タイムゾーンの指定が不正な場合は RangeError をスローする
      *
      * @param {string} timezone IANA名
-     * @returns {DateTime}
+     * @returns {ZonedDateTime}
      */
-    setZone(timezone: string): DateTime;
+    setZone(timezone: string): ZonedDateTime;
     /**
      * 自身 − other を unit の単位で返す
      * 両方を自身のタイムゾーンで unit の始まりに切り捨ててから差を取るため、暦の上での差になる(23:00 と翌 01:00 の days は 1)
      *
-     * @param {DateTime} other
+     * @param {ZonedDateTime} other
      * @param {TimeUnit} unit
      * @returns {number}
      */
-    diff(other: DateTime, unit: TimeUnit): number;
+    diff(other: ZonedDateTime, unit: TimeUnit): number;
     /**
      * 時刻を比較する。タイムゾーンが異なっていても同じ時刻なら等しい
      *
-     * @param {DateTime} other
+     * @param {ZonedDateTime} other
      * @returns {-1 | 0 | 1} 自身が前なら-1、等しければ0、後なら1
      */
-    compareTo(other: DateTime): -1 | 0 | 1;
+    compareTo(other: ZonedDateTime): -1 | 0 | 1;
     /**
      * 同じ時刻か判定する
      *
-     * @param {DateTime} other
+     * @param {ZonedDateTime} other
      * @returns {boolean}
      */
-    eq(other: DateTime): boolean;
+    eq(other: ZonedDateTime): boolean;
     /**
      * 自身が前の時刻か判定する
      *
-     * @param {DateTime} other
+     * @param {ZonedDateTime} other
      * @returns {boolean}
      */
-    lt(other: DateTime): boolean;
+    lt(other: ZonedDateTime): boolean;
     /**
      * 自身が前か同じ時刻か判定する
      *
-     * @param {DateTime} other
+     * @param {ZonedDateTime} other
      * @returns {boolean}
      */
-    lte(other: DateTime): boolean;
+    lte(other: ZonedDateTime): boolean;
     /**
      * 自身が後の時刻か判定する
      *
-     * @param {DateTime} other
+     * @param {ZonedDateTime} other
      * @returns {boolean}
      */
-    gt(other: DateTime): boolean;
+    gt(other: ZonedDateTime): boolean;
     /**
      * 自身が後か同じ時刻か判定する
      *
-     * @param {DateTime} other
+     * @param {ZonedDateTime} other
      * @returns {boolean}
      */
-    gte(other: DateTime): boolean;
+    gte(other: ZonedDateTime): boolean;
     /**
      * 自身のタイムゾーンで、指定した書式の文字列にする
      *
      * @param {string} outputFormat
-     * @param {DateTimeFormatOptions} [options]
+     * @param {ZonedDateTimeFormatOptions} [options]
      * @returns {string}
      */
-    format(outputFormat: string, options?: DateTimeFormatOptions): string;
+    format(outputFormat: string, options?: ZonedDateTimeFormatOptions): string;
     /**
      * 自身のタイムゾーンで、ISO形式の文字列にする
      *

package/lib/{date-time.js → zoned-date-time.js}

@@ -1,10 +1,10 @@
 import { DateTime as a } from "luxon";
-const u = "UTC", h = "en-US", m = (s) => {
+const d = "UTC", h = "en-US", m = (s) => {
   if (!s.isValid && s.invalidReason === "unsupported zone")
     throw new RangeError(s.invalidExplanation ?? s.invalidReason);
-}, o = (s, t, e, r) => {
-  if (t !== void 0 && (!Number.isInteger(t) || t < e || r < t))
-    throw new RangeError(`${s} must be an integer from ${e} to ${r}: ${t}`);
+}, o = (s, t, e, n) => {
+  if (t !== void 0 && (!Number.isInteger(t) || t < e || n < t))
+    throw new RangeError(`${s} must be an integer from ${e} to ${n}: ${t}`);
 };
 class i {
   /**
@@ -19,49 +19,49 @@ class i {
    * タイムゾーンの指定が不正な場合は RangeError をスローする
    *
    * @param {string} [timezone] IANA名。既定は 'UTC'
-   * @returns {DateTime}
+   * @returns {ZonedDateTime}
    */
-  static now(t = u) {
+  static now(t = d) {
     const e = a.now().setZone(t);
     return m(e), new i(e);
   }
   /**
    * 値を日時として解釈する
    * 生成したインスタンスは inputTimezone のタイムゾーンを持つ
-   * DateTime を渡した場合、inputTimezone を省略すると渡した DateTime のタイムゾーンを引き継ぐ
+   * ZonedDateTime を渡した場合、inputTimezone を省略すると渡した ZonedDateTime のタイムゾーンを引き継ぐ
    * duration / startOf / endOf はそのタイムゾーンで計算する
    * 解釈できない値、null / undefined / 空文字は null を返す。タイムゾーンの指定が不正な場合は RangeError をスローする
    *
    * @param {DateInput} value
    * @param {ParseDateOptions} [options]
-   * @returns {DateTime | null}
+   * @returns {ZonedDateTime | null}
    */
   static parse(t, e) {
     if (t == null || t === "")
       return null;
-    const r = e?.inputTimezone ?? u;
-    let n = null;
+    const n = e?.inputTimezone ?? d;
+    let r = null;
     if (t instanceof i)
-      n = e?.inputTimezone ? t.dateTime.setZone(e.inputTimezone) : t.dateTime;
+      r = e?.inputTimezone ? t.dateTime.setZone(e.inputTimezone) : t.dateTime;
     else if (t instanceof Date)
-      n = a.fromJSDate(t, { zone: r });
+      r = a.fromJSDate(t, { zone: n });
     else if (typeof t == "number")
-      n = Number.isFinite(t) ? a.fromMillis(t, { zone: r }) : null;
+      r = Number.isFinite(t) ? a.fromMillis(t, { zone: n }) : null;
     else {
       const c = e?.locale ?? h, l = e?.inputFormat ? [e.inputFormat].flat() : [];
-      for (const T of l) {
-        const d = a.fromFormat(t, T, {
-          zone: r,
+      for (const f of l) {
+        const u = a.fromFormat(t, f, {
+          zone: n,
           locale: c
         });
-        if (m(d), d.isValid) {
-          n = d;
+        if (m(u), u.isValid) {
+          r = u;
           break;
         }
       }
-      n == null && (n = a.fromISO(t, { zone: r }));
+      r == null && (r = a.fromISO(t, { zone: n }));
     }
-    return n == null || (m(n), !n.isValid) ? null : (e?.duration && (n = n.plus(e.duration)), e?.startOf && (n = n.startOf(e.startOf)), e?.endOf && (n = n.endOf(e.endOf)), new i(n));
+    return r == null || (m(r), !r.isValid) ? null : (e?.duration && (r = r.plus(e.duration)), e?.startOf && (r = r.startOf(e.startOf)), e?.endOf && (r = r.endOf(e.endOf)), new i(r));
   }
   /** 年 */
   get year() {
@@ -112,7 +112,7 @@ class i {
    * 負の値を指定すると減算になる
    *
    * @param {Duration} duration
-   * @returns {DateTime}
+   * @returns {ZonedDateTime}
    */
   plus(t) {
     return new i(this.dateTime.plus(t));
@@ -121,7 +121,7 @@ class i {
    * 期間を減算した結果を返す
    *
    * @param {Duration} duration
-   * @returns {DateTime}
+   * @returns {ZonedDateTime}
    */
   minus(t) {
     return new i(this.dateTime.minus(t));
@@ -131,7 +131,7 @@ class i {
    * week は月曜始まりで切り捨てる
    *
    * @param {DateUnit} unit
-   * @returns {DateTime}
+   * @returns {ZonedDateTime}
    */
   startOf(t) {
     return new i(this.dateTime.startOf(t));
@@ -141,7 +141,7 @@ class i {
    * week は日曜終わりで切り上げる
    *
    * @param {DateUnit} unit
-   * @returns {DateTime}
+   * @returns {ZonedDateTime}
    */
   endOf(t) {
     return new i(this.dateTime.endOf(t));
@@ -151,8 +151,8 @@ class i {
    * 範囲外の値や整数でない値を指定した場合は RangeError をスローする
    * day を指定せずに year / month を変更し、日がその月に無い場合は月末日にする(1月31日に { month: 2 } なら2月末日)
    *
-   * @param {DateTimeFields} fields
-   * @returns {DateTime}
+   * @param {ZonedDateTimeFields} fields
+   * @returns {ZonedDateTime}
    */
   set(t) {
     o("month", t.month, 1, 12), o("hour", t.hour, 0, 23), o("minute", t.minute, 0, 59), o("second", t.second, 0, 59), o("millisecond", t.millisecond, 0, 999);
@@ -168,7 +168,7 @@ class i {
    * タイムゾーンの指定が不正な場合は RangeError をスローする
    *
    * @param {string} timezone IANA名
-   * @returns {DateTime}
+   * @returns {ZonedDateTime}
    */
   setZone(t) {
     const e = this.dateTime.setZone(t);
@@ -178,18 +178,18 @@ class i {
    * 自身 − other を unit の単位で返す
    * 両方を自身のタイムゾーンで unit の始まりに切り捨ててから差を取るため、暦の上での差になる(23:00 と翌 01:00 の days は 1)
    *
-   * @param {DateTime} other
+   * @param {ZonedDateTime} other
    * @param {TimeUnit} unit
    * @returns {number}
    */
   diff(t, e) {
-    const r = e.slice(0, -1), n = t.dateTime.setZone(this.dateTime.zone);
-    return this.dateTime.startOf(r).diff(n.startOf(r), e).get(e);
+    const n = e.slice(0, -1), r = t.dateTime.setZone(this.dateTime.zone);
+    return this.dateTime.startOf(n).diff(r.startOf(n), e).get(e);
   }
   /**
    * 時刻を比較する。タイムゾーンが異なっていても同じ時刻なら等しい
    *
-   * @param {DateTime} other
+   * @param {ZonedDateTime} other
    * @returns {-1 | 0 | 1} 自身が前なら-1、等しければ0、後なら1
    */
   compareTo(t) {
@@ -198,7 +198,7 @@ class i {
   /**
    * 同じ時刻か判定する
    *
-   * @param {DateTime} other
+   * @param {ZonedDateTime} other
    * @returns {boolean}
    */
   eq(t) {
@@ -207,7 +207,7 @@ class i {
   /**
    * 自身が前の時刻か判定する
    *
-   * @param {DateTime} other
+   * @param {ZonedDateTime} other
    * @returns {boolean}
    */
   lt(t) {
@@ -216,7 +216,7 @@ class i {
   /**
    * 自身が前か同じ時刻か判定する
    *
-   * @param {DateTime} other
+   * @param {ZonedDateTime} other
    * @returns {boolean}
    */
   lte(t) {
@@ -225,7 +225,7 @@ class i {
   /**
    * 自身が後の時刻か判定する
    *
-   * @param {DateTime} other
+   * @param {ZonedDateTime} other
    * @returns {boolean}
    */
   gt(t) {
@@ -234,7 +234,7 @@ class i {
   /**
    * 自身が後か同じ時刻か判定する
    *
-   * @param {DateTime} other
+   * @param {ZonedDateTime} other
    * @returns {boolean}
    */
   gte(t) {
@@ -244,7 +244,7 @@ class i {
    * 自身のタイムゾーンで、指定した書式の文字列にする
    *
    * @param {string} outputFormat
-   * @param {DateTimeFormatOptions} [options]
+   * @param {ZonedDateTimeFormatOptions} [options]
    * @returns {string}
    */
   format(t, e) {
@@ -284,6 +284,6 @@ class i {
   }
 }
 export {
-  i as DateTime
+  i as ZonedDateTime
 };
-//# sourceMappingURL=date-time.js.map
+//# sourceMappingURL=zoned-date-time.js.map

package/lib/zoned-date-time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zoned-date-time.js","sources":["../src/zoned-date-time.ts"],"sourcesContent":["/**\n * このクラス ZonedDateTime の役割は、日時演算の実体としての luxon を内部に閉じ込め、利用者側に露出させないことにある\n */\nimport { DateTime } from 'luxon';\nimport type { DateInput, DateUnit, Duration, ParseDateOptions, TimeUnit } from './date-util';\n\n/** set で変更する日時の要素。month は1〜12 */\nexport interface ZonedDateTimeFields {\n  year?: number;\n  month?: number;\n  day?: number;\n  hour?: number;\n  minute?: number;\n  second?: number;\n  millisecond?: number;\n}\n\n/**\n * 日時を文字列にするときのオプション\n */\nexport interface ZonedDateTimeFormatOptions {\n  /** 月名・曜日名に使うロケール。既定は 'en-US' */\n  locale?: string;\n}\n\nconst DEFAULT_TIMEZONE = 'UTC';\n\nconst DEFAULT_LOCALE = 'en-US';\n\n/**\n * タイムゾーンの指定が不正な場合は、日時の不正とは区別して例外にする\n */\nconst assertZone = (d: DateTime): void => {\n  if (!d.isValid && d.invalidReason === 'unsupported zone') {\n    throw new RangeError(d.invalidExplanation ?? d.invalidReason);\n  }\n};\n\n/**\n * set に渡された要素が min〜max の整数であることを確かめる\n */\nconst assertField = (name: keyof ZonedDateTimeFields, value: number | undefined, min: number, max: number): void => {\n  if (value === undefined) {\n    return;\n  }\n  if (!Number.isInteger(value) || value < min || max < value) {\n    throw new RangeError(`${name} must be an integer from ${min} to ${max}: ${value}`);\n  }\n};\n\n/**\n * 日時を表す不変オブジェクト\n * 演算メソッドは自身を変更せず、結果を新しいインスタンスで返す\n * インスタンスごとにタイムゾーンを持ち、startOf / endOf / set や各要素の参照はそのタイムゾーンで計算する\n */\nexport class ZonedDateTime {\n  /**\n   * 日時演算インスタンス\n   */\n  private dateTime: DateTime;\n\n  private constructor(dateTime: DateTime) {\n    this.dateTime = dateTime;\n  }\n\n  /**\n   * 現在時刻を返す\n   * タイムゾーンの指定が不正な場合は RangeError をスローする\n   *\n   * @param {string} [timezone] IANA名。既定は 'UTC'\n   * @returns {ZonedDateTime}\n   */\n  public static now(timezone: string = DEFAULT_TIMEZONE): ZonedDateTime {\n    const d = DateTime.now().setZone(timezone);\n    assertZone(d);\n    return new ZonedDateTime(d);\n  }\n\n  /**\n   * 値を日時として解釈する\n   * 生成したインスタンスは inputTimezone のタイムゾーンを持つ\n   * ZonedDateTime を渡した場合、inputTimezone を省略すると渡した ZonedDateTime のタイムゾーンを引き継ぐ\n   * duration / startOf / endOf はそのタイムゾーンで計算する\n   * 解釈できない値、null / undefined / 空文字は null を返す。タイムゾーンの指定が不正な場合は RangeError をスローする\n   *\n   * @param {DateInput} value\n   * @param {ParseDateOptions} [options]\n   * @returns {ZonedDateTime | null}\n   */\n  public static parse(value: DateInput, options?: ParseDateOptions): ZonedDateTime | null {\n    if (value == null || value === '') {\n      return null;\n    }\n    const zone = options?.inputTimezone ?? DEFAULT_TIMEZONE;\n    let d: DateTime | null = null;\n    if (value instanceof ZonedDateTime) {\n      d = options?.inputTimezone ? value.dateTime.setZone(options.inputTimezone) : value.dateTime;\n    } else if (value instanceof Date) {\n      d = DateTime.fromJSDate(value, { zone: zone });\n    } else if (typeof value === 'number') {\n      d = Number.isFinite(value) ? DateTime.fromMillis(value, { zone: zone }) : null;\n    } else {\n      const locale = options?.locale ?? DEFAULT_LOCALE;\n      const formats = options?.inputFormat ? [options.inputFormat].flat() : [];\n      for (const format of formats) {\n        const parsed = DateTime.fromFormat(value, format, {\n          zone: zone,\n          locale: locale\n        });\n        assertZone(parsed);\n        if (parsed.isValid) {\n          d = parsed;\n          break;\n        }\n      }\n      if (d == null) {\n        d = DateTime.fromISO(value, { zone: zone });\n      }\n    }\n    if (d == null) {\n      return null;\n    }\n    assertZone(d);\n    if (!d.isValid) {\n      return null;\n    }\n    if (options?.duration) {\n      d = d.plus(options.duration);\n    }\n    if (options?.startOf) {\n      d = d.startOf(options.startOf);\n    }\n    if (options?.endOf) {\n      d = d.endOf(options.endOf);\n    }\n    return new ZonedDateTime(d);\n  }\n\n  /** 年 */\n  public get year(): number {\n    return this.dateTime.year;\n  }\n\n  /** 月(1〜12) */\n  public get month(): number {\n    return this.dateTime.month;\n  }\n\n  /** 日 */\n  public get day(): number {\n    return this.dateTime.day;\n  }\n\n  /** 時 */\n  public get hour(): number {\n    return this.dateTime.hour;\n  }\n\n  /** 分 */\n  public get minute(): number {\n    return this.dateTime.minute;\n  }\n\n  /** 秒 */\n  public get second(): number {\n    return this.dateTime.second;\n  }\n\n  /** ミリ秒 */\n  public get millisecond(): number {\n    return this.dateTime.millisecond;\n  }\n\n  /** 曜日。月曜が1、日曜が7 */\n  public get weekday(): number {\n    return this.dateTime.weekday;\n  }\n\n  /** その月の日数 */\n  public get daysInMonth(): number {\n    return this.dateTime.daysInMonth as number;\n  }\n\n  /** 夏時間の期間中か */\n  public get isInDST(): boolean {\n    return this.dateTime.isInDST;\n  }\n\n  /** タイムゾーン(IANA名) */\n  public get timezone(): string {\n    return this.dateTime.zoneName as string;\n  }\n\n  /**\n   * 期間を加算した結果を返す\n   * 負の値を指定すると減算になる\n   *\n   * @param {Duration} duration\n   * @returns {ZonedDateTime}\n   */\n  public plus(duration: Duration): ZonedDateTime {\n    return new ZonedDateTime(this.dateTime.plus(duration));\n  }\n\n  /**\n   * 期間を減算した結果を返す\n   *\n   * @param {Duration} duration\n   * @returns {ZonedDateTime}\n   */\n  public minus(duration: Duration): ZonedDateTime {\n    return new ZonedDateTime(this.dateTime.minus(duration));\n  }\n\n  /**\n   * 指定した単位の最初の時点に切り捨てた結果を返す(month なら月初の00:00:00.000)\n   * week は月曜始まりで切り捨てる\n   *\n   * @param {DateUnit} unit\n   * @returns {ZonedDateTime}\n   */\n  public startOf(unit: DateUnit): ZonedDateTime {\n    return new ZonedDateTime(this.dateTime.startOf(unit));\n  }\n\n  /**\n   * 指定した単位の最後の時点に切り上げた結果を返す(month なら月末の23:59:59.999)\n   * week は日曜終わりで切り上げる\n   *\n   * @param {DateUnit} unit\n   * @returns {ZonedDateTime}\n   */\n  public endOf(unit: DateUnit): ZonedDateTime {\n    return new ZonedDateTime(this.dateTime.endOf(unit));\n  }\n\n  /**\n   * 指定した要素を変更した結果を返す\n   * 範囲外の値や整数でない値を指定した場合は RangeError をスローする\n   * day を指定せずに year / month を変更し、日がその月に無い場合は月末日にする(1月31日に { month: 2 } なら2月末日)\n   *\n   * @param {ZonedDateTimeFields} fields\n   * @returns {ZonedDateTime}\n   */\n  public set(fields: ZonedDateTimeFields): ZonedDateTime {\n    assertField('month', fields.month, 1, 12);\n    assertField('hour', fields.hour, 0, 23);\n    assertField('minute', fields.minute, 0, 59);\n    assertField('second', fields.second, 0, 59);\n    assertField('millisecond', fields.millisecond, 0, 999);\n    // day の上限は変更後の年月で決まる\n    const daysInMonth = this.dateTime.set({\n      year: fields.year ?? this.year,\n      month: fields.month ?? this.month,\n      day: 1\n    }).daysInMonth as number;\n    assertField('day', fields.day, 1, daysInMonth);\n    return new ZonedDateTime(this.dateTime.set(fields));\n  }\n\n  /**\n   * 同じ時刻を別のタイムゾーンで表した結果を返す\n   * タイムゾーンの指定が不正な場合は RangeError をスローする\n   *\n   * @param {string} timezone IANA名\n   * @returns {ZonedDateTime}\n   */\n  public setZone(timezone: string): ZonedDateTime {\n    const d = this.dateTime.setZone(timezone);\n    assertZone(d);\n    return new ZonedDateTime(d);\n  }\n\n  /**\n   * 自身 − other を unit の単位で返す\n   * 両方を自身のタイムゾーンで unit の始まりに切り捨ててから差を取るため、暦の上での差になる(23:00 と翌 01:00 の days は 1)\n   *\n   * @param {ZonedDateTime} other\n   * @param {TimeUnit} unit\n   * @returns {number}\n   */\n  public diff(other: ZonedDateTime, unit: TimeUnit): number {\n    // 'days' → 'day' のように切り捨ての単位にする\n    const dateUnit = unit.slice(0, -1) as DateUnit;\n    const target = other.dateTime.setZone(this.dateTime.zone);\n    return this.dateTime.startOf(dateUnit).diff(target.startOf(dateUnit), unit).get(unit);\n  }\n\n  /**\n   * 時刻を比較する。タイムゾーンが異なっていても同じ時刻なら等しい\n   *\n   * @param {ZonedDateTime} other\n   * @returns {-1 | 0 | 1} 自身が前なら-1、等しければ0、後なら1\n   */\n  public compareTo(other: ZonedDateTime): -1 | 0 | 1 {\n    return Math.sign(this.toMillis() - other.toMillis()) as -1 | 0 | 1;\n  }\n\n  /**\n   * 同じ時刻か判定する\n   *\n   * @param {ZonedDateTime} other\n   * @returns {boolean}\n   */\n  public eq(other: ZonedDateTime): boolean {\n    return this.compareTo(other) === 0;\n  }\n\n  /**\n   * 自身が前の時刻か判定する\n   *\n   * @param {ZonedDateTime} other\n   * @returns {boolean}\n   */\n  public lt(other: ZonedDateTime): boolean {\n    return this.compareTo(other) < 0;\n  }\n\n  /**\n   * 自身が前か同じ時刻か判定する\n   *\n   * @param {ZonedDateTime} other\n   * @returns {boolean}\n   */\n  public lte(other: ZonedDateTime): boolean {\n    return this.compareTo(other) <= 0;\n  }\n\n  /**\n   * 自身が後の時刻か判定する\n   *\n   * @param {ZonedDateTime} other\n   * @returns {boolean}\n   */\n  public gt(other: ZonedDateTime): boolean {\n    return 0 < this.compareTo(other);\n  }\n\n  /**\n   * 自身が後か同じ時刻か判定する\n   *\n   * @param {ZonedDateTime} other\n   * @returns {boolean}\n   */\n  public gte(other: ZonedDateTime): boolean {\n    return 0 <= this.compareTo(other);\n  }\n\n  /**\n   * 自身のタイムゾーンで、指定した書式の文字列にする\n   *\n   * @param {string} outputFormat\n   * @param {ZonedDateTimeFormatOptions} [options]\n   * @returns {string}\n   */\n  public format(outputFormat: string, options?: ZonedDateTimeFormatOptions): string {\n    return this.dateTime.toFormat(outputFormat, { locale: options?.locale ?? DEFAULT_LOCALE });\n  }\n\n  /**\n   * 自身のタイムゾーンで、ISO形式の文字列にする\n   *\n   * @returns {string}\n   */\n  public toISO(): string {\n    return this.dateTime.toISO() as string;\n  }\n\n  /**\n   * Date に変換する\n   *\n   * @returns {Date}\n   */\n  public toDate(): Date {\n    return this.dateTime.toJSDate();\n  }\n\n  /**\n   * epoch ミリ秒に変換する\n   *\n   * @returns {number}\n   */\n  public toMillis(): number {\n    return this.dateTime.toMillis();\n  }\n\n  /**\n   * 自身のタイムゾーンで、ISO形式の文字列にする\n   *\n   * @returns {string}\n   */\n  public toString(): string {\n    return this.toISO();\n  }\n}\n"],"names":["DEFAULT_TIMEZONE","DEFAULT_LOCALE","assertZone","d","assertField","name","value","min","max","ZonedDateTime","dateTime","timezone","DateTime","options","zone","locale","formats","format","parsed","duration","unit","fields","daysInMonth","other","dateUnit","target","outputFormat"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digitalwalletcorp/utils",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "description": "A javascript utility.",
   "type": "module",
   "main": "lib/index.cjs",