@digitalwalletcorp/utils 0.10.0 → 0.12.0

package/lib/zoned-date-time.d.ts

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

package/lib/zoned-date-time.js

@@ -0,0 +1,289 @@
+import { DateTime as a } from "luxon";
+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, 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 {
+  /**
+   * 日時演算インスタンス
+   */
+  dateTime;
+  constructor(t) {
+    this.dateTime = t;
+  }
+  /**
+   * 現在時刻を返す
+   * タイムゾーンの指定が不正な場合は RangeError をスローする
+   *
+   * @param {string} [timezone] IANA名。既定は 'UTC'
+   * @returns {ZonedDateTime}
+   */
+  static now(t = d) {
+    const e = a.now().setZone(t);
+    return m(e), new i(e);
+  }
+  /**
+   * 値を日時として解釈する
+   * 生成したインスタンスは inputTimezone のタイムゾーンを持つ
+   * ZonedDateTime を渡した場合、inputTimezone を省略すると渡した ZonedDateTime のタイムゾーンを引き継ぐ
+   * duration / startOf / endOf はそのタイムゾーンで計算する
+   * 解釈できない値、null / undefined / 空文字は null を返す。タイムゾーンの指定が不正な場合は RangeError をスローする
+   *
+   * @param {DateInput} value
+   * @param {ParseDateOptions} [options]
+   * @returns {ZonedDateTime | null}
+   */
+  static parse(t, e) {
+    if (t == null || t === "")
+      return null;
+    const n = e?.inputTimezone ?? d;
+    let r = null;
+    if (t instanceof i)
+      r = e?.inputTimezone ? t.dateTime.setZone(e.inputTimezone) : t.dateTime;
+    else if (t instanceof Date)
+      r = a.fromJSDate(t, { zone: n });
+    else if (typeof t == "number")
+      r = Number.isFinite(t) ? a.fromMillis(t, { zone: n }) : null;
+    else {
+      const c = e?.locale ?? h, l = e?.inputFormat ? [e.inputFormat].flat() : [];
+      for (const f of l) {
+        const u = a.fromFormat(t, f, {
+          zone: n,
+          locale: c
+        });
+        if (m(u), u.isValid) {
+          r = u;
+          break;
+        }
+      }
+      r == null && (r = a.fromISO(t, { zone: 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() {
+    return this.dateTime.year;
+  }
+  /** 月(1〜12) */
+  get month() {
+    return this.dateTime.month;
+  }
+  /** 日 */
+  get day() {
+    return this.dateTime.day;
+  }
+  /** 時 */
+  get hour() {
+    return this.dateTime.hour;
+  }
+  /** 分 */
+  get minute() {
+    return this.dateTime.minute;
+  }
+  /** 秒 */
+  get second() {
+    return this.dateTime.second;
+  }
+  /** ミリ秒 */
+  get millisecond() {
+    return this.dateTime.millisecond;
+  }
+  /** 曜日。月曜が1、日曜が7 */
+  get weekday() {
+    return this.dateTime.weekday;
+  }
+  /** その月の日数 */
+  get daysInMonth() {
+    return this.dateTime.daysInMonth;
+  }
+  /** 夏時間の期間中か */
+  get isInDST() {
+    return this.dateTime.isInDST;
+  }
+  /** タイムゾーン(IANA名) */
+  get timezone() {
+    return this.dateTime.zoneName;
+  }
+  /**
+   * 期間を加算した結果を返す
+   * 負の値を指定すると減算になる
+   *
+   * @param {Duration} duration
+   * @returns {ZonedDateTime}
+   */
+  plus(t) {
+    return new i(this.dateTime.plus(t));
+  }
+  /**
+   * 期間を減算した結果を返す
+   *
+   * @param {Duration} duration
+   * @returns {ZonedDateTime}
+   */
+  minus(t) {
+    return new i(this.dateTime.minus(t));
+  }
+  /**
+   * 指定した単位の最初の時点に切り捨てた結果を返す(month なら月初の00:00:00.000)
+   * week は月曜始まりで切り捨てる
+   *
+   * @param {DateUnit} unit
+   * @returns {ZonedDateTime}
+   */
+  startOf(t) {
+    return new i(this.dateTime.startOf(t));
+  }
+  /**
+   * 指定した単位の最後の時点に切り上げた結果を返す(month なら月末の23:59:59.999)
+   * week は日曜終わりで切り上げる
+   *
+   * @param {DateUnit} unit
+   * @returns {ZonedDateTime}
+   */
+  endOf(t) {
+    return new i(this.dateTime.endOf(t));
+  }
+  /**
+   * 指定した要素を変更した結果を返す
+   * 範囲外の値や整数でない値を指定した場合は RangeError をスローする
+   * day を指定せずに year / month を変更し、日がその月に無い場合は月末日にする(1月31日に { month: 2 } なら2月末日)
+   *
+   * @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);
+    const e = this.dateTime.set({
+      year: t.year ?? this.year,
+      month: t.month ?? this.month,
+      day: 1
+    }).daysInMonth;
+    return o("day", t.day, 1, e), new i(this.dateTime.set(t));
+  }
+  /**
+   * 同じ時刻を別のタイムゾーンで表した結果を返す
+   * タイムゾーンの指定が不正な場合は RangeError をスローする
+   *
+   * @param {string} timezone IANA名
+   * @returns {ZonedDateTime}
+   */
+  setZone(t) {
+    const e = this.dateTime.setZone(t);
+    return m(e), new i(e);
+  }
+  /**
+   * 自身 − other を unit の単位で返す
+   * 両方を自身のタイムゾーンで unit の始まりに切り捨ててから差を取るため、暦の上での差になる(23:00 と翌 01:00 の days は 1)
+   *
+   * @param {ZonedDateTime} other
+   * @param {TimeUnit} unit
+   * @returns {number}
+   */
+  diff(t, 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 {ZonedDateTime} other
+   * @returns {-1 | 0 | 1} 自身が前なら-1、等しければ0、後なら1
+   */
+  compareTo(t) {
+    return Math.sign(this.toMillis() - t.toMillis());
+  }
+  /**
+   * 同じ時刻か判定する
+   *
+   * @param {ZonedDateTime} other
+   * @returns {boolean}
+   */
+  eq(t) {
+    return this.compareTo(t) === 0;
+  }
+  /**
+   * 自身が前の時刻か判定する
+   *
+   * @param {ZonedDateTime} other
+   * @returns {boolean}
+   */
+  lt(t) {
+    return this.compareTo(t) < 0;
+  }
+  /**
+   * 自身が前か同じ時刻か判定する
+   *
+   * @param {ZonedDateTime} other
+   * @returns {boolean}
+   */
+  lte(t) {
+    return this.compareTo(t) <= 0;
+  }
+  /**
+   * 自身が後の時刻か判定する
+   *
+   * @param {ZonedDateTime} other
+   * @returns {boolean}
+   */
+  gt(t) {
+    return 0 < this.compareTo(t);
+  }
+  /**
+   * 自身が後か同じ時刻か判定する
+   *
+   * @param {ZonedDateTime} other
+   * @returns {boolean}
+   */
+  gte(t) {
+    return 0 <= this.compareTo(t);
+  }
+  /**
+   * 自身のタイムゾーンで、指定した書式の文字列にする
+   *
+   * @param {string} outputFormat
+   * @param {ZonedDateTimeFormatOptions} [options]
+   * @returns {string}
+   */
+  format(t, e) {
+    return this.dateTime.toFormat(t, { locale: e?.locale ?? h });
+  }
+  /**
+   * 自身のタイムゾーンで、ISO形式の文字列にする
+   *
+   * @returns {string}
+   */
+  toISO() {
+    return this.dateTime.toISO();
+  }
+  /**
+   * Date に変換する
+   *
+   * @returns {Date}
+   */
+  toDate() {
+    return this.dateTime.toJSDate();
+  }
+  /**
+   * epoch ミリ秒に変換する
+   *
+   * @returns {number}
+   */
+  toMillis() {
+    return this.dateTime.toMillis();
+  }
+  /**
+   * 自身のタイムゾーンで、ISO形式の文字列にする
+   *
+   * @returns {string}
+   */
+  toString() {
+    return this.toISO();
+  }
+}
+export {
+  i as ZonedDateTime
+};
+//# 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.10.0",
+  "version": "0.12.0",
   "description": "A javascript utility.",
   "type": "module",
   "main": "lib/index.cjs",