@digitalwalletcorp/utils 0.2.0 → 0.4.0

package/lib/date-util.d.cts

@@ -0,0 +1,231 @@
+/** 日時として解釈する値。string はISO形式または inputFormat の書式、number は epoch ミリ秒 */
+export type DateInput = string | Date | number | null | undefined;
+/** 日時の切り捨て(startOf / endOf)に使う単位 */
+export type DateUnit = 'year' | 'quarter' | 'month' | 'week' | 'day' | 'hour' | 'minute' | 'second' | 'millisecond';
+/** 期間の単位 */
+export type TimeUnit = 'milliseconds' | 'seconds' | 'minutes' | 'hours' | 'days' | 'months' | 'years';
+/** 日時の加算・減算に使う期間。負の値で減算になる */
+export interface Duration {
+    years?: number;
+    quarters?: number;
+    months?: number;
+    weeks?: number;
+    days?: number;
+    hours?: number;
+    minutes?: number;
+    seconds?: number;
+    milliseconds?: number;
+}
+/**
+ * 日時を解釈するときのオプション
+ */
+export interface ParseDateOptions {
+    /** 入力の書式。配列の場合は先頭から順に試す。いずれにも一致しない場合はISO形式として解釈する */
+    inputFormat?: string | string[];
+    /** ゾーン情報を含まない入力をどのタイムゾーンの日時とみなすか(IANA名)。既定は 'UTC' */
+    inputTimezone?: string;
+    /** 解釈した日時に加算する期間。startOf / endOf より先に適用する */
+    duration?: Duration;
+    /** 指定した単位の最初の時点に切り捨てる(month なら月初の00:00:00.000) */
+    startOf?: DateUnit;
+    /** 指定した単位の最後の時点に切り上げる(month なら月末の23:59:59.999) */
+    endOf?: DateUnit;
+}
+/**
+ * 日時を文字列にするときのオプション
+ */
+export interface FormatDateOptions extends ParseDateOptions {
+    /** 出力の書式。省略時はISO形式 */
+    outputFormat?: string;
+    /** 出力に使うタイムゾーン(IANA名)。既定は 'UTC' */
+    outputTimezone?: string;
+    /** 日時として解釈できない値に対する出力。既定は 'Invalid Date' */
+    invalidText?: string;
+}
+/** タイムゾーンの略称。夏時間のないタイムゾーンでは daylight を持たない */
+export interface TimezoneAbbreviation {
+    standard: string;
+    daylight?: string;
+}
+/** IANA名をキーにしたタイムゾーンの略称の表 */
+export type TimezoneAbbreviations = Record<string, TimezoneAbbreviation>;
+/**
+ * タイムゾーンの略称を解決するときのオプション
+ */
+export interface TimezoneAbbrOptions {
+    /** 夏時間かどうかを判定する時点。既定は現在時刻 */
+    at?: Date;
+    /** 既定の表に追加・上書きする略称 */
+    abbreviations?: TimezoneAbbreviations;
+}
+/**
+ * 値を日時として解釈し、Date を返す
+ * duration / startOf / endOf は inputTimezone のゾーンで計算する
+ * 解釈できない値、null / undefined / 空文字は null を返す。タイムゾーンの指定が不正な場合は RangeError をスローする
+ *
+ * @param {DateInput} value
+ * @param {ParseDateOptions} [options]
+ * @returns {Date | null}
+ */
+export declare function parseDate(value: DateInput, options?: ParseDateOptions): Date | null;
+/**
+ * 値を日時として解釈し、outputTimezone での文字列にする
+ * null / undefined / 空文字は空文字を返す。解釈できない値は invalidText(既定 'Invalid Date')を返す
+ * タイムゾーンの指定が不正な場合は RangeError をスローする
+ *
+ * @param {DateInput} value
+ * @param {FormatDateOptions} [options]
+ * @returns {string}
+ */
+export declare function formatDate(value: DateInput, options?: FormatDateOptions): string;
+/**
+ * 値が日時として解釈できるか判定する
+ *
+ * @param {DateInput} value
+ * @param {ParseDateOptions} [options]
+ * @returns {boolean}
+ */
+export declare function isValid(value: DateInput, options?: ParseDateOptions): boolean;
+/**
+ * date1 と date2 が同じ時刻か判定する。どちらかが解釈できない場合は false
+ *
+ * @param {DateInput} date1
+ * @param {DateInput} date2
+ * @param {ParseDateOptions} [options] 両方の値に適用する
+ * @returns {boolean}
+ */
+export declare function isSame(date1: DateInput, date2: DateInput, options?: ParseDateOptions): boolean;
+/**
+ * date1 が date2 より前の時刻か判定する。どちらかが解釈できない場合は false
+ *
+ * @param {DateInput} date1
+ * @param {DateInput} date2
+ * @param {ParseDateOptions} [options] 両方の値に適用する
+ * @returns {boolean}
+ */
+export declare function isBefore(date1: DateInput, date2: DateInput, options?: ParseDateOptions): boolean;
+/**
+ * date1 が date2 と同じか、より前の時刻か判定する。どちらかが解釈できない場合は false
+ *
+ * @param {DateInput} date1
+ * @param {DateInput} date2
+ * @param {ParseDateOptions} [options] 両方の値に適用する
+ * @returns {boolean}
+ */
+export declare function isSameOrBefore(date1: DateInput, date2: DateInput, options?: ParseDateOptions): boolean;
+/**
+ * date1 が date2 より後の時刻か判定する。どちらかが解釈できない場合は false
+ *
+ * @param {DateInput} date1
+ * @param {DateInput} date2
+ * @param {ParseDateOptions} [options] 両方の値に適用する
+ * @returns {boolean}
+ */
+export declare function isAfter(date1: DateInput, date2: DateInput, options?: ParseDateOptions): boolean;
+/**
+ * date1 が date2 と同じか、より後の時刻か判定する。どちらかが解釈できない場合は false
+ *
+ * @param {DateInput} date1
+ * @param {DateInput} date2
+ * @param {ParseDateOptions} [options] 両方の値に適用する
+ * @returns {boolean}
+ */
+export declare function isSameOrAfter(date1: DateInput, date2: DateInput, options?: ParseDateOptions): boolean;
+/**
+ * 値が inputTimezone での今日より前の日付か判定する。解釈できない場合は false
+ *
+ * @param {DateInput} value
+ * @param {ParseDateOptions} [options]
+ * @returns {boolean}
+ */
+export declare function isPastDate(value: DateInput, options?: ParseDateOptions): boolean;
+/**
+ * 値が現在時刻より前か判定する。解釈できない場合は false
+ *
+ * @param {DateInput} value
+ * @param {ParseDateOptions} [options]
+ * @returns {boolean}
+ */
+export declare function isPastDateTime(value: DateInput, options?: ParseDateOptions): boolean;
+/**
+ * date1 − date2 を unit の単位で返す
+ * 両方を inputTimezone で unit の始まりに切り捨ててから差を取るため、暦の上での差になる(23:00 と翌 01:00 の days は 1)
+ * どちらかが解釈できない場合は NaN を返す
+ *
+ * @param {DateInput} date1
+ * @param {DateInput} date2
+ * @param {TimeUnit} unit
+ * @param {ParseDateOptions} [options] 両方の値に適用する
+ * @returns {number}
+ */
+export declare function diff(date1: DateInput, date2: DateInput, unit: TimeUnit, options?: ParseDateOptions): number;
+/**
+ * timezone での今日の始まりを返す
+ *
+ * @param {string} [timezone] IANA名。既定は 'UTC'
+ * @returns {Date}
+ */
+export declare function currentDate(timezone?: string): Date;
+/**
+ * 現在時刻を返す
+ * Date はタイムゾーンを保持しないため、ゾーンは文字列にする時点(formatDate の outputTimezone)で指定する
+ *
+ * @returns {Date}
+ */
+export declare function currentDateTime(): Date;
+/**
+ * 現在時刻を timezone での 'yyyy-MM-ddTHH:mm:ss.SSS+HH:mm' 形式の文字列で返す
+ *
+ * @param {string} [timezone] IANA名。既定は 'UTC'
+ * @returns {string}
+ */
+export declare function currentTimestamp(timezone?: string): string;
+/**
+ * Excelの日付シリアル値を epoch ミリ秒に変換する
+ * Excelの日付シリアル値はゾーンの概念を持たないため、そのままではUTCの日時として変換される
+ * シリアル値がどのゾーンの日時かが分かっている場合は offset に時間差を指定する
+ *
+ * @example
+ *   convertExcelDateSerialToUnixTimeSerial(45200);                 // 1696118400000 (2023-10-01T00:00:00Z)
+ *   convertExcelDateSerialToUnixTimeSerial(45200, { offset: 9 }); // 1696086000000 (2023-10-01T00:00:00+09:00)
+ *
+ * @param {number} excelDateSerial
+ * @param {*} [options]
+ *   └ offset シリアル値のゾーンのUTCからの時間差(時)
+ * @returns {number}
+ */
+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;
+/**
+ * タイムゾーンの略称を返す。夏時間の期間中は夏時間の略称を返す
+ * 既定の表にない場合は null を返す。表は options.abbreviations で追加・上書きできる
+ *
+ * @param {string} timezone IANA名
+ * @param {TimezoneAbbrOptions} [options]
+ * @returns {string | null}
+ */
+export declare function getTimezoneAbbr(timezone: string, options?: TimezoneAbbrOptions): string | null;
+/**
+ * 文字列中の 'GMT+9' のようなオフセット表記を、timezone の略称に置き換える
+ * 略称が解決できない場合は文字列をそのまま返す
+ *
+ * @param {string} text
+ * @param {string} timezone IANA名
+ * @param {TimezoneAbbrOptions} [options]
+ * @returns {string}
+ */
+export declare function applyTimezoneAbbr(text: string, timezone: string, options?: TimezoneAbbrOptions): string;

