lyb-js 1.6.15 → 1.6.16

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

@@ -333,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

@@ -3601,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 返回数据类型
@@ -3891,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.15",
+  "version": "1.6.16",
   "description": "自用JS方法库",
   "license": "ISC",
   "type": "module",