@jhqn/utils-core 0.4.5 → 0.4.7-beta.1

package/dist/index.d.ts

@@ -3,9 +3,7 @@
 /// <reference types="dayjs/plugin/relativeTime" />
 /// <reference types="dayjs/plugin/customParseFormat" />
 /// <reference types="dayjs/plugin/objectSupport" />
-
 import dayjs, { ConfigType, Dayjs } from "dayjs";
-
 //#region types/index.d.ts
 /**
  * 数字或字符串
@@ -538,16 +536,25 @@ declare const filterObj: (obj: Record<string, any>, keys: string[], reverse?: bo
 declare const toThousands: (num: number) => string;
 /**
  * 货币格式化
+ * @example
+ * ```ts
+ * currencyFmt(123456.789) // "￥123,456.79"
+ * ```
  * @param {number | string | bigint} currency - 金额
- * @param {number} [maximumFractionDigits] - 小数位数
+ * @param {number} [maximumFractionDigits] - 最多小数位数
  */
 declare const currencyFmt: (currency: UnDef<Numeric | bigint>, maximumFractionDigits?: number) => string;
 //#endregion
 //#region src/format/dayjs.d.ts
 /**
  * 格式化时间
+ * @example
+ * ```ts
+ * dateFmt(new Date(), 'date') // 2024-06-01
+ * dateFmt(dayjs(), 'datetime') // 2024-06-01 12:34:56
+ * ```
  * @param {import('dayjs').ConfigType} date 时间
- * @param {string} format 格式
+ * @param {string} [format = "datetime"] 格式化pattern
  * @returns {string} 格式化后的时间
  */
 declare const dateFmt: (date: ConfigType, format?: string | "date" | "datetime") => string;
@@ -718,6 +725,11 @@ declare const isArray: (val: any) => val is Array<any>;
  * @param {any} val 检测的目标
  */
 declare const isFunction: (val: any) => val is Function;
+/**
+ * 是否是纯函数（不包含 Class，含原生构造函数如 Date、Array 等）
+ * @param {any} val 检测的目标
+ */
+declare const isPureFunction: (val: any) => val is Function;
 /**
  * 是否是日期
  * @param {any} val 检测的目标
@@ -895,4 +907,4 @@ declare const isValidArrRes: (res: Res<any[]>, code?: number) => boolean;
  */
 declare const isValidPageRes: (res: PageRes, code?: number) => boolean;
 //#endregion
