@base-web-kits/base-tools-ts 0.9.9 → 0.9.10

package/dist/number/big.d.ts

@@ -16,27 +16,27 @@ export declare function big(x: NumLike): BigNumber;
 /**
  * 高精度加法（支持多个参数连加）。
  * @example
- * bigAdd(0.1, 0.2); // => 0.3
- * bigAdd('0.1', '0.2'); // => 0.3
- * bigAdd(1, 2, 3, 4); // => 10  // 多参数连加: 1+2+3+4
+ * bigPlus(0.1, 0.2); // => 0.3
+ * bigPlus('0.1', '0.2'); // => 0.3
+ * bigPlus(1, 2, 3, 4); // => 10  // 多参数连加: 1+2+3+4
  */
-export declare function bigAdd(a: NumLike, ...rest: NumLike[]): number;
+export declare function bigPlus(...rest: NumLike[]): number;
 /**
  * 高精度减法（支持多个参数连减）。
  * @example
- * bigSub(1, 0.9); // => 0.1
- * bigSub('1.1', '0.2'); // => 0.9
- * bigSub(10, 1, 2, 3); // => 4  // 多参数连减: 10-1-2-3
+ * bigMinus(1, 0.9); // => 0.1
+ * bigMinus('1.1', '0.2'); // => 0.9
+ * bigMinus(10, 1, 2, 3); // => 4  // 多参数连减: 10-1-2-3
  */
-export declare function bigSub(a: NumLike, ...rest: NumLike[]): number;
+export declare function bigMinus(...rest: NumLike[]): number;
 /**
  * 高精度乘法（支持多个参数连乘）。
  * @example
- * bigMul(0.1, 0.2); // => 0.02
- * bigMul('1.5', '3'); // => 4.5
- * bigMul(2, 3, 4); // => 24  // 多参数连乘: 2*3*4
+ * bigTimes(0.1, 0.2); // => 0.02
+ * bigTimes('1.5', '3'); // => 4.5
+ * bigTimes(2, 3, 4); // => 24  // 多参数连乘: 2*3*4
  */
-export declare function bigMul(a: NumLike, ...rest: NumLike[]): number;
+export declare function bigTimes(...rest: NumLike[]): number;
 /**
  * 高精度除法（支持多个参数连除）。
  * @example
@@ -44,7 +44,7 @@ export declare function bigMul(a: NumLike, ...rest: NumLike[]): number;
  * bigDiv('10', '4'); // => 2.5
  * bigDiv(100, 5, 2); // => 10  // 多参数连除: 100/5/2
  */
-export declare function bigDiv(a: NumLike, ...rest: NumLike[]): number;
+export declare function bigDiv(...rest: NumLike[]): number;
 /**
  * 指数运算
  * @param x 底数。
@@ -56,7 +56,7 @@ export declare function bigDiv(a: NumLike, ...rest: NumLike[]): number;
  */
 export declare function bigPow(x: NumLike, y: NumLike): number;
 /**
- * 四舍五入到指定位数
+ * 四舍五入到指定小数位数
  * @param x 需要舍入的数值。
  * @param dp 保留的小数位数，默认 `0`（取整）。
  * @param rm 舍入模式，默认 `ROUND_HALF_UP`（四舍五入）。
@@ -75,13 +75,13 @@ export declare function bigRound(x: NumLike, dp?: number, rm?: BigNumber.Roundin
  * @param rm 舍入模式，默认 `ROUND_HALF_UP`（四舍五入）。
  * @returns 格式化后的字符串。
  * @example
- * toFixed('1'); // => '1.00'
- * +toFixed('1'); // => 1
- * toFixed(1.2345); // => '1.23'
- * toFixed(1.2345, 3); // => '1.235'
- * toFixed('1.2345', 0, BigNumber.ROUND_UP); // => '2'
+ * bigFixed('1'); // => '1.00'
+ * +bigFixed('1'); // => 1
+ * bigFixed(1.2345); // => '1.23'
+ * bigFixed(1.2345, 3); // => '1.235'
+ * bigFixed('1.2345', 0, BigNumber.ROUND_UP); // => '2'
  */