package/lib/date-util.d.ts

@@ -0,0 +1,231 @@
+/** 日時として解釈する値。string はISO形式または inputFormat の書式、number は epoch ミリ秒 */
+export type DateInput = string | Date | number | null | undefined;
+/** 日時の切り捨て(startOf / endOf)に使う単位 */
+export type DateUnit = 'year' | 'quarter' | 'month' | 'week' | 'day' | 'hour' | 'minute' | 'second' | 'millisecond';
+/** 期間の単位 */
+export type TimeUnit = 'milliseconds' | 'seconds' | 'minutes' | 'hours' | 'days' | 'months' | 'years';
+/** 日時の加算・減算に使う期間。負の値で減算になる */
+export interface Duration {
+    years?: number;
+    quarters?: number;
+    months?: number;
+    weeks?: number;
+    days?: number;
+    hours?: number;
+    minutes?: number;
+    seconds?: number;
+    milliseconds?: number;
+}
+/**
+ * 日時を解釈するときのオプション
+ */
+export interface ParseDateOptions {
+    /** 入力の書式。配列の場合は先頭から順に試す。いずれにも一致しない場合はISO形式として解釈する */
+    inputFormat?: string | string[];
+    /** ゾーン情報を含まない入力をどのタイムゾーンの日時とみなすか(IANA名)。既定は 'UTC' */
+    inputTimezone?: string;
+    /** 解釈した日時に加算する期間。startOf / endOf より先に適用する */
+    duration?: Duration;
+    /** 指定した単位の最初の時点に切り捨てる(month なら月初の00:00:00.000) */
+    startOf?: DateUnit;
+    /** 指定した単位の最後の時点に切り上げる(month なら月末の23:59:59.999) */
+    endOf?: DateUnit;
+}
+/**
+ * 日時を文字列にするときのオプション
+ */
+export interface FormatDateOptions extends ParseDateOptions {
+    /** 出力の書式。省略時はISO形式 */
+    outputFormat?: string;
+    /** 出力に使うタイムゾーン(IANA名)。既定は 'UTC' */
+    outputTimezone?: string;
+    /** 日時として解釈できない値に対する出力。既定は 'Invalid Date' */
+    invalidText?: string;
+}
+/** タイムゾーンの略称。夏時間のないタイムゾーンでは daylight を持たない */
+export interface TimezoneAbbreviation {
+    standard: string;
+    daylight?: string;
+}
+/** IANA名をキーにしたタイムゾーンの略称の表 */
+export type TimezoneAbbreviations = Record<string, TimezoneAbbreviation>;
+/**
+ * タイムゾーンの略称を解決するときのオプション
+ */
+export interface TimezoneAbbrOptions {
+    /** 夏時間かどうかを判定する時点。既定は現在時刻 */
+    at?: Date;
+    /** 既定の表に追加・上書きする略称 */
+    abbreviations?: TimezoneAbbreviations;
+}
+/**
+ * 値を日時として解釈し、Date を返す
+ * duration / startOf / endOf は inputTimezone のゾーンで計算する
+ * 解釈できない値、null / undefined / 空文字は null を返す。タイムゾーンの指定が不正な場合は RangeError をスローする
+ *
+ * @param {DateInput} value
+ * @param {ParseDateOptions} [options]
+ * @returns {Date | null}
+ */
+export declare function parseDate(value: DateInput, options?: ParseDateOptions): Date | null;
+/**
+ * 値を日時として解釈し、outputTimezone での文字列にする
+ * null / undefined / 空文字は空文字を返す。解釈できない値は invalidText(既定 'Invalid Date')を返す
+ * タイムゾーンの指定が不正な場合は RangeError をスローする
+ *
+ * @param {DateInput} value
+ * @param {FormatDateOptions} [options]
+ * @returns {string}
+ */
+export declare function formatDate(value: DateInput, options?: FormatDateOptions): string;
+/**
+ * 値が日時として解釈できるか判定する
+ *
+ * @param {DateInput} value
+ * @param {ParseDateOptions} [options]
+ * @returns {boolean}
+ */
+export declare function isValid(value: DateInput, options?: ParseDateOptions): boolean;
+/**
+ * date1 と date2 が同じ時刻か判定する。どちらかが解釈できない場合は false
+ *
+ * @param {DateInput} date1
+ * @param {DateInput} date2
+ * @param {ParseDateOptions} [options] 両方の値に適用する
+ * @returns {boolean}
+ */
+export declare function isSame(date1: DateInput, date2: DateInput, options?: ParseDateOptions): boolean;
+/**
+ * date1 が date2 より前の時刻か判定する。どちらかが解釈できない場合は false
+ *
+ * @param {DateInput} date1
+ * @param {DateInput} date2
+ * @param {ParseDateOptions} [options] 両方の値に適用する
+ * @returns {boolean}
+ */
+export declare function isBefore(date1: DateInput, date2: DateInput, options?: ParseDateOptions): boolean;
+/**
+ * date1 が date2 と同じか、より前の時刻か判定する。どちらかが解釈できない場合は false
+ *
+ * @param {DateInput} date1
+ * @param {DateInput} date2
+ * @param {ParseDateOptions} [options] 両方の値に適用する
+ * @returns {boolean}
+ */
+export declare function isSameOrBefore(date1: DateInput, date2: DateInput, options?: ParseDateOptions): boolean;
+/**
+ * date1 が date2 より後の時刻か判定する。どちらかが解釈できない場合は false
+ *
+ * @param {DateInput} date1
+ * @param {DateInput} date2
+ * @param {ParseDateOptions} [options] 両方の値に適用する
+ * @returns {boolean}
+ */
+export declare function isAfter(date1: DateInput, date2: DateInput, options?: ParseDateOptions): boolean;
+/**
+ * date1 が date2 と同じか、より後の時刻か判定する。どちらかが解釈できない場合は false
+ *
+ * @param {DateInput} date1
+ * @param {DateInput} date2
+ * @param {ParseDateOptions} [options] 両方の値に適用する
+ * @returns {boolean}
+ */
+export declare function isSameOrAfter(date1: DateInput, date2: DateInput, options?: ParseDateOptions): boolean;
+/**
+ * 値が inputTimezone での今日より前の日付か判定する。解釈できない場合は false
+ *
+ * @param {DateInput} value
+ * @param {ParseDateOptions} [options]
+ * @returns {boolean}
+ */
+export declare function isPastDate(value: DateInput, options?: ParseDateOptions): boolean;
+/**
+ * 値が現在時刻より前か判定する。解釈できない場合は false
+ *
+ * @param {DateInput} value
+ * @param {ParseDateOptions} [options]
+ * @returns {boolean}
+ */
+export declare function isPastDateTime(value: DateInput, options?: ParseDateOptions): boolean;
+/**
+ * date1 − date2 を unit の単位で返す
+ * 両方を inputTimezone で unit の始まりに切り捨ててから差を取るため、暦の上での差になる(23:00 と翌 01:00 の days は 1)
+ * どちらかが解釈できない場合は NaN を返す
+ *
+ * @param {DateInput} date1
+ * @param {DateInput} date2
+ * @param {TimeUnit} unit
+ * @param {ParseDateOptions} [options] 両方の値に適用する
+ * @returns {number}
+ */
+export declare function diff(date1: DateInput, date2: DateInput, unit: TimeUnit, options?: ParseDateOptions): number;
+/**
+ * timezone での今日の始まりを返す
+ *
+ * @param {string} [timezone] IANA名。既定は 'UTC'
+ * @returns {Date}
+ */
+export declare function currentDate(timezone?: string): Date;
+/**
+ * 現在時刻を返す
+ * Date はタイムゾーンを保持しないため、ゾーンは文字列にする時点(formatDate の outputTimezone)で指定する
+ *
+ * @returns {Date}
+ */
+export declare function currentDateTime(): Date;
+/**
+ * 現在時刻を timezone での 'yyyy-MM-ddTHH:mm:ss.SSS+HH:mm' 形式の文字列で返す
+ *
+ * @param {string} [timezone] IANA名。既定は 'UTC'
+ * @returns {string}
+ */
+export declare function currentTimestamp(timezone?: string): string;
+/**
+ * Excelの日付シリアル値を epoch ミリ秒に変換する
+ * Excelの日付シリアル値はゾーンの概念を持たないため、そのままではUTCの日時として変換される
+ * シリアル値がどのゾーンの日時かが分かっている場合は offset に時間差を指定する
+ *
+ * @example
+ *   convertExcelDateSerialToUnixTimeSerial(45200);                 // 1696118400000 (2023-10-01T00:00:00Z)
+ *   convertExcelDateSerialToUnixTimeSerial(45200, { offset: 9 }); // 1696086000000 (2023-10-01T00:00:00+09:00)
+ *
+ * @param {number} excelDateSerial
+ * @param {*} [options]
+ *   └ offset シリアル値のゾーンのUTCからの時間差(時)
+ * @returns {number}
+ */
+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;
+/**
+ * タイムゾーンの略称を返す。夏時間の期間中は夏時間の略称を返す
+ * 既定の表にない場合は null を返す。表は options.abbreviations で追加・上書きできる
+ *
+ * @param {string} timezone IANA名
+ * @param {TimezoneAbbrOptions} [options]
+ * @returns {string | null}
+ */
+export declare function getTimezoneAbbr(timezone: string, options?: TimezoneAbbrOptions): string | null;
+/**
+ * 文字列中の 'GMT+9' のようなオフセット表記を、timezone の略称に置き換える
+ * 略称が解決できない場合は文字列をそのまま返す
+ *
+ * @param {string} text
+ * @param {string} timezone IANA名
+ * @param {TimezoneAbbrOptions} [options]
+ * @returns {string}
+ */
+export declare function applyTimezoneAbbr(text: string, timezone: string, options?: TimezoneAbbrOptions): string;