-export { type Dayjs, type Dict, type HostEnv, type MaybeArray, type NullOrUndefinable, type Nullable, type Numeric, type PageReq, type PageRes, type PageResData, type PartialBy, type Res, type UnDef, type Undefinable, type VK, attachFmt, camel2Kebab, camel2Pascal, camel2Snake, camel2Title, checkImg, cnIdCard15Re, cnIdCard18Re, cnPhoneRE, cnTelRE, cnTelRE2, cnUSCIRE, currencyFmt, dateDuration, dateFmt, dayjs, emailRE, filterObj, fixiOSInputAutoZoomIn, getBaseAttachUrl, getCodeOfDate, getCodeOfHour, getCodeOfMonth, getHostEnv, getMockData, getMockDataList, getVariableType, hideBankCard, hideCardNo, hideEmail, hideFirstName, hideHead, hideMiddle, hidePhone, hideSurname, hideTail, hideThird, inBrowser, isArrStr, isArray, isBigInt, isBlob, isBoolean, isDate, isDef, isEmail, isEmpty, isError, isFile, isFunction, isIdCard, isJSONStr, isMap, isNull, isNumber, isNumeric, isObject, isPhone, isPromise, isRegExp, isSet, isString, isSymbol, isTel, isURL, isUSCI, isUndefined, isValidArrRes, isValidFileType, isValidKey, isValidPageRes, isValidRes, isValidResCode, isWeakMap, isWeakSet, jClear, jDebug, jError, jGroup, jGroupC, jGroupE, jInfo, jLog, jLogDedupe, jLogOnce, jTime, jTimeEnd, jWarn, kebab2Camel, kebab2Pascal, kebab2Snake, kebab2Title, naturalSort, naturalSortBy, nonASCII, parseJSON, parseToJSON, pascal2Camel, pascal2Kebab, pascal2Snake, pascal2Title, recoverFile, replacer, resUrl, reviver, setBaseAttachUrl, snake2Camel, snake2Kebab, snake2Pascal, snake2Title, stringifyJSON, title2Camel, title2Kebab, title2Pascal, title2Snake, toThousands, userAgent, waitTime };
+export { type Dayjs, type Dict, type HostEnv, type MaybeArray, type NullOrUndefinable, type Nullable, type Numeric, type PageReq, type PageRes, type PageResData, type PartialBy, type Res, type UnDef, type Undefinable, type VK, attachFmt, camel2Kebab, camel2Pascal, camel2Snake, camel2Title, checkImg, cnIdCard15Re, cnIdCard18Re, cnPhoneRE, cnTelRE, cnTelRE2, cnUSCIRE, currencyFmt, dateDuration, dateFmt, dayjs, emailRE, filterObj, fixiOSInputAutoZoomIn, getBaseAttachUrl, getCodeOfDate, getCodeOfHour, getCodeOfMonth, getHostEnv, getMockData, getMockDataList, getVariableType, hideBankCard, hideCardNo, hideEmail, hideFirstName, hideHead, hideMiddle, hidePhone, hideSurname, hideTail, hideThird, inBrowser, isArrStr, isArray, isBigInt, isBlob, isBoolean, isDate, isDef, isEmail, isEmpty, isError, isFile, isFunction, isIdCard, isJSONStr, isMap, isNull, isNumber, isNumeric, isObject, isPhone, isPromise, isPureFunction, isRegExp, isSet, isString, isSymbol, isTel, isURL, isUSCI, isUndefined, isValidArrRes, isValidFileType, isValidKey, isValidPageRes, isValidRes, isValidResCode, isWeakMap, isWeakSet, jClear, jDebug, jError, jGroup, jGroupC, jGroupE, jInfo, jLog, jLogDedupe, jLogOnce, jTime, jTimeEnd, jWarn, kebab2Camel, kebab2Pascal, kebab2Snake, kebab2Title, naturalSort, naturalSortBy, nonASCII, parseJSON, parseToJSON, pascal2Camel, pascal2Kebab, pascal2Snake, pascal2Title, recoverFile, replacer, resUrl, reviver, setBaseAttachUrl, snake2Camel, snake2Kebab, snake2Pascal, snake2Title, stringifyJSON, title2Camel, title2Kebab, title2Pascal, title2Snake, toThousands, userAgent, waitTime };

package/dist/index.js

@@ -283,7 +283,18 @@ const isArray = (val) => Array.isArray(val);
 * 是否是函数，但也有可能是Class
 * @param {any} val 检测的目标
 */
