lyb-js 1.6.14 → 1.6.16

package/Misc/LibJsEmitter.d.ts

@@ -5,4 +5,5 @@ export declare const LibJsEmitter: <T extends Record<string, any>>() => {
     on: <K extends keyof T>(event: K, listener: T[K] extends any[] ? (...args: T[K]) => void : (arg: T[K]) => void) => void;
     emit: <K extends keyof T>(event: K, ...args: T[K] extends any[] ? T[K] : [T[K]]) => void;
     off: <K extends keyof T>(event: K, listener?: T[K] extends any[] ? (...args: T[K]) => void : (arg: T[K]) => void) => void;
+    clear: () => void;
 };

package/Misc/LibJsEmitter.js

@@ -24,5 +24,6 @@ export const LibJsEmitter = () => {
             }
         }
     };
-    return { on, emit, off };
+    const clear = () => _eventMap.clear();
+    return { on, emit, off, clear };
 };

package/README.md

@@ -778,3 +778,24 @@ const result3 = libJsTimeGreeting({ afternoon: "午后好" }); //自定义下午
 console.log(result3); //50% 概率为 true
 ```
 
+### libJsCountdown-倒计时
+
+> 以当前时间为开始时间，传递结束时间，返回年到秒的数值，以及是否结束
+
+```ts
+const result = libJsCountdown("2025-12-01 12:00:00");
+
+console.log(result);
+/*
+{
+  years: "00",
+  months: "01",
+  days: "20",
+  hours: "05",
+  minutes: "34",
+  seconds: "12",
+  ended: false
+}
+*/
+```
+

package/Time/LibJsCountdown.d.ts

@@ -0,0 +1,9 @@
+export declare const libJsCountdown: (endTime: number) => {
+    years: string;
+    months: string;
+    days: string;
+    hours: string;
+    minutes: string;
+    seconds: string;
+    ended: boolean;
+};

package/Time/LibJsCountdown.js

@@ -0,0 +1,18 @@
+import dayjs from "dayjs";
+import duration from "dayjs/plugin/duration";
+dayjs.extend(duration);
+export const libJsCountdown = (endTime) => {
+    const startTime = dayjs();
+    const diff = dayjs(endTime).diff(startTime);
+    const time = dayjs.duration(diff);
+    const pad = (n) => n.toString().padStart(2, "0");
+    return {
+        years: pad(time.years()),
+        months: pad(time.months()),
+        days: pad(time.days()),
+        hours: pad(time.hours()),
+        minutes: pad(time.minutes()),
+        seconds: pad(time.seconds()),
+        ended: diff <= 0,
+    };
+};

package/libJs.d.ts

@@ -276,6 +276,7 @@ export declare const Misc: {
         on: <K extends keyof T>(event: K, listener: T[K] extends any[] ? (...args: T[K]) => void : (arg: T[K]) => void) => void;
         emit: <K extends keyof T>(event: K, ...args: T[K] extends any[] ? T[K] : [T[K]]) => void;
         off: <K extends keyof T>(event: K, listener?: T[K] extends any[] ? (...args: T[K]) => void : (arg: T[K]) => void) => void;
+        clear: () => void;
     };
     /** @description 类属性监听器
      * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsClassObservable-类属性监听器
@@ -332,4 +333,16 @@ export declare const Time: {
      * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsTimeGreeting-时间问候
      */
     libJsTimeGreeting: (greet?: import("./Time/LibJsTimeGreeting").LibTimeGreetingParams) => string;
+    /** @description 倒计时
+     * @param endTime 毫秒时间戳
+     */
+    libJsCountdown: (endTime: number) => {
+        years: string;
+        months: string;
+        days: string;
+        hours: string;
+        minutes: string;
+        seconds: string;
+        ended: boolean;
+    };
 };

package/libJs.js

@@ -45,6 +45,7 @@ import { libJsCopy } from "./Browser/LibJsCopy";
 import { LibJsResizeWatcher } from "./Base/LibJsResizeWatcher";
 import { LibJsPullUpLoad } from "./Misc/LibJsPullUpLoad";
 import { libJsPickUnique } from "./Data/libJsPickUnique";
+import { libJsCountdown } from "./Time/LibJsCountdown";
 /** @description 基础方法 */
 export const Base = {
     /**
@@ -345,4 +346,8 @@ export const Time = {
      * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsTimeGreeting-时间问候
      */
     libJsTimeGreeting,
+    /** @description 倒计时
+     * @param endTime 毫秒时间戳
+     */
+    libJsCountdown,
 };

package/lyb.js

@@ -3389,7 +3389,8 @@ ${log3.label}：`, log3.value];
         }
       }
     };
-    return { on, emit, off };
+    const clear = () => _eventMap.clear();
+    return { on, emit, off, clear };
   };
   const LibJsLerp = (start, end, value) => {
     const t = Math.min(Math.max(value, 0), 1);
@@ -3600,6 +3601,22 @@ ${log3.label}：`, log3.value];
       return void 0;
     return available[libJsRandom(0, available.length - 1)];
   };
+  dayjs.extend(duration);
+  const libJsCountdown = (endTime) => {
+    const startTime = dayjs();
+    const diff = dayjs(endTime).diff(startTime);
+    const time = dayjs.duration(diff);
+    const pad = (n) => n.toString().padStart(2, "0");
+    return {
+      years: pad(time.years()),
+      months: pad(time.months()),
+      days: pad(time.days()),
+      hours: pad(time.hours()),
+      minutes: pad(time.minutes()),
+      seconds: pad(time.seconds()),
+      ended: diff <= 0
+    };
+  };
   const Base = {
     /**
      * @description 返回数据类型
@@ -3890,7 +3907,11 @@ ${log3.label}：`, log3.value];
      * @param greet 自定义问候语对象
      * @link 使用方法：https://www.npmjs.com/package/lyb-js#LibJsTimeGreeting-时间问候
      */
-    libJsTimeGreeting
+    libJsTimeGreeting,
+    /** @description 倒计时
+     * @param endTime 毫秒时间戳
+     */
+    libJsCountdown
   };
   const LibJs = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
     __proto__: null,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lyb-js",
-  "version": "1.6.14",
+  "version": "1.6.16",
   "description": "自用JS方法库",
   "license": "ISC",
   "type": "module",