package/lib/date-util.js

@@ -0,0 +1,23 @@
+import "luxon";
+import { a as r, c as i, b as t, e as m, f as o, g as n, h as f, i as T, j as c, k as p, l as D, m as l, n as b, o as S, p as A, q as u, r as x, s as d } from "./date-util-CG7L8nSP.js";
+export {
+  r as applyTimezoneAbbr,
+  i as convertExcelDateSerialToUnixTimeSerial,
+  t as convertTimeUnit,
+  m as currentDate,
+  o as currentDateTime,
+  n as currentTimestamp,
+  f as diff,
+  T as formatDate,
+  c as getTimezoneAbbr,
+  p as isAfter,
+  D as isBefore,
+  l as isPastDate,
+  b as isPastDateTime,
+  S as isSame,
+  A as isSameOrAfter,
+  u as isSameOrBefore,
+  x as isValid,
+  d as parseDate
+};
+//# sourceMappingURL=date-util.js.map

package/lib/date-util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-util.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/lib/decimal.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=require("big.js"),o={roundDown:0,roundHalfUp:1,roundHalfEven:2,roundUp:3},b=20,g=/^[+-]?(\d+\.?\d*|\.\d+)(e[+-]?\d+)?$/i,n=u.Big();n.DP=b;n.RM=o.roundHalfUp;const s=e=>e==null||e===""||typeof e=="number"&&Number.isNaN(e);class t{static ROUNDING_MODE=o;big;constructor(r){this.big=t.toBig(r)}static toBig(r){if(s(r))return n(0);if(r instanceof t)return r.big;switch(typeof r){case"number":if(!Number.isFinite(r))throw new TypeError(`Invalid number: ${r}`);return n(r);case"bigint":return n(r.toString());default:{const i=r.trim();if(!g.test(i))throw new TypeError(`Invalid number: ${r}`);return n(i.replace(/^\+/,""))}}}static wrap(r){const i=new t(0);return i.big=r,i}add(r){return t.wrap(this.big.add(t.toBig(r)))}sub(r){return t.wrap(this.big.sub(t.toBig(r)))}times(r){return t.wrap(this.big.times(t.toBig(r)))}div(r){if(s(r))return t.wrap(this.big);const i=t.toBig(r);if(i.eq(0))throw new RangeError("Division by zero");return t.wrap(this.big.div(i))}round(r=0,i=o.roundHalfUp){return t.wrap(this.big.round(r,i))}abs(){return t.wrap(this.big.abs())}compareTo(r){return this.big.cmp(t.toBig(r))}eq(r){return this.compareTo(r)===0}lt(r){return this.compareTo(r)<0}lte(r){return this.compareTo(r)<=0}gt(r){return 0<this.compareTo(r)}gte(r){return 0<=this.compareTo(r)}toNumber(){return this.big.toNumber()}toFixed(r,i=o.roundHalfUp){return this.big.round(r,i).toFixed(r)}toString(){return this.big.toFixed()}}exports.Decimal=t;exports.ROUNDING_MODE=o;
+//# sourceMappingURL=decimal.cjs.map