-const isFunction = (val) => getVariableType(val) === "function";
+const isFunction = (val) => typeof val === "function";
+/**
+* 是否是纯函数（不包含 Class，含原生构造函数如 Date、Array 等）
+* @param {any} val 检测的目标
+*/
+const isPureFunction = (val) => {
+	if (!isFunction(val)) return false;
+	const source = Function.prototype.toString.call(val);
+	if (source.startsWith("class")) return false;
+	if (source.includes("[native code]") && val.prototype !== void 0) return false;
+	return true;
+};
 /**
 * 是否是日期
 * @param {any} val 检测的目标
@@ -821,8 +832,12 @@ const toThousands = (num) => {
 };
 /**
 * 货币格式化
+* @example
+* ```ts
+* currencyFmt(123456.789) // "￥123,456.79"
+* ```
 * @param {number | string | bigint} currency - 金额
-* @param {number} [maximumFractionDigits] - 小数位数
+* @param {number} [maximumFractionDigits] - 最多小数位数
 */
 const currencyFmt = (currency, maximumFractionDigits = 2) => {
 	if (!isDef(currency)) return "";
@@ -843,11 +858,16 @@ dayjs.extend(customParseFormat);
 dayjs.extend(objectSupport);
 /**
 * 格式化时间
+* @example
+* ```ts
+* dateFmt(new Date(), 'date') // 2024-06-01
+* dateFmt(dayjs(), 'datetime') // 2024-06-01 12:34:56
+* ```
 * @param {import('dayjs').ConfigType} date 时间
-* @param {string} format 格式
+* @param {string} [format = "datetime"] 格式化pattern
 * @returns {string} 格式化后的时间
 */
-const dateFmt = (date, format = "YYYY-MM-DD HH:mm:ss") => {
+const dateFmt = (date, format = "datetime") => {
 	const dd = dayjs(date);
 	let fmt = format;
 	if (!isDef(date) || !dd.isValid()) return "";
@@ -1063,4 +1083,4 @@ const getMockDataList = (data, total, code = 200, message = "success", options =
 	};
 };
 //#endregion
-export { attachFmt, camel2Kebab, camel2Pascal, camel2Snake, camel2Title, checkImg, cnIdCard15Re, cnIdCard18Re, cnPhoneRE, cnTelRE, cnTelRE2, cnUSCIRE, currencyFmt, dateDuration, dateFmt, dayjs, emailRE, filterObj, fixiOSInputAutoZoomIn, getBaseAttachUrl, getCodeOfDate, getCodeOfHour, getCodeOfMonth, getHostEnv, getMockData, getMockDataList, getVariableType, hideBankCard, hideCardNo, hideEmail, hideFirstName, hideHead, hideMiddle, hidePhone, hideSurname, hideTail, hideThird, inBrowser, isArrStr, isArray, isBigInt, isBlob, isBoolean, isDate, isDef, isEmail, isEmpty, isError, isFile, isFunction, isIdCard, isJSONStr, isMap, isNull, isNumber, isNumeric, isObject, isPhone, isPromise, isRegExp, isSet, isString, isSymbol, isTel, isURL, isUSCI, isUndefined, isValidArrRes, isValidFileType, isValidKey, isValidPageRes, isValidRes, isValidResCode, isWeakMap, isWeakSet, jClear, jDebug, jError, jGroup, jGroupC, jGroupE, jInfo, jLog, jLogDedupe, jLogOnce, jTime, jTimeEnd, jWarn, kebab2Camel, kebab2Pascal, kebab2Snake, kebab2Title, naturalSort, naturalSortBy, nonASCII, parseJSON, parseToJSON, pascal2Camel, pascal2Kebab, pascal2Snake, pascal2Title, recoverFile, replacer, resUrl, reviver, setBaseAttachUrl, snake2Camel, snake2Kebab, snake2Pascal, snake2Title, stringifyJSON, title2Camel, title2Kebab, title2Pascal, title2Snake, toThousands, userAgent, waitTime };
+export { attachFmt, camel2Kebab, camel2Pascal, camel2Snake, camel2Title, checkImg, cnIdCard15Re, cnIdCard18Re, cnPhoneRE, cnTelRE, cnTelRE2, cnUSCIRE, currencyFmt, dateDuration, dateFmt, dayjs, emailRE, filterObj, fixiOSInputAutoZoomIn, getBaseAttachUrl, getCodeOfDate, getCodeOfHour, getCodeOfMonth, getHostEnv, getMockData, getMockDataList, getVariableType, hideBankCard, hideCardNo, hideEmail, hideFirstName, hideHead, hideMiddle, hidePhone, hideSurname, hideTail, hideThird, inBrowser, isArrStr, isArray, isBigInt, isBlob, isBoolean, isDate, isDef, isEmail, isEmpty, isError, isFile, isFunction, isIdCard, isJSONStr, isMap, isNull, isNumber, isNumeric, isObject, isPhone, isPromise, isPureFunction, isRegExp, isSet, isString, isSymbol, isTel, isURL, isUSCI, isUndefined, isValidArrRes, isValidFileType, isValidKey, isValidPageRes, isValidRes, isValidResCode, isWeakMap, isWeakSet, jClear, jDebug, jError, jGroup, jGroupC, jGroupE, jInfo, jLog, jLogDedupe, jLogOnce, jTime, jTimeEnd, jWarn, kebab2Camel, kebab2Pascal, kebab2Snake, kebab2Title, naturalSort, naturalSortBy, nonASCII, parseJSON, parseToJSON, pascal2Camel, pascal2Kebab, pascal2Snake, pascal2Title, recoverFile, replacer, resUrl, reviver, setBaseAttachUrl, snake2Camel, snake2Kebab, snake2Pascal, snake2Title, stringifyJSON, title2Camel, title2Kebab, title2Pascal, title2Snake, toThousands, userAgent, waitTime };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jhqn/utils-core",
-  "version": "0.4.5",
+  "version": "0.4.7-beta.1",
   "keywords": [
     "jade",
     "utils"
@@ -33,7 +33,7 @@
     }
   },
   "dependencies": {
-    "dayjs": "^1.11.20",
+    "dayjs": "^1.11.21",
     "detect-browser-es": "0.1.1"
   },
   "scripts": {