@gateweb/react-utils 0.0.1

package/dist/es/index.mjs

@@ -0,0 +1,666 @@
+import dayjs from 'dayjs';
+export { u as useCountdown } from './useCountdown-client-t52WIHfq.mjs';
+export { d as downloadFile } from './download-client-CnaJ0p_f.mjs';
+export { g as getLocalStorage, s as setLocalStorage } from './webStorage-client-Pd-loNCg.mjs';
+
+/**
+ * convert CamelCase string to PascalCase string
+ * @param str the string to convert
+ * @example
+ * camelString2PascalString('camelCase') // 'CamelCase'
+ * camelString2PascalString('camelCaseTest') // 'CamelCaseTest'
+ */ const camelString2PascalString = (str)=>`${str[0].toUpperCase()}${str.slice(1)}`;
+/**
+ * convert CamelCase string to SnakeCase string
+ * @param str the string to convert
+ * @example
+ * camelString2SnakeString('camelCase') // 'camel_case'
+ * camelString2SnakeString('camelCaseTest') // 'camel_case_test'
+ */ const camelString2SnakeString = (str)=>str.replace(/[A-Z]/g, (letter)=>`_${letter.toLowerCase()}`);
+/**
+ * convert PascalCase string to CamelCase string
+ * @param str the string to convert
+ * @example
+ * pascalString2CamelString('PascalCase') // 'pascalCase'
+ * pascalString2CamelString('PascalCaseTest') // 'pascalCaseTest'
+ */ const pascalString2CamelString = (str)=>`${str[0].toLowerCase()}${str.slice(1)}`;
+/**
+ * convert PascalCase string to SnakeCase string
+ * @param str the string to convert
+ * @example
+ * pascalString2SnakeString('PascalCase') // 'pascal_case'
+ * pascalString2SnakeString('PascalCaseTest') // 'pascal_case_test'
+ */ const pascalString2SnakeString = (str)=>camelString2SnakeString(pascalString2CamelString(str));
+/**
+ * convert SnakeCase string to CamelCase string
+ * @param str the string to convert
+ * @example
+ * snakeString2CamelString('snake_case') // 'snakeCase'
+ * snakeString2CamelString('snake_case_test') // 'snakeCaseTest'
+ */ const snakeString2CamelString = (str)=>str.replace(/(_[a-z])/g, (group)=>group.toUpperCase().replace('_', ''));
+/**
+ * convert SnakeCase string to PascalCase string
+ * @param str the string to convert
+ * @example
+ * snakeString2PascalString('snake_case') // 'SnakeCase'
+ * snakeString2PascalString('snake_case_test') // 'SnakeCaseTest'
+ */ const snakeString2PascalString = (str)=>camelString2PascalString(snakeString2CamelString(str));
+const transformFun = {
+    CamelToPascal: camelString2PascalString,
+    CamelToSnake: camelString2SnakeString,
+    PascalToCamel: pascalString2CamelString,
+    PascalToSnake: pascalString2SnakeString,
+    SnakeToCamel: snakeString2CamelString,
+    SnakeToPascal: snakeString2PascalString
+};
+const transformObjectKey = (obj, transformFunName)=>{
+    if (!obj || typeof obj !== 'object') return obj;
+    if (Array.isArray(obj)) return obj.map((item)=>transformObjectKey(item, transformFunName));
+    return Object.keys(obj).reduce((acc, key)=>({
+            ...acc,
+            [transformFun[transformFunName](key)]: transformObjectKey(obj[key], transformFunName)
+        }), {});
+};
+/**
+ * convert object key from CamelCase to PascalCase
+ * @param obj the object to convert
+ * @example
+ * const obj = {
+ *  fooBar: 'fooBar',
+ *  fooBar2: 'fooBar2',
+ *  fooBar3: {
+ *    fooBar4: 'fooBar4',
+ *    fooBar5: 'fooBar5',
+ *  },
+ * };
+ * const result = camelCase2PascalCase(obj);
+ * console.log(result); // { FooBar: 'fooBar', FooBar2: 'fooBar2', FooBar3: { FooBar4: 'fooBar4', FooBar5: 'fooBar5' } }
+ */ const camelCase2PascalCase = (obj)=>transformObjectKey(obj, 'CamelToPascal');
+/**
+ * convert object key from CamelCase to SnakeCase
+ * @param obj the object to convert
+ * @example
+ * const obj = {
+ *  fooBar: 'fooBar',
+ *  fooBar2: 'fooBar2',
+ *  fooBar3: {
+ *    fooBar4: 'fooBar4',
+ *    fooBar5: 'fooBar5',
+ *  },
+ * };
+ * const result = camelCase2SnakeCase(obj);
+ * console.log(result); // { foo_bar: 'fooBar', foo_bar2: 'fooBar2', foo_bar3: { foo_bar4: 'fooBar4', foo_bar5: 'fooBar5' } }
+ */ const camelCase2SnakeCase = (obj)=>transformObjectKey(obj, 'CamelToSnake');
+/**
+ * convert object key from PascalCase to CamelCase
+ * @param obj the object to convert
+ * @example
+ * const obj = {
+ *  FooBar: 'fooBar',
+ *  FooBar2: 'fooBar2',
+ *  FooBar3: {
+ *    FooBar4: 'fooBar4',
+ *    FooBar5: 'fooBar5',
+ *  },
+ * };
+ * const result = pascalCase2CamelCase(obj);
+ * console.log(result); // { fooBar: 'fooBar', fooBar2: 'fooBar2', fooBar3: { fooBar4: 'fooBar4', fooBar5: 'fooBar5' } }
+ */ const pascalCase2CamelCase = (obj)=>transformObjectKey(obj, 'PascalToCamel');
+/**
+ * convert object key from PascalCase to SnakeCase
+ * @param obj the object to convert
+ * @example
+ * const obj = {
+ *  FooBar: 'fooBar',
+ *  FooBar2: 'fooBar2',
+ *  FooBar3: {
+ *    FooBar4: 'fooBar4',
+ *    FooBar5: 'fooBar5',
+ *  },
+ * };
+ * const result = pascalCase2SnakeCase(obj);
+ * console.log(result); // { foo_bar: 'fooBar', foo_bar2: 'fooBar2', foo_bar3: { foo_bar4: 'fooBar4', foo_bar5: 'fooBar5' } }
+ */ const pascalCase2SnakeCase = (obj)=>transformObjectKey(obj, 'PascalToSnake');
+/**
+ * convert object key from SnakeCase to CamelCase
+ * @param obj the object to convert
+ * @example
+ * const obj = {
+ *  foo_bar: 'fooBar',
+ *  foo_bar2: 'fooBar2',
+ *  foo_bar3: {
+ *    foo_bar4: 'fooBar4',
+ *    foo_bar5: 'fooBar5',
+ *  },
+ * };
+ * const result = snakeCase2CamelCase(obj);
+ * console.log(result); // { fooBar: 'fooBar', fooBar2: 'fooBar2', fooBar3: { fooBar4: 'fooBar4', fooBar5: 'fooBar5' } }
+ */ const snakeCase2CamelCase = (obj)=>transformObjectKey(obj, 'SnakeToCamel');
+/**
+ * convert object key from SnakeCase to PascalCase
+ * @param obj the object to convert
+ * @example
+ * const obj = {
+ *  foo_bar: 'fooBar',
+ *  foo_bar2: 'fooBar2',
+ *  foo_bar3: {
+ *    foo_bar4: 'fooBar4',
+ *    foo_bar5: 'fooBar5',
+ *  },
+ * };
+ * const result = snakeCase2PascalCase(obj);
+ * console.log(result); // { FooBar: 'fooBar', FooBar2: 'fooBar2', FooBar3: { FooBar4: 'fooBar4', FooBar5: 'fooBar5' } }
+ */ const snakeCase2PascalCase = (obj)=>transformObjectKey(obj, 'SnakeToPascal');
+
+/**
+ * 檢查稅務編號是否符合正確的編號規則。
+ *
+ * @param {string} taxId - 要檢查的8位數稅務編號。
+ * @returns {boolean} - 如果符合規則則返回 true，否則返回 false。
+ *
+ * ### 編號檢查規則：
+ * 1. **基本格式檢查**：
+ *    - 編號必須為 8 位數字。
+ *    - 不得為「00000000」或「11111111」，這些編號被視為無效。
+ *
+ * 2. **驗證邏輯**：
+ *    - 使用一組驗證運算子：`[1, 2, 1, 2, 1, 2, 4, 1]`。
+ *    - 將稅務編號的每一位數字與對應的運算子相乘後，使用 `calculate` 函數計算各位數的和。
+ *      - 計算公式為：`(product % 10) + (product - (product % 10)) / 10`
+ *    - 將所有位數經計算後的結果加總為 `sum`。
+ *
+ * 3. **檢查規則**：
+ *    - 如果總和 `sum` 可以被 5 整除，則編號有效。
+ *    - 或者，若第七位數為 7，且 `(sum + 1) % 5 === 0`，則編號有效。
+ *
+ * @example
+ *
+ * validTaxId('22099131') // true
+ * validTaxId('84149961') // true
+ * validTaxId('00000000') // false
+ * validTaxId('11111111') // false
+ * validTaxId('22099132') // false
+ */ const validTaxId = (taxId)=>{
+    const invalidList = '00000000,11111111';
+    if (/^\d{8}$/.test(taxId) === false || invalidList.indexOf(taxId) >= 0) {
+        return false;
+    }
+    const validateOperator = [
+        1,
+        2,
+        1,
+        2,
+        1,
+        2,
+        4,
+        1
+    ];
+    const calculate = (product)=>product % 10 + (product - product % 10) / 10;
+    const sum = validateOperator.reduce((pre, cur, index)=>pre + calculate(Number(taxId[index]) * cur), 0);
+    return sum % 5 === 0 || taxId[6] === '7' && (sum + 1) % 5 === 0;
+};
+/**
+ * 驗證日期格式是否正確
+ *
+ * @param dateString 日期字串
+ * @param format 日期格式
+ * @example
+ *
+ * validateDateString('20210201', 'YYYYMMDD') // true
+ * validateDateString('2021-02-01', 'YYYY-MM-DD') // true
+ * validateDateString('20210201', 'YYYY-MM-DD') // false
+ * validateDateString('20210201', 'YYYYMM') // false
+ */ const validateDateString = (dateString, format)=>{
+    if (!dateString) return false;
+    // 根據 format 生成正則表達式
+    const regexPattern = format.replace(/YYYY/, '\\d{4}').replace(/MM/, '\\d{2}').replace(/DD/, '\\d{2}').replace(/HH/, '\\d{2}').replace(/mm/, '\\d{2}').replace(/ss/, '\\d{2}');
+    const regex = new RegExp(`^${regexPattern}$`);
+    // 先用正則驗證格式
+    if (!regex.test(dateString)) return false;
+    // 再用 dayjs 驗證是否為有效日期
+    return dayjs(dateString, format, true).isValid();
+};
+
+/**
+ * 取得去年今年以及明年期別陣列
+ *
+ * @example
+ * // 假設 今年為 112 年
+ * generatePeriodArray() // 11102 ~ 11312
+ */ const generatePeriodArray = ()=>{
+    const currentYear = new Date().getFullYear() - 1911;
+    const months = [
+        '02',
+        '04',
+        '06',
+        '08',
+        '10',
+        '12'
+    ];
+    const years = [
+        currentYear - 1,
+        currentYear,
+        currentYear + 1
+    ];
+    return years.flatMap((year)=>months.map((month)=>`${year}${month}`));
+};
+/**
+ * 取得當前期別
+ *
+ * 報稅期限次期開始15日內
+ *
+ * 雙數月沒有特殊規則，期別皆為當月開頭
+ *
+ * 單數月15號以前，期別為上個月否則為下個月開頭
+ *
+ * @example
+ *
+ * // 假設今天是 111-02-15
+ * getCurrentPeriod() // 11102
+ * // 假設今天是 111-02-16
+ * getCurrentPeriod() // 11102
+ * // 假設今天是 111-03-15
+ * getCurrentPeriod() // 11102
+ * // 假設今天是 111-03-16
+ * getCurrentPeriod() // 11104
+ */ const getCurrentPeriod = ()=>{
+    const now = dayjs();
+    const currentDate = now.format('DD');
+    const currentYear = now.format('YYYY');
+    const currentMonth = now.format('MM');
+    let endMonth;
+    if (Number(currentMonth) % 2 === 1) {
+        endMonth = dayjs(`${currentYear}${currentMonth}`, 'YYYYMM').add(Number(currentDate) <= 15 ? -1 : 1, 'month').format('YYYYMM');
+    } else {
+        endMonth = `${currentYear}${currentMonth}`;
+    }
+    return dayjs(endMonth, 'YYYYMM').subtract(1911, 'year').format('YYYYMM').substring(1);
+};
+/**
+ * 民國年轉西元年
+ * @param dateString 日期字串
+ * @param format 日期格式
+ * @example
+ *
+ * rocEraToAd('1100201') // 20210201
+ * rocEraToAd('11002', 'YYYYMM') // 202102
+ */ const rocEraToAd = (dateString, format = 'YYYYMMDD')=>{
+    if (!validateDateString(`0${dateString}`, format)) return dateString;
+    return dayjs(`0${dateString}`, format).add(1911, 'year').format(format);
+};
+/**
+ * 西元年轉民國年
+ * @param dateString 日期字串
+ * @param format 日期格式
+ * @example
+ *
+ * adToRocEra('20210201') // 1100201
+ * adToRocEra('202102', 'YYYYMM') // 11002
+ */ const adToRocEra = (dateString, format = 'YYYYMMDD')=>{
+    if (!validateDateString(dateString, format)) return dateString;
+    return dayjs(dateString, format).add(-1911, 'year').format(format).substring(1);
+};
+
+/**
+ * 檢查檔案是否為合法的 MIME 類型
+ *
+ * @param file 檔案
+ * @param accepts 允許的 MIME 類型
+ *
+ * @example
+ *
+ * ```js
+ * validateFileType({ type: 'image/png' }, ['image/png', 'image/jpeg']) // true
+ * validateFileType({ type: 'image/png' }, ['image/jpeg']) // false
+ * validateFileType({ type: 'image/png' }, ['image/*']) // true
+ * ```
+ */ const validateFileType = (file, accepts)=>{
+    if (accepts.length === 0) return true;
+    // 獲取文件的MIME類型
+    const fileMimeType = file.type;
+    return accepts.some((accept)=>{
+        if (accept === fileMimeType) {
+            return true;
+        }
+        if (accept.endsWith('/*')) {
+            const acceptedCategory = accept.split('/')[0];
+            const fileCategory = fileMimeType.split('/')[0];
+            if (acceptedCategory === fileCategory) {
+                return true;
+            }
+        }
+        return false;
+    });
+};
+/**
+ * 根據檔案副檔名取得對應的 MIME Type
+ *
+ * 目前支援的副檔名有：pdf, csv, jpeg, jpg, png, zip, txt
+ * 除此之外的副檔名皆回傳 application/octet-stream
+ *
+ * @param fileExtension 檔案副檔名
+ *
+ * @example
+ *
+ * getMimeType('pdf') // 'application/pdf'
+ * getMimeType('csv') // 'text/csv'
+ * getMimeType('jpeg') // 'image/jpeg'
+ * getMimeType('jpg') // 'image/jpeg'
+ * getMimeType('png') // 'image/png'
+ * getMimeType('txt') // 'text/plain'
+ * getMimeType('zip') // 'application/zip'
+ * getMimeType('mp4') // 'application/octet-stream'
+ */ const getMimeType = (fileName)=>{
+    switch((fileName.split('.').pop() || '').toLocaleLowerCase()){
+        case 'jpeg':
+        case 'jpg':
+            return 'image/jpeg';
+        case 'png':
+            return 'image/png';
+        case 'pdf':
+            return 'application/pdf';
+        case 'zip':
+            return 'application/zip';
+        case 'csv':
+            return 'text/csv';
+        case 'txt':
+            return 'text/plain';
+        default:
+            return 'application/octet-stream';
+    }
+};
+
+/**
+ * 判斷執行環境是否為 Server(node.js) 端
+ */ const isServer = ()=>typeof window === 'undefined';
+
+/**
+ * 將物件中的某些 key 排除
+ *
+ * @param object 原始物件
+ * @param keys 要排除的 key
+ *
+ * @example
+ * const a = { a: 1, b: 2, c: 3, d: 4 };
+ * const b = omit(a, 'a', 'b'); // { c: 3, d: 4 }
+ */ const omit = (object, ...keys)=>Object.keys(object).reduce((acc, cur)=>{
+        if (keys.includes(cur)) {
+            return acc;
+        }
+        return {
+            ...acc,
+            [cur]: object[cur]
+        };
+    }, {});
+/**
+ * 將物件中的某些 value 排除
+ *
+ * @param object 原始物件
+ * @param values 要排除的 value
+ *
+ * @example
+ * const a = { a: undefined, b: null, c: 3, d: 4 };
+ * const b = omitByValue(a, undefined, null); // { c: 3, d: 4 }
+ */ const omitByValue = (object, ...values)=>Object.entries(object).reduce((acc, [key, value])=>{
+        if (values.includes(value)) {
+            return acc;
+        }
+        return {
+            ...acc,
+            [key]: value
+        };
+    }, {});
+/**
+ * 將指定格式的物件轉換成類似 enum 的物件
+ *
+ * @param enumObject enum 物件
+ * @param valueKey value 的 key
+ *
+ * @example
+ *
+ * ```js
+ * const myObj = {
+ *    A: { value: 'a' },
+ *    B: { value: 'b', other: 'other' },
+ * }
+ *
+ * const enumCode = extractEnumLikeObject(myObj, 'value');
+ * console.log(enumCode); // { A: 'a', B: 'b' }
+ * ```
+ */ const extractEnumLikeObject = (enumObject, valueKey)=>Object.entries(enumObject).reduce((acc, [key, value])=>({
+            ...acc,
+            [key]: value[valueKey]
+        }), {});
+
+/**
+ * debounce function
+ *
+ * @param {Function} fn function to be executed
+ * @param {number} delay time to wait before executing the function
+ *
+ * @example
+ * const debouncedFunction = debounce((a: number, b: number) => console.log(a + b), 1000);
+ * debouncedFunction(1, 2);
+ * debouncedFunction(3, 4);
+ * // after 1 second
+ * // 7
+ */ const debounce = (fn, delay)=>{
+    let timeout;
+    // if (isAsync) {
+    //   return (...args: P[]) =>
+    //     new Promise((resolve) => {
+    //       if (timeout) {
+    //         clearTimeout(timeout);
+    //       }
+    //       timeout = setTimeout(() => {
+    //         resolve(fn(...args));
+    //       }, delay);
+    //     });
+    // }
+    return (...args)=>{
+        if (timeout) {
+            clearTimeout(timeout);
+        }
+        timeout = setTimeout(()=>{
+            fn(...args);
+        }, delay);
+    };
+};
+/**
+ * throttle function
+ *
+ * @param {Function} fn function to be executed
+ * @param {number} delay time to wait before executing the function
+ *
+ * @example
+ * const throttledFunction = throttle((a: number, b: number) => a + b, 1000);
+ * throttledFunction(1, 2); // 3
+ * throttledFunction(3, 4); // undefined
+ * setTimeout(() => {
+ *  throttledFunction(5, 6); // 11
+ * }, 2000);
+ */ const throttle = (fn, delay)=>{
+    let wait = false;
+    return (...args)=>{
+        if (wait) return undefined;
+        const val = fn(...args);
+        wait = true;
+        setTimeout(()=>{
+            wait = false;
+        }, delay);
+        return val;
+    };
+};
+
+/**
+ * 中文
+ *
+ * @param options - 選項
+ *
+ * @example
+ *
+ * isChinese().test('你好') // true
+ * isChinese().test('你 好') // false
+ * isChinese({ containSpace: true }).test('你 好') // true
+ * isChinese().test('123') // false
+ */ const isChinese = (options)=>new RegExp(`^[\u4e00-\u9fa5${options?.mark ? '\\p{P}' : ''}${options?.containSpace ? '\\s' : ''}]+$`, 'u');
+/**
+ * 英文
+ *
+ * @param options - 選項
+ *
+ * @example
+ *
+ * isEnglish().test('abc') // true
+ * isEnglish().test('abc def') // false
+ * isEnglish({ containSpace: true }).test('abc def') // true
+ * isEnglish({ number: true }).test('abc123') // true
+ * isEnglish({ mark: true }).test('abc!') // true
+ * isEnglish({ fullWidth: true }).test('ＡＢＣ') // true
+ * isEnglish({ lowercase: false }).test('abc') // false
+ * isEnglish({ uppercase: false }).test('ABC') // false
+ */ const isEnglish = (options)=>new RegExp(`^[${options?.lowercase ?? true ? 'a-z' : ''}${options?.uppercase ?? true ? 'A-Z' : ''}${options?.number ? '\\d' : ''}${options?.fullWidth ? 'Ａ-Ｚａ-ｚ' : ''}${options?.mark ? '\\p{P}\\p{S}' : ''}${options?.containSpace ? '\\s' : ''}]+$`, 'u');
+/**
+ * email
+ *
+ * @example
+ *
+ * isEmail().test('123') // false
+ * isEmail().test('123@gmail.com') // true
+ */ const isEmail = ()=>// eslint-disable-next-line
+    /^(?!\.)(?!.*\.\.)([A-Z0-9_+-\.]*)[A-Z0-9_+-]@([A-Z0-9][A-Z0-9\-]*\.)+[A-Z]{2,}$/i;
+/**
+ * 日期字串
+ *
+ * @param separator 分隔符號 (預設為 -)
+ *
+ * @example
+ *
+ * isDateString().test('2021-01-01') // true
+ * isDateString('/').test('2021/01/01') // true
+ */ const isDateString = (separator = '-')=>new RegExp(`^\\d{4}${separator}\\d{2}${separator}\\d{2}$`);
+/**
+ * 日期時間字串
+ *
+ * @param separator 分隔符號 (預設為 -)
+ *
+ * @example
+ *
+ * isDateTimeString().test('2021-01-01 12:00:00') // true
+ * isDateTimeString('/').test('2021/01/01 12:00:00') // true
+ */ const isDateTimeString = (separator = '-')=>new RegExp(`^\\d{4}${separator}\\d{2}${separator}\\d{2} \\d{2}:\\d{2}:\\d{2}$`);
+/**
+ * 日期時間字串 (不包含豪秒)
+ *
+ * @example
+ *
+ * isTimeString().test('12:00:00') // true
+ * isTimeString().test('12:00:00.123') // false
+ */ const isTimeString = ()=>/^\d{2}:\d{2}:\d{2}$/;
+
+/**
+ * 數字
+ *
+ * @example
+ * isNumber().test('123') // true
+ */ const isNumber = ()=>/^\d+$/;
+/**
+ * 非零開頭的數字
+ *
+ * @param allowZero 是否允許0
+ *
+ * @example
+ * isNonZeroNumber().test('123') // true
+ * isNonZeroNumber().test('0123') // false
+ * isNonZeroNumber().test('0') // false
+ * isNonZeroNumber(true).test('0') // true
+ */ const isNonZeroStart = (allowZero = false)=>allowZero ? /^[1-9]\d*|0$/ : /^[1-9]\d*$/;
+/**
+ * n位數的數字
+ *
+ * @param n 位數
+ *
+ * @example
+ * isNumberN(3).test('123') // true
+ * isNumberN(3).test('1234') // false
+ */ const isNumberN = (n)=>new RegExp(`^\\d{${n}}$`);
+/**
+ * n - m 位數的數字
+ *
+ * @param n 最小位數
+ * @param m 最大位數
+ *
+ * @example
+ * isNumberNM(3, 5).test('123') // true
+ * isNumberNM(3, 5).test('12345') // true
+ * isNumberNM(3, 5).test('123456') // false
+ */ const isNumberNM = (n, m)=>new RegExp(`^\\d{${n},${m}}$`);
+/**
+ * 至少n位數的數字
+ *
+ * @param n 最小位數
+ *
+ * @example
+ * isNumberAtLeastN(3).test('123') // true
+ * isNumberAtLeastN(3).test('1234') // true
+ * isNumberAtLeastN(3).test('12') // false
+ */ const isNumberAtLeastN = (n)=>new RegExp(`^\\d{${n},}$`);
+
+/**
+ * 台灣手機號碼
+ *
+ * 1. 09開頭
+ * 2. 10碼數字
+ *
+ * @example
+ *
+ * isTWMobile().test('0912345678') // true
+ * isTWMobile().test('091234567') // false
+ */ const isTWMobile = ()=>/09[0-9]{8}$/;
+/**
+ * 台灣市話
+ *
+ * 1. 0開頭
+ * 2. 2~3碼區碼
+ * 3. 區碼與號碼之間可以有-號
+ * 4. 6~8碼號碼
+ * 5. 區碼加上號碼最多10碼
+ * 6. 可以有分機號碼，分機號碼為#號開頭，後面接1~5碼數字
+ *
+ * @example
+ *
+ * isTWPhone().test('0212345678') // true
+ * isTWPhone().test('02-12345678') // true
+ * isTWPhone().test('023-1234567') // true
+ * isTWPhone().test('02-12345678#123') // true
+ *
+ * isTWPhone().test('02123456789') // false
+ * isTWPhone().test('02-123456789') // false
+ * isTWPhone().test('02-12345678#123456') // false
+ */ const isTWPhone = ()=>/^(((0[2-9]-?\d{6,8})(#\d{1,5})?)|((0[2-9][0-9]-?\d{6,7})(#\d{1,5})?))$/;
+
+/**
+ * 將數字轉換成金額千分位格式
+ *
+ * @param num - 數字
+ *
+ * @example
+ *
+ * formatAmount(1234567) // '1,234,567'
+ */ const formatAmount = (num)=>{
+    if (typeof num !== 'number') return '';
+    return num.toString().replace(/(\d)(?=(\d{3})+(?!\d))/g, '$1,');
+};
+/**
+ * 將字串的第 n - m 個字轉換成星號
+ *
+ * @param str - 字串
+ * @param n - 起始位置
+ * @param m - 結束位置
+ *
+ * @example
+ *
+ * formatString('123456', 1, 4) // '1****6'
+ */ const formatStarMask = (str, n, m)=>str.slice(0, n) + '*'.repeat(m - n + 1) + str.slice(m + 1);
+
+export { adToRocEra, camelCase2PascalCase, camelCase2SnakeCase, camelString2PascalString, camelString2SnakeString, debounce, extractEnumLikeObject, formatAmount, formatStarMask, generatePeriodArray, getCurrentPeriod, getMimeType, isChinese, isDateString, isDateTimeString, isEmail, isEnglish, isNonZeroStart, isNumber, isNumberAtLeastN, isNumberN, isNumberNM, isServer, isTWMobile, isTWPhone, isTimeString, omit, omitByValue, pascalCase2CamelCase, pascalCase2SnakeCase, pascalString2CamelString, pascalString2SnakeString, rocEraToAd, snakeCase2CamelCase, snakeCase2PascalCase, snakeString2CamelString, snakeString2PascalString, throttle, validTaxId, validateDateString, validateFileType };