package/lib/decimal.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"decimal.cjs","sources":["../src/decimal.ts"],"sourcesContent":["/**\n * このクラス Decimal の役割は、算術演算の実体としての Big を内部に閉じ込め、利用者側に露出させないことにある。\n * 2026-10-08時点では big.js に依存しているが、将来的に演算演算のライブラリを変更した場合に\n * 安全・簡単に移行できることを目的としている。\n */\nimport { Big } from 'big.js';\n\n/**\n * 数値として扱える値の型\n */\nexport type NumberSource = number | string | bigint;\n\n/**\n * 丸めモード\n */\nexport const ROUNDING_MODE = {\n  /**\n   * Rounds towards zero.\n   * I.e. truncate, no rounding.\n   */\n  roundDown: 0,\n  /**\n   * Rounds towards nearest neighbour.\n   * If equidistant, rounds away from zero.\n   */\n  roundHalfUp: 1,\n  /**\n   * Rounds towards nearest neighbour.\n   * If equidistant, rounds towards even neighbour.\n   */\n  roundHalfEven: 2,\n  /**\n   * Rounds away from zero.\n   */\n  roundUp: 3\n} as const;\n\nexport type RoundingMode = typeof ROUNDING_MODE[keyof typeof ROUNDING_MODE];\n\n/**\n * Decimalの生成・演算に渡せる値の型\n * null/undefined/空文字/NaNは0とみなす(divの割る値は1とみなす)\n */\nexport type DecimalSource = NumberSource | Decimal | null | undefined;\n\n/** 除算で保持する小数桁数 */\nconst DIVISION_SCALE = 20;\n\n/** 数値として解釈できる文字列のパターン(符号・小数点・指数表記) */\nconst NUMERIC_STRING_PATTERN = /^[+-]?(\\d+\\.?\\d*|\\.\\d+)(e[+-]?\\d+)?$/i;\n\n// 独立したコンストラクタにすることで、利用側がグローバルの Big.DP / Big.RM を書き換えても影響を受けないようにする\nconst BigNumber = Big();\nBigNumber.DP = DIVISION_SCALE;\nBigNumber.RM = ROUNDING_MODE.roundHalfUp;\n\n// null/undefined/空文字/NaNはtrueを返す\nconst isEmpty = (value: DecimalSource): value is null | undefined | '' => value == null || value === '' || (typeof value === 'number' && Number.isNaN(value));\n\n/**\n * 任意精度の10進数を表す不変オブジェクト\n * 演算メソッドは自身を変更せず、結果を新しいインスタンスで返す\n * 除算は小数20桁(roundHalfUp)まで保持し、それ以降の桁は切り捨てではなく丸める\n */\nexport class Decimal {\n  /** 丸めモード */\n  public static readonly ROUNDING_MODE = ROUNDING_MODE;\n\n  /**\n   * 算術演算インスタンス\n   */\n  private big: Big;\n\n  /**\n   * @param {DecimalSource} value 数値、数値文字列、bigint、Decimal\n   *   null/undefined/空文字/NaNは0とみなす\n   *   数値として解釈できない文字列・Infinityは TypeError をスローする\n   */\n  constructor(value: DecimalSource) {\n    this.big = Decimal.toBig(value);\n  }\n\n  private static toBig(value: DecimalSource): Big {\n    if (isEmpty(value)) {\n      return BigNumber(0);\n    }\n    if (value instanceof Decimal) {\n      return value.big;\n    }\n    switch (typeof value) {\n      case 'number':\n        if (!Number.isFinite(value)) {\n          throw new TypeError(`Invalid number: ${value}`);\n        }\n        return BigNumber(value);\n      case 'bigint':\n        return BigNumber(value.toString());\n      default: {\n        const trimmed = value.trim();\n        if (!NUMERIC_STRING_PATTERN.test(trimmed)) {\n          throw new TypeError(`Invalid number: ${value}`);\n        }\n        // 先頭の '+' は数値として解釈できる表記だが、内部の算術ライブラリが受け付けないため取り除く\n        return BigNumber(trimmed.replace(/^\\+/, ''));\n      }\n    }\n  }\n\n  private static wrap(big: Big): Decimal {\n    const decimal = new Decimal(0);\n    decimal.big = big;\n    return decimal;\n  }\n\n  /**\n   * 加算した結果を返す\n   * null/undefined/空文字/NaNは0とみなす\n   *\n   * @param {DecimalSource} value\n   * @returns {Decimal}\n   */\n  public add(value: DecimalSource): Decimal {\n    return Decimal.wrap(this.big.add(Decimal.toBig(value)));\n  }\n\n  /**\n   * 減算した結果を返す\n   * null/undefined/空文字/NaNは0とみなす\n   *\n   * @param {DecimalSource} value\n   * @returns {Decimal}\n   */\n  public sub(value: DecimalSource): Decimal {\n    return Decimal.wrap(this.big.sub(Decimal.toBig(value)));\n  }\n\n  /**\n   * 乗算した結果を返す\n   * null/undefined/空文字/NaNは0とみなすため、結果は0になる\n   * 元の値を保持したい場合は times(discount ?? 1) のようにフォールバック値を指定する\n   *\n   * @param {DecimalSource} value\n   * @returns {Decimal}\n   */\n  public times(value: DecimalSource): Decimal {\n    // 掛ける値が空のとき、0とみなすべきか元の値を保持すべきかは計算対象によって異なる\n    //   手数料 x 件数: 件数が未定義なら総額は0が適切\n    //   商品価格 x 割引率: 割引率が未定義なら元の価格が適切\n    // 1とみなすと、new Decimal(null).times(3) は 0、new Decimal(3).times(null) は 3 になり、引数の順序で結果が変わる\n    // そのため常に0とみなし、元の値を保持したい場合は呼び出し側でフォールバック値を指定する\n    return Decimal.wrap(this.big.times(Decimal.toBig(value)));\n  }\n\n  /**\n   * 除算した結果を返す\n   * 結果は小数20桁(roundHalfUp)まで保持する\n   * 割る値のnull/undefined/空文字/NaNは1とみなすため、結果は元の値と同じになる\n   * 割る値に0を指定した場合は RangeError をスローする\n   *\n   * @param {DecimalSource} value\n   * @returns {Decimal}\n   */\n  public div(value: DecimalSource): Decimal {\n    // 割る値が空のとき、0とみなすとすべてゼロ除算エラーになり計算が成り立たないため1とみなす\n    if (isEmpty(value)) {\n      return Decimal.wrap(this.big);\n    }\n    const divisor = Decimal.toBig(value);\n    if (divisor.eq(0)) {\n      throw new RangeError('Division by zero');\n    }\n    return Decimal.wrap(this.big.div(divisor));\n  }\n\n  /**\n   * 指定した小数桁で丸めた結果を返す\n   * 負の桁数を指定すると整数部を丸める(-2 なら百の位)\n   *\n   * @param {number} [scale] 小数桁数 デフォルトは0\n   * @param {RoundingMode} [roundingMode] 丸めモード デフォルトはROUNDING_MODE.roundHalfUp(四捨五入・half-away-from-zero)\n   * @returns {Decimal}\n   */\n  public round(scale: number = 0, roundingMode: RoundingMode = ROUNDING_MODE.roundHalfUp): Decimal {\n    return Decimal.wrap(this.big.round(scale, roundingMode));\n  }\n\n  /**\n   * 絶対値を返す\n   *\n   * @returns {Decimal}\n   */\n  public abs(): Decimal {\n    return Decimal.wrap(this.big.abs());\n  }\n\n  /**\n   * 値を比較する\n   * null/undefined/空文字/NaNは0とみなす\n   *\n   * @param {DecimalSource} value\n   * @returns {-1 | 0 | 1} 自身が小さければ-1、等しければ0、大きければ1\n   */\n  public compareTo(value: DecimalSource): -1 | 0 | 1 {\n    return this.big.cmp(Decimal.toBig(value));\n  }\n\n  /**\n   * 等しいか判定する\n   * null/undefined/空文字/NaNは0とみなす\n   *\n   * @param {DecimalSource} value\n   * @returns {boolean}\n   */\n  public eq(value: DecimalSource): boolean {\n    return this.compareTo(value) === 0;\n  }\n\n  /**\n   * 自身が小さいか判定する\n   * null/undefined/空文字/NaNは0とみなす\n   *\n   * @param {DecimalSource} value\n   * @returns {boolean}\n   */\n  public lt(value: DecimalSource): boolean {\n    return this.compareTo(value) < 0;\n  }\n\n  /**\n   * 自身が小さいか等しいか判定する\n   * null/undefined/空文字/NaNは0とみなす\n   *\n   * @param {DecimalSource} value\n   * @returns {boolean}\n   */\n  public lte(value: DecimalSource): boolean {\n    return this.compareTo(value) <= 0;\n  }\n\n  /**\n   * 自身が大きいか判定する\n   * null/undefined/空文字/NaNは0とみなす\n   *\n   * @param {DecimalSource} value\n   * @returns {boolean}\n   */\n  public gt(value: DecimalSource): boolean {\n    return 0 < this.compareTo(value);\n  }\n\n  /**\n   * 自身が大きいか等しいか判定する\n   * null/undefined/空文字/NaNは0とみなす\n   *\n   * @param {DecimalSource} value\n   * @returns {boolean}\n   */\n  public gte(value: DecimalSource): boolean {\n    return 0 <= this.compareTo(value);\n  }\n\n  /**\n   * numberに変換する\n   * Number.MAX_SAFE_INTEGERを超える値や、numberで表現できない桁数の小数は精度が落ちる\n   *\n   * @returns {number}\n   */\n  public toNumber(): number {\n    return this.big.toNumber();\n  }\n\n  /**\n   * 指定した小数桁で丸め、小数桁を0で埋めた文字列に変換する\n   * 指数表記にはならず、通常の表記で返す\n   * 丸めた結果が0になる場合は符号を付けない\n   *\n   * @param {number} scale 小数桁数\n   * @param {RoundingMode} [roundingMode] 丸めモード デフォルトはROUNDING_MODE.roundHalfUp(四捨五入・half-away-from-zero)\n   * @returns {string}\n   */\n  public toFixed(scale: number, roundingMode: RoundingMode = ROUNDING_MODE.roundHalfUp): string {\n    return this.big.round(scale, roundingMode).toFixed(scale);\n  }\n\n  /**\n   * 文字列に変換する\n   * 指数表記にはならず、通常の表記で返す\n   *\n   * @returns {string}\n   */\n  public toString(): string {\n    return this.big.toFixed();\n  }\n}\n"],"names":["ROUNDING_MODE","DIVISION_SCALE","NUMERIC_STRING_PATTERN","BigNumber","Big","isEmpty","value","Decimal","trimmed","big","decimal","divisor","scale","roundingMode"],"mappings":"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"}