-export declare function toFixed(x: NumLike, dp?: number, rm?: BigNumber.RoundingMode): string;
+export declare function bigFixed(x: NumLike, dp?: number, rm?: BigNumber.RoundingMode): string;
 /**
  * 比较两个数值大小。
  * @example
@@ -100,32 +100,32 @@ export declare function bigEqual(a: NumLike, b: NumLike): boolean;
 /**
  * 判断 a 是否大于 b。
  * @example
- * bigGt(2, 1); // => true
- * bigGt(1, 2); // => false
+ * bigGreaterThan(2, 1); // => true
+ * bigGreaterThan(1, 2); // => false
  */
-export declare function bigGt(a: NumLike, b: NumLike): boolean;
+export declare function bigGreaterThan(a: NumLike, b: NumLike): boolean;
 /**
  * 判断 a 是否大于等于 b。
  * @example
- * bigGte(2, 2); // => true
- * bigGte(1, 2); // => false
+ * bigGreaterThanOrEqual(2, 2); // => true
+ * bigGreaterThanOrEqual(1, 2); // => false
  */
-export declare function bigGte(a: NumLike, b: NumLike): boolean;
+export declare function bigGreaterThanOrEqualTo(a: NumLike, b: NumLike): boolean;
 /**
  * 判断 a 是否小于 b。
  * @example
- * bigLt(1, 2); // => true
- * bigLt(2, 1); // => false
+ * bigLessThan(1, 2); // => true
+ * bigLessThan(2, 1); // => false
  */
-export declare function bigLt(a: NumLike, b: NumLike): boolean;
+export declare function bigLessThan(a: NumLike, b: NumLike): boolean;
 /**
  * 判断 a 是否小于等于 b。
  * @example
- * bigLte(2, 2); // => true
- * bigLte(1, 2); // => true
- * bigLte(2, 1); // => false
+ * bigLessThanOrEqual(2, 2); // => true
+ * bigLessThanOrEqual(1, 2); // => true
+ * bigLessThanOrEqual(2, 1); // => false
  */
-export declare function bigLte(a: NumLike, b: NumLike): boolean;
+export declare function bigLessThanOrEqual(a: NumLike, b: NumLike): boolean;
 /**
  * 导出 BigNumber 类
  * @example

package/dist/number/big.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"big.d.ts","sourceRoot":"","sources":["../../src/ts/number/big.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,cAAc,CAAC;AAErC;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAElD;;;;;;;GAOG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,SAAS,CAEzC;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,UAIpD;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,UAIpD;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,UAIpD;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,UAIpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,UAE5C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,SAAI,EAAE,EAAE,GAAE,SAAS,CAAC,YAAsC,UAEhG;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CACrB,CAAC,EAAE,OAAO,EACV,EAAE,SAAI,EACN,EAAE,GAAE,SAAS,CAAC,YAAsC,GACnD,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAEpE;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAErD;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAErD;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAEtD;AAED;;;;;;GAMG;AACH,OAAO,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"big.d.ts","sourceRoot":"","sources":["../../src/ts/number/big.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,cAAc,CAAC;AAErC;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAElD;;;;;;;GAOG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,SAAS,CAEzC;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,UAIzC;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,UAI1C;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,UAI1C;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,UAIxC;AAED;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,UAE5C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,SAAI,EAAE,EAAE,GAAE,SAAS,CAAC,YAAsC,UAEhG;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CACtB,CAAC,EAAE,OAAO,EACV,EAAE,SAAI,EACN,EAAE,GAAE,SAAS,CAAC,YAAsC,GACnD,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAEpE;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAEvE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAE3D;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAElE;AAED;;;;;;GAMG;AACH,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base-web-kits/base-tools-ts",
-  "version": "0.9.9",
+  "version": "0.9.10",
   "sideEffects": false,
   "description": "Independent TS utilities package built from src/ts.",
   "keywords": [

package/src/ts/day/index.ts

@@ -22,7 +22,7 @@ type BaseTime = number | string | Date | dayjs.Dayjs | null | undefined;
  * @param t 各种规范或不规范的时间
  * @returns dayjs 实例
  * @example
- * const d = toDayjs('2021-01-01'); // dayjs 实例
+ * const d = toDayjs('2021-01-01'); // dayjs 实例 (无参,则默认当前时间)
  * d.format('YYYY-MM-DD HH:mm:ss'); // "2025-12-10 11:33:16"
  * d.valueOf(); // 毫秒时间戳，如 1765337596913
  * d.unix(); // 秒时间戳，如 1765337596
@@ -50,7 +50,7 @@ type BaseTime = number | string | Date | dayjs.Dayjs | null | undefined;
  * d.diff(t, 'quarter'); // 与t相差的季度数
  * d.diff(t, 'year'); // 与t相差的年数
  */
