diff --git a/package.json b/package.json
index 662dbf3..4875535 100644
--- a/package.json
+++ b/package.json
@@ -1,7 +1,6 @@
{
"name": "kunpocc",
"version": "1.0.23",
- "type": "module",
"description": "基于creator3.0+的kunpocc库",
"main": "./dist/kunpocc.cjs",
"module": "./dist/kunpocc.mjs",
diff --git a/rollup.config.mjs b/rollup.config.mjs
index c6554ab..f9a345b 100644
--- a/rollup.config.mjs
+++ b/rollup.config.mjs
@@ -22,7 +22,17 @@ export default [
plugins: [
typescript({
tsconfig: './tsconfig.json',
- importHelpers: false
+ importHelpers: false,
+ compilerOptions: {
+ target: "es6",
+ module: "es6",
+ experimentalDecorators: true, // 启用ES装饰器。
+ strict: true,
+ strictNullChecks: false,
+ moduleResolution: "Node",
+ skipLibCheck: true,
+ esModuleInterop: true,
+ }
})
]
},
@@ -45,7 +55,17 @@ export default [
plugins: [
typescript({
tsconfig: './tsconfig.json',
- importHelpers: false
+ importHelpers: false,
+ compilerOptions: {
+ target: "es6",
+ module: "es6",
+ experimentalDecorators: true, // 启用ES装饰器。
+ strict: true,
+ strictNullChecks: false,
+ moduleResolution: "Node",
+ skipLibCheck: true,
+ esModuleInterop: true,
+ }
}),
terser()
]
diff --git a/src/cocos/CocosEntry.ts b/src/cocos/CocosEntry.ts
index cd7c987..9704546 100644
--- a/src/cocos/CocosEntry.ts
+++ b/src/cocos/CocosEntry.ts
@@ -14,6 +14,7 @@ import { Platform, PlatformType } from "../global/Platform";
import { ECManager } from "../kunpocc";
import { ModuleBase } from "../module/ModuleBase";
import { info } from "../tool/log";
+import { Time } from "../tool/Time";
import { PropsHelper } from "../ui/PropsHelper";
import { CocosAdapter } from "./CocosAdapter";
const { property } = _decorator;
@@ -109,6 +110,7 @@ export abstract class CocosEntry extends Component {
}
private initTime(): void {
+ Time._configBoot();
InnerTimer.initTimer();
GlobalTimer.initTimer();
this.schedule(this.tick.bind(this), 0, macro.REPEAT_FOREVER);
diff --git a/src/kunpocc.ts b/src/kunpocc.ts
index 4a479a8..c7a9fc4 100644
--- a/src/kunpocc.ts
+++ b/src/kunpocc.ts
@@ -10,7 +10,7 @@ export { Binary } from "./tool/Binary";
export * from "./tool/log";
export { MathTool } from "./tool/Math";
export { md5 } from "./tool/MD5";
-
+export { Time } from "./tool/Time";
/** 消息监听 */
export { EventManager } from "./event/EventManager";
diff --git a/src/tool/Math.ts b/src/tool/Math.ts
index 6ce8712..739bc7a 100644
--- a/src/tool/Math.ts
+++ b/src/tool/Math.ts
@@ -4,6 +4,7 @@ const MathFloor = Math.floor;
const MathRandom = Math.random;
export class MathTool {
+ /** 限制 value 在 min 和 max 之间 */
public static clampf(value: number, min: number, max: number): number {
return MathMin(MathMax(value, min), max);
}
@@ -18,14 +19,24 @@ export class MathTool {
return MathRandom() * (max - min) + min;
}
+ /** 角度转弧度 */
public static rad(angle: number): number {
return (angle * Math.PI) / 180;
}
+ /** 弧度转角度 */
public static deg(radian: number): number {
return (radian * 180) / Math.PI;
}
+ /**
+ * 平滑过渡
+ * @param num1 起始值
+ * @param num2 目标值
+ * @param elapsedTime 已用时间
+ * @param responseTime 响应时间
+ * @returns 平滑过渡后的值
+ */
public static smooth(num1: number, num2: number, elapsedTime: number, responseTime: number): number {
let out: number = num1;
if (elapsedTime > 0) {
diff --git a/src/tool/Time.ts b/src/tool/Time.ts
new file mode 100644
index 0000000..a95846e
--- /dev/null
+++ b/src/tool/Time.ts
@@ -0,0 +1,548 @@
+/**
+ * @Author: Gongxh
+ * @Date: 2025-03-06
+ * @Description: 时间工具
+ */
+
+import { game } from "cc";
+import { log } from "./log";
+
+/** 时间对象缓存 */
+let TimeCache: Date = null;
+
+export class Time {
+ /** 游戏系统启动时间戳 */
+ private static _osBootTime: number = 0;
+
+ /** 主动设置的网络时间 单位ms */
+ private static _netTime: number = 0;
+
+ /** 本地时间与网路时间的偏移量 单位ms */
+ private static _netTimeDiff: number = 0;
+
+ /** 获取当前毫秒时间戳 */
+ private static _nowTimestamp: () => number;
+
+ /** 获取游戏系统启动时间戳 */
+ public static get osBootTime(): number { return this._osBootTime; }
+
+ /** 获取主动设置的网络时间 单位ms */
+ public static get netTime(): number { return this._netTime; }
+
+ /** 获取本地时间与网路时间的偏移量 单位ms */
+ public static get netTimeDiff(): number { return this._netTimeDiff; }
+
+ /** 获取系统运行时间 */
+ public static get runTime(): number { return game.totalTime };
+
+
+ public static _configBoot(): void {
+ this._osBootTime = Date.now();
+ log("系统启动时间", this._osBootTime);
+ TimeCache = new Date();
+ this._nowTimestamp = (): number => {
+ return this._osBootTime + this.runTime;
+ }
+ }
+
+ /**
+ * 设置网络时间, 单位ms
+ * @param netTime 网络时间
+ */
+ public static setNetTime(netTime: number): void {
+ if (netTime == 0) {
+ return;
+ }
+ this._netTime = netTime;
+ const localTime = this._nowTimestamp();
+ this._netTimeDiff = this.netTime - localTime;
+ log(`设置网络时间: net(${this.formatTime(this.netTime)}), boot(${this.formatTime(this.osBootTime)}), diff(${Math.abs(this.netTimeDiff / 1000)}秒)`);
+ }
+
+ /**
+ * 获取当前时间 单位ms
+ */
+ public static now(): number {
+ return this._nowTimestamp() + this.netTimeDiff;
+ }
+
+ /**
+ * 将毫秒转换为秒
+ * @param ms 毫秒
+ */
+ public static msTos(ms: number): number {
+ return Math.floor((ms || 0) / 1000);
+ }
+
+ /**
+ * 将秒转换为毫秒
+ */
+ public static sToMs(s: number): number {
+ return (s || 0) * 1000;
+ }
+
+ /**
+ * 获取时间
+ * @param timestamp 时间戳 (ms)
+ * @returns 时间
+ */
+ public static getTime(timestamp?: number): { year: number, month: number, day: number, hour: number, minute: number, second: number } {
+ TimeCache.setTime(timestamp || this.now());
+ return {
+ year: TimeCache.getFullYear(),
+ month: TimeCache.getMonth() + 1,
+ day: TimeCache.getDate(),
+ hour: TimeCache.getHours(),
+ minute: TimeCache.getMinutes(),
+ second: TimeCache.getSeconds()
+ };
+ }
+
+ /**
+ * 获取年份
+ * @param timestamp 时间戳 (ms)
+ * @returns 年份
+ */
+ public static getYear(timestamp?: number): number {
+ TimeCache.setTime(timestamp || this.now());
+ return TimeCache.getFullYear();
+ }
+
+ /**
+ * 获取月份
+ * @param timestamp 时间戳 (ms)
+ * @returns 月份
+ */
+ public static getMonth(timestamp?: number): number {
+ TimeCache.setTime(timestamp || this.now());
+ return TimeCache.getMonth() + 1;
+ }
+
+ /**
+ * 获取日期
+ * @param timestamp 时间戳 (ms)
+ * @returns 日期
+ */
+ public static getDay(timestamp?: number): number {
+ TimeCache.setTime(timestamp || this.now());
+ return TimeCache.getDate();
+ }
+
+ /**
+ * 获取小时
+ * @param timestamp 时间戳 (ms)
+ * @returns 小时
+ */
+ public static getHour(timestamp?: number): number {
+ TimeCache.setTime(timestamp || this.now());
+ return TimeCache.getHours();
+ }
+
+ /**
+ * 获取分钟
+ * @param timestamp 时间戳 (ms)
+ * @returns 分钟
+ */
+ public static getMinute(timestamp?: number): number {
+ TimeCache.setTime(timestamp || this.now());
+ return TimeCache.getMinutes();
+ }
+
+ /**
+ * 获取秒
+ * @param timestamp 时间戳 (ms)
+ * @returns 秒
+ */
+ public static getSecond(timestamp?: number): number {
+ TimeCache.setTime(timestamp || this.now());
+ return TimeCache.getSeconds();
+ }
+
+ /**
+ * 获取当天开始时间
+ * @param timestamp 时间戳 (ms)
+ * @returns 时间戳 (ms)
+ */
+ public static getDayStartTime(timestamp?: number): number {
+ TimeCache.setTime(timestamp || this.now());
+ TimeCache.setHours(0, 0, 0, 0);
+ return TimeCache.getTime();
+ }
+
+ /**
+ * 获取当天的结束时间
+ * @param timestamp 时间戳 (ms)
+ * @returns 时间戳 (ms)
+ */
+ public static getDayEndTime(timestamp?: number): number {
+ return this.getDayStartTime(timestamp) + 86400000;
+ }
+
+ /**
+ * 获取传入时间是周几
+ * @param {number} [time] (ms)
+ * @returns {number}
+ */
+ public static getWeekDay(time?: number): number {
+ TimeCache.setTime(time || Time.now());
+ return TimeCache.getDay() || 7;
+ }
+
+ /**
+ * 获取当前周的开始时间
+ * @param timestamp 时间戳 (ms)
+ * @returns 时间戳 (ms)
+ */
+ public static getWeekStartTime(timestamp?: number): number {
+ return this.getDayStartTime(timestamp - this.getWeekDay(timestamp) * 86400000);
+ }
+
+ public static getWeekEndTime(timestamp?: number): number {
+ return this.getWeekStartTime(timestamp) + 86400000 * 7;
+ }
+
+ /**
+ * 获取当前月开始时间
+ * @param timestamp 时间戳 (ms)
+ * @returns 时间戳 (ms)
+ */
+ public static getMonthStartTime(timestamp?: number): number {
+ TimeCache.setTime(timestamp || this.now());
+ TimeCache.setDate(1);
+ TimeCache.setHours(0, 0, 0, 0);
+ return TimeCache.getTime();
+ }
+
+ /**
+ * 获取当前月结束时间
+ * @param timestamp 时间戳 (ms)
+ * @returns 时间戳 (ms)
+ */
+ public static getMonthEndTime(timestamp?: number): number {
+ TimeCache.setTime(timestamp || this.now());
+ TimeCache.setDate(1);
+ TimeCache.setHours(0, 0, 0, 0);
+ TimeCache.setMonth(TimeCache.getMonth() + 1);
+ return TimeCache.getTime();
+ }
+
+ /**
+ * 获取当前年份开始时间
+ * @param timestamp 时间戳 (ms)
+ * @returns 时间戳 (ms)
+ */
+ public static getYearStartTime(timestamp?: number): number {
+ TimeCache.setTime(timestamp || this.now());
+ TimeCache.setMonth(0);
+ TimeCache.setDate(1);
+ TimeCache.setHours(0, 0, 0, 0);
+ return TimeCache.getTime();
+ }
+
+ /**
+ * 获取当前年份结束时间
+ * @param timestamp 时间戳 (ms)
+ * @returns 时间戳 (ms)
+ */
+ public static getYearEndTime(timestamp?: number): number {
+ TimeCache.setTime(timestamp || this.now());
+ TimeCache.setMonth(0);
+ TimeCache.setDate(1);
+ TimeCache.setHours(0, 0, 0, 0);
+ TimeCache.setFullYear(TimeCache.getFullYear() + 1);
+ return TimeCache.getTime();
+ }
+
+ /**
+ * 获取当前月的天数
+ * @param timestamp 时间戳 (ms)
+ * @returns 天数
+ */
+ public static getMonthDays(timestamp?: number): number {
+ const monthEndTime = this.getMonthEndTime(timestamp);
+ const monthStartTime = this.getMonthStartTime(timestamp);
+ return Math.round((monthEndTime - monthStartTime) / 86400000);
+ }
+
+ /**
+ * 是否是同一天
+ * @param timestamp1 时间戳1 (ms)
+ * @param now 时间戳2 (ms) 如果不传，则和当前时间比较
+ * @returns 是否是同一天
+ */
+ public static isSameDay(timestamp1: number, now?: number): boolean {
+ now = now || this.now();
+ if (now - timestamp1 > 86400000) {
+ return false;
+ }
+ return this.getDayStartTime(timestamp1) === this.getDayStartTime(now);
+ }
+
+ /**
+ * 是否是同一周
+ * @param timestamp1 时间戳1 (ms)
+ * @param now 时间戳2 (ms) 如果不传，则和当前时间比较
+ * @returns 是否是同一周
+ */
+ public static isSameWeek(timestamp1: number, now?: number): boolean {
+ now = now || this.now();
+ if (now - timestamp1 > 86400000 * 7) {
+ return false;
+ }
+ return this.getWeekStartTime(timestamp1) === this.getWeekStartTime(now);
+ }
+
+ /**
+ * 是否是同一月
+ * @param timestamp1 时间戳1 (ms)
+ * @param now 时间戳2 (ms) 如果不传，则和当前时间比较
+ * @returns 是否是同一月
+ */
+ public static isSameMonth(timestamp1: number, now?: number): boolean {
+ now = now || this.now();
+ TimeCache.setTime(timestamp1);
+ const month1 = TimeCache.getMonth();
+ const year1 = TimeCache.getFullYear();
+ TimeCache.setTime(now);
+ const month2 = TimeCache.getMonth();
+ const year2 = TimeCache.getFullYear();
+ return month1 === month2 && year1 === year2;
+ }
+
+ /**
+ * 是否是同一年
+ * @param timestamp1 时间戳1 (ms)
+ * @param now 时间戳2 (ms) 如果不传，则和当前时间比较
+ * @returns 是否是同一年
+ */
+ public static isSameYear(timestamp1: number, now?: number): boolean {
+ now = now || this.now();
+ // 直接比较年份，避免使用天数计算可能出现的边界错误
+ TimeCache.setTime(timestamp1);
+ const year1 = TimeCache.getFullYear();
+ TimeCache.setTime(now);
+ const year2 = TimeCache.getFullYear();
+ return year1 === year2;
+ }
+
+ /**
+ * 格式化时间 格式: xxxx-xx-xx HH:MM:SS
+ * @param timestamp 时间戳 (ms)
+ */
+ public static formatTime(timestamp: number): string {
+ TimeCache.setTime(timestamp);
+ return `${TimeCache.getFullYear()}-${TimeCache.getMonth() + 1}-${TimeCache.getDate()} ${TimeCache.getHours()}:${TimeCache.getMinutes()}:${TimeCache.getSeconds()}`;
+ }
+
+ /**
+ * 格式化时间 格式: xxxx年xx月xx日 HH:MM:SS
+ * @param timestamp 时间戳 (ms)
+ */
+ public static formatTimeChinese(timestamp: number): string {
+ TimeCache.setTime(timestamp);
+ return `${TimeCache.getFullYear()}年${TimeCache.getMonth() + 1}月${TimeCache.getDate()}日 ${TimeCache.getHours()}:${TimeCache.getMinutes()}:${TimeCache.getSeconds()}`;
+ }
+
+ /**
+ * 格式化时间 格式: xxxx-xx-xx hh:mm
+ * @param timestamp 时间戳 (ms)
+ */
+ public static formatYMDHM(timestamp: number): string {
+ TimeCache.setTime(timestamp);
+ return `${TimeCache.getFullYear()}-${TimeCache.getMonth() + 1}-${TimeCache.getDate()} ${TimeCache.getHours()}:${TimeCache.getMinutes()}`;
+ }
+
+ /**
+ * 格式化时间 格式: xxxx年xx月xx日 h时m分
+ * @param timestamp 时间戳 (ms)
+ */
+ public static formatYMDHMChinese(timestamp: number): string {
+ TimeCache.setTime(timestamp);
+ return `${TimeCache.getFullYear()}年${TimeCache.getMonth() + 1}月${TimeCache.getDate()}日 ${TimeCache.getHours()}时${TimeCache.getMinutes()}分`;
+ }
+
+ /**
+ * 格式化时间 格式: xxxx-xx-xx
+ * @param timestamp 时间戳 (ms)
+ */
+ public static formatYMD(timestamp: number): string {
+ TimeCache.setTime(timestamp);
+ return `${TimeCache.getFullYear()}-${TimeCache.getMonth() + 1}-${TimeCache.getDate()}`;
+ }
+
+ /**
+ * 格式化时间 格式: xxxx年xx月xx日
+ * @param timestamp 时间戳 (ms)
+ */
+ public static formatYMDChinese(timestamp: number): string {
+ TimeCache.setTime(timestamp);
+ return `${TimeCache.getFullYear()}年${TimeCache.getMonth() + 1}月${TimeCache.getDate()}日`;
+ }
+
+ /**
+ * 格式化时间 格式: xx-xx h:m:s
+ * @param timestamp 时间戳 (ms)
+ */
+ public static formatMDHMS(timestamp: number): string {
+ TimeCache.setTime(timestamp);
+ return `${TimeCache.getMonth() + 1}-${TimeCache.getDate()} ${TimeCache.getHours()}:${TimeCache.getMinutes()}:${TimeCache.getSeconds()}`;
+ }
+
+ /**
+ * 格式化时间 格式: xx月xx日 h时m分s秒
+ * @param timestamp 时间戳 (ms)
+ */
+ public static formatMDHMSChinese(timestamp: number): string {
+ TimeCache.setTime(timestamp);
+ return `${TimeCache.getMonth() + 1}月${TimeCache.getDate()}日 ${TimeCache.getHours()}时${TimeCache.getMinutes()}分${TimeCache.getSeconds()}秒`;
+ }
+
+ /**
+ * 格式化时间 格式: xx-xx
+ * @param timestamp 时间戳 (ms)
+ */
+ public static formatMD(timestamp: number): string {
+ TimeCache.setTime(timestamp);
+ return `${TimeCache.getMonth() + 1}-${TimeCache.getDate()}`;
+ }
+
+ /**
+ * 格式化时间 格式: xx月xx日
+ * @param timestamp 时间戳 (ms)
+ */
+ public static formatMDChinese(timestamp: number): string {
+ TimeCache.setTime(timestamp);
+ return `${TimeCache.getMonth() + 1}月${TimeCache.getDate()}日`;
+ }
+
+ /**
+ * 格式化时间 格式: hh:mm
+ * @param timestamp 时间戳 (ms)
+ */
+ public static formatHM(timestamp: number): string {
+ TimeCache.setTime(timestamp);
+ return `${TimeCache.getHours()}:${TimeCache.getMinutes()}`;
+ }
+
+ /**
+ * 格式化时间 格式: h时m分
+ * @param timestamp 时间戳 (ms)
+ */
+ public static formatHMChinese(timestamp: number): string {
+ TimeCache.setTime(timestamp);
+ return `${TimeCache.getHours()}时${TimeCache.getMinutes()}分`;
+ }
+
+ /**
+ * 格式化时间 格式: hh:mm:ss
+ * @param timestamp 时间戳 (ms)
+ */
+ public static formatHMS(timestamp: number): string {
+ TimeCache.setTime(timestamp);
+ return `${TimeCache.getHours()}:${TimeCache.getMinutes()}:${TimeCache.getSeconds()}`;
+ }
+
+ /**
+ * 格式化时间 格式: h时m分s秒
+ * @param timestamp 时间戳 (ms)
+ */
+ public static formatHMSChinese(timestamp: number): string {
+ TimeCache.setTime(timestamp);
+ return `${TimeCache.getHours()}时${TimeCache.getMinutes()}分${TimeCache.getSeconds()}秒`;
+ }
+
+ /**
+ * 智能格式化时间 格式 >1天(x天x小时x分x秒) >1小时(xx小时x分x秒) 1分钟(xx分x秒) 1秒(xx秒)
+ * @param time 时间 (s)
+ */
+ public static formatSmart(time: number): string {
+ const curTime = Math.floor(time < 0 ? 0 : time);
+ const day = Math.floor(curTime / 86400);
+ const hour = Math.floor((curTime % 86400) / 3600);
+ const minute = Math.floor((curTime % 3600) / 60);
+ const second = curTime % 60;
+ if (day > 0) {
+ return `${day}天${hour}小时${minute}分${second}秒`;
+ } else if (hour > 0) {
+ return `${hour}小时${minute}分${second}秒`;
+ } else if (minute > 0) {
+ return `${minute}分${second}秒`;
+ } else {
+ return `${second}秒`;
+ }
+ }
+
+ /**
+ * 智能格式化时间 格式 >1天(x天x小时) >1小时(xx小时xx分) 1分钟(xx分xx秒) 1秒(xx秒)
+ * @param time 时间 (s)
+ */
+ public static formatSmartSimple(time: number): string {
+ const curTime = Math.floor(time < 0 ? 0 : time);
+ if (curTime > 86400) {
+ const day = Math.floor(curTime / 86400);
+ const hour = Math.ceil((curTime % 86400) / 3600);
+ return `${day}天${hour}小时`;
+ } else if (curTime > 3600) {
+ const hour = Math.floor(curTime / 3600);
+ const minute = Math.ceil((curTime % 3600) / 60);
+ return `${hour}小时${minute}分`;
+ } else if (curTime > 60) {
+ const minute = Math.floor(curTime / 60);
+ const second = Math.ceil(curTime % 60);
+ return `${minute}分${second}秒`;
+ } else {
+ return `${curTime}秒`;
+ }
+ }
+
+ /**
+ * 格式化倒计时 格式: xx:xx:xx
+ * @param time 时间 (s)
+ */
+ public static formatToHour(time: number): string {
+ const curTime = time < 0 ? 0 : time;
+ const timeNum = Math.floor(curTime);
+ const hour = Math.floor(timeNum / 3600);
+ const minute = Math.floor((timeNum % 3600) / 60);
+ const seconds = timeNum % 60;
+ const hourStr = hour < 10 ? `0${hour}` : `${hour}`;
+ const minuteStr = minute < 10 ? `0${minute}` : `${minute}`;
+ const secondsStr = seconds < 10 ? `0${seconds}` : `${seconds}`;
+ return `${hourStr}:${minuteStr}:${secondsStr}`;
+ }
+
+ /**
+ * 格式化倒计时 格式: xx小时xx分xx秒
+ * @param time 时间 (s)
+ */
+ public static formatToHourChinese(time: number): string {
+ const curTime = time < 0 ? 0 : time;
+ const timeNum = Math.floor(curTime);
+ const hour = Math.floor(timeNum / 3600);
+ const minute = Math.floor((timeNum % 3600) / 60);
+ const seconds = timeNum % 60;
+ return `${hour}小时${minute}分${seconds}秒`;
+ }
+
+ /**
+ * 格式化倒计时 格式: xx:xx
+ * @param time 时间 (s)
+ */
+ public static formatToMinute(time: number): string {
+ const curTime = time < 0 ? 0 : time;
+ const timeNum = Math.floor(curTime);
+ const minute = Math.floor(timeNum / 60);
+ const seconds = timeNum % 60;
+ const minuteStr = minute < 10 ? `0${minute}` : `${minute}`;
+ const secondsStr = seconds < 10 ? `0${seconds}` : `${seconds}`;
+ return `${minuteStr}:${secondsStr}`;
+ }
+
+ /**
+ * 格式化倒计时 格式: xx分xx秒
+ * @param time 时间 (s)
+ */
+ public static formatToMinuteChinese(time: number): string {
+ return this.formatToMinute(time).replace(/:/g, "分") + "秒";
+ }
+}
\ No newline at end of file
diff --git a/tsconfig.json b/tsconfig.json
index f21f222..fcaa9e9 100644
--- a/tsconfig.json
+++ b/tsconfig.json
@@ -1,7 +1,7 @@
{
"compilerOptions": {
"target": "es6", //
- "module": "es6", //
+ "module": "commonjs", //
"experimentalDecorators": true, // 启用ES装饰器。
"strict": true,
"strictNullChecks": false,