minutool 1.0.14 → 1.0.16

package/dist/index.d.ts

@@ -174,6 +174,16 @@ export declare const buildHtmlHidden: (maps: Record<string, any>) => string;
  */
 export declare const buildStyleVars: (vars: Record<string, number | string | undefined>) => Record<string, string>;
 
+/**
+ * 计算剩余时间，单位为毫秒
+ * @param progress 当前进度
+ * @param total 总进度
+ * @param startTime 开始时间（毫秒时间戳）
+ * @returns 剩余时间，单位毫秒
+ * @description 根据当前进度、总进度和已用时间估算剩余时间。公式为：剩余时间 = (已用时间 / 当前进度) * (总进度 - 当前进度)。如果当前进度为0，则返回Infinity。
+ */
+export declare const calcRemainingMSecs: (progress: number, total: number, startTime: number) => number;
+
 /**
  * 驼峰命名转换
  * @param str - 输入字符串
@@ -203,11 +213,10 @@ export declare function capitalize(str: string): string;
  */
 export declare const cleanNull: (obj: any, recursive?: boolean) => any;
 
+export declare const convertMinutesToTimezoneOffsetStr: (offsetMinutes: number) => string;
+
 /**
  * 倒计时函数（该方法采用 setTimeout 方式，不够精准）
- * @param {number} timeout - 倒计时总秒数
- * @param {Function} [tickFunc] - 每秒回调函数，接收剩余秒数作为参数
- * @param {Function} [onFinish] - 倒计时结束回调函数
  * @returns {void}
  * @example
  * countDown(10, (sec) => console.log(sec), () => console.log('done'))
@@ -441,23 +450,17 @@ export declare const fileToBase64DataUri: (file: File | Blob | string) => Promis
 
 /**
  * 通过选择器查找子节点（强制添加 :scope 来约束必须是子节点）
- * @param {string|HTMLElement|HTMLElement[]|NodeList|HTMLCollection} selector - 选择器或 DOM 元素
- * @param {Document|HTMLElement} [parent=document] - 父节点，默认为 document
- * @returns {HTMLElement[]} 返回查找到的所有元素数组
  * @example
  * findAll('.item', container)
  */
-export declare const findAll: (selector: string | HTMLElement | HTMLElement[] | NodeList | HTMLCollection, parent?: Document | HTMLElement) => HTMLElement[];
+export declare const findAll: (selector: string | Element | Element[], parent?: Document | DocumentFragment | Element) => Element[];
 
 /**
  * 通过选择器查找单个节点
- * @param {string|HTMLElement} selector - 选择器，如果是 HTMLElement，则直接返回
- * @param {Document|HTMLElement} [parent=document] - 父节点，默认为 document
- * @returns {HTMLElement} 返回查找到的元素
  * @example
  * findOne('.item')
  */
-export declare const findOne: (selector: string | HTMLElement, parent?: Document | HTMLElement) => HTMLElement;
+export declare const findOne: (selector: string | Element, parent?: Document | DocumentFragment | Element) => Element | null;
 
 /**
  * 修复基本 URL（将相对路径转换为绝对 URL）
@@ -537,6 +540,22 @@ export declare const getJson: (url: string, data?: any, option?: RequestOption)
  */
 export declare const getNodeXPath: (el: HTMLElement | null) => string | null;
 
+/**
+ * 根据时区名称获取该时区相对于 UTC 的分钟偏移量（分钟）
+ * @param timeZone - 时区名称（如 "America/New_York"）
+ * @param date - 可选的日期对象，默认为当前时间
+ */
+export declare const getTimezoneOffsetMinutes: (timeZone: string) => number;
+
+/**
+ * 根据时区名称获取该时区相对于 UTC 的偏移字符串（格式为 "+HH:MM" 或 "-HH:MM"）
+ * @param timeZone - 时区名称（如 "America/New_York"）
+ * @returns 偏移字符串（如 "-05:00"）
+ * @example
+ * getTimezoneOffsetStr("America/New_York") // "-05:00"
+ */
+export declare const getTimezoneOffsetStr: (timeZone: string) => string;
+
 /**
  * 获取 UTF-8 字符串长度（一个中文字按照 3 个字数计算）
  * @param {string} str - 要计算的字符串
@@ -569,6 +588,7 @@ export declare const guid: (prefix?: string) => string;
 
 /**
  * 隐藏节点（通过设置 display:none 方式）
+ * 注：只有 HTMLElement 才有 style 属性，其他类型的 Node 没有，因此需要断言为 HTMLElement
  * @param {HTMLElement|string} dom - DOM 元素或选择器
  * @returns {void}
  * @example
@@ -1160,8 +1180,6 @@ export declare const MONTH_NOW: number;
 
 /**
  * 毫秒转换为“时分秒前”格式
- * @param {number} ms - 毫秒数
- * @returns {string} 返回格式化后的字符串
  * @example
  * msToHMS(3661000) // '1小时0分钟1秒前'
  */
@@ -1499,6 +1517,7 @@ export declare const setCookie: (name: string, value: string, days: number, path
 
 /**
  * 显示节点（通过设置 display 为空方式）
+ * 注：只有 HTMLElement 才有 style 属性，其他类型的 Node 没有，因此需要断言为 HTMLElement
  * @param {HTMLElement|string} dom - DOM 元素或选择器
  * @returns {void}
  * @example
@@ -1603,6 +1622,15 @@ export declare const throttle: (fn: Function, intervalMiSec: number) => Function
  */
 export declare const throttleEffect: (fn: Function, intervalMiSec: number) => Function;
 
+/**
+ * 将时间戳转换为本地时间的日期时间字符串（YYYY-MM-DDTHH:mm），
+ * 一般用于填充到 input[type="datetime-local"] 的 value 属性中
+ * @param timestamp 时间戳，可以是数字、字符串或 Date 对象
+ * @param includeSec 是否包含秒，默认为 false，如果为 true 则返回的字符串格式为 YYYY-MM-DDTHH:mm:ss
+ * @returns 本地时间的日期时间字符串，格式为 YYYY-MM-DDTHH:mm:ss（如果 includeSec 参数为 true 则包含秒）
+ */
+export declare const timestampToDateTimeLocal: (timestamp: number | string | Date, includeSec?: boolean) => string;
+
 /**
  * 禁用启用元素切换
  * @param {String|Node} el