-export function toDayjs(t: BaseTime, fmt?: dayjs.OptionType) {
+export function toDayjs(t?: BaseTime, fmt?: dayjs.OptionType) {
   if (t === null || t === undefined) return dayjs();
   if (typeof t === 'number') {
     const s = String(Math.trunc(t));

package/src/ts/number/big.ts

@@ -21,39 +21,39 @@ export function big(x: NumLike): BigNumber {
 /**
  * 高精度加法（支持多个参数连加）。
  * @example
- * bigAdd(0.1, 0.2); // => 0.3
- * bigAdd('0.1', '0.2'); // => 0.3
- * bigAdd(1, 2, 3, 4); // => 10  // 多参数连加: 1+2+3+4
+ * bigPlus(0.1, 0.2); // => 0.3
+ * bigPlus('0.1', '0.2'); // => 0.3
+ * bigPlus(1, 2, 3, 4); // => 10  // 多参数连加: 1+2+3+4
  */
-export function bigAdd(a: NumLike, ...rest: NumLike[]) {
-  let acc = big(a);
-  for (const x of rest) acc = acc.plus(big(x));
+export function bigPlus(...rest: NumLike[]) {
+  let acc = big(rest[0]);
+  for (const x of rest.slice(1)) acc = acc.plus(big(x));
   return acc.toNumber();
 }
 
 /**
  * 高精度减法（支持多个参数连减）。
  * @example
- * bigSub(1, 0.9); // => 0.1
- * bigSub('1.1', '0.2'); // => 0.9
- * bigSub(10, 1, 2, 3); // => 4  // 多参数连减: 10-1-2-3
+ * bigMinus(1, 0.9); // => 0.1
+ * bigMinus('1.1', '0.2'); // => 0.9
+ * bigMinus(10, 1, 2, 3); // => 4  // 多参数连减: 10-1-2-3
  */
-export function bigSub(a: NumLike, ...rest: NumLike[]) {
-  let acc = big(a);
-  for (const x of rest) acc = acc.minus(big(x));
+export function bigMinus(...rest: NumLike[]) {
+  let acc = big(rest[0]);
+  for (const x of rest.slice(1)) acc = acc.minus(big(x));
   return acc.toNumber();
 }
 
 /**
  * 高精度乘法（支持多个参数连乘）。
  * @example
- * bigMul(0.1, 0.2); // => 0.02
- * bigMul('1.5', '3'); // => 4.5
- * bigMul(2, 3, 4); // => 24  // 多参数连乘: 2*3*4
+ * bigTimes(0.1, 0.2); // => 0.02
+ * bigTimes('1.5', '3'); // => 4.5
+ * bigTimes(2, 3, 4); // => 24  // 多参数连乘: 2*3*4
  */
-export function bigMul(a: NumLike, ...rest: NumLike[]) {
-  let acc = big(a);
-  for (const x of rest) acc = acc.times(big(x));
+export function bigTimes(...rest: NumLike[]) {
+  let acc = big(rest[0]);
+  for (const x of rest.slice(1)) acc = acc.times(big(x));
   return acc.toNumber();
 }
 
@@ -64,9 +64,9 @@ export function bigMul(a: NumLike, ...rest: NumLike[]) {
  * bigDiv('10', '4'); // => 2.5
  * bigDiv(100, 5, 2); // => 10  // 多参数连除: 100/5/2
  */
-export function bigDiv(a: NumLike, ...rest: NumLike[]) {
-  let acc = big(a);
-  for (const x of rest) acc = acc.div(big(x));
+export function bigDiv(...rest: NumLike[]) {
+  let acc = big(rest[0]);
+  for (const x of rest.slice(1)) acc = acc.div(big(x));
   return acc.toNumber();
 }
 
@@ -84,7 +84,7 @@ export function bigPow(x: NumLike, y: NumLike) {
 }
 
 /**
- * 四舍五入到指定位数
+ * 四舍五入到指定小数位数
  * @param x 需要舍入的数值。
  * @param dp 保留的小数位数，默认 `0`（取整）。
  * @param rm 舍入模式，默认 `ROUND_HALF_UP`（四舍五入）。
@@ -106,13 +106,13 @@ export function bigRound(x: NumLike, dp = 0, rm: BigNumber.RoundingMode = BigNum
  * @param rm 舍入模式，默认 `ROUND_HALF_UP`（四舍五入）。
  * @returns 格式化后的字符串。
  * @example
- * toFixed('1'); // => '1.00'
- * +toFixed('1'); // => 1
- * toFixed(1.2345); // => '1.23'
- * toFixed(1.2345, 3); // => '1.235'
- * toFixed('1.2345', 0, BigNumber.ROUND_UP); // => '2'
+ * bigFixed('1'); // => '1.00'
+ * +bigFixed('1'); // => 1
+ * bigFixed(1.2345); // => '1.23'
+ * bigFixed(1.2345, 3); // => '1.235'
+ * bigFixed('1.2345', 0, BigNumber.ROUND_UP); // => '2'
  */
-export function toFixed(
+export function bigFixed(
   x: NumLike,
   dp = 2,
   rm: BigNumber.RoundingMode = BigNumber.ROUND_HALF_UP,
@@ -144,41 +144,41 @@ export function bigEqual(a: NumLike, b: NumLike): boolean {
 /**
  * 判断 a 是否大于 b。
  * @example
- * bigGt(2, 1); // => true
- * bigGt(1, 2); // => false
+ * bigGreaterThan(2, 1); // => true
+ * bigGreaterThan(1, 2); // => false
  */
-export function bigGt(a: NumLike, b: NumLike): boolean {
+export function bigGreaterThan(a: NumLike, b: NumLike): boolean {
   return big(a).isGreaterThan(big(b));
 }
 
 /**
  * 判断 a 是否大于等于 b。
  * @example
- * bigGte(2, 2); // => true
- * bigGte(1, 2); // => false
+ * bigGreaterThanOrEqual(2, 2); // => true
+ * bigGreaterThanOrEqual(1, 2); // => false
  */
-export function bigGte(a: NumLike, b: NumLike): boolean {
+export function bigGreaterThanOrEqualTo(a: NumLike, b: NumLike): boolean {
   return big(a).isGreaterThanOrEqualTo(big(b));
 }
 
 /**
  * 判断 a 是否小于 b。
  * @example
- * bigLt(1, 2); // => true
- * bigLt(2, 1); // => false
+ * bigLessThan(1, 2); // => true
+ * bigLessThan(2, 1); // => false
  */
-export function bigLt(a: NumLike, b: NumLike): boolean {
+export function bigLessThan(a: NumLike, b: NumLike): boolean {
   return big(a).isLessThan(big(b));
 }
 
 /**
  * 判断 a 是否小于等于 b。
  * @example
- * bigLte(2, 2); // => true
- * bigLte(1, 2); // => true
- * bigLte(2, 1); // => false
+ * bigLessThanOrEqual(2, 2); // => true
+ * bigLessThanOrEqual(1, 2); // => true
+ * bigLessThanOrEqual(2, 1); // => false
  */
-export function bigLte(a: NumLike, b: NumLike): boolean {
+export function bigLessThanOrEqual(a: NumLike, b: NumLike): boolean {
   return big(a).isLessThanOrEqualTo(big(b));
 }