zzz-pc-view 0.0.12 → 0.0.13

package/src/utils/Date/ZDate.d.ts

@@ -553,5 +553,32 @@ export declare class ZDate extends Date {
      * // 输出 1722539071887
      */
     setByFormat(...args: WithoutFirstParams<typeof setDateByFormat>): number;
+    /**
+     * 获取两个时间之间的持续时间格式字符串。
+     *
+     * @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: string | number | Date | ZDate, endTime: string | number | Date | ZDate, lastEndIndex?: number): string;
 }
 export {};