zzz-pc-view 0.0.11 → 0.0.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zzz-pc-view",
-  "version": "0.0.11",
+  "version": "0.0.13",
   "main": "src/index.umd.js",
   "module": "src/index.es.js",
   "types": "src/index.d.ts",

package/src/decorators/Loader/index.d.ts

@@ -22,11 +22,20 @@ interface StoreType<T extends TypeWithPrototype = TypeWithPrototype> {
     [storeKey]: Store<T>;
 }
 /**
- * API 列表的接口，包含一个获取列表的方法
- * @template T 列表项的类型
+ * 定义一个接口 `ApiList`，用于描述一个包含 `getList` 方法的对象。
+ * `getList` 方法用于获取数据列表，它接受一个可选的 `query` 参数，
+ * 并返回一个 `HttpRequestPromise` 或 `Promise`，其解析值为 `CombineInstanceType<T>[]` 类型的数组。
+ *
+ * @template T 一个泛型类型，必须是一个类类型。
  */
 export interface ApiList<T extends TypeWithPrototype = TypeWithPrototype> {
-    getList(query?: any): HttpRequestPromise<CombineInstanceType<T>[]>;
+    /**
+     * 获取数据列表的方法。
+     *
+     * @param {any} [query] - 可选的查询参数。
+     * @returns {HttpRequestPromise<CombineInstanceType<T>[]> | Promise<CombineInstanceType<T>[]>} 返回一个 `HttpRequestPromise` 或 `Promise`，其解析值为 `CombineInstanceType<T>[]` 类型的数组。
+     */
+    getList(query?: any): HttpRequestPromise<CombineInstanceType<T>[]> | Promise<CombineInstanceType<T>[]>;
 }
 /**
  * Loader 的参数接口，包含 API 列表、全局标志、子键和加载完成的回调函数

package/src/index.es.js

@@ -691,6 +691,34 @@ const setDateByFormat = (date, dateStr, format, ...params) => {
   }
   return date.getTime();
 };
+const timeConfigs = [
+  {
+    unit: "天",
+    step: 864e5,
+    pad: NaN,
+    max: Infinity
+  },
+  {
+    unit: "小时",
+    step: 36e5,
+    pad: 2,
+    max: 23
+  },
+  {
+    unit: "分",
+    step: 6e4,
+    pad: 2,
+    max: 59
+  },
+  {
+    unit: "秒",
+    step: 1e3,
+    pad: 2,
+    max: 59
+  }
+];
+const timeConfigsLen = timeConfigs.length;
+const lastTimeConfigsIndex = timeConfigsLen - 1;
 class ZDate extends Date {
   /**
    * 设置日期的季度。
@@ -922,6 +950,94 @@ class ZDate extends Date {
   setByFormat(...args) {
     return setDateByFormat(this, ...args);
   }
+  /**
+     * 获取两个时间之间的持续时间格式字符串。
+     *
+     * @param beginTime - 开始时间，可以是字符串、数字、Date 对象或 ZDate 对象。
+     * @param endTime - 结束时间，可以是字符串、数字、Date 对象或 ZDate 对象。
+     * @param lastEndIndex - 最后一个时间单位的索引，默认为 timeConfigs 数组的最后一个索引。
+     * @returns 持续时间的格式字符串。
+     *
+     * @example
+        const beginTime = new ZDate('2023/01/01 00:00:00')
+        const endTime = new ZDate('2023/01/01 00:00:05')
+        const durationStr = ZUtils.ZDate.getDurationFormatStr(beginTime, endTime)
+        console.log(durationStr)
+     *
+     * @example
+        const beginTime = new ZDate('2023/01/01 00:00:00')
+        const endTime = new ZDate('2023/01/01 00:05:00')
+        const durationStr = ZUtils.ZDate.getDurationFormatStr(beginTime, endTime, 2)
+        console.log(durationStr)
+  
+     * @example
+        const beginTime = new ZDate('2023/01/01 00:00:00')
+        const endTime = new ZDate('2023/01/01 00:05:00')
+        const durationStr = ZUtils.ZDate.getDurationFormatStr(beginTime, endTime, -1)
+        console.log(durationStr)
+     */
+  static getDurationFormatStr(beginTime, endTime, lastEndIndex = lastTimeConfigsIndex) {
+    const results = [];
+    lastEndIndex = Math.max(
+      0,
+      Math.min(
+        lastEndIndex + (lastEndIndex >> -1 & 1) * lastTimeConfigsIndex,
+        lastTimeConfigsIndex
+      )
+    );
+    const endIndex = lastEndIndex + 1;
+    const begin = new ZUtils.ZDate(beginTime).getTime();
+    const end = new ZUtils.ZDate(endTime).getTime();
+    let duration = end - begin;
+    if (duration === 0) {
+      results.push([0, timeConfigs[lastEndIndex]]);
+    } else {
+      for (let i = 0; i < endIndex; i++) {
+        const timeConfig = timeConfigs[i];
+        const { step } = timeConfig;
+        const result = duration / step;
+        results.push([result, timeConfig]);
+        duration = duration % step;
+        if (duration === 0) {
+          break;
+        }
+      }
+    }
+    const lastResultsIndex = results.length - 1;
+    const lastResult = results[lastResultsIndex];
+    lastResult[0] = Math.ceil(lastResult[0]);
+    if (lastResult[0] > lastResult[1].max) {
+      lastResult[0] = 0;
+      for (let i = lastResultsIndex - 1; i >= 0; i--) {
+        const result = results[i];
+        result[0] = Math.floor(result[0]) + 1;
+        if (result[0] > result[1].max) {
+          result[0] = 0;
+        } else {
+          break;
+        }
+      }
+    }
+    let firstNotZeroIndex = results.findIndex((result) => result[0] >= 1);
+    if (firstNotZeroIndex === -1) {
+      firstNotZeroIndex = lastResultsIndex;
+    }
+    let lastNotZeroIndex = lastResultsIndex;
+    for (; lastNotZeroIndex > firstNotZeroIndex; lastNotZeroIndex--) {
+      const result = results[lastNotZeroIndex];
+      if (result[0] > 0) {
+        break;
+      }
+    }
+    let response2 = "";
+    for (let i = firstNotZeroIndex; i <= lastNotZeroIndex; i++) {
+      const result = results[i];
+      const { unit, pad } = result[1];
+      const value = Math.floor(result[0]);
+      response2 += `${Number.isFinite(pad) ? value.toString().padStart(pad, "0") : value}${unit}`;
+    }
+    return response2;
+  }
 }
 const completeByDate = (list2, dataTimeProp, dateRange, completeConfig, missDataFormatter = (data) => data) => {
   const { interval } = completeConfig;
@@ -1625,7 +1741,7 @@ const index$c = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.definePrope
   bindThenAjaxSource,
   create
 }, Symbol.toStringTag, { value: "Module" }));
-const ZUtils = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+const ZUtils$1 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   WithNew,
   WithPrototype,
@@ -10112,7 +10228,7 @@ const index = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.definePropert
 }, Symbol.toStringTag, { value: "Module" }));
 const indexPcViews = {
   install(app, param) {
-    app.config.globalProperties.$ZUtils = ZUtils;
+    app.config.globalProperties.$ZUtils = ZUtils$1;
     app.config.globalProperties.$ZDecorators = ZDecorators;
     setApi(param.api);
     app.use(directiveInstaller);
@@ -10127,7 +10243,7 @@ const indexPcViews = {
 export {
   index as PcViews,
   ZDecorators,
-  ZUtils,
+  ZUtils$1 as ZUtils,
   index$b as ZWebUtils,
   indexPcViews as default
 };