@digitalwalletcorp/utils 0.9.0 → 0.11.0

package/lib/date-time.js

@@ -0,0 +1,289 @@
+import { DateTime as a } from "luxon";
+const u = "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}`);
+};
+class i {
+  /**
+   * 日時演算インスタンス
+   */
+  dateTime;
+  constructor(t) {
+    this.dateTime = t;
+  }
+  /**
+   * 現在時刻を返す
+   * タイムゾーンの指定が不正な場合は RangeError をスローする
+   *
+   * @param {string} [timezone] IANA名。既定は 'UTC'
+   * @returns {DateTime}
+   */
+  static now(t = u) {
+    const e = a.now().setZone(t);
+    return m(e), new i(e);
+  }
+  /**
+   * 値を日時として解釈する
+   * 生成したインスタンスは inputTimezone のタイムゾーンを持つ
+   * DateTime を渡した場合、inputTimezone を省略すると渡した DateTime のタイムゾーンを引き継ぐ
+   * duration / startOf / endOf はそのタイムゾーンで計算する
+   * 解釈できない値、null / undefined / 空文字は null を返す。タイムゾーンの指定が不正な場合は RangeError をスローする
+   *
+   * @param {DateInput} value
+   * @param {ParseDateOptions} [options]
+   * @returns {DateTime | null}
+   */
+  static parse(t, e) {
+    if (t == null || t === "")
+      return null;
+    const r = e?.inputTimezone ?? u;
+    let n = null;
+    if (t instanceof i)
+      n = e?.inputTimezone ? t.dateTime.setZone(e.inputTimezone) : t.dateTime;
+    else if (t instanceof Date)
+      n = a.fromJSDate(t, { zone: r });
+    else if (typeof t == "number")
+      n = Number.isFinite(t) ? a.fromMillis(t, { zone: r }) : 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,
+          locale: c
+        });
+        if (m(d), d.isValid) {
+          n = d;
+          break;
+        }
+      }
+      n == null && (n = a.fromISO(t, { zone: r }));
+    }
+    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));
+  }
+  /** 年 */
+  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 {DateTime}
+   */
+  plus(t) {
+    return new i(this.dateTime.plus(t));
+  }
+  /**
+   * 期間を減算した結果を返す
+   *
+   * @param {Duration} duration
+   * @returns {DateTime}
+   */
+  minus(t) {
+    return new i(this.dateTime.minus(t));
+  }
+  /**
+   * 指定した単位の最初の時点に切り捨てた結果を返す(month なら月初の00:00:00.000)
+   * week は月曜始まりで切り捨てる
+   *
+   * @param {DateUnit} unit
+   * @returns {DateTime}
+   */
+  startOf(t) {
+    return new i(this.dateTime.startOf(t));
+  }
+  /**
+   * 指定した単位の最後の時点に切り上げた結果を返す(month なら月末の23:59:59.999)
+   * week は日曜終わりで切り上げる
+   *
+   * @param {DateUnit} unit
+   * @returns {DateTime}
+   */
+  endOf(t) {
+    return new i(this.dateTime.endOf(t));
+  }
+  /**
+   * 指定した要素を変更した結果を返す
+   * 範囲外の値や整数でない値を指定した場合は RangeError をスローする
+   * day を指定せずに year / month を変更し、日がその月に無い場合は月末日にする(1月31日に { month: 2 } なら2月末日)
+   *
+   * @param {DateTimeFields} fields
+   * @returns {DateTime}
+   */
+  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 {DateTime}
+   */
+  setZone(t) {
+    const e = this.dateTime.setZone(t);
+    return m(e), new i(e);
+  }
+  /**
+   * 自身 − other を unit の単位で返す
+   * 両方を自身のタイムゾーンで unit の始まりに切り捨ててから差を取るため、暦の上での差になる(23:00 と翌 01:00 の days は 1)
+   *
+   * @param {DateTime} 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);
+  }
+  /**
+   * 時刻を比較する。タイムゾーンが異なっていても同じ時刻なら等しい
+   *
+   * @param {DateTime} other
+   * @returns {-1 | 0 | 1} 自身が前なら-1、等しければ0、後なら1
+   */
+  compareTo(t) {
+    return Math.sign(this.toMillis() - t.toMillis());
+  }
+  /**
+   * 同じ時刻か判定する
+   *
+   * @param {DateTime} other
+   * @returns {boolean}
+   */
+  eq(t) {
+    return this.compareTo(t) === 0;
+  }
+  /**
+   * 自身が前の時刻か判定する
+   *
+   * @param {DateTime} other
+   * @returns {boolean}
+   */
+  lt(t) {
+    return this.compareTo(t) < 0;
+  }
+  /**
+   * 自身が前か同じ時刻か判定する
+   *
+   * @param {DateTime} other
+   * @returns {boolean}
+   */
+  lte(t) {
+    return this.compareTo(t) <= 0;
+  }
+  /**
+   * 自身が後の時刻か判定する
+   *
+   * @param {DateTime} other
+   * @returns {boolean}
+   */
+  gt(t) {
+    return 0 < this.compareTo(t);
+  }
+  /**
+   * 自身が後か同じ時刻か判定する
+   *
+   * @param {DateTime} other
+   * @returns {boolean}
+   */
+  gte(t) {
+    return 0 <= this.compareTo(t);
+  }
+  /**
+   * 自身のタイムゾーンで、指定した書式の文字列にする
+   *
+   * @param {string} outputFormat
+   * @param {DateTimeFormatOptions} [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 DateTime
+};
+//# sourceMappingURL=date-time.js.map

package/lib/date-time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-time.js","sources":["../src/date-time.ts"],"sourcesContent":["/**\n * このクラス DateTime の役割は、日時演算の実体としての luxon を内部に閉じ込め、利用者側に露出させないことにある\n */\nimport { DateTime as LuxonDateTime } from 'luxon';\nimport type { DateInput, DateUnit, Duration, ParseDateOptions, TimeUnit } from './date-util';\n\n/** set で変更する日時の要素。month は1〜12 */\nexport interface DateTimeFields {\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 DateTimeFormatOptions {\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: LuxonDateTime): 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 DateTimeFields, 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 DateTime {\n  /**\n   * 日時演算インスタンス\n   */\n  private dateTime: LuxonDateTime;\n\n  private constructor(dateTime: LuxonDateTime) {\n    this.dateTime = dateTime;\n  }\n\n  /**\n   * 現在時刻を返す\n   * タイムゾーンの指定が不正な場合は RangeError をスローする\n   *\n   * @param {string} [timezone] IANA名。既定は 'UTC'\n   * @returns {DateTime}\n   */\n  public static now(timezone: string = DEFAULT_TIMEZONE): DateTime {\n    const d = LuxonDateTime.now().setZone(timezone);\n    assertZone(d);\n    return new DateTime(d);\n  }\n\n  /**\n   * 値を日時として解釈する\n   * 生成したインスタンスは inputTimezone のタイムゾーンを持つ\n   * DateTime を渡した場合、inputTimezone を省略すると渡した DateTime のタイムゾーンを引き継ぐ\n   * duration / startOf / endOf はそのタイムゾーンで計算する\n   * 解釈できない値、null / undefined / 空文字は null を返す。タイムゾーンの指定が不正な場合は RangeError をスローする\n   *\n   * @param {DateInput} value\n   * @param {ParseDateOptions} [options]\n   * @returns {DateTime | null}\n   */\n  public static parse(value: DateInput, options?: ParseDateOptions): DateTime | null {\n    if (value == null || value === '') {\n      return null;\n    }\n    const zone = options?.inputTimezone ?? DEFAULT_TIMEZONE;\n    let d: LuxonDateTime | null = null;\n    if (value instanceof DateTime) {\n      d = options?.inputTimezone ? value.dateTime.setZone(options.inputTimezone) : value.dateTime;\n    } else if (value instanceof Date) {\n      d = LuxonDateTime.fromJSDate(value, { zone: zone });\n    } else if (typeof value === 'number') {\n      d = Number.isFinite(value) ? LuxonDateTime.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 = LuxonDateTime.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 = LuxonDateTime.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 DateTime(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 {DateTime}\n   */\n  public plus(duration: Duration): DateTime {\n    return new DateTime(this.dateTime.plus(duration));\n  }\n\n  /**\n   * 期間を減算した結果を返す\n   *\n   * @param {Duration} duration\n   * @returns {DateTime}\n   */\n  public minus(duration: Duration): DateTime {\n    return new DateTime(this.dateTime.minus(duration));\n  }\n\n  /**\n   * 指定した単位の最初の時点に切り捨てた結果を返す(month なら月初の00:00:00.000)\n   * week は月曜始まりで切り捨てる\n   *\n   * @param {DateUnit} unit\n   * @returns {DateTime}\n   */\n  public startOf(unit: DateUnit): DateTime {\n    return new DateTime(this.dateTime.startOf(unit));\n  }\n\n  /**\n   * 指定した単位の最後の時点に切り上げた結果を返す(month なら月末の23:59:59.999)\n   * week は日曜終わりで切り上げる\n   *\n   * @param {DateUnit} unit\n   * @returns {DateTime}\n   */\n  public endOf(unit: DateUnit): DateTime {\n    return new DateTime(this.dateTime.endOf(unit));\n  }\n\n  /**\n   * 指定した要素を変更した結果を返す\n   * 範囲外の値や整数でない値を指定した場合は RangeError をスローする\n   * day を指定せずに year / month を変更し、日がその月に無い場合は月末日にする(1月31日に { month: 2 } なら2月末日)\n   *\n   * @param {DateTimeFields} fields\n   * @returns {DateTime}\n   */\n  public set(fields: DateTimeFields): DateTime {\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 DateTime(this.dateTime.set(fields));\n  }\n\n  /**\n   * 同じ時刻を別のタイムゾーンで表した結果を返す\n   * タイムゾーンの指定が不正な場合は RangeError をスローする\n   *\n   * @param {string} timezone IANA名\n   * @returns {DateTime}\n   */\n  public setZone(timezone: string): DateTime {\n    const d = this.dateTime.setZone(timezone);\n    assertZone(d);\n    return new DateTime(d);\n  }\n\n  /**\n   * 自身 − other を unit の単位で返す\n   * 両方を自身のタイムゾーンで unit の始まりに切り捨ててから差を取るため、暦の上での差になる(23:00 と翌 01:00 の days は 1)\n   *\n   * @param {DateTime} other\n   * @param {TimeUnit} unit\n   * @returns {number}\n   */\n  public diff(other: DateTime, 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 {DateTime} other\n   * @returns {-1 | 0 | 1} 自身が前なら-1、等しければ0、後なら1\n   */\n  public compareTo(other: DateTime): -1 | 0 | 1 {\n    return Math.sign(this.toMillis() - other.toMillis()) as -1 | 0 | 1;\n  }\n\n  /**\n   * 同じ時刻か判定する\n   *\n   * @param {DateTime} other\n   * @returns {boolean}\n   */\n  public eq(other: DateTime): boolean {\n    return this.compareTo(other) === 0;\n  }\n\n  /**\n   * 自身が前の時刻か判定する\n   *\n   * @param {DateTime} other\n   * @returns {boolean}\n   */\n  public lt(other: DateTime): boolean {\n    return this.compareTo(other) < 0;\n  }\n\n  /**\n   * 自身が前か同じ時刻か判定する\n   *\n   * @param {DateTime} other\n   * @returns {boolean}\n   */\n  public lte(other: DateTime): boolean {\n    return this.compareTo(other) <= 0;\n  }\n\n  /**\n   * 自身が後の時刻か判定する\n   *\n   * @param {DateTime} other\n   * @returns {boolean}\n   */\n  public gt(other: DateTime): boolean {\n    return 0 < this.compareTo(other);\n  }\n\n  /**\n   * 自身が後か同じ時刻か判定する\n   *\n   * @param {DateTime} other\n   * @returns {boolean}\n   */\n  public gte(other: DateTime): boolean {\n    return 0 <= this.compareTo(other);\n  }\n\n  /**\n   * 自身のタイムゾーンで、指定した書式の文字列にする\n   *\n   * @param {string} outputFormat\n   * @param {DateTimeFormatOptions} [options]\n   * @returns {string}\n   */\n  public format(outputFormat: string, options?: DateTimeFormatOptions): 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","DateTime","dateTime","timezone","LuxonDateTime","options","zone","locale","formats","format","parsed","duration","unit","fields","daysInMonth","other","dateUnit","target","outputFormat"],"mappings":"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"}

package/lib/date-util-ByW86YIS.cjs

@@ -0,0 +1,2 @@
+"use strict";const i=require("./date-time.cjs"),c="UTC",_="yyyy-MM-dd'T'HH:mm:ss.SSSZZ",I=25569,O=1440*60*1e3,P=3600*1e3,b=/GMT[+-]\d{1,2}(:\d{2})?/g,B={UTC:{standard:"UTC"},"Asia/Tokyo":{standard:"JST"},"Asia/Seoul":{standard:"KST"},"Asia/Shanghai":{standard:"CST"},"Asia/Hong_Kong":{standard:"HKT"},"Asia/Taipei":{standard:"CST"},"Asia/Singapore":{standard:"SGT"},"Asia/Manila":{standard:"PHT"},"Asia/Bangkok":{standard:"ICT"},"Asia/Ho_Chi_Minh":{standard:"ICT"},"Asia/Jakarta":{standard:"WIB"},"Asia/Kolkata":{standard:"IST"},"Asia/Dubai":{standard:"GST"},"Australia/Sydney":{standard:"AEST",daylight:"AEDT"},"Pacific/Auckland":{standard:"NZST",daylight:"NZDT"},"Europe/London":{standard:"GMT",daylight:"BST"},"Europe/Paris":{standard:"CET",daylight:"CEST"},"Europe/Berlin":{standard:"CET",daylight:"CEST"},"Europe/Madrid":{standard:"CET",daylight:"CEST"},"Europe/Rome":{standard:"CET",daylight:"CEST"},"Europe/Amsterdam":{standard:"CET",daylight:"CEST"},"America/New_York":{standard:"EST",daylight:"EDT"},"America/Toronto":{standard:"EST",daylight:"EDT"},"America/Chicago":{standard:"CST",daylight:"CDT"},"America/Denver":{standard:"MST",daylight:"MDT"},"America/Phoenix":{standard:"MST"},"America/Los_Angeles":{standard:"PST",daylight:"PDT"},"America/Vancouver":{standard:"PST",daylight:"PDT"},"America/Mexico_City":{standard:"CST"},"America/Sao_Paulo":{standard:"BRT"}},d=(a,t,e,r)=>{const n=i.DateTime.parse(a,e),s=i.DateTime.parse(t,e);return!n||!s?!1:r(n.toMillis(),s.toMillis())};function u(a,t){return i.DateTime.parse(a,t)?.toDate()??null}function o(a,t){if(typeof a=="object"&&a!==null&&!(a instanceof Date)&&!(a instanceof i.DateTime))return o(new Date,a);if(a==null||a==="")return"";const e=i.DateTime.parse(a,t);if(!e)return t?.invalidText??"Invalid Date";const r=e.setZone(t?.outputTimezone??c);return t?.outputFormat?r.format(t.outputFormat,{locale:t.locale}):r.toISO()}function l(a,t){return i.DateTime.parse(a,t)!=null}function f(a,t,e){return d(a,t,e,(r,n)=>r===n)}function m(a,t,e){return d(a,t,e,(r,n)=>r<n)}function S(a,t,e){return d(a,t,e,(r,n)=>r<=n)}function D(a,t,e){return d(a,t,e,(r,n)=>n<r)}function A(a,t,e){return d(a,t,e,(r,n)=>n<=r)}function E(a,t){const e=i.DateTime.parse(a,t)?.startOf("day");if(!e)return!1;const r=i.DateTime.now(e.timezone).startOf("day");return e.lt(r)}function y(a,t){const e=i.DateTime.parse(a,t);return e!=null&&e.toMillis()<Date.now()}function g(a,t,e,r){const n=i.DateTime.parse(a,r),s=i.DateTime.parse(t,r);return!n||!s?NaN:n.diff(s,e)}function p(a=c){return i.DateTime.now(a).format(_)}function C(a,t){let e=(a-I)*O;return t?.offset&&(e-=t.offset*P),e}function M(a,t){return(t===void 0?i.DateTime.now(a):i.DateTime.parse(t)?.setZone(a))?.isInDST??!1}function T(a,t){const e={...B,...t?.abbreviations}[a];return e?e.daylight&&i.DateTime.parse(t?.at??new Date)?.setZone(a)?.isInDST?e.daylight:e.standard:null}function h(a,t,e){const r=T(t,e);return r==null?a:a.replace(b,r)}const L=Object.freeze(Object.defineProperty({__proto__:null,applyTimezoneAbbr:h,convertExcelDateSerialToUnixTimeSerial:C,currentTimestamp:p,diff:g,formatDate:o,getTimezoneAbbr:T,isAfter:D,isBefore:m,isInDST:M,isPastDate:E,isPastDateTime:y,isSame:f,isSameOrAfter:A,isSameOrBefore:S,isValid:l,parseDate:u},Symbol.toStringTag,{value:"Module"}));exports.applyTimezoneAbbr=h;exports.convertExcelDateSerialToUnixTimeSerial=C;exports.currentTimestamp=p;exports.dateUtil=L;exports.diff=g;exports.formatDate=o;exports.getTimezoneAbbr=T;exports.isAfter=D;exports.isBefore=m;exports.isInDST=M;exports.isPastDate=E;exports.isPastDateTime=y;exports.isSame=f;exports.isSameOrAfter=A;exports.isSameOrBefore=S;exports.isValid=l;exports.parseDate=u;
+//# sourceMappingURL=date-util-ByW86YIS.cjs.map

package/lib/date-util-ByW86YIS.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-util-ByW86YIS.cjs","sources":["../src/date-util.ts"],"sourcesContent":["import { DateTime } from './date-time';\n\n/**\n * 日時として解釈する値。string はISO形式または inputFormat の書式、number は epoch ミリ秒\n * DateTime は inputTimezone を省略した場合、その DateTime のタイムゾーンで扱う\n */\nexport type DateInput = string | Date | number | DateTime | null | undefined;\n\n/** 日時の切り捨て(startOf / endOf)に使う単位 */\nexport type DateUnit = 'year' | 'quarter' | 'month' | 'week' | 'day' | 'hour' | 'minute' | 'second' | 'millisecond';\n\n/** 期間の単位 */\nexport type TimeUnit = 'milliseconds' | 'seconds' | 'minutes' | 'hours' | 'days' | 'months' | 'years';\n\n/** 日時の加算・減算に使う期間。負の値で減算になる */\nexport interface Duration {\n  years?: number;\n  quarters?: number;\n  months?: number;\n  weeks?: number;\n  days?: number;\n  hours?: number;\n  minutes?: number;\n  seconds?: number;\n  milliseconds?: number;\n}\n\n/**\n * 日時を解釈するときのオプション\n */\nexport interface ParseDateOptions {\n  /** 入力の書式。配列の場合は先頭から順に試す。いずれにも一致しない場合はISO形式として解釈する */\n  inputFormat?: string | string[];\n  /** ゾーン情報を含まない入力をどのタイムゾーンの日時とみなすか(IANA名)。既定は 'UTC' */\n  inputTimezone?: string;\n  /** 解釈した日時に加算する期間。startOf / endOf より先に適用する */\n  duration?: Duration;\n  /** 指定した単位の最初の時点に切り捨てる(month なら月初の00:00:00.000) */\n  startOf?: DateUnit;\n  /** 指定した単位の最後の時点に切り上げる(month なら月末の23:59:59.999) */\n  endOf?: DateUnit;\n  /** 書式の月名・曜日名を解釈・出力するときのロケール。既定は 'en-US' */\n  locale?: string;\n}\n\n/**\n * 日時を文字列にするときのオプション\n */\nexport interface FormatDateOptions extends ParseDateOptions {\n  /** 出力の書式。省略時はISO形式 */\n  outputFormat?: string;\n  /** 出力に使うタイムゾーン(IANA名)。既定は 'UTC' */\n  outputTimezone?: string;\n  /** 日時として解釈できない値に対する出力。既定は 'Invalid Date' */\n  invalidText?: string;\n}\n\n/** タイムゾーンの略称。夏時間のないタイムゾーンでは daylight を持たない */\nexport interface TimezoneAbbreviation {\n  standard: string;\n  daylight?: string;\n}\n\n/** IANA名をキーにしたタイムゾーンの略称の表 */\nexport type TimezoneAbbreviations = Record<string, TimezoneAbbreviation>;\n\n/**\n * タイムゾーンの略称を解決するときのオプション\n */\nexport interface TimezoneAbbrOptions {\n  /** 夏時間かどうかを判定する時点。既定は現在時刻 */\n  at?: Date;\n  /** 既定の表に追加・上書きする略称 */\n  abbreviations?: TimezoneAbbreviations;\n}\n\nconst DEFAULT_TIMEZONE = 'UTC';\n\nconst TIMESTAMP_FORMAT = `yyyy-MM-dd'T'HH:mm:ss.SSSZZ`;\n\n/** 1970-01-01 を表すExcelの日付シリアル値 */\nconst EXCEL_EPOCH_SERIAL = 25569;\n\nconst MILLISECONDS_PER_DAY = 24 * 60 * 60 * 1000;\n\nconst MILLISECONDS_PER_HOUR = 60 * 60 * 1000;\n\nconst GMT_OFFSET = /GMT[+-]\\d{1,2}(:\\d{2})?/g;\n\n/**\n * 略称の既定の表。略称は世界で一意ではないため(CST は米国中部・中国などで使われる)、このライブラリが採用する表記である\n */\nconst DEFAULT_TIMEZONE_ABBREVIATIONS: TimezoneAbbreviations = {\n  'UTC': { standard: 'UTC' },\n  'Asia/Tokyo': { standard: 'JST' },\n  'Asia/Seoul': { standard: 'KST' },\n  'Asia/Shanghai': { standard: 'CST' },\n  'Asia/Hong_Kong': { standard: 'HKT' },\n  'Asia/Taipei': { standard: 'CST' },\n  'Asia/Singapore': { standard: 'SGT' },\n  'Asia/Manila': { standard: 'PHT' },\n  'Asia/Bangkok': { standard: 'ICT' },\n  'Asia/Ho_Chi_Minh': { standard: 'ICT' },\n  'Asia/Jakarta': { standard: 'WIB' },\n  'Asia/Kolkata': { standard: 'IST' },\n  'Asia/Dubai': { standard: 'GST' },\n  'Australia/Sydney': { standard: 'AEST', daylight: 'AEDT' },\n  'Pacific/Auckland': { standard: 'NZST', daylight: 'NZDT' },\n  'Europe/London': { standard: 'GMT', daylight: 'BST' },\n  'Europe/Paris': { standard: 'CET', daylight: 'CEST' },\n  'Europe/Berlin': { standard: 'CET', daylight: 'CEST' },\n  'Europe/Madrid': { standard: 'CET', daylight: 'CEST' },\n  'Europe/Rome': { standard: 'CET', daylight: 'CEST' },\n  'Europe/Amsterdam': { standard: 'CET', daylight: 'CEST' },\n  'America/New_York': { standard: 'EST', daylight: 'EDT' },\n  'America/Toronto': { standard: 'EST', daylight: 'EDT' },\n  'America/Chicago': { standard: 'CST', daylight: 'CDT' },\n  'America/Denver': { standard: 'MST', daylight: 'MDT' },\n  'America/Phoenix': { standard: 'MST' },\n  'America/Los_Angeles': { standard: 'PST', daylight: 'PDT' },\n  'America/Vancouver': { standard: 'PST', daylight: 'PDT' },\n  'America/Mexico_City': { standard: 'CST' },\n  'America/Sao_Paulo': { standard: 'BRT' }\n};\n\nconst compare = (date1: DateInput, date2: DateInput, options: ParseDateOptions | undefined, predicate: (v1: number, v2: number) => boolean): boolean => {\n  const d1 = DateTime.parse(date1, options);\n  const d2 = DateTime.parse(date2, options);\n  if (!d1 || !d2) {\n    return false;\n  }\n  return predicate(d1.toMillis(), d2.toMillis());\n};\n\n/**\n * 値を日時として解釈し、Date を返す\n * duration / startOf / endOf は inputTimezone のゾーンで計算する\n * 解釈できない値、null / undefined / 空文字は null を返す。タイムゾーンの指定が不正な場合は RangeError をスローする\n *\n * @param {DateInput} value\n * @param {ParseDateOptions} [options]\n * @returns {Date | null}\n */\nexport function parseDate(value: DateInput, options?: ParseDateOptions): Date | null {\n  return DateTime.parse(value, options)?.toDate() ?? null;\n}\n\n/**\n * 値を日時として解釈し、outputTimezone での文字列にする\n * value を省略して options だけを渡した場合は現在時刻を整形する\n * null / undefined / 空文字は空文字を返す。解釈できない値は 'Invalid Date' を返す\n * タイムゾーンの指定が不正な場合は RangeError をスローする\n *\n * @param {DateInput} value\n * @param {FormatDateOptions} [options]\n * @returns {string}\n */\nexport function formatDate(options: FormatDateOptions): string;\nexport function formatDate(value: DateInput, options?: FormatDateOptions): string;\nexport function formatDate(value: DateInput | FormatDateOptions, options?: FormatDateOptions): string {\n  if (typeof value === 'object' && value !== null && !(value instanceof Date) && !(value instanceof DateTime)) {\n    return formatDate(new Date(), value);\n  }\n  if (value == null || value === '') {\n    return '';\n  }\n  const d = DateTime.parse(value, options);\n  if (!d) {\n    return options?.invalidText ?? 'Invalid Date';\n  }\n  const output = d.setZone(options?.outputTimezone ?? DEFAULT_TIMEZONE);\n  return options?.outputFormat ? output.format(options.outputFormat, { locale: options.locale }) : output.toISO();\n}\n\n/**\n * 値が日時として解釈できるか判定する\n *\n * @param {DateInput} value\n * @param {ParseDateOptions} [options]\n * @returns {boolean}\n */\nexport function isValid(value: DateInput, options?: ParseDateOptions): boolean {\n  return DateTime.parse(value, options) != null;\n}\n\n/**\n * date1 と date2 が同じ時刻か判定する。どちらかが解釈できない場合は false\n *\n * @param {DateInput} date1\n * @param {DateInput} date2\n * @param {ParseDateOptions} [options] 両方の値に適用する\n * @returns {boolean}\n */\nexport function isSame(date1: DateInput, date2: DateInput, options?: ParseDateOptions): boolean {\n  return compare(date1, date2, options, (v1, v2) => v1 === v2);\n}\n\n/**\n * date1 が date2 より前の時刻か判定する。どちらかが解釈できない場合は false\n *\n * @param {DateInput} date1\n * @param {DateInput} date2\n * @param {ParseDateOptions} [options] 両方の値に適用する\n * @returns {boolean}\n */\nexport function isBefore(date1: DateInput, date2: DateInput, options?: ParseDateOptions): boolean {\n  return compare(date1, date2, options, (v1, v2) => v1 < v2);\n}\n\n/**\n * date1 が date2 と同じか、より前の時刻か判定する。どちらかが解釈できない場合は false\n *\n * @param {DateInput} date1\n * @param {DateInput} date2\n * @param {ParseDateOptions} [options] 両方の値に適用する\n * @returns {boolean}\n */\nexport function isSameOrBefore(date1: DateInput, date2: DateInput, options?: ParseDateOptions): boolean {\n  return compare(date1, date2, options, (v1, v2) => v1 <= v2);\n}\n\n/**\n * date1 が date2 より後の時刻か判定する。どちらかが解釈できない場合は false\n *\n * @param {DateInput} date1\n * @param {DateInput} date2\n * @param {ParseDateOptions} [options] 両方の値に適用する\n * @returns {boolean}\n */\nexport function isAfter(date1: DateInput, date2: DateInput, options?: ParseDateOptions): boolean {\n  return compare(date1, date2, options, (v1, v2) => v2 < v1);\n}\n\n/**\n * date1 が date2 と同じか、より後の時刻か判定する。どちらかが解釈できない場合は false\n *\n * @param {DateInput} date1\n * @param {DateInput} date2\n * @param {ParseDateOptions} [options] 両方の値に適用する\n * @returns {boolean}\n */\nexport function isSameOrAfter(date1: DateInput, date2: DateInput, options?: ParseDateOptions): boolean {\n  return compare(date1, date2, options, (v1, v2) => v2 <= v1);\n}\n\n/**\n * 値が inputTimezone での今日より前の日付か判定する。解釈できない場合は false\n *\n * @param {DateInput} value\n * @param {ParseDateOptions} [options]\n * @returns {boolean}\n */\nexport function isPastDate(value: DateInput, options?: ParseDateOptions): boolean {\n  const target = DateTime.parse(value, options)?.startOf('day');\n  if (!target) {\n    return false;\n  }\n  const today = DateTime.now(target.timezone).startOf('day');\n  return target.lt(today);\n}\n\n/**\n * 値が現在時刻より前か判定する。解釈できない場合は false\n *\n * @param {DateInput} value\n * @param {ParseDateOptions} [options]\n * @returns {boolean}\n */\nexport function isPastDateTime(value: DateInput, options?: ParseDateOptions): boolean {\n  const target = DateTime.parse(value, options);\n  return target != null && target.toMillis() < Date.now();\n}\n\n/**\n * date1 − date2 を unit の単位で返す\n * 両方を inputTimezone で unit の始まりに切り捨ててから差を取るため、暦の上での差になる(23:00 と翌 01:00 の days は 1)\n * どちらかが解釈できない場合は NaN を返す\n *\n * @param {DateInput} date1\n * @param {DateInput} date2\n * @param {TimeUnit} unit\n * @param {ParseDateOptions} [options] 両方の値に適用する\n * @returns {number}\n */\nexport function diff(date1: DateInput, date2: DateInput, unit: TimeUnit, options?: ParseDateOptions): number {\n  const d1 = DateTime.parse(date1, options);\n  const d2 = DateTime.parse(date2, options);\n  if (!d1 || !d2) {\n    return NaN;\n  }\n  return d1.diff(d2, unit);\n}\n\n/**\n * 現在時刻を timezone での 'yyyy-MM-ddTHH:mm:ss.SSS+HH:mm' 形式の文字列で返す\n *\n * @param {string} [timezone] IANA名。既定は 'UTC'\n * @returns {string}\n */\nexport function currentTimestamp(timezone: string = DEFAULT_TIMEZONE): string {\n  return DateTime.now(timezone).format(TIMESTAMP_FORMAT);\n}\n\n/**\n * Excelの日付シリアル値を epoch ミリ秒に変換する\n * Excelの日付シリアル値はゾーンの概念を持たないため、そのままではUTCの日時として変換される\n * シリアル値がどのゾーンの日時かが分かっている場合は offset に時間差を指定する\n *\n * @example\n *   convertExcelDateSerialToUnixTimeSerial(45200);                 // 1696118400000 (2023-10-01T00:00:00Z)\n *   convertExcelDateSerialToUnixTimeSerial(45200, { offset: 9 }); // 1696086000000 (2023-10-01T00:00:00+09:00)\n *\n * @param {number} excelDateSerial\n * @param {*} [options]\n *   └ offset シリアル値のゾーンのUTCからの時間差(時)\n * @returns {number}\n */\nexport function convertExcelDateSerialToUnixTimeSerial(excelDateSerial: number, options?: {\n  offset: number;\n}): number {\n  let timeserial = (excelDateSerial - EXCEL_EPOCH_SERIAL) * MILLISECONDS_PER_DAY;\n  if (options?.offset) {\n    timeserial -= options.offset * MILLISECONDS_PER_HOUR;\n  }\n  return timeserial;\n}\n\n/**\n * timezone が at の時点で夏時間かどうかを返す\n * at を省略した場合は現在時刻で判定する。at が解釈できない場合は false を返す\n * タイムゾーンの指定が不正な場合は RangeError をスローする\n *\n * @param {string} timezone IANA名\n * @param {DateInput} [at] 判定する時点\n * @returns {boolean}\n */\nexport function isInDST(timezone: string, at?: DateInput): boolean {\n  const d = at === undefined ? DateTime.now(timezone) : DateTime.parse(at)?.setZone(timezone);\n  return d?.isInDST ?? false;\n}\n\n/**\n * タイムゾーンの略称を返す。夏時間の期間中は夏時間の略称を返す\n * 既定の表にない場合は null を返す。表は options.abbreviations で追加・上書きできる\n *\n * @param {string} timezone IANA名\n * @param {TimezoneAbbrOptions} [options]\n * @returns {string | null}\n */\nexport function getTimezoneAbbr(timezone: string, options?: TimezoneAbbrOptions): string | null {\n  const definition = { ...DEFAULT_TIMEZONE_ABBREVIATIONS, ...options?.abbreviations }[timezone];\n  if (!definition) {\n    return null;\n  }\n  if (definition.daylight) {\n    const d = DateTime.parse(options?.at ?? new Date())?.setZone(timezone);\n    if (d?.isInDST) {\n      return definition.daylight;\n    }\n  }\n  return definition.standard;\n}\n\n/**\n * 文字列中の 'GMT+9' のようなオフセット表記を、timezone の略称に置き換える\n * 略称が解決できない場合は文字列をそのまま返す\n *\n * @param {string} text\n * @param {string} timezone IANA名\n * @param {TimezoneAbbrOptions} [options]\n * @returns {string}\n */\nexport function applyTimezoneAbbr(text: string, timezone: string, options?: TimezoneAbbrOptions): string {\n  const abbr = getTimezoneAbbr(timezone, options);\n  return abbr == null ? text : text.replace(GMT_OFFSET, abbr);\n}\n"],"names":["DEFAULT_TIMEZONE","TIMESTAMP_FORMAT","EXCEL_EPOCH_SERIAL","MILLISECONDS_PER_DAY","MILLISECONDS_PER_HOUR","GMT_OFFSET","DEFAULT_TIMEZONE_ABBREVIATIONS","compare","date1","date2","options","predicate","d1","DateTime","d2","parseDate","value","formatDate","d","output","isValid","isSame","v1","v2","isBefore","isSameOrBefore","isAfter","isSameOrAfter","isPastDate","target","today","isPastDateTime","diff","unit","currentTimestamp","timezone","convertExcelDateSerialToUnixTimeSerial","excelDateSerial","timeserial","isInDST","at","getTimezoneAbbr","definition","applyTimezoneAbbr","text","abbr"],"mappings":"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"}

package/lib/date-util-C581gVKx.js

@@ -0,0 +1,140 @@
+import { DateTime as s } from "./date-time.js";
+const o = "UTC", u = "yyyy-MM-dd'T'HH:mm:ss.SSSZZ", l = 25569, f = 1440 * 60 * 1e3, S = 3600 * 1e3, E = /GMT[+-]\d{1,2}(:\d{2})?/g, A = {
+  UTC: { standard: "UTC" },
+  "Asia/Tokyo": { standard: "JST" },
+  "Asia/Seoul": { standard: "KST" },
+  "Asia/Shanghai": { standard: "CST" },
+  "Asia/Hong_Kong": { standard: "HKT" },
+  "Asia/Taipei": { standard: "CST" },
+  "Asia/Singapore": { standard: "SGT" },
+  "Asia/Manila": { standard: "PHT" },
+  "Asia/Bangkok": { standard: "ICT" },
+  "Asia/Ho_Chi_Minh": { standard: "ICT" },
+  "Asia/Jakarta": { standard: "WIB" },
+  "Asia/Kolkata": { standard: "IST" },
+  "Asia/Dubai": { standard: "GST" },
+  "Australia/Sydney": { standard: "AEST", daylight: "AEDT" },
+  "Pacific/Auckland": { standard: "NZST", daylight: "NZDT" },
+  "Europe/London": { standard: "GMT", daylight: "BST" },
+  "Europe/Paris": { standard: "CET", daylight: "CEST" },
+  "Europe/Berlin": { standard: "CET", daylight: "CEST" },
+  "Europe/Madrid": { standard: "CET", daylight: "CEST" },
+  "Europe/Rome": { standard: "CET", daylight: "CEST" },
+  "Europe/Amsterdam": { standard: "CET", daylight: "CEST" },
+  "America/New_York": { standard: "EST", daylight: "EDT" },
+  "America/Toronto": { standard: "EST", daylight: "EDT" },
+  "America/Chicago": { standard: "CST", daylight: "CDT" },
+  "America/Denver": { standard: "MST", daylight: "MDT" },
+  "America/Phoenix": { standard: "MST" },
+  "America/Los_Angeles": { standard: "PST", daylight: "PDT" },
+  "America/Vancouver": { standard: "PST", daylight: "PDT" },
+  "America/Mexico_City": { standard: "CST" },
+  "America/Sao_Paulo": { standard: "BRT" }
+}, d = (a, t, n, r) => {
+  const e = s.parse(a, n), i = s.parse(t, n);
+  return !e || !i ? !1 : r(e.toMillis(), i.toMillis());
+};
+function m(a, t) {
+  return s.parse(a, t)?.toDate() ?? null;
+}
+function T(a, t) {
+  if (typeof a == "object" && a !== null && !(a instanceof Date) && !(a instanceof s))
+    return T(/* @__PURE__ */ new Date(), a);
+  if (a == null || a === "")
+    return "";
+  const n = s.parse(a, t);
+  if (!n)
+    return t?.invalidText ?? "Invalid Date";
+  const r = n.setZone(t?.outputTimezone ?? o);
+  return t?.outputFormat ? r.format(t.outputFormat, { locale: t.locale }) : r.toISO();
+}
+function y(a, t) {
+  return s.parse(a, t) != null;
+}
+function g(a, t, n) {
+  return d(a, t, n, (r, e) => r === e);
+}
+function D(a, t, n) {
+  return d(a, t, n, (r, e) => r < e);
+}
+function C(a, t, n) {
+  return d(a, t, n, (r, e) => r <= e);
+}
+function p(a, t, n) {
+  return d(a, t, n, (r, e) => e < r);
+}
+function h(a, t, n) {
+  return d(a, t, n, (r, e) => e <= r);
+}
+function M(a, t) {
+  const n = s.parse(a, t)?.startOf("day");
+  if (!n)
+    return !1;
+  const r = s.now(n.timezone).startOf("day");
+  return n.lt(r);
+}
+function _(a, t) {
+  const n = s.parse(a, t);
+  return n != null && n.toMillis() < Date.now();
+}
+function I(a, t, n, r) {
+  const e = s.parse(a, r), i = s.parse(t, r);
+  return !e || !i ? NaN : e.diff(i, n);
+}
+function O(a = o) {
+  return s.now(a).format(u);
+}
+function P(a, t) {
+  let n = (a - l) * f;
+  return t?.offset && (n -= t.offset * S), n;
+}
+function b(a, t) {
+  return (t === void 0 ? s.now(a) : s.parse(t)?.setZone(a))?.isInDST ?? !1;
+}
+function c(a, t) {
+  const n = { ...A, ...t?.abbreviations }[a];
+  return n ? n.daylight && s.parse(t?.at ?? /* @__PURE__ */ new Date())?.setZone(a)?.isInDST ? n.daylight : n.standard : null;
+}
+function L(a, t, n) {
+  const r = c(t, n);
+  return r == null ? a : a.replace(E, r);
+}
+const B = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  applyTimezoneAbbr: L,
+  convertExcelDateSerialToUnixTimeSerial: P,
+  currentTimestamp: O,
+  diff: I,
+  formatDate: T,
+  getTimezoneAbbr: c,
+  isAfter: p,
+  isBefore: D,
+  isInDST: b,
+  isPastDate: M,
+  isPastDateTime: _,
+  isSame: g,
+  isSameOrAfter: h,
+  isSameOrBefore: C,
+  isValid: y,
+  parseDate: m
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  L as a,
+  O as b,
+  P as c,
+  B as d,
+  I as e,
+  T as f,
+  c as g,
+  D as h,
+  p as i,
+  b as j,
+  M as k,
+  _ as l,
+  g as m,
+  h as n,
+  C as o,
+  y as p,
+  m as q
+};
+//# sourceMappingURL=date-util-C581gVKx.js.map

package/lib/date-util-C581gVKx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-util-C581gVKx.js","sources":["../src/date-util.ts"],"sourcesContent":["import { DateTime } from './date-time';\n\n/**\n * 日時として解釈する値。string はISO形式または inputFormat の書式、number は epoch ミリ秒\n * DateTime は inputTimezone を省略した場合、その DateTime のタイムゾーンで扱う\n */\nexport type DateInput = string | Date | number | DateTime | null | undefined;\n\n/** 日時の切り捨て(startOf / endOf)に使う単位 */\nexport type DateUnit = 'year' | 'quarter' | 'month' | 'week' | 'day' | 'hour' | 'minute' | 'second' | 'millisecond';\n\n/** 期間の単位 */\nexport type TimeUnit = 'milliseconds' | 'seconds' | 'minutes' | 'hours' | 'days' | 'months' | 'years';\n\n/** 日時の加算・減算に使う期間。負の値で減算になる */\nexport interface Duration {\n  years?: number;\n  quarters?: number;\n  months?: number;\n  weeks?: number;\n  days?: number;\n  hours?: number;\n  minutes?: number;\n  seconds?: number;\n  milliseconds?: number;\n}\n\n/**\n * 日時を解釈するときのオプション\n */\nexport interface ParseDateOptions {\n  /** 入力の書式。配列の場合は先頭から順に試す。いずれにも一致しない場合はISO形式として解釈する */\n  inputFormat?: string | string[];\n  /** ゾーン情報を含まない入力をどのタイムゾーンの日時とみなすか(IANA名)。既定は 'UTC' */\n  inputTimezone?: string;\n  /** 解釈した日時に加算する期間。startOf / endOf より先に適用する */\n  duration?: Duration;\n  /** 指定した単位の最初の時点に切り捨てる(month なら月初の00:00:00.000) */\n  startOf?: DateUnit;\n  /** 指定した単位の最後の時点に切り上げる(month なら月末の23:59:59.999) */\n  endOf?: DateUnit;\n  /** 書式の月名・曜日名を解釈・出力するときのロケール。既定は 'en-US' */\n  locale?: string;\n}\n\n/**\n * 日時を文字列にするときのオプション\n */\nexport interface FormatDateOptions extends ParseDateOptions {\n  /** 出力の書式。省略時はISO形式 */\n  outputFormat?: string;\n  /** 出力に使うタイムゾーン(IANA名)。既定は 'UTC' */\n  outputTimezone?: string;\n  /** 日時として解釈できない値に対する出力。既定は 'Invalid Date' */\n  invalidText?: string;\n}\n\n/** タイムゾーンの略称。夏時間のないタイムゾーンでは daylight を持たない */\nexport interface TimezoneAbbreviation {\n  standard: string;\n  daylight?: string;\n}\n\n/** IANA名をキーにしたタイムゾーンの略称の表 */\nexport type TimezoneAbbreviations = Record<string, TimezoneAbbreviation>;\n\n/**\n * タイムゾーンの略称を解決するときのオプション\n */\nexport interface TimezoneAbbrOptions {\n  /** 夏時間かどうかを判定する時点。既定は現在時刻 */\n  at?: Date;\n  /** 既定の表に追加・上書きする略称 */\n  abbreviations?: TimezoneAbbreviations;\n}\n\nconst DEFAULT_TIMEZONE = 'UTC';\n\nconst TIMESTAMP_FORMAT = `yyyy-MM-dd'T'HH:mm:ss.SSSZZ`;\n\n/** 1970-01-01 を表すExcelの日付シリアル値 */\nconst EXCEL_EPOCH_SERIAL = 25569;\n\nconst MILLISECONDS_PER_DAY = 24 * 60 * 60 * 1000;\n\nconst MILLISECONDS_PER_HOUR = 60 * 60 * 1000;\n\nconst GMT_OFFSET = /GMT[+-]\\d{1,2}(:\\d{2})?/g;\n\n/**\n * 略称の既定の表。略称は世界で一意ではないため(CST は米国中部・中国などで使われる)、このライブラリが採用する表記である\n */\nconst DEFAULT_TIMEZONE_ABBREVIATIONS: TimezoneAbbreviations = {\n  'UTC': { standard: 'UTC' },\n  'Asia/Tokyo': { standard: 'JST' },\n  'Asia/Seoul': { standard: 'KST' },\n  'Asia/Shanghai': { standard: 'CST' },\n  'Asia/Hong_Kong': { standard: 'HKT' },\n  'Asia/Taipei': { standard: 'CST' },\n  'Asia/Singapore': { standard: 'SGT' },\n  'Asia/Manila': { standard: 'PHT' },\n  'Asia/Bangkok': { standard: 'ICT' },\n  'Asia/Ho_Chi_Minh': { standard: 'ICT' },\n  'Asia/Jakarta': { standard: 'WIB' },\n  'Asia/Kolkata': { standard: 'IST' },\n  'Asia/Dubai': { standard: 'GST' },\n  'Australia/Sydney': { standard: 'AEST', daylight: 'AEDT' },\n  'Pacific/Auckland': { standard: 'NZST', daylight: 'NZDT' },\n  'Europe/London': { standard: 'GMT', daylight: 'BST' },\n  'Europe/Paris': { standard: 'CET', daylight: 'CEST' },\n  'Europe/Berlin': { standard: 'CET', daylight: 'CEST' },\n  'Europe/Madrid': { standard: 'CET', daylight: 'CEST' },\n  'Europe/Rome': { standard: 'CET', daylight: 'CEST' },\n  'Europe/Amsterdam': { standard: 'CET', daylight: 'CEST' },\n  'America/New_York': { standard: 'EST', daylight: 'EDT' },\n  'America/Toronto': { standard: 'EST', daylight: 'EDT' },\n  'America/Chicago': { standard: 'CST', daylight: 'CDT' },\n  'America/Denver': { standard: 'MST', daylight: 'MDT' },\n  'America/Phoenix': { standard: 'MST' },\n  'America/Los_Angeles': { standard: 'PST', daylight: 'PDT' },\n  'America/Vancouver': { standard: 'PST', daylight: 'PDT' },\n  'America/Mexico_City': { standard: 'CST' },\n  'America/Sao_Paulo': { standard: 'BRT' }\n};\n\nconst compare = (date1: DateInput, date2: DateInput, options: ParseDateOptions | undefined, predicate: (v1: number, v2: number) => boolean): boolean => {\n  const d1 = DateTime.parse(date1, options);\n  const d2 = DateTime.parse(date2, options);\n  if (!d1 || !d2) {\n    return false;\n  }\n  return predicate(d1.toMillis(), d2.toMillis());\n};\n\n/**\n * 値を日時として解釈し、Date を返す\n * duration / startOf / endOf は inputTimezone のゾーンで計算する\n * 解釈できない値、null / undefined / 空文字は null を返す。タイムゾーンの指定が不正な場合は RangeError をスローする\n *\n * @param {DateInput} value\n * @param {ParseDateOptions} [options]\n * @returns {Date | null}\n */\nexport function parseDate(value: DateInput, options?: ParseDateOptions): Date | null {\n  return DateTime.parse(value, options)?.toDate() ?? null;\n}\n\n/**\n * 値を日時として解釈し、outputTimezone での文字列にする\n * value を省略して options だけを渡した場合は現在時刻を整形する\n * null / undefined / 空文字は空文字を返す。解釈できない値は 'Invalid Date' を返す\n * タイムゾーンの指定が不正な場合は RangeError をスローする\n *\n * @param {DateInput} value\n * @param {FormatDateOptions} [options]\n * @returns {string}\n */\nexport function formatDate(options: FormatDateOptions): string;\nexport function formatDate(value: DateInput, options?: FormatDateOptions): string;\nexport function formatDate(value: DateInput | FormatDateOptions, options?: FormatDateOptions): string {\n  if (typeof value === 'object' && value !== null && !(value instanceof Date) && !(value instanceof DateTime)) {\n    return formatDate(new Date(), value);\n  }\n  if (value == null || value === '') {\n    return '';\n  }\n  const d = DateTime.parse(value, options);\n  if (!d) {\n    return options?.invalidText ?? 'Invalid Date';\n  }\n  const output = d.setZone(options?.outputTimezone ?? DEFAULT_TIMEZONE);\n  return options?.outputFormat ? output.format(options.outputFormat, { locale: options.locale }) : output.toISO();\n}\n\n/**\n * 値が日時として解釈できるか判定する\n *\n * @param {DateInput} value\n * @param {ParseDateOptions} [options]\n * @returns {boolean}\n */\nexport function isValid(value: DateInput, options?: ParseDateOptions): boolean {\n  return DateTime.parse(value, options) != null;\n}\n\n/**\n * date1 と date2 が同じ時刻か判定する。どちらかが解釈できない場合は false\n *\n * @param {DateInput} date1\n * @param {DateInput} date2\n * @param {ParseDateOptions} [options] 両方の値に適用する\n * @returns {boolean}\n */\nexport function isSame(date1: DateInput, date2: DateInput, options?: ParseDateOptions): boolean {\n  return compare(date1, date2, options, (v1, v2) => v1 === v2);\n}\n\n/**\n * date1 が date2 より前の時刻か判定する。どちらかが解釈できない場合は false\n *\n * @param {DateInput} date1\n * @param {DateInput} date2\n * @param {ParseDateOptions} [options] 両方の値に適用する\n * @returns {boolean}\n */\nexport function isBefore(date1: DateInput, date2: DateInput, options?: ParseDateOptions): boolean {\n  return compare(date1, date2, options, (v1, v2) => v1 < v2);\n}\n\n/**\n * date1 が date2 と同じか、より前の時刻か判定する。どちらかが解釈できない場合は false\n *\n * @param {DateInput} date1\n * @param {DateInput} date2\n * @param {ParseDateOptions} [options] 両方の値に適用する\n * @returns {boolean}\n */\nexport function isSameOrBefore(date1: DateInput, date2: DateInput, options?: ParseDateOptions): boolean {\n  return compare(date1, date2, options, (v1, v2) => v1 <= v2);\n}\n\n/**\n * date1 が date2 より後の時刻か判定する。どちらかが解釈できない場合は false\n *\n * @param {DateInput} date1\n * @param {DateInput} date2\n * @param {ParseDateOptions} [options] 両方の値に適用する\n * @returns {boolean}\n */\nexport function isAfter(date1: DateInput, date2: DateInput, options?: ParseDateOptions): boolean {\n  return compare(date1, date2, options, (v1, v2) => v2 < v1);\n}\n\n/**\n * date1 が date2 と同じか、より後の時刻か判定する。どちらかが解釈できない場合は false\n *\n * @param {DateInput} date1\n * @param {DateInput} date2\n * @param {ParseDateOptions} [options] 両方の値に適用する\n * @returns {boolean}\n */\nexport function isSameOrAfter(date1: DateInput, date2: DateInput, options?: ParseDateOptions): boolean {\n  return compare(date1, date2, options, (v1, v2) => v2 <= v1);\n}\n\n/**\n * 値が inputTimezone での今日より前の日付か判定する。解釈できない場合は false\n *\n * @param {DateInput} value\n * @param {ParseDateOptions} [options]\n * @returns {boolean}\n */\nexport function isPastDate(value: DateInput, options?: ParseDateOptions): boolean {\n  const target = DateTime.parse(value, options)?.startOf('day');\n  if (!target) {\n    return false;\n  }\n  const today = DateTime.now(target.timezone).startOf('day');\n  return target.lt(today);\n}\n\n/**\n * 値が現在時刻より前か判定する。解釈できない場合は false\n *\n * @param {DateInput} value\n * @param {ParseDateOptions} [options]\n * @returns {boolean}\n */\nexport function isPastDateTime(value: DateInput, options?: ParseDateOptions): boolean {\n  const target = DateTime.parse(value, options);\n  return target != null && target.toMillis() < Date.now();\n}\n\n/**\n * date1 − date2 を unit の単位で返す\n * 両方を inputTimezone で unit の始まりに切り捨ててから差を取るため、暦の上での差になる(23:00 と翌 01:00 の days は 1)\n * どちらかが解釈できない場合は NaN を返す\n *\n * @param {DateInput} date1\n * @param {DateInput} date2\n * @param {TimeUnit} unit\n * @param {ParseDateOptions} [options] 両方の値に適用する\n * @returns {number}\n */\nexport function diff(date1: DateInput, date2: DateInput, unit: TimeUnit, options?: ParseDateOptions): number {\n  const d1 = DateTime.parse(date1, options);\n  const d2 = DateTime.parse(date2, options);\n  if (!d1 || !d2) {\n    return NaN;\n  }\n  return d1.diff(d2, unit);\n}\n\n/**\n * 現在時刻を timezone での 'yyyy-MM-ddTHH:mm:ss.SSS+HH:mm' 形式の文字列で返す\n *\n * @param {string} [timezone] IANA名。既定は 'UTC'\n * @returns {string}\n */\nexport function currentTimestamp(timezone: string = DEFAULT_TIMEZONE): string {\n  return DateTime.now(timezone).format(TIMESTAMP_FORMAT);\n}\n\n/**\n * Excelの日付シリアル値を epoch ミリ秒に変換する\n * Excelの日付シリアル値はゾーンの概念を持たないため、そのままではUTCの日時として変換される\n * シリアル値がどのゾーンの日時かが分かっている場合は offset に時間差を指定する\n *\n * @example\n *   convertExcelDateSerialToUnixTimeSerial(45200);                 // 1696118400000 (2023-10-01T00:00:00Z)\n *   convertExcelDateSerialToUnixTimeSerial(45200, { offset: 9 }); // 1696086000000 (2023-10-01T00:00:00+09:00)\n *\n * @param {number} excelDateSerial\n * @param {*} [options]\n *   └ offset シリアル値のゾーンのUTCからの時間差(時)\n * @returns {number}\n */\nexport function convertExcelDateSerialToUnixTimeSerial(excelDateSerial: number, options?: {\n  offset: number;\n}): number {\n  let timeserial = (excelDateSerial - EXCEL_EPOCH_SERIAL) * MILLISECONDS_PER_DAY;\n  if (options?.offset) {\n    timeserial -= options.offset * MILLISECONDS_PER_HOUR;\n  }\n  return timeserial;\n}\n\n/**\n * timezone が at の時点で夏時間かどうかを返す\n * at を省略した場合は現在時刻で判定する。at が解釈できない場合は false を返す\n * タイムゾーンの指定が不正な場合は RangeError をスローする\n *\n * @param {string} timezone IANA名\n * @param {DateInput} [at] 判定する時点\n * @returns {boolean}\n */\nexport function isInDST(timezone: string, at?: DateInput): boolean {\n  const d = at === undefined ? DateTime.now(timezone) : DateTime.parse(at)?.setZone(timezone);\n  return d?.isInDST ?? false;\n}\n\n/**\n * タイムゾーンの略称を返す。夏時間の期間中は夏時間の略称を返す\n * 既定の表にない場合は null を返す。表は options.abbreviations で追加・上書きできる\n *\n * @param {string} timezone IANA名\n * @param {TimezoneAbbrOptions} [options]\n * @returns {string | null}\n */\nexport function getTimezoneAbbr(timezone: string, options?: TimezoneAbbrOptions): string | null {\n  const definition = { ...DEFAULT_TIMEZONE_ABBREVIATIONS, ...options?.abbreviations }[timezone];\n  if (!definition) {\n    return null;\n  }\n  if (definition.daylight) {\n    const d = DateTime.parse(options?.at ?? new Date())?.setZone(timezone);\n    if (d?.isInDST) {\n      return definition.daylight;\n    }\n  }\n  return definition.standard;\n}\n\n/**\n * 文字列中の 'GMT+9' のようなオフセット表記を、timezone の略称に置き換える\n * 略称が解決できない場合は文字列をそのまま返す\n *\n * @param {string} text\n * @param {string} timezone IANA名\n * @param {TimezoneAbbrOptions} [options]\n * @returns {string}\n */\nexport function applyTimezoneAbbr(text: string, timezone: string, options?: TimezoneAbbrOptions): string {\n  const abbr = getTimezoneAbbr(timezone, options);\n  return abbr == null ? text : text.replace(GMT_OFFSET, abbr);\n}\n"],"names":["DEFAULT_TIMEZONE","TIMESTAMP_FORMAT","EXCEL_EPOCH_SERIAL","MILLISECONDS_PER_DAY","MILLISECONDS_PER_HOUR","GMT_OFFSET","DEFAULT_TIMEZONE_ABBREVIATIONS","compare","date1","date2","options","predicate","d1","DateTime","d2","parseDate","value","formatDate","d","output","isValid","isSame","v1","v2","isBefore","isSameOrBefore","isAfter","isSameOrAfter","isPastDate","target","today","isPastDateTime","diff","unit","currentTimestamp","timezone","convertExcelDateSerialToUnixTimeSerial","excelDateSerial","timeserial","isInDST","at","getTimezoneAbbr","definition","applyTimezoneAbbr","text","abbr"],"mappings":"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"}

package/lib/date-util.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require("luxon");const e=require("./date-util-b1Lw7Nyu.cjs");exports.applyTimezoneAbbr=e.applyTimezoneAbbr;exports.convertExcelDateSerialToUnixTimeSerial=e.convertExcelDateSerialToUnixTimeSerial;exports.convertTimeUnit=e.convertTimeUnit;exports.currentTimestamp=e.currentTimestamp;exports.diff=e.diff;exports.formatDate=e.formatDate;exports.getTimezoneAbbr=e.getTimezoneAbbr;exports.isAfter=e.isAfter;exports.isBefore=e.isBefore;exports.isInDST=e.isInDST;exports.isPastDate=e.isPastDate;exports.isPastDateTime=e.isPastDateTime;exports.isSame=e.isSame;exports.isSameOrAfter=e.isSameOrAfter;exports.isSameOrBefore=e.isSameOrBefore;exports.isValid=e.isValid;exports.parseDate=e.parseDate;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require("./date-time.cjs");const e=require("./date-util-ByW86YIS.cjs");exports.applyTimezoneAbbr=e.applyTimezoneAbbr;exports.convertExcelDateSerialToUnixTimeSerial=e.convertExcelDateSerialToUnixTimeSerial;exports.currentTimestamp=e.currentTimestamp;exports.diff=e.diff;exports.formatDate=e.formatDate;exports.getTimezoneAbbr=e.getTimezoneAbbr;exports.isAfter=e.isAfter;exports.isBefore=e.isBefore;exports.isInDST=e.isInDST;exports.isPastDate=e.isPastDate;exports.isPastDateTime=e.isPastDateTime;exports.isSame=e.isSame;exports.isSameOrAfter=e.isSameOrAfter;exports.isSameOrBefore=e.isSameOrBefore;exports.isValid=e.isValid;exports.parseDate=e.parseDate;
 //# sourceMappingURL=date-util.cjs.map

package/lib/date-util.d.cts

@@ -1,5 +1,9 @@
-/** 日時として解釈する値。string はISO形式または inputFormat の書式、number は epoch ミリ秒 */
-export type DateInput = string | Date | number | null | undefined;
+import { DateTime } from './date-time.cjs';
+/**
+ * 日時として解釈する値。string はISO形式または inputFormat の書式、number は epoch ミリ秒
+ * DateTime は inputTimezone を省略した場合、その DateTime のタイムゾーンで扱う
+ */
+export type DateInput = string | Date | number | DateTime | null | undefined;
 /** 日時の切り捨て(startOf / endOf)に使う単位 */
 export type DateUnit = 'year' | 'quarter' | 'month' | 'week' | 'day' | 'hour' | 'minute' | 'second' | 'millisecond';
 /** 期間の単位 */
@@ -30,6 +34,8 @@ export interface ParseDateOptions {
     startOf?: DateUnit;
     /** 指定した単位の最後の時点に切り上げる(month なら月末の23:59:59.999) */
     endOf?: DateUnit;
+    /** 書式の月名・曜日名を解釈・出力するときのロケール。既定は 'en-US' */
+    locale?: string;
 }
 /**
  * 日時を文字列にするときのオプション
@@ -185,19 +191,6 @@ export declare function currentTimestamp(timezone?: string): string;
 export declare function convertExcelDateSerialToUnixTimeSerial(excelDateSerial: number, options?: {
     offset: number;
 }): number;
-/**
- * 期間の値を別の単位に換算する
- * 月と年は固定長(1か月 = 30日、1年 = 365日)として換算する
- *
- * @example
- *   convertTimeUnit(1, 'hours', 'milliseconds');   // 3600000
- *
- * @param {number} value
- * @param {TimeUnit} inputUnit
- * @param {TimeUnit} outputUnit
- * @returns {number}
- */
-export declare function convertTimeUnit(value: number, inputUnit: TimeUnit, outputUnit: TimeUnit): number;
 /**
  * timezone が at の時点で夏時間かどうかを返す
  * at を省略した場合は現在時刻で判定する。at が解釈できない場合は false を返す