@oeos-components/utils 0.0.15 → 0.0.16

package/dist/index.cjs

@@ -232,7 +232,12 @@ function formatTime(time, cFormat = "{y}-{m}-{d} {h}:{i}:{s}") {
   if (typeof time === "object") {
     date = time;
   } else {
-    if (("" + time).length === 10) time = parseInt(time) * 1e3;
+    const timeStr = "" + time;
+    if (timeStr.includes(".") && !isNaN(parseFloat(timeStr))) {
+      time = parseFloat(time) * 1e3;
+    } else if (timeStr.length === 10) {
+      time = parseInt(time) * 1e3;
+    }
     date = new Date(time);
   }
   const formatObj = {
@@ -651,26 +656,15 @@ function formatBytes(bytes, options = {}) {
   } else {
     return bytes;
   }
-  if (bytes <= 0) {
-    return bytes.toFixed(digit) + " B";
+  if (bytes <= 1) {
+    return Math[roundType](bytes * Math.pow(10, digit)) / Math.pow(10, digit) + " B";
   }
   const k = 1024;
   const sizes = ["B", "KB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"];
   const i = Math.floor(Math.log(bytes) / Math.log(k));
   const power = Math.pow(k, i);
   let num = bytes / power;
-  switch (roundType) {
-    case "ceil":
-      num = Math.ceil(num * Math.pow(10, digit)) / Math.pow(10, digit);
-      break;
-    case "round":
-      num = Math.round(num * Math.pow(10, digit)) / Math.pow(10, digit);
-      break;
-    case "floor":
-    default:
-      num = Math.floor(num * Math.pow(10, digit)) / Math.pow(10, digit);
-      break;
-  }
+  num = Math[roundType](num * Math.pow(10, digit)) / Math.pow(10, digit);
   let res = num.toFixed(digit) + " " + sizes[i];
   if (thousands) {
     res = formatThousands(res);

package/dist/index.d.cts

@@ -130,8 +130,9 @@ declare function clone(data: any, times?: number): any;
  * formatTime(1541927611000); //2018-11-11 17:13:21
  * formatTime(1541927611000, "{y}年{m}月{d}日 {h}时{m}分{s}秒"); // 2018年11月11日 17时11分31秒
  * formatTime(1541927611, "{y}/{m}/{d} {h}:{m}:{s}"); // 2018/11/11 17:11:31
- * formatTime(new Date()); //2018-11-11 17:13:21
- * formatTime(new Date().getTime()); //2018-11-11 17:13:21
+ * formatTime(new Date()); // 2018-11-11 17:13:21
+ * formatTime(new Date().getTime()); // 2018-11-11 17:13:21
+ * formatTime('1764128798.456'); // 2025/11/26 11:11:38
  */
 declare function formatTime(time: any, cFormat?: string): any;
 /**
@@ -179,7 +180,36 @@ declare function uuid(type?: string, length?: number, { emailStr, timeStr, start
  * getType(123) number
  */
 declare function getType(type: any): string;
-declare function sleep(delay?: number, fn?: () => void): Promise<unknown>;
+/**
+ * 一个辅助函数，用于在代码中创建一个暂停（延迟）。
+ * 它返回一个 Promise，你可以在 `await` 后使用它来实现类似 "sleep" 的效果。
+ *
+ * @param delay - 等待的毫秒数。默认值为 0，表示不延迟。
+ * @param fn - (可选) 一个在延迟结束后立即执行的函数。
+ *
+ * @returns 一个 Promise，当延迟结束后解析（resolve）。
+ *
+ * @example
+ * // 基本用法：延迟 2 秒后打印消息
+ * console.log('开始');
+ * await sleep(2000);
+ * console.log('2秒后执行');
+ *
+ * @example
+ * // 带回调函数的用法：延迟 1 秒后执行清理工作
+ * sleep(1000, () => {
+ *   console.log('执行清理操作...');
+ *   // 清理代码...
+ * });
+ *
+ * @example
+ * // 在循环中使用：每次迭代后延迟 500 毫秒
+ * for (let i = 0; i < 5; i++) {
+ *   console.log(`当前值: ${i}`);
+ *   await sleep(500);
+ * }
+ */
+declare function sleep(delay?: number, fn?: () => void): Promise<void>;
 /** @使用方式
  * 1. 在el-form中使用
 name: [ proxy.validate('name', { message: '你干嘛哈哈' })],

package/dist/index.d.mts

@@ -130,8 +130,9 @@ declare function clone(data: any, times?: number): any;
  * formatTime(1541927611000); //2018-11-11 17:13:21
  * formatTime(1541927611000, "{y}年{m}月{d}日 {h}时{m}分{s}秒"); // 2018年11月11日 17时11分31秒
  * formatTime(1541927611, "{y}/{m}/{d} {h}:{m}:{s}"); // 2018/11/11 17:11:31
- * formatTime(new Date()); //2018-11-11 17:13:21
- * formatTime(new Date().getTime()); //2018-11-11 17:13:21
+ * formatTime(new Date()); // 2018-11-11 17:13:21
+ * formatTime(new Date().getTime()); // 2018-11-11 17:13:21
+ * formatTime('1764128798.456'); // 2025/11/26 11:11:38
  */
 declare function formatTime(time: any, cFormat?: string): any;
 /**
@@ -179,7 +180,36 @@ declare function uuid(type?: string, length?: number, { emailStr, timeStr, start
  * getType(123) number
  */
 declare function getType(type: any): string;
-declare function sleep(delay?: number, fn?: () => void): Promise<unknown>;
+/**
+ * 一个辅助函数，用于在代码中创建一个暂停（延迟）。
+ * 它返回一个 Promise，你可以在 `await` 后使用它来实现类似 "sleep" 的效果。
+ *
+ * @param delay - 等待的毫秒数。默认值为 0，表示不延迟。
+ * @param fn - (可选) 一个在延迟结束后立即执行的函数。
+ *
+ * @returns 一个 Promise，当延迟结束后解析（resolve）。
+ *
+ * @example
+ * // 基本用法：延迟 2 秒后打印消息
+ * console.log('开始');
+ * await sleep(2000);
+ * console.log('2秒后执行');
+ *
+ * @example
+ * // 带回调函数的用法：延迟 1 秒后执行清理工作
+ * sleep(1000, () => {
+ *   console.log('执行清理操作...');
+ *   // 清理代码...
+ * });
+ *
+ * @example
+ * // 在循环中使用：每次迭代后延迟 500 毫秒
+ * for (let i = 0; i < 5; i++) {
+ *   console.log(`当前值: ${i}`);
+ *   await sleep(500);
+ * }
+ */
+declare function sleep(delay?: number, fn?: () => void): Promise<void>;
 /** @使用方式
  * 1. 在el-form中使用
 name: [ proxy.validate('name', { message: '你干嘛哈哈' })],

package/dist/index.d.ts

@@ -130,8 +130,9 @@ declare function clone(data: any, times?: number): any;
  * formatTime(1541927611000); //2018-11-11 17:13:21
  * formatTime(1541927611000, "{y}年{m}月{d}日 {h}时{m}分{s}秒"); // 2018年11月11日 17时11分31秒
  * formatTime(1541927611, "{y}/{m}/{d} {h}:{m}:{s}"); // 2018/11/11 17:11:31
- * formatTime(new Date()); //2018-11-11 17:13:21
- * formatTime(new Date().getTime()); //2018-11-11 17:13:21
+ * formatTime(new Date()); // 2018-11-11 17:13:21
+ * formatTime(new Date().getTime()); // 2018-11-11 17:13:21
+ * formatTime('1764128798.456'); // 2025/11/26 11:11:38
  */
 declare function formatTime(time: any, cFormat?: string): any;
 /**
@@ -179,7 +180,36 @@ declare function uuid(type?: string, length?: number, { emailStr, timeStr, start
  * getType(123) number
  */
 declare function getType(type: any): string;
-declare function sleep(delay?: number, fn?: () => void): Promise<unknown>;
+/**
+ * 一个辅助函数，用于在代码中创建一个暂停（延迟）。
+ * 它返回一个 Promise，你可以在 `await` 后使用它来实现类似 "sleep" 的效果。
+ *
+ * @param delay - 等待的毫秒数。默认值为 0，表示不延迟。
+ * @param fn - (可选) 一个在延迟结束后立即执行的函数。
+ *
+ * @returns 一个 Promise，当延迟结束后解析（resolve）。
+ *
+ * @example
+ * // 基本用法：延迟 2 秒后打印消息
+ * console.log('开始');
+ * await sleep(2000);
+ * console.log('2秒后执行');
+ *
+ * @example
+ * // 带回调函数的用法：延迟 1 秒后执行清理工作
+ * sleep(1000, () => {
+ *   console.log('执行清理操作...');
+ *   // 清理代码...
+ * });
+ *
+ * @example
+ * // 在循环中使用：每次迭代后延迟 500 毫秒
+ * for (let i = 0; i < 5; i++) {
+ *   console.log(`当前值: ${i}`);
+ *   await sleep(500);
+ * }
+ */
+declare function sleep(delay?: number, fn?: () => void): Promise<void>;
 /** @使用方式
  * 1. 在el-form中使用
 name: [ proxy.validate('name', { message: '你干嘛哈哈' })],

package/dist/index.mjs

@@ -229,7 +229,12 @@ function formatTime(time, cFormat = "{y}-{m}-{d} {h}:{i}:{s}") {
   if (typeof time === "object") {
     date = time;
   } else {
-    if (("" + time).length === 10) time = parseInt(time) * 1e3;
+    const timeStr = "" + time;
+    if (timeStr.includes(".") && !isNaN(parseFloat(timeStr))) {
+      time = parseFloat(time) * 1e3;
+    } else if (timeStr.length === 10) {
+      time = parseInt(time) * 1e3;
+    }
     date = new Date(time);
   }
   const formatObj = {
@@ -648,26 +653,15 @@ function formatBytes(bytes, options = {}) {
   } else {
     return bytes;
   }
-  if (bytes <= 0) {
-    return bytes.toFixed(digit) + " B";
+  if (bytes <= 1) {
+    return Math[roundType](bytes * Math.pow(10, digit)) / Math.pow(10, digit) + " B";
   }
   const k = 1024;
   const sizes = ["B", "KB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"];
   const i = Math.floor(Math.log(bytes) / Math.log(k));
   const power = Math.pow(k, i);
   let num = bytes / power;
-  switch (roundType) {
-    case "ceil":
-      num = Math.ceil(num * Math.pow(10, digit)) / Math.pow(10, digit);
-      break;
-    case "round":
-      num = Math.round(num * Math.pow(10, digit)) / Math.pow(10, digit);
-      break;
-    case "floor":
-    default:
-      num = Math.floor(num * Math.pow(10, digit)) / Math.pow(10, digit);
-      break;
-  }
+  num = Math[roundType](num * Math.pow(10, digit)) / Math.pow(10, digit);
   let res = num.toFixed(digit) + " " + sizes[i];
   if (thousands) {
     res = formatThousands(res);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oeos-components/utils",
-  "version": "0.0.15",
+  "version": "0.0.16",
   "description": "utils of oeos-components",
   "license": "MIT",
   "type": "commonjs",
@@ -18,7 +18,7 @@
     "stub": "npx unbuild --stub",
     "version": "git add . && git commit -am \"chore: release v$npm_package_version\"",
     "postversion": "git push && git push origin --tags && npm publish",
-    "release": "npx unbuild && npm version patch && gg \"chore: release v$(npm pkg get version | sed 's/\"//g')\" && npm publish"
+    "release": "npx unbuild && npm version patch && gg \"chore: release @oeos-components/utils v$(npm pkg get version | sed 's/\"//g')\" && npm publish"
   },
   "author": "",
   "dependencies": {