npm - @cloudcome/utils-core - Versions diffs - 1.18.1 → 1.19.0 - Mend

@cloudcome/utils-core 1.18.1 → 1.19.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (21) hide show

package/README.md CHANGED Viewed

@@ -5,14 +5,120 @@
 [![Codacy Badge](https://app.codacy.com/project/badge/Grade/4fa1acaeb717469caddfe21a84c50bb2)](https://app.codacy.com/gh/cloudcome/utils/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade)
 [![Codacy Badge](https://app.codacy.com/project/badge/Coverage/4fa1acaeb717469caddfe21a84c50bb2)](https://app.codacy.com/gh/cloudcome/utils/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_coverage)
+跨平台、多框架的 TypeScript 工具函数库，覆盖浏览器、Node.js、Vue、React、UniApp 等环境。
+## 包列表
 | 名称 | 版本 | 描述 |
 | --- | --- | --- |
-| @cloudcome/utils-core | [![npm version](https://badge.fury.io/js/@cloudcome%2Futils-core.svg)](https://npmjs.com/package/@cloudcome/utils-core) | 核心工具库 |
-| @cloudcome/utils-browser | [![npm version](https://badge.fury.io/js/@cloudcome%2Futils-browser.svg)](https://npmjs.com/package/@cloudcome/utils-browser) | 浏览器工具库 |
-| @cloudcome/utils-node| [![npm version](https://badge.fury.io/js/@cloudcome%2Futils-node.svg)](https://npmjs.com/package/@cloudcome/utils-node) | Node.js 工具库 |
-| @cloudcome/utils-vue| [![npm version](https://badge.fury.io/js/@cloudcome%2Futils-vue.svg)](https://npmjs.com/package/@cloudcome/utils-vue) | Vue 工具库 |
-| @cloudcome/utils-react| [![npm version](https://badge.fury.io/js/@cloudcome%2Futils-react.svg)](https://npmjs.com/package/@cloudcome/utils-react) | React 工具库 |
-| @cloudcome/utils-uni| [![npm version](https://badge.fury.io/js/@cloudcome%2Futils-uni.svg)](https://npmjs.com/package/@cloudcome/utils-uni) | UniApp 工具库 |
+| [@cloudcome/utils-core](./packages/utils-core) | [![npm version](https://badge.fury.io/js/@cloudcome%2Futils-core.svg)](https://npmjs.com/package/@cloudcome/utils-core) | 核心工具库，与运行环境无关的通用工具 |
+| [@cloudcome/utils-browser](./packages/utils-browser) | [![npm version](https://badge.fury.io/js/@cloudcome%2Futils-browser.svg)](https://npmjs.com/package/@cloudcome/utils-browser) | 浏览器端工具（DOM、Canvas、Cookie、剪贴板等） |
+| [@cloudcome/utils-node](./packages/utils-node) | [![npm version](https://badge.fury.io/js/@cloudcome%2Futils-node.svg)](https://npmjs.com/package/@cloudcome/utils-node) | Node.js 端工具（Base64、加密等） |
+| [@cloudcome/utils-vue](./packages/utils-vue) | [![npm version](https://badge.fury.io/js/@cloudcome%2Futils-vue.svg)](https://npmjs.com/package/@cloudcome/utils-vue) | Vue 3 工具库（组合式函数、组件、请求等） |
+| [@cloudcome/utils-react](./packages/utils-react) | [![npm version](https://badge.fury.io/js/@cloudcome%2Futils-react.svg)](https://npmjs.com/package/@cloudcome/utils-react) | React 工具库 |
+| [@cloudcome/utils-uni](./packages/utils-uni) | [![npm version](https://badge.fury.io/js/@cloudcome%2Futils-uni.svg)](https://npmjs.com/package/@cloudcome/utils-uni) | UniApp 工具库（云函数、数据库、页面等） |
+| [@cloudcome/docs](./packages/docs) | - | VitePress 文档站点 |
+## 功能概览
+### @cloudcome/utils-core
+核心工具库，提供以下子模块：
+| 子模块 | 导入路径 | 功能 |
+| --- | --- | --- |
+| array | `@cloudcome/utils-core/array` | 数组操作 |
+| async | `@cloudcome/utils-core/async` | 异步工具 |
+| base64 | `@cloudcome/utils-core/base64` | Base64 编解码 |
+| cache | `@cloudcome/utils-core/cache` | 缓存工具 |
+| color | `@cloudcome/utils-core/color` | 颜色转换（RGB/HSL/HSV/HWB/LAB/XYZ）、对比度、亮度、混合 |
+| crypto | `@cloudcome/utils-core/crypto` | 加密（MD5、SHA1、SHA256、SHA512） |
+| date | `@cloudcome/utils-core/date` | 日期解析、格式化、时区、相对时间、周/天计算 |
+| dict | `@cloudcome/utils-core/dict` | 字典/映射工具 |
+| easing | `@cloudcome/utils-core/easing` | 缓动函数 |
+| emitter | `@cloudcome/utils-core/emitter` | 事件发射器 |
+| env | `@cloudcome/utils-core/env` | 环境检测 |
+| error | `@cloudcome/utils-core/error` | 错误处理 |
+| exception | `@cloudcome/utils-core/exception` | 异常处理 |
+| function | `@cloudcome/utils-core/function` | 函数工具 |
+| number | `@cloudcome/utils-core/number` | 数字工具 |
+| object | `@cloudcome/utils-core/object` | 对象遍历、深层 get/set、合并、类型判断 |
+| path | `@cloudcome/utils-core/path` | 路径工具 |
+| promise | `@cloudcome/utils-core/promise` | Promise 工具 |
+| qs | `@cloudcome/utils-core/qs` | 查询字符串解析与序列化 |
+| regexp | `@cloudcome/utils-core/regexp` | 正则表达式工具 |
+| string | `@cloudcome/utils-core/string` | 字符串工具 |
+| time | `@cloudcome/utils-core/time` | 时间单位转换 |
+| timer | `@cloudcome/utils-core/timer` | 定时器工具 |
+| tree | `@cloudcome/utils-core/tree` | 树结构操作 |
+| try | `@cloudcome/utils-core/try` | 安全调用（try-catch 包装，支持同步/异步/柯里化） |
+| type | `@cloudcome/utils-core/type` | 类型判断 |
+| types | `@cloudcome/utils-core/types` | 公共类型定义 |
+| unique | `@cloudcome/utils-core/unique` | 唯一 ID 生成 |
+| url | `@cloudcome/utils-core/url` | URL 解析与构建 |
+| version | `@cloudcome/utils-core/version` | 版本号比较 |
+### @cloudcome/utils-browser
+浏览器端工具库，依赖 `@cloudcome/utils-core`：
+| 子模块 | 导入路径 | 功能 |
+| --- | --- | --- |
+| base64 | `@cloudcome/utils-browser/base64` | 浏览器端 Base64 编解码 |
+| cache | `@cloudcome/utils-browser/cache` | 浏览器缓存（localStorage/sessionStorage） |
+| canvas | `@cloudcome/utils-browser/canvas` | Canvas 操作 |
+| clipboard | `@cloudcome/utils-browser/clipboard` | 剪贴板读写 |
+| cookie | `@cloudcome/utils-browser/cookie` | Cookie 读写 |
+| dom | `@cloudcome/utils-browser/dom` | DOM 操作 |
+| download | `@cloudcome/utils-browser/download` | 文件下载 |
+| image | `@cloudcome/utils-browser/image` | 图片处理 |
+| timer | `@cloudcome/utils-browser/timer` | 浏览器端定时器 |
+| video | `@cloudcome/utils-browser/video` | 视频处理 |
+### @cloudcome/utils-node
+Node.js 端工具库：
+| 子模块 | 导入路径 | 功能 |
+| --- | --- | --- |
+| base64 | `@cloudcome/utils-node/base64` | Node.js 端 Base64 编解码 |
+| crypto | `@cloudcome/utils-node/crypto` | Node.js 端加密工具 |
+### @cloudcome/utils-vue
+Vue 3 工具库，依赖 `@cloudcome/utils-core` 和 `vue`：
+| 子模块 | 导入路径 | 功能 |
+| --- | --- | --- |
+| async | `@cloudcome/utils-vue/async` | Vue 异步组合式函数 |
+| component | `@cloudcome/utils-vue/component` | 组件工具（生命周期等） |
+| event | `@cloudcome/utils-vue/event` | 事件工具 |
+| request | `@cloudcome/utils-vue/request` | 请求组合式函数（useRequest） |
+| shared | `@cloudcome/utils-vue/shared` | 共享工具 |
+| state | `@cloudcome/utils-vue/state` | 状态管理工具 |
+| time | `@cloudcome/utils-vue/time` | 时间相关组合式函数 |
+| types | `@cloudcome/utils-vue/types` | 类型定义 |
+### @cloudcome/utils-react
+React 工具库。
+### @cloudcome/utils-uni
+UniApp 工具库，依赖 `@cloudcome/utils-core`、`@cloudcome/utils-vue`：
+| 子模块 | 导入路径 | 功能 |
+| --- | --- | --- |
+| app | `@cloudcome/utils-uni/app` | App 相关工具 |
+| client | `@cloudcome/utils-uni/client` | 客户端工具 |
+| cloud | `@cloudcome/utils-uni/cloud` | 云函数工具（调用、错误处理、uni-id 等） |
+| database | `@cloudcome/utils-uni/database` | 数据库操作（CRUD、事务、分页、upsert 等） |
+| page | `@cloudcome/utils-uni/page` | 页面相关工具 |
+## 开发
+详见 [DEVELOPMENT.md](./DEVELOPMENT.md)。
+## 许可
+[MIT](LICENSE)

package/dist/core.cjs CHANGED Viewed

@@ -329,14 +329,14 @@ const rules = [
     /h{2}/g,
     (date) => {
       const h = date.getHours();
-      return _pad(h > 12 ? h - 12 : h);
+      return _pad(h === 0 ? 12 : h > 12 ? h - 12 : h);
     }
   ],
   [
     /h{1}/g,
     (date) => {
       const h = date.getHours();
-      return h > 12 ? h - 12 : h;
+      return h === 0 ? 12 : h > 12 ? h - 12 : h;
     }
   ],
   [/m{2}/g, (date) => _pad(date.getMinutes())],

package/dist/core.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"core.cjs","sources":["../src/date/timezone.ts","../src/date/core.ts"],"sourcesContent":["import { isNumber } from '../type';\nimport { dateFormat } from './core';\n\nexport type TimezoneDateOptions = {\n /*\n 时间戳\n * @default Date.now()\n /\n timestamp?: number;\n\n /\n 日期值\n /\n value?: readonly [\n year?: number,\n month?: number,\n day?: number,\n hours?: number,\n minutes?: number,\n seconds?: number,\n milliseconds?: number,\n ];\n\n /\n UTC 时区，支持负数和小数，例如：\n * - 8 表示 UTC+8\n * - -12 表示 UTC-12\n * - 0 表示 UTC 时间\n * - 12.5 表示 UTC+12:30\n /\n utcOffset?: number;\n};\n\n/\n 时区偏移量毫秒常量（1分钟 = 60 * 1000 毫秒）\n /\nconst TIMEZONE_OFFSET_MS = 60 1000;\n\n/*\n 时区日期类，用于处理不同时区的日期时间\n /\nexport class TimezoneDate {\n /\n 内部时间戳\n /\n #timestamp: number;\n\n /\n 目标时区的日期对象\n /\n #targetDate: Date;\n\n /\n UTC 日期对象\n /\n #utcDate: Date;\n\n /\n 本地时区偏移量（分钟）\n /\n #localTimezoneOffset = TimezoneDate.getTimezoneOffset();\n\n /\n 本地时区偏移量（毫秒）\n /\n #localTimezoneOffsetMS = this.#localTimezoneOffset TIMEZONE_OFFSET_MS;\n\n /*\n 目标时区偏移量（分钟）\n /\n #targetTimezoneOffset = 0;\n\n /\n 目标时区偏移量（毫秒）\n /\n #targetTimezoneOffsetMS = 0;\n\n /\n 构造函数选项\n /\n #options: TimezoneDateOptions;\n\n /\n 构造一个 TimezoneDate 实例\n * @param options - 配置选项\n /\n constructor(options?: TimezoneDateOptions \| TimezoneDate) {\n this.#options =\n (options instanceof TimezoneDate\n ? {\n timestamp: options.getTime(),\n utcOffset: options.getUTCOffset(),\n }\n : options) \|\| {};\n const { utcOffset, timestamp, value } = this.#options;\n this.#targetTimezoneOffset = isNumber(utcOffset)\n ? TimezoneDate.getTimezoneOffset(utcOffset)\n : this.#localTimezoneOffset;\n this.#targetTimezoneOffsetMS = this.#targetTimezoneOffset TIMEZONE_OFFSET_MS;\n\n if (Array.isArray(value) && value.length > 0) {\n const [fullYear, month, day, hours, minutes, seconds, milliseconds] = value;\n const timestamp = Date.UTC(\n fullYear ?? 0,\n month ?? 0,\n day ?? 1,\n hours ?? 0,\n minutes ?? 0,\n seconds ?? 0,\n milliseconds ?? 0,\n );\n\n this.#timestamp = timestamp + this.#targetTimezoneOffsetMS;\n } else {\n this.#timestamp = timestamp \|\| Date.now();\n }\n\n this.#targetDate = new Date(this.#timestamp + this.#localTimezoneOffsetMS - this.#targetTimezoneOffsetMS);\n this.#utcDate = new Date(this.#timestamp + this.#localTimezoneOffsetMS);\n }\n\n /*\n 更新内部时间戳\n /\n #updateTimestamp() {\n this.#timestamp = this.#targetDate.getTime() + this.#targetTimezoneOffsetMS - this.#localTimezoneOffsetMS;\n this.#utcDate = new Date(this.#timestamp + this.#localTimezoneOffsetMS);\n }\n\n /\n 获取时区偏移量（分钟）\n * @returns 时区偏移量\n /\n getTimezoneOffset() {\n return this.#targetTimezoneOffset;\n }\n\n /\n 获取时区偏移量（UTC）\n * @returns 时区序号\n /\n getUTCOffset() {\n return TimezoneDate.getUTCOffset(this.#targetTimezoneOffset);\n }\n\n /\n 获取年份\n * @returns 年份\n /\n getFullYear() {\n return this.#targetDate.getFullYear();\n }\n\n /\n 获取月份\n * @returns 月份 (0-11)\n /\n getMonth() {\n return this.#targetDate.getMonth();\n }\n\n /\n 获取日期\n * @returns 日期 (1-31)\n /\n getDate() {\n return this.#targetDate.getDate();\n }\n\n /\n 获取小时\n * @returns 小时 (0-23)\n /\n getHours() {\n return this.#targetDate.getHours();\n }\n\n /\n 获取分钟\n * @returns 分钟 (0-59)\n /\n getMinutes() {\n return this.#targetDate.getMinutes();\n }\n\n /\n 获取秒数\n * @returns 秒数 (0-59)\n /\n getSeconds() {\n return this.#targetDate.getSeconds();\n }\n\n /\n 获取毫秒\n * @returns 毫秒 (0-999)\n /\n getMilliseconds() {\n return this.#targetDate.getMilliseconds();\n }\n\n /\n 设置年份\n * @param year - 年份\n * @param month - 月份\n * @param date - 日期\n * @returns 时间戳\n /\n setFullYear(year: number, month?: number, date?: number) {\n this.#targetDate.setFullYear(year);\n this.#updateTimestamp();\n\n if (isNumber(month)) this.setMonth(month);\n if (isNumber(date)) this.setDate(date);\n\n return this.getTime();\n }\n\n /\n 设置月份\n * @param month - 月份\n * @param date - 日期\n * @returns 时间戳\n /\n setMonth(month: number, date?: number) {\n this.#targetDate.setMonth(month);\n this.#updateTimestamp();\n\n if (isNumber(date)) this.setDate(date);\n\n return this.getTime();\n }\n\n /\n 设置日期\n * @param date - 日期\n * @returns 时间戳\n /\n setDate(date: number) {\n this.#targetDate.setDate(date);\n this.#updateTimestamp();\n\n return this.getTime();\n }\n\n /\n 设置小时\n * @param hours - 小时\n * @param minutes - 分钟\n * @param seconds - 秒数\n * @param milliseconds - 毫秒\n * @returns 时间戳\n /\n setHours(hours: number, minutes?: number, seconds?: number, milliseconds?: number) {\n this.#targetDate.setHours(hours);\n this.#updateTimestamp();\n\n if (isNumber(minutes)) this.setMinutes(minutes);\n if (isNumber(seconds)) this.setSeconds(seconds);\n if (isNumber(milliseconds)) this.setMilliseconds(milliseconds);\n\n return this.getTime();\n }\n\n /\n 设置分钟\n * @param minutes - 分钟\n * @param seconds - 秒数\n * @param milliseconds - 毫秒\n * @returns 时间戳\n /\n setMinutes(minutes: number, seconds?: number, milliseconds?: number) {\n this.#targetDate.setMinutes(minutes);\n this.#updateTimestamp();\n\n if (isNumber(seconds)) this.setSeconds(seconds);\n if (isNumber(milliseconds)) this.setMilliseconds(milliseconds);\n\n return this.getTime();\n }\n\n /\n 设置秒数\n * @param seconds - 秒数\n * @param milliseconds - 毫秒\n * @returns 时间戳\n /\n setSeconds(seconds: number, milliseconds?: number) {\n this.#targetDate.setSeconds(seconds);\n this.#updateTimestamp();\n\n if (isNumber(milliseconds)) this.setMilliseconds(milliseconds);\n\n return this.getTime();\n }\n\n /\n 设置毫秒\n * @param milliseconds - 毫秒\n * @returns 时间戳\n /\n setMilliseconds(milliseconds: number) {\n this.#targetDate.setMilliseconds(milliseconds);\n this.#updateTimestamp();\n\n return this.getTime();\n }\n\n /\n 获取时间戳\n * @returns 时间戳\n /\n getTime() {\n return this.#timestamp;\n }\n\n /\n 获取星期几\n * @returns 星期几 (0-6, 0表示周日)\n /\n getDay() {\n return this.#targetDate.getDay();\n }\n\n /\n 转换为 ISO 格式的字符串\n * @returns ISO 格式的时间字符串\n /\n toISOString() {\n return dateFormat(this.#utcDate, 'YYYY-MM-DDTHH:mm:ss.SSSZ');\n }\n\n /\n 转换为指定时区的 TimezoneDate 对象\n * @param td - 需要转换的日期对象\n * @param offset - 目标时区分钟偏移量，默认为当前时区\n * @returns 返回一个 TimezoneDate 对象\n * @example\n * ```js\n * // 转换为 UTC 时间\n * const utc0Td = TimezoneDate.changeUtcOffset(new TimezoneDate(), 0);\n \n // 转换为东八区时间\n * const utc8Td = TimezoneDate.changeUtcOffset(new TimezoneDate(), 8);\n * ```\n /\n static changeUtcOffset(td: TimezoneDate, utcOffset: number) {\n return new TimezoneDate({\n utcOffset,\n timestamp: td.getTime(),\n });\n }\n\n /\n 获取时区分钟偏移量\n * @param utcOffset - 默认使用当前时区\n * @returns 时区分钟偏移量\n /\n static getTimezoneOffset(utcOffset?: number) {\n return isNumber(utcOffset) ? utcOffset -60 : new Date().getTimezoneOffset();\n }\n\n /*\n 获取时区序号\n * @param timezoneOffset - 默认使用当前时区分钟偏移量\n * @returns 时区序号\n /\n static getUTCOffset(timezoneOffset = TimezoneDate.getTimezoneOffset()) {\n return timezoneOffset / -60;\n }\n}\n","import { objectEach } from '@/object';\nimport { isDate, isString } from '@/type';\nimport { TimezoneDate } from './timezone';\n\n/\n 判断一个值是否为有效的日期对象\n * @param unknown - 需要判断的值\n * @returns 如果值是有效的日期对象则返回 true，否则返回 false\n * @example\n * ```typescript\n * isValidDate(new Date()); // true\n * isValidDate('2023-01-01'); // false\n * isValidDate(NaN); // false\n * ```\n /\nexport function isValidDate(unknown: unknown): unknown is Date \| TimezoneDate {\n return (\n (unknown instanceof Date && !Number.isNaN(unknown.getTime())) \|\|\n (unknown instanceof TimezoneDate && !Number.isNaN(unknown.getTime()))\n );\n}\n\nexport type DateLike = Date \| TimezoneDate;\nexport type DateValue = number \| string \| DateLike;\n\nfunction _guessDateSeparator(value: DateValue): Date \| undefined {\n if (!isString(value)) return;\n\n const value2 = value.replace(/-/g, '/');\n\n return new Date(value2);\n}\n\nfunction _guessDateTimezone(value: DateValue): Date \| undefined {\n if (!isString(value)) return;\n\n const re = /([+-])(\\d\\d)(\\d\\d)$/;\n\n const matches = re.exec(value);\n\n if (!matches) return;\n\n const value2 = value.replace(re, 'Z');\n const d = new Date(value2);\n\n if (!isValidDate(d)) return;\n\n const [, flag, hours, minutes] = matches;\n const hours2 = Number.parseInt(hours, 10);\n const minutes2 = Number.parseInt(minutes, 10);\n const offset = (a: number, b: number): number => (flag === '+' ? a - b : a + b);\n\n d.setHours(offset(d.getHours(), hours2));\n d.setMinutes(offset(d.getMinutes(), minutes2));\n\n return d;\n}\n\n/\n 解析为Date对象\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 解析后的 Date 对象\n * @throws {SyntaxError} 如果无法解析为有效的日期对象，则抛出错误\n * @example\n * ```typescript\n * dateParse('2023-01-01'); // Date对象\n * dateParse(1672531200000); // Date对象\n * dateParse(new Date()); // Date对象\n * dateParse('invalid date'); // 抛出 SyntaxError\n * ```\n /\nexport function dateParse(dateValue: DateValue): DateLike {\n // 传入的 Date 对象有 Date、TimezoneDate\n // @ts-ignore\n const d1 = isDate(dateValue)\n ? new Date(dateValue)\n : dateValue instanceof TimezoneDate\n ? new TimezoneDate(dateValue)\n : new Date(dateValue);\n if (isValidDate(d1)) return d1;\n\n // safari 浏览器的日期解析有问题\n // new Date('2020-06-26 18:06:15') 返回值是一个非法日期对象\n const d2 = _guessDateSeparator(dateValue);\n if (isValidDate(d2)) return d2;\n\n // safari 浏览器的日期解析有问题\n // new Date('2020-06-26T18:06:15.000+0800') 返回值是一个非法日期对象\n const d3 = _guessDateTimezone(dateValue);\n if (isValidDate(d3)) return d3;\n\n throw new SyntaxError(`${dateValue.toString()} 不是一个合法的日期值`);\n}\n\nfunction _pad(num: number, len = 2) {\n return `${num}`.padStart(len, '0');\n}\n\nconst rules: [RegExp, (date: DateLike) => number \| string][] = [\n [/Y{4}/gi, (date) => date.getFullYear()],\n [/Y{2}/gi, (date) => date.getFullYear() % 100],\n [/M{2}/g, (date) => _pad(date.getMonth() + 1)],\n [/M{1}/g, (date) => date.getMonth() + 1],\n [/D{2}/gi, (date) => _pad(date.getDate())],\n [/D{1}/gi, (date) => date.getDate()],\n [/H{2}/g, (date) => _pad(date.getHours())],\n [/H{1}/g, (date) => date.getHours()],\n [\n /h{2}/g,\n (date) => {\n const h = date.getHours();\n return _pad(h > 12 ? h - 12 : h);\n },\n ],\n [\n /h{1}/g,\n (date) => {\n const h = date.getHours();\n return h > 12 ? h - 12 : h;\n },\n ],\n [/m{2}/g, (date) => _pad(date.getMinutes())],\n [/m{1}/g, (date) => date.getMinutes()],\n [/s{2}/g, (date) => _pad(date.getSeconds())],\n [/s{1}/g, (date) => date.getSeconds()],\n [/S{3}/g, (date) => _pad(date.getMilliseconds(), 3)],\n [/S{2}/g, (date) => _pad(date.getMilliseconds(), 2)],\n [/S{1}/g, (date) => date.getMilliseconds()],\n];\n\n/\n 格式化为日期字符串(带自定义格式化模板)\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param format - 模板，默认是 'YYYY-MM-DD HH:mm:ss'，模板字符：\n * - YYYY：年\n * - yyyy: 年\n * - MM：月\n * - DD：日\n * - dd: 日\n * - HH：时（24 小时制）\n * - hh：时（12 小时制）\n * - mm：分\n * - ss：秒\n * - SSS：毫秒\n * @returns 格式化后的日期字符串\n * @example\n * ```typescript\n * dateFormat(new Date(), 'YYYY-MM-DD'); // '2023-01-01'\n * dateFormat(1672531200000, 'YYYY/MM/DD HH:mm:ss'); // '2023/01/01 00:00:00'\n * dateFormat('2023-01-01', 'YYYY年MM月DD日'); // '2023年01月01日'\n * ```\n */\nexport function dateFormat(dateValue: DateValue, format = 'YYYY-MM-DD HH:mm:ss'): string {\n const date = dateParse(dateValue);\n let result = format;\n\n for (const rule of rules) {\n result = result.replace(rule[0], String(rule[1](date)));\n }\n\n return result;\n}\n"],"names":["isNumber","timestamp","isString","isDate"],"mappings":"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"}
1	+ {"version":3,"file":"core.cjs","sources":["../src/date/timezone.ts","../src/date/core.ts"],"sourcesContent":["import { isNumber } from '../type';\nimport { dateFormat } from './core';\n\nexport type TimezoneDateOptions = {\n /*\n 时间戳\n * @default Date.now()\n /\n timestamp?: number;\n\n /\n 日期值\n /\n value?: readonly [\n year?: number,\n month?: number,\n day?: number,\n hours?: number,\n minutes?: number,\n seconds?: number,\n milliseconds?: number,\n ];\n\n /\n UTC 时区，支持负数和小数，例如：\n * - 8 表示 UTC+8\n * - -12 表示 UTC-12\n * - 0 表示 UTC 时间\n * - 12.5 表示 UTC+12:30\n /\n utcOffset?: number;\n};\n\n/\n 时区偏移量毫秒常量（1分钟 = 60 * 1000 毫秒）\n /\nconst TIMEZONE_OFFSET_MS = 60 1000;\n\n/*\n 时区日期类，用于处理不同时区的日期时间\n /\nexport class TimezoneDate {\n /\n 内部时间戳\n /\n #timestamp: number;\n\n /\n 目标时区的日期对象\n /\n #targetDate: Date;\n\n /\n UTC 日期对象\n /\n #utcDate: Date;\n\n /\n 本地时区偏移量（分钟）\n /\n #localTimezoneOffset = TimezoneDate.getTimezoneOffset();\n\n /\n 本地时区偏移量（毫秒）\n /\n #localTimezoneOffsetMS = this.#localTimezoneOffset TIMEZONE_OFFSET_MS;\n\n /*\n 目标时区偏移量（分钟）\n /\n #targetTimezoneOffset = 0;\n\n /\n 目标时区偏移量（毫秒）\n /\n #targetTimezoneOffsetMS = 0;\n\n /\n 构造函数选项\n /\n #options: TimezoneDateOptions;\n\n /\n 构造一个 TimezoneDate 实例\n * @param options - 配置选项\n /\n constructor(options?: TimezoneDateOptions \| TimezoneDate) {\n this.#options =\n (options instanceof TimezoneDate\n ? {\n timestamp: options.getTime(),\n utcOffset: options.getUTCOffset(),\n }\n : options) \|\| {};\n const { utcOffset, timestamp, value } = this.#options;\n this.#targetTimezoneOffset = isNumber(utcOffset)\n ? TimezoneDate.getTimezoneOffset(utcOffset)\n : this.#localTimezoneOffset;\n this.#targetTimezoneOffsetMS = this.#targetTimezoneOffset TIMEZONE_OFFSET_MS;\n\n if (Array.isArray(value) && value.length > 0) {\n const [fullYear, month, day, hours, minutes, seconds, milliseconds] = value;\n const timestamp = Date.UTC(\n fullYear ?? 0,\n month ?? 0,\n day ?? 1,\n hours ?? 0,\n minutes ?? 0,\n seconds ?? 0,\n milliseconds ?? 0,\n );\n\n this.#timestamp = timestamp + this.#targetTimezoneOffsetMS;\n } else {\n this.#timestamp = timestamp \|\| Date.now();\n }\n\n this.#targetDate = new Date(this.#timestamp + this.#localTimezoneOffsetMS - this.#targetTimezoneOffsetMS);\n this.#utcDate = new Date(this.#timestamp + this.#localTimezoneOffsetMS);\n }\n\n /*\n 更新内部时间戳\n /\n #updateTimestamp() {\n this.#timestamp = this.#targetDate.getTime() + this.#targetTimezoneOffsetMS - this.#localTimezoneOffsetMS;\n this.#utcDate = new Date(this.#timestamp + this.#localTimezoneOffsetMS);\n }\n\n /\n 获取时区偏移量（分钟）\n * @returns 时区偏移量\n /\n getTimezoneOffset() {\n return this.#targetTimezoneOffset;\n }\n\n /\n 获取时区偏移量（UTC）\n * @returns 时区序号\n /\n getUTCOffset() {\n return TimezoneDate.getUTCOffset(this.#targetTimezoneOffset);\n }\n\n /\n 获取年份\n * @returns 年份\n /\n getFullYear() {\n return this.#targetDate.getFullYear();\n }\n\n /\n 获取月份\n * @returns 月份 (0-11)\n /\n getMonth() {\n return this.#targetDate.getMonth();\n }\n\n /\n 获取日期\n * @returns 日期 (1-31)\n /\n getDate() {\n return this.#targetDate.getDate();\n }\n\n /\n 获取小时\n * @returns 小时 (0-23)\n /\n getHours() {\n return this.#targetDate.getHours();\n }\n\n /\n 获取分钟\n * @returns 分钟 (0-59)\n /\n getMinutes() {\n return this.#targetDate.getMinutes();\n }\n\n /\n 获取秒数\n * @returns 秒数 (0-59)\n /\n getSeconds() {\n return this.#targetDate.getSeconds();\n }\n\n /\n 获取毫秒\n * @returns 毫秒 (0-999)\n /\n getMilliseconds() {\n return this.#targetDate.getMilliseconds();\n }\n\n /\n 设置年份\n * @param year - 年份\n * @param month - 月份\n * @param date - 日期\n * @returns 时间戳\n /\n setFullYear(year: number, month?: number, date?: number) {\n this.#targetDate.setFullYear(year);\n this.#updateTimestamp();\n\n if (isNumber(month)) this.setMonth(month);\n if (isNumber(date)) this.setDate(date);\n\n return this.getTime();\n }\n\n /\n 设置月份\n * @param month - 月份\n * @param date - 日期\n * @returns 时间戳\n /\n setMonth(month: number, date?: number) {\n this.#targetDate.setMonth(month);\n this.#updateTimestamp();\n\n if (isNumber(date)) this.setDate(date);\n\n return this.getTime();\n }\n\n /\n 设置日期\n * @param date - 日期\n * @returns 时间戳\n /\n setDate(date: number) {\n this.#targetDate.setDate(date);\n this.#updateTimestamp();\n\n return this.getTime();\n }\n\n /\n 设置小时\n * @param hours - 小时\n * @param minutes - 分钟\n * @param seconds - 秒数\n * @param milliseconds - 毫秒\n * @returns 时间戳\n /\n setHours(hours: number, minutes?: number, seconds?: number, milliseconds?: number) {\n this.#targetDate.setHours(hours);\n this.#updateTimestamp();\n\n if (isNumber(minutes)) this.setMinutes(minutes);\n if (isNumber(seconds)) this.setSeconds(seconds);\n if (isNumber(milliseconds)) this.setMilliseconds(milliseconds);\n\n return this.getTime();\n }\n\n /\n 设置分钟\n * @param minutes - 分钟\n * @param seconds - 秒数\n * @param milliseconds - 毫秒\n * @returns 时间戳\n /\n setMinutes(minutes: number, seconds?: number, milliseconds?: number) {\n this.#targetDate.setMinutes(minutes);\n this.#updateTimestamp();\n\n if (isNumber(seconds)) this.setSeconds(seconds);\n if (isNumber(milliseconds)) this.setMilliseconds(milliseconds);\n\n return this.getTime();\n }\n\n /\n 设置秒数\n * @param seconds - 秒数\n * @param milliseconds - 毫秒\n * @returns 时间戳\n /\n setSeconds(seconds: number, milliseconds?: number) {\n this.#targetDate.setSeconds(seconds);\n this.#updateTimestamp();\n\n if (isNumber(milliseconds)) this.setMilliseconds(milliseconds);\n\n return this.getTime();\n }\n\n /\n 设置毫秒\n * @param milliseconds - 毫秒\n * @returns 时间戳\n /\n setMilliseconds(milliseconds: number) {\n this.#targetDate.setMilliseconds(milliseconds);\n this.#updateTimestamp();\n\n return this.getTime();\n }\n\n /\n 获取时间戳\n * @returns 时间戳\n /\n getTime() {\n return this.#timestamp;\n }\n\n /\n 获取星期几\n * @returns 星期几 (0-6, 0表示周日)\n /\n getDay() {\n return this.#targetDate.getDay();\n }\n\n /\n 转换为 ISO 格式的字符串\n * @returns ISO 格式的时间字符串\n /\n toISOString() {\n return dateFormat(this.#utcDate, 'YYYY-MM-DDTHH:mm:ss.SSSZ');\n }\n\n /\n 转换为指定时区的 TimezoneDate 对象\n * @param td - 需要转换的日期对象\n * @param offset - 目标时区分钟偏移量，默认为当前时区\n * @returns 返回一个 TimezoneDate 对象\n * @example\n * ```js\n * // 转换为 UTC 时间\n * const utc0Td = TimezoneDate.changeUtcOffset(new TimezoneDate(), 0);\n \n // 转换为东八区时间\n * const utc8Td = TimezoneDate.changeUtcOffset(new TimezoneDate(), 8);\n * ```\n /\n static changeUtcOffset(td: TimezoneDate, utcOffset: number) {\n return new TimezoneDate({\n utcOffset,\n timestamp: td.getTime(),\n });\n }\n\n /\n 获取时区分钟偏移量\n * @param utcOffset - 默认使用当前时区\n * @returns 时区分钟偏移量\n /\n static getTimezoneOffset(utcOffset?: number) {\n return isNumber(utcOffset) ? utcOffset -60 : new Date().getTimezoneOffset();\n }\n\n /*\n 获取时区序号\n * @param timezoneOffset - 默认使用当前时区分钟偏移量\n * @returns 时区序号\n /\n static getUTCOffset(timezoneOffset = TimezoneDate.getTimezoneOffset()) {\n return timezoneOffset / -60;\n }\n}\n","import { objectEach } from '@/object';\nimport { isDate, isString } from '@/type';\nimport { TimezoneDate } from './timezone';\n\n/\n 判断一个值是否为有效的日期对象\n * @param unknown - 需要判断的值\n * @returns 如果值是有效的日期对象则返回 true，否则返回 false\n * @example\n * ```typescript\n * isValidDate(new Date()); // true\n * isValidDate('2023-01-01'); // false\n * isValidDate(NaN); // false\n * ```\n /\nexport function isValidDate(unknown: unknown): unknown is Date \| TimezoneDate {\n return (\n (unknown instanceof Date && !Number.isNaN(unknown.getTime())) \|\|\n (unknown instanceof TimezoneDate && !Number.isNaN(unknown.getTime()))\n );\n}\n\nexport type DateLike = Date \| TimezoneDate;\nexport type DateValue = number \| string \| DateLike;\n\nfunction _guessDateSeparator(value: DateValue): Date \| undefined {\n if (!isString(value)) return;\n\n const value2 = value.replace(/-/g, '/');\n\n return new Date(value2);\n}\n\nfunction _guessDateTimezone(value: DateValue): Date \| undefined {\n if (!isString(value)) return;\n\n const re = /([+-])(\\d\\d)(\\d\\d)$/;\n\n const matches = re.exec(value);\n\n if (!matches) return;\n\n const value2 = value.replace(re, 'Z');\n const d = new Date(value2);\n\n if (!isValidDate(d)) return;\n\n const [, flag, hours, minutes] = matches;\n const hours2 = Number.parseInt(hours, 10);\n const minutes2 = Number.parseInt(minutes, 10);\n const offset = (a: number, b: number): number => (flag === '+' ? a - b : a + b);\n\n d.setHours(offset(d.getHours(), hours2));\n d.setMinutes(offset(d.getMinutes(), minutes2));\n\n return d;\n}\n\n/\n 解析为Date对象\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 解析后的 Date 对象\n * @throws {SyntaxError} 如果无法解析为有效的日期对象，则抛出错误\n * @example\n * ```typescript\n * dateParse('2023-01-01'); // Date对象\n * dateParse(1672531200000); // Date对象\n * dateParse(new Date()); // Date对象\n * dateParse('invalid date'); // 抛出 SyntaxError\n * ```\n /\nexport function dateParse(dateValue: DateValue): DateLike {\n // 传入的 Date 对象有 Date、TimezoneDate\n // @ts-ignore\n const d1 = isDate(dateValue)\n ? new Date(dateValue)\n : dateValue instanceof TimezoneDate\n ? new TimezoneDate(dateValue)\n : new Date(dateValue);\n if (isValidDate(d1)) return d1;\n\n // safari 浏览器的日期解析有问题\n // new Date('2020-06-26 18:06:15') 返回值是一个非法日期对象\n const d2 = _guessDateSeparator(dateValue);\n if (isValidDate(d2)) return d2;\n\n // safari 浏览器的日期解析有问题\n // new Date('2020-06-26T18:06:15.000+0800') 返回值是一个非法日期对象\n const d3 = _guessDateTimezone(dateValue);\n if (isValidDate(d3)) return d3;\n\n throw new SyntaxError(`${dateValue.toString()} 不是一个合法的日期值`);\n}\n\nfunction _pad(num: number, len = 2) {\n return `${num}`.padStart(len, '0');\n}\n\nconst rules: [RegExp, (date: DateLike) => number \| string][] = [\n [/Y{4}/gi, (date) => date.getFullYear()],\n [/Y{2}/gi, (date) => date.getFullYear() % 100],\n [/M{2}/g, (date) => _pad(date.getMonth() + 1)],\n [/M{1}/g, (date) => date.getMonth() + 1],\n [/D{2}/gi, (date) => _pad(date.getDate())],\n [/D{1}/gi, (date) => date.getDate()],\n [/H{2}/g, (date) => _pad(date.getHours())],\n [/H{1}/g, (date) => date.getHours()],\n [\n /h{2}/g,\n (date) => {\n const h = date.getHours();\n return _pad(h === 0 ? 12 : h > 12 ? h - 12 : h);\n },\n ],\n [\n /h{1}/g,\n (date) => {\n const h = date.getHours();\n return h === 0 ? 12 : h > 12 ? h - 12 : h;\n },\n ],\n [/m{2}/g, (date) => _pad(date.getMinutes())],\n [/m{1}/g, (date) => date.getMinutes()],\n [/s{2}/g, (date) => _pad(date.getSeconds())],\n [/s{1}/g, (date) => date.getSeconds()],\n [/S{3}/g, (date) => _pad(date.getMilliseconds(), 3)],\n [/S{2}/g, (date) => _pad(date.getMilliseconds(), 2)],\n [/S{1}/g, (date) => date.getMilliseconds()],\n];\n\n/\n 格式化为日期字符串(带自定义格式化模板)\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param format - 模板，默认是 'YYYY-MM-DD HH:mm:ss'，模板字符：\n * - YYYY：年\n * - yyyy: 年\n * - MM：月\n * - DD：日\n * - dd: 日\n * - HH：时（24 小时制）\n * - hh：时（12 小时制）\n * - mm：分\n * - ss：秒\n * - SSS：毫秒\n * @returns 格式化后的日期字符串\n * @example\n * ```typescript\n * dateFormat(new Date(), 'YYYY-MM-DD'); // '2023-01-01'\n * dateFormat(1672531200000, 'YYYY/MM/DD HH:mm:ss'); // '2023/01/01 00:00:00'\n * dateFormat('2023-01-01', 'YYYY年MM月DD日'); // '2023年01月01日'\n * ```\n */\nexport function dateFormat(dateValue: DateValue, format = 'YYYY-MM-DD HH:mm:ss'): string {\n const date = dateParse(dateValue);\n let result = format;\n\n for (const rule of rules) {\n result = result.replace(rule[0], String(rule[1](date)));\n }\n\n return result;\n}\n"],"names":["isNumber","timestamp","isString","isDate"],"mappings":"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"}

package/dist/core.mjs CHANGED Viewed

@@ -328,14 +328,14 @@ const rules = [
     /h{2}/g,
     (date) => {
       const h = date.getHours();
-      return _pad(h > 12 ? h - 12 : h);
+      return _pad(h === 0 ? 12 : h > 12 ? h - 12 : h);
     }
   ],
   [
     /h{1}/g,
     (date) => {
       const h = date.getHours();
-      return h > 12 ? h - 12 : h;
+      return h === 0 ? 12 : h > 12 ? h - 12 : h;
     }
   ],
   [/m{2}/g, (date) => _pad(date.getMinutes())],

package/dist/core.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"core.mjs","sources":["../src/date/timezone.ts","../src/date/core.ts"],"sourcesContent":["import { isNumber } from '../type';\nimport { dateFormat } from './core';\n\nexport type TimezoneDateOptions = {\n /*\n 时间戳\n * @default Date.now()\n /\n timestamp?: number;\n\n /\n 日期值\n /\n value?: readonly [\n year?: number,\n month?: number,\n day?: number,\n hours?: number,\n minutes?: number,\n seconds?: number,\n milliseconds?: number,\n ];\n\n /\n UTC 时区，支持负数和小数，例如：\n * - 8 表示 UTC+8\n * - -12 表示 UTC-12\n * - 0 表示 UTC 时间\n * - 12.5 表示 UTC+12:30\n /\n utcOffset?: number;\n};\n\n/\n 时区偏移量毫秒常量（1分钟 = 60 * 1000 毫秒）\n /\nconst TIMEZONE_OFFSET_MS = 60 1000;\n\n/*\n 时区日期类，用于处理不同时区的日期时间\n /\nexport class TimezoneDate {\n /\n 内部时间戳\n /\n #timestamp: number;\n\n /\n 目标时区的日期对象\n /\n #targetDate: Date;\n\n /\n UTC 日期对象\n /\n #utcDate: Date;\n\n /\n 本地时区偏移量（分钟）\n /\n #localTimezoneOffset = TimezoneDate.getTimezoneOffset();\n\n /\n 本地时区偏移量（毫秒）\n /\n #localTimezoneOffsetMS = this.#localTimezoneOffset TIMEZONE_OFFSET_MS;\n\n /*\n 目标时区偏移量（分钟）\n /\n #targetTimezoneOffset = 0;\n\n /\n 目标时区偏移量（毫秒）\n /\n #targetTimezoneOffsetMS = 0;\n\n /\n 构造函数选项\n /\n #options: TimezoneDateOptions;\n\n /\n 构造一个 TimezoneDate 实例\n * @param options - 配置选项\n /\n constructor(options?: TimezoneDateOptions \| TimezoneDate) {\n this.#options =\n (options instanceof TimezoneDate\n ? {\n timestamp: options.getTime(),\n utcOffset: options.getUTCOffset(),\n }\n : options) \|\| {};\n const { utcOffset, timestamp, value } = this.#options;\n this.#targetTimezoneOffset = isNumber(utcOffset)\n ? TimezoneDate.getTimezoneOffset(utcOffset)\n : this.#localTimezoneOffset;\n this.#targetTimezoneOffsetMS = this.#targetTimezoneOffset TIMEZONE_OFFSET_MS;\n\n if (Array.isArray(value) && value.length > 0) {\n const [fullYear, month, day, hours, minutes, seconds, milliseconds] = value;\n const timestamp = Date.UTC(\n fullYear ?? 0,\n month ?? 0,\n day ?? 1,\n hours ?? 0,\n minutes ?? 0,\n seconds ?? 0,\n milliseconds ?? 0,\n );\n\n this.#timestamp = timestamp + this.#targetTimezoneOffsetMS;\n } else {\n this.#timestamp = timestamp \|\| Date.now();\n }\n\n this.#targetDate = new Date(this.#timestamp + this.#localTimezoneOffsetMS - this.#targetTimezoneOffsetMS);\n this.#utcDate = new Date(this.#timestamp + this.#localTimezoneOffsetMS);\n }\n\n /*\n 更新内部时间戳\n /\n #updateTimestamp() {\n this.#timestamp = this.#targetDate.getTime() + this.#targetTimezoneOffsetMS - this.#localTimezoneOffsetMS;\n this.#utcDate = new Date(this.#timestamp + this.#localTimezoneOffsetMS);\n }\n\n /\n 获取时区偏移量（分钟）\n * @returns 时区偏移量\n /\n getTimezoneOffset() {\n return this.#targetTimezoneOffset;\n }\n\n /\n 获取时区偏移量（UTC）\n * @returns 时区序号\n /\n getUTCOffset() {\n return TimezoneDate.getUTCOffset(this.#targetTimezoneOffset);\n }\n\n /\n 获取年份\n * @returns 年份\n /\n getFullYear() {\n return this.#targetDate.getFullYear();\n }\n\n /\n 获取月份\n * @returns 月份 (0-11)\n /\n getMonth() {\n return this.#targetDate.getMonth();\n }\n\n /\n 获取日期\n * @returns 日期 (1-31)\n /\n getDate() {\n return this.#targetDate.getDate();\n }\n\n /\n 获取小时\n * @returns 小时 (0-23)\n /\n getHours() {\n return this.#targetDate.getHours();\n }\n\n /\n 获取分钟\n * @returns 分钟 (0-59)\n /\n getMinutes() {\n return this.#targetDate.getMinutes();\n }\n\n /\n 获取秒数\n * @returns 秒数 (0-59)\n /\n getSeconds() {\n return this.#targetDate.getSeconds();\n }\n\n /\n 获取毫秒\n * @returns 毫秒 (0-999)\n /\n getMilliseconds() {\n return this.#targetDate.getMilliseconds();\n }\n\n /\n 设置年份\n * @param year - 年份\n * @param month - 月份\n * @param date - 日期\n * @returns 时间戳\n /\n setFullYear(year: number, month?: number, date?: number) {\n this.#targetDate.setFullYear(year);\n this.#updateTimestamp();\n\n if (isNumber(month)) this.setMonth(month);\n if (isNumber(date)) this.setDate(date);\n\n return this.getTime();\n }\n\n /\n 设置月份\n * @param month - 月份\n * @param date - 日期\n * @returns 时间戳\n /\n setMonth(month: number, date?: number) {\n this.#targetDate.setMonth(month);\n this.#updateTimestamp();\n\n if (isNumber(date)) this.setDate(date);\n\n return this.getTime();\n }\n\n /\n 设置日期\n * @param date - 日期\n * @returns 时间戳\n /\n setDate(date: number) {\n this.#targetDate.setDate(date);\n this.#updateTimestamp();\n\n return this.getTime();\n }\n\n /\n 设置小时\n * @param hours - 小时\n * @param minutes - 分钟\n * @param seconds - 秒数\n * @param milliseconds - 毫秒\n * @returns 时间戳\n /\n setHours(hours: number, minutes?: number, seconds?: number, milliseconds?: number) {\n this.#targetDate.setHours(hours);\n this.#updateTimestamp();\n\n if (isNumber(minutes)) this.setMinutes(minutes);\n if (isNumber(seconds)) this.setSeconds(seconds);\n if (isNumber(milliseconds)) this.setMilliseconds(milliseconds);\n\n return this.getTime();\n }\n\n /\n 设置分钟\n * @param minutes - 分钟\n * @param seconds - 秒数\n * @param milliseconds - 毫秒\n * @returns 时间戳\n /\n setMinutes(minutes: number, seconds?: number, milliseconds?: number) {\n this.#targetDate.setMinutes(minutes);\n this.#updateTimestamp();\n\n if (isNumber(seconds)) this.setSeconds(seconds);\n if (isNumber(milliseconds)) this.setMilliseconds(milliseconds);\n\n return this.getTime();\n }\n\n /\n 设置秒数\n * @param seconds - 秒数\n * @param milliseconds - 毫秒\n * @returns 时间戳\n /\n setSeconds(seconds: number, milliseconds?: number) {\n this.#targetDate.setSeconds(seconds);\n this.#updateTimestamp();\n\n if (isNumber(milliseconds)) this.setMilliseconds(milliseconds);\n\n return this.getTime();\n }\n\n /\n 设置毫秒\n * @param milliseconds - 毫秒\n * @returns 时间戳\n /\n setMilliseconds(milliseconds: number) {\n this.#targetDate.setMilliseconds(milliseconds);\n this.#updateTimestamp();\n\n return this.getTime();\n }\n\n /\n 获取时间戳\n * @returns 时间戳\n /\n getTime() {\n return this.#timestamp;\n }\n\n /\n 获取星期几\n * @returns 星期几 (0-6, 0表示周日)\n /\n getDay() {\n return this.#targetDate.getDay();\n }\n\n /\n 转换为 ISO 格式的字符串\n * @returns ISO 格式的时间字符串\n /\n toISOString() {\n return dateFormat(this.#utcDate, 'YYYY-MM-DDTHH:mm:ss.SSSZ');\n }\n\n /\n 转换为指定时区的 TimezoneDate 对象\n * @param td - 需要转换的日期对象\n * @param offset - 目标时区分钟偏移量，默认为当前时区\n * @returns 返回一个 TimezoneDate 对象\n * @example\n * ```js\n * // 转换为 UTC 时间\n * const utc0Td = TimezoneDate.changeUtcOffset(new TimezoneDate(), 0);\n \n // 转换为东八区时间\n * const utc8Td = TimezoneDate.changeUtcOffset(new TimezoneDate(), 8);\n * ```\n /\n static changeUtcOffset(td: TimezoneDate, utcOffset: number) {\n return new TimezoneDate({\n utcOffset,\n timestamp: td.getTime(),\n });\n }\n\n /\n 获取时区分钟偏移量\n * @param utcOffset - 默认使用当前时区\n * @returns 时区分钟偏移量\n /\n static getTimezoneOffset(utcOffset?: number) {\n return isNumber(utcOffset) ? utcOffset -60 : new Date().getTimezoneOffset();\n }\n\n /*\n 获取时区序号\n * @param timezoneOffset - 默认使用当前时区分钟偏移量\n * @returns 时区序号\n /\n static getUTCOffset(timezoneOffset = TimezoneDate.getTimezoneOffset()) {\n return timezoneOffset / -60;\n }\n}\n","import { objectEach } from '@/object';\nimport { isDate, isString } from '@/type';\nimport { TimezoneDate } from './timezone';\n\n/\n 判断一个值是否为有效的日期对象\n * @param unknown - 需要判断的值\n * @returns 如果值是有效的日期对象则返回 true，否则返回 false\n * @example\n * ```typescript\n * isValidDate(new Date()); // true\n * isValidDate('2023-01-01'); // false\n * isValidDate(NaN); // false\n * ```\n /\nexport function isValidDate(unknown: unknown): unknown is Date \| TimezoneDate {\n return (\n (unknown instanceof Date && !Number.isNaN(unknown.getTime())) \|\|\n (unknown instanceof TimezoneDate && !Number.isNaN(unknown.getTime()))\n );\n}\n\nexport type DateLike = Date \| TimezoneDate;\nexport type DateValue = number \| string \| DateLike;\n\nfunction _guessDateSeparator(value: DateValue): Date \| undefined {\n if (!isString(value)) return;\n\n const value2 = value.replace(/-/g, '/');\n\n return new Date(value2);\n}\n\nfunction _guessDateTimezone(value: DateValue): Date \| undefined {\n if (!isString(value)) return;\n\n const re = /([+-])(\\d\\d)(\\d\\d)$/;\n\n const matches = re.exec(value);\n\n if (!matches) return;\n\n const value2 = value.replace(re, 'Z');\n const d = new Date(value2);\n\n if (!isValidDate(d)) return;\n\n const [, flag, hours, minutes] = matches;\n const hours2 = Number.parseInt(hours, 10);\n const minutes2 = Number.parseInt(minutes, 10);\n const offset = (a: number, b: number): number => (flag === '+' ? a - b : a + b);\n\n d.setHours(offset(d.getHours(), hours2));\n d.setMinutes(offset(d.getMinutes(), minutes2));\n\n return d;\n}\n\n/\n 解析为Date对象\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 解析后的 Date 对象\n * @throws {SyntaxError} 如果无法解析为有效的日期对象，则抛出错误\n * @example\n * ```typescript\n * dateParse('2023-01-01'); // Date对象\n * dateParse(1672531200000); // Date对象\n * dateParse(new Date()); // Date对象\n * dateParse('invalid date'); // 抛出 SyntaxError\n * ```\n /\nexport function dateParse(dateValue: DateValue): DateLike {\n // 传入的 Date 对象有 Date、TimezoneDate\n // @ts-ignore\n const d1 = isDate(dateValue)\n ? new Date(dateValue)\n : dateValue instanceof TimezoneDate\n ? new TimezoneDate(dateValue)\n : new Date(dateValue);\n if (isValidDate(d1)) return d1;\n\n // safari 浏览器的日期解析有问题\n // new Date('2020-06-26 18:06:15') 返回值是一个非法日期对象\n const d2 = _guessDateSeparator(dateValue);\n if (isValidDate(d2)) return d2;\n\n // safari 浏览器的日期解析有问题\n // new Date('2020-06-26T18:06:15.000+0800') 返回值是一个非法日期对象\n const d3 = _guessDateTimezone(dateValue);\n if (isValidDate(d3)) return d3;\n\n throw new SyntaxError(`${dateValue.toString()} 不是一个合法的日期值`);\n}\n\nfunction _pad(num: number, len = 2) {\n return `${num}`.padStart(len, '0');\n}\n\nconst rules: [RegExp, (date: DateLike) => number \| string][] = [\n [/Y{4}/gi, (date) => date.getFullYear()],\n [/Y{2}/gi, (date) => date.getFullYear() % 100],\n [/M{2}/g, (date) => _pad(date.getMonth() + 1)],\n [/M{1}/g, (date) => date.getMonth() + 1],\n [/D{2}/gi, (date) => _pad(date.getDate())],\n [/D{1}/gi, (date) => date.getDate()],\n [/H{2}/g, (date) => _pad(date.getHours())],\n [/H{1}/g, (date) => date.getHours()],\n [\n /h{2}/g,\n (date) => {\n const h = date.getHours();\n return _pad(h > 12 ? h - 12 : h);\n },\n ],\n [\n /h{1}/g,\n (date) => {\n const h = date.getHours();\n return h > 12 ? h - 12 : h;\n },\n ],\n [/m{2}/g, (date) => _pad(date.getMinutes())],\n [/m{1}/g, (date) => date.getMinutes()],\n [/s{2}/g, (date) => _pad(date.getSeconds())],\n [/s{1}/g, (date) => date.getSeconds()],\n [/S{3}/g, (date) => _pad(date.getMilliseconds(), 3)],\n [/S{2}/g, (date) => _pad(date.getMilliseconds(), 2)],\n [/S{1}/g, (date) => date.getMilliseconds()],\n];\n\n/\n 格式化为日期字符串(带自定义格式化模板)\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param format - 模板，默认是 'YYYY-MM-DD HH:mm:ss'，模板字符：\n * - YYYY：年\n * - yyyy: 年\n * - MM：月\n * - DD：日\n * - dd: 日\n * - HH：时（24 小时制）\n * - hh：时（12 小时制）\n * - mm：分\n * - ss：秒\n * - SSS：毫秒\n * @returns 格式化后的日期字符串\n * @example\n * ```typescript\n * dateFormat(new Date(), 'YYYY-MM-DD'); // '2023-01-01'\n * dateFormat(1672531200000, 'YYYY/MM/DD HH:mm:ss'); // '2023/01/01 00:00:00'\n * dateFormat('2023-01-01', 'YYYY年MM月DD日'); // '2023年01月01日'\n * ```\n */\nexport function dateFormat(dateValue: DateValue, format = 'YYYY-MM-DD HH:mm:ss'): string {\n const date = dateParse(dateValue);\n let result = format;\n\n for (const rule of rules) {\n result = result.replace(rule[0], String(rule[1](date)));\n }\n\n return result;\n}\n"],"names":["timestamp"],"mappings":"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"}
1	+ {"version":3,"file":"core.mjs","sources":["../src/date/timezone.ts","../src/date/core.ts"],"sourcesContent":["import { isNumber } from '../type';\nimport { dateFormat } from './core';\n\nexport type TimezoneDateOptions = {\n /*\n 时间戳\n * @default Date.now()\n /\n timestamp?: number;\n\n /\n 日期值\n /\n value?: readonly [\n year?: number,\n month?: number,\n day?: number,\n hours?: number,\n minutes?: number,\n seconds?: number,\n milliseconds?: number,\n ];\n\n /\n UTC 时区，支持负数和小数，例如：\n * - 8 表示 UTC+8\n * - -12 表示 UTC-12\n * - 0 表示 UTC 时间\n * - 12.5 表示 UTC+12:30\n /\n utcOffset?: number;\n};\n\n/\n 时区偏移量毫秒常量（1分钟 = 60 * 1000 毫秒）\n /\nconst TIMEZONE_OFFSET_MS = 60 1000;\n\n/*\n 时区日期类，用于处理不同时区的日期时间\n /\nexport class TimezoneDate {\n /\n 内部时间戳\n /\n #timestamp: number;\n\n /\n 目标时区的日期对象\n /\n #targetDate: Date;\n\n /\n UTC 日期对象\n /\n #utcDate: Date;\n\n /\n 本地时区偏移量（分钟）\n /\n #localTimezoneOffset = TimezoneDate.getTimezoneOffset();\n\n /\n 本地时区偏移量（毫秒）\n /\n #localTimezoneOffsetMS = this.#localTimezoneOffset TIMEZONE_OFFSET_MS;\n\n /*\n 目标时区偏移量（分钟）\n /\n #targetTimezoneOffset = 0;\n\n /\n 目标时区偏移量（毫秒）\n /\n #targetTimezoneOffsetMS = 0;\n\n /\n 构造函数选项\n /\n #options: TimezoneDateOptions;\n\n /\n 构造一个 TimezoneDate 实例\n * @param options - 配置选项\n /\n constructor(options?: TimezoneDateOptions \| TimezoneDate) {\n this.#options =\n (options instanceof TimezoneDate\n ? {\n timestamp: options.getTime(),\n utcOffset: options.getUTCOffset(),\n }\n : options) \|\| {};\n const { utcOffset, timestamp, value } = this.#options;\n this.#targetTimezoneOffset = isNumber(utcOffset)\n ? TimezoneDate.getTimezoneOffset(utcOffset)\n : this.#localTimezoneOffset;\n this.#targetTimezoneOffsetMS = this.#targetTimezoneOffset TIMEZONE_OFFSET_MS;\n\n if (Array.isArray(value) && value.length > 0) {\n const [fullYear, month, day, hours, minutes, seconds, milliseconds] = value;\n const timestamp = Date.UTC(\n fullYear ?? 0,\n month ?? 0,\n day ?? 1,\n hours ?? 0,\n minutes ?? 0,\n seconds ?? 0,\n milliseconds ?? 0,\n );\n\n this.#timestamp = timestamp + this.#targetTimezoneOffsetMS;\n } else {\n this.#timestamp = timestamp \|\| Date.now();\n }\n\n this.#targetDate = new Date(this.#timestamp + this.#localTimezoneOffsetMS - this.#targetTimezoneOffsetMS);\n this.#utcDate = new Date(this.#timestamp + this.#localTimezoneOffsetMS);\n }\n\n /*\n 更新内部时间戳\n /\n #updateTimestamp() {\n this.#timestamp = this.#targetDate.getTime() + this.#targetTimezoneOffsetMS - this.#localTimezoneOffsetMS;\n this.#utcDate = new Date(this.#timestamp + this.#localTimezoneOffsetMS);\n }\n\n /\n 获取时区偏移量（分钟）\n * @returns 时区偏移量\n /\n getTimezoneOffset() {\n return this.#targetTimezoneOffset;\n }\n\n /\n 获取时区偏移量（UTC）\n * @returns 时区序号\n /\n getUTCOffset() {\n return TimezoneDate.getUTCOffset(this.#targetTimezoneOffset);\n }\n\n /\n 获取年份\n * @returns 年份\n /\n getFullYear() {\n return this.#targetDate.getFullYear();\n }\n\n /\n 获取月份\n * @returns 月份 (0-11)\n /\n getMonth() {\n return this.#targetDate.getMonth();\n }\n\n /\n 获取日期\n * @returns 日期 (1-31)\n /\n getDate() {\n return this.#targetDate.getDate();\n }\n\n /\n 获取小时\n * @returns 小时 (0-23)\n /\n getHours() {\n return this.#targetDate.getHours();\n }\n\n /\n 获取分钟\n * @returns 分钟 (0-59)\n /\n getMinutes() {\n return this.#targetDate.getMinutes();\n }\n\n /\n 获取秒数\n * @returns 秒数 (0-59)\n /\n getSeconds() {\n return this.#targetDate.getSeconds();\n }\n\n /\n 获取毫秒\n * @returns 毫秒 (0-999)\n /\n getMilliseconds() {\n return this.#targetDate.getMilliseconds();\n }\n\n /\n 设置年份\n * @param year - 年份\n * @param month - 月份\n * @param date - 日期\n * @returns 时间戳\n /\n setFullYear(year: number, month?: number, date?: number) {\n this.#targetDate.setFullYear(year);\n this.#updateTimestamp();\n\n if (isNumber(month)) this.setMonth(month);\n if (isNumber(date)) this.setDate(date);\n\n return this.getTime();\n }\n\n /\n 设置月份\n * @param month - 月份\n * @param date - 日期\n * @returns 时间戳\n /\n setMonth(month: number, date?: number) {\n this.#targetDate.setMonth(month);\n this.#updateTimestamp();\n\n if (isNumber(date)) this.setDate(date);\n\n return this.getTime();\n }\n\n /\n 设置日期\n * @param date - 日期\n * @returns 时间戳\n /\n setDate(date: number) {\n this.#targetDate.setDate(date);\n this.#updateTimestamp();\n\n return this.getTime();\n }\n\n /\n 设置小时\n * @param hours - 小时\n * @param minutes - 分钟\n * @param seconds - 秒数\n * @param milliseconds - 毫秒\n * @returns 时间戳\n /\n setHours(hours: number, minutes?: number, seconds?: number, milliseconds?: number) {\n this.#targetDate.setHours(hours);\n this.#updateTimestamp();\n\n if (isNumber(minutes)) this.setMinutes(minutes);\n if (isNumber(seconds)) this.setSeconds(seconds);\n if (isNumber(milliseconds)) this.setMilliseconds(milliseconds);\n\n return this.getTime();\n }\n\n /\n 设置分钟\n * @param minutes - 分钟\n * @param seconds - 秒数\n * @param milliseconds - 毫秒\n * @returns 时间戳\n /\n setMinutes(minutes: number, seconds?: number, milliseconds?: number) {\n this.#targetDate.setMinutes(minutes);\n this.#updateTimestamp();\n\n if (isNumber(seconds)) this.setSeconds(seconds);\n if (isNumber(milliseconds)) this.setMilliseconds(milliseconds);\n\n return this.getTime();\n }\n\n /\n 设置秒数\n * @param seconds - 秒数\n * @param milliseconds - 毫秒\n * @returns 时间戳\n /\n setSeconds(seconds: number, milliseconds?: number) {\n this.#targetDate.setSeconds(seconds);\n this.#updateTimestamp();\n\n if (isNumber(milliseconds)) this.setMilliseconds(milliseconds);\n\n return this.getTime();\n }\n\n /\n 设置毫秒\n * @param milliseconds - 毫秒\n * @returns 时间戳\n /\n setMilliseconds(milliseconds: number) {\n this.#targetDate.setMilliseconds(milliseconds);\n this.#updateTimestamp();\n\n return this.getTime();\n }\n\n /\n 获取时间戳\n * @returns 时间戳\n /\n getTime() {\n return this.#timestamp;\n }\n\n /\n 获取星期几\n * @returns 星期几 (0-6, 0表示周日)\n /\n getDay() {\n return this.#targetDate.getDay();\n }\n\n /\n 转换为 ISO 格式的字符串\n * @returns ISO 格式的时间字符串\n /\n toISOString() {\n return dateFormat(this.#utcDate, 'YYYY-MM-DDTHH:mm:ss.SSSZ');\n }\n\n /\n 转换为指定时区的 TimezoneDate 对象\n * @param td - 需要转换的日期对象\n * @param offset - 目标时区分钟偏移量，默认为当前时区\n * @returns 返回一个 TimezoneDate 对象\n * @example\n * ```js\n * // 转换为 UTC 时间\n * const utc0Td = TimezoneDate.changeUtcOffset(new TimezoneDate(), 0);\n \n // 转换为东八区时间\n * const utc8Td = TimezoneDate.changeUtcOffset(new TimezoneDate(), 8);\n * ```\n /\n static changeUtcOffset(td: TimezoneDate, utcOffset: number) {\n return new TimezoneDate({\n utcOffset,\n timestamp: td.getTime(),\n });\n }\n\n /\n 获取时区分钟偏移量\n * @param utcOffset - 默认使用当前时区\n * @returns 时区分钟偏移量\n /\n static getTimezoneOffset(utcOffset?: number) {\n return isNumber(utcOffset) ? utcOffset -60 : new Date().getTimezoneOffset();\n }\n\n /*\n 获取时区序号\n * @param timezoneOffset - 默认使用当前时区分钟偏移量\n * @returns 时区序号\n /\n static getUTCOffset(timezoneOffset = TimezoneDate.getTimezoneOffset()) {\n return timezoneOffset / -60;\n }\n}\n","import { objectEach } from '@/object';\nimport { isDate, isString } from '@/type';\nimport { TimezoneDate } from './timezone';\n\n/\n 判断一个值是否为有效的日期对象\n * @param unknown - 需要判断的值\n * @returns 如果值是有效的日期对象则返回 true，否则返回 false\n * @example\n * ```typescript\n * isValidDate(new Date()); // true\n * isValidDate('2023-01-01'); // false\n * isValidDate(NaN); // false\n * ```\n /\nexport function isValidDate(unknown: unknown): unknown is Date \| TimezoneDate {\n return (\n (unknown instanceof Date && !Number.isNaN(unknown.getTime())) \|\|\n (unknown instanceof TimezoneDate && !Number.isNaN(unknown.getTime()))\n );\n}\n\nexport type DateLike = Date \| TimezoneDate;\nexport type DateValue = number \| string \| DateLike;\n\nfunction _guessDateSeparator(value: DateValue): Date \| undefined {\n if (!isString(value)) return;\n\n const value2 = value.replace(/-/g, '/');\n\n return new Date(value2);\n}\n\nfunction _guessDateTimezone(value: DateValue): Date \| undefined {\n if (!isString(value)) return;\n\n const re = /([+-])(\\d\\d)(\\d\\d)$/;\n\n const matches = re.exec(value);\n\n if (!matches) return;\n\n const value2 = value.replace(re, 'Z');\n const d = new Date(value2);\n\n if (!isValidDate(d)) return;\n\n const [, flag, hours, minutes] = matches;\n const hours2 = Number.parseInt(hours, 10);\n const minutes2 = Number.parseInt(minutes, 10);\n const offset = (a: number, b: number): number => (flag === '+' ? a - b : a + b);\n\n d.setHours(offset(d.getHours(), hours2));\n d.setMinutes(offset(d.getMinutes(), minutes2));\n\n return d;\n}\n\n/\n 解析为Date对象\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 解析后的 Date 对象\n * @throws {SyntaxError} 如果无法解析为有效的日期对象，则抛出错误\n * @example\n * ```typescript\n * dateParse('2023-01-01'); // Date对象\n * dateParse(1672531200000); // Date对象\n * dateParse(new Date()); // Date对象\n * dateParse('invalid date'); // 抛出 SyntaxError\n * ```\n /\nexport function dateParse(dateValue: DateValue): DateLike {\n // 传入的 Date 对象有 Date、TimezoneDate\n // @ts-ignore\n const d1 = isDate(dateValue)\n ? new Date(dateValue)\n : dateValue instanceof TimezoneDate\n ? new TimezoneDate(dateValue)\n : new Date(dateValue);\n if (isValidDate(d1)) return d1;\n\n // safari 浏览器的日期解析有问题\n // new Date('2020-06-26 18:06:15') 返回值是一个非法日期对象\n const d2 = _guessDateSeparator(dateValue);\n if (isValidDate(d2)) return d2;\n\n // safari 浏览器的日期解析有问题\n // new Date('2020-06-26T18:06:15.000+0800') 返回值是一个非法日期对象\n const d3 = _guessDateTimezone(dateValue);\n if (isValidDate(d3)) return d3;\n\n throw new SyntaxError(`${dateValue.toString()} 不是一个合法的日期值`);\n}\n\nfunction _pad(num: number, len = 2) {\n return `${num}`.padStart(len, '0');\n}\n\nconst rules: [RegExp, (date: DateLike) => number \| string][] = [\n [/Y{4}/gi, (date) => date.getFullYear()],\n [/Y{2}/gi, (date) => date.getFullYear() % 100],\n [/M{2}/g, (date) => _pad(date.getMonth() + 1)],\n [/M{1}/g, (date) => date.getMonth() + 1],\n [/D{2}/gi, (date) => _pad(date.getDate())],\n [/D{1}/gi, (date) => date.getDate()],\n [/H{2}/g, (date) => _pad(date.getHours())],\n [/H{1}/g, (date) => date.getHours()],\n [\n /h{2}/g,\n (date) => {\n const h = date.getHours();\n return _pad(h === 0 ? 12 : h > 12 ? h - 12 : h);\n },\n ],\n [\n /h{1}/g,\n (date) => {\n const h = date.getHours();\n return h === 0 ? 12 : h > 12 ? h - 12 : h;\n },\n ],\n [/m{2}/g, (date) => _pad(date.getMinutes())],\n [/m{1}/g, (date) => date.getMinutes()],\n [/s{2}/g, (date) => _pad(date.getSeconds())],\n [/s{1}/g, (date) => date.getSeconds()],\n [/S{3}/g, (date) => _pad(date.getMilliseconds(), 3)],\n [/S{2}/g, (date) => _pad(date.getMilliseconds(), 2)],\n [/S{1}/g, (date) => date.getMilliseconds()],\n];\n\n/\n 格式化为日期字符串(带自定义格式化模板)\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param format - 模板，默认是 'YYYY-MM-DD HH:mm:ss'，模板字符：\n * - YYYY：年\n * - yyyy: 年\n * - MM：月\n * - DD：日\n * - dd: 日\n * - HH：时（24 小时制）\n * - hh：时（12 小时制）\n * - mm：分\n * - ss：秒\n * - SSS：毫秒\n * @returns 格式化后的日期字符串\n * @example\n * ```typescript\n * dateFormat(new Date(), 'YYYY-MM-DD'); // '2023-01-01'\n * dateFormat(1672531200000, 'YYYY/MM/DD HH:mm:ss'); // '2023/01/01 00:00:00'\n * dateFormat('2023-01-01', 'YYYY年MM月DD日'); // '2023年01月01日'\n * ```\n */\nexport function dateFormat(dateValue: DateValue, format = 'YYYY-MM-DD HH:mm:ss'): string {\n const date = dateParse(dateValue);\n let result = format;\n\n for (const rule of rules) {\n result = result.replace(rule[0], String(rule[1](date)));\n }\n\n return result;\n}\n"],"names":["timestamp"],"mappings":"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"}

package/dist/date/start-end.d.ts CHANGED Viewed

@@ -23,6 +23,12 @@ export declare function dateStartInHour(dateValue: DateValue): DateLike;
  * @returns 返回天级起始时间，小时、分钟、秒和毫秒部分为 0
  */
 export declare function dateStartInDay(dateValue: DateValue): DateLike;
+/**
+ * 返回周级起始时间（周一 00:00:00.000）
+ * @param dateValue - 可以是数值、字符串或 Date 对象
+ * @returns 返回当周周一的起始时间，时间部分为 0
+ */
+export declare function dateStartInWeek(dateValue: DateValue): DateLike;
 /**
  * 返回月级起始时间
  * @param dateValue - 可以是数值、字符串或 Date 对象
@@ -59,6 +65,12 @@ export declare function dateEndInHour(dateValue: DateValue): DateLike;
  * @returns 返回天级结束时间，小时为 23，分钟为 59，秒为 59，毫秒为 999
  */
 export declare function dateEndInDay(dateValue: DateValue): DateLike;
+/**
+ * 返回周级结束时间（周日 23:59:59.999）
+ * @param dateValue - 可以是数值、字符串或 Date 对象
+ * @returns 返回当周周日的结束时间，时间为 23:59:59.999
+ */
+export declare function dateEndInWeek(dateValue: DateValue): DateLike;
 /**
  * 返回月级结束时间
  * @param dateValue - 可以是数值、字符串或 Date 对象

package/dist/date.cjs CHANGED Viewed

@@ -9,7 +9,7 @@ const dateOfStartMap = [
   ["m", (d) => d.setSeconds(0)],
   ["h", (d) => d.setMinutes(0)],
   ["D", (d) => d.setHours(0)],
-  ["W", (d) => d.setHours(0)],
+  ["W", (d) => d.setDate(d.getDate() - (d.getDay() + 6) % 7)],
   ["M", (d) => d.setDate(1)],
   ["Y", (d) => d.setMonth(0)]
 ];
@@ -33,6 +33,9 @@ function dateStartInHour(dateValue) {
 function dateStartInDay(dateValue) {
   return _dateStart(dateValue, "D");
 }
+function dateStartInWeek(dateValue) {
+  return _dateStart(dateValue, "W");
+}
 function dateStartInMonth(dateValue) {
   return _dateStart(dateValue, "M");
 }
@@ -44,6 +47,7 @@ const dateOfEndMap = [
   ["m", (d) => d.setSeconds(59)],
   ["h", (d) => d.setMinutes(59)],
   ["D", (d) => d.setHours(23)],
+  ["W", (d) => d.setDate(d.getDate() + (7 - d.getDay()) % 7)],
   [
     "M",
     (d) => {
@@ -81,6 +85,9 @@ function dateEndInHour(dateValue) {
 function dateEndInDay(dateValue) {
   return _dateEnd(dateValue, "D");
 }
+function dateEndInWeek(dateValue) {
+  return _dateEnd(dateValue, "W");
+}
 function dateEndInMonth(dateValue) {
   return _dateEnd(dateValue, "M");
 }
@@ -219,6 +226,7 @@ exports.dateEndInHour = dateEndInHour;
 exports.dateEndInMinute = dateEndInMinute;
 exports.dateEndInMonth = dateEndInMonth;
 exports.dateEndInSecond = dateEndInSecond;
+exports.dateEndInWeek = dateEndInWeek;
 exports.dateEndInYear = dateEndInYear;
 exports.dateRelative = dateRelative;
 exports.dateStartInDay = dateStartInDay;
@@ -226,6 +234,7 @@ exports.dateStartInHour = dateStartInHour;
 exports.dateStartInMinute = dateStartInMinute;
 exports.dateStartInMonth = dateStartInMonth;
 exports.dateStartInSecond = dateStartInSecond;
+exports.dateStartInWeek = dateStartInWeek;
 exports.dateStartInYear = dateStartInYear;
 exports.isLeapYear = isLeapYear;
 exports.isSameDateInDay = isSameDateInDay;

package/dist/date.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"date.cjs","sources":["../src/date/start-end.ts","../src/date/days.ts","../src/date/relative.ts","../src/date/is.ts","../src/date/weeks.ts"],"sourcesContent":["import { type DateLike, type DateValue, dateParse } from './core';\n\n/*\n 时间单位符号枚举\n * - 'Y': 年\n * - 'M': 月\n * - 'D': 天\n * - 'W': 周\n * - 'h': 小时\n * - 'm': 分钟\n * - 's': 秒\n /\ntype _TDateOfSymbol = 'Y' \| 'M' \| 'D' \| 'W' \| 'h' \| 'm' \| 's';\n\n/\n 各时间单位起始时间映射表\n * 包含将日期设置到单位起始时间的函数\n /\nconst dateOfStartMap: [_TDateOfSymbol, (date: DateLike) => unknown][] = [\n ['s', (d) => d.setMilliseconds(0)],\n ['m', (d) => d.setSeconds(0)],\n ['h', (d) => d.setMinutes(0)],\n ['D', (d) => d.setHours(0)],\n ['W', (d) => d.setHours(0)],\n ['M', (d) => d.setDate(1)],\n ['Y', (d) => d.setMonth(0)],\n];\n\n/\n 返回指定时间单位的起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param symbol - 时间单位符号，可选值为 'Y'（年）、'M'（月）、'D'（天）、'h'（小时）、'm'（分钟）、's'（秒），默认为 'D'\n * @returns 返回指定时间单位的起始时间\n * @example\n * ```typescript\n * const date = new Date(2023, 5, 15, 12, 30, 45, 500); // 2023-06-15 12:30:45.500\n \n // 返回秒级起始时间\n * dateOfStart(date, 's'); // 2023-06-15 12:30:45.000\n \n // 返回分钟级起始时间\n * dateOfStart(date, 'm'); // 2023-06-15 12:30:00.000\n \n // 返回小时级起始时间\n * dateOfStart(date, 'h'); // 2023-06-15 12:00:00.000\n \n // 返回天级起始时间\n * dateOfStart(date, 'D'); // 2023-06-15 00:00:00.000\n \n // 返回月级起始时间\n * dateOfStart(date, 'M'); // 2023-06-01 00:00:00.000\n \n // 返回年级起始时间\n * dateOfStart(date, 'Y'); // 2023-01-01 00:00:00.000\n \n // 默认返回天级起始时间\n * dateOfStart(date); // 2023-06-15 00:00:00.000\n * ```\n /\nfunction _dateStart(dateValue: DateValue, symbol: _TDateOfSymbol = 'D') {\n const date = dateParse(dateValue);\n\n for (const [sym, fn] of dateOfStartMap) {\n fn(date);\n if (symbol === sym) break;\n }\n\n return date;\n}\n\n/\n 返回秒级起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回秒级起始时间，毫秒部分为 0\n /\nexport function dateStartInSecond(dateValue: DateValue) {\n return _dateStart(dateValue, 's');\n}\n\n/\n 返回分钟级起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回分钟级起始时间，秒和毫秒部分为 0\n /\nexport function dateStartInMinute(dateValue: DateValue) {\n return _dateStart(dateValue, 'm');\n}\n\n/\n 返回小时级起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回小时级起始时间，分钟、秒和毫秒部分为 0\n /\nexport function dateStartInHour(dateValue: DateValue) {\n return _dateStart(dateValue, 'h');\n}\n\n/\n 返回天级起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回天级起始时间，小时、分钟、秒和毫秒部分为 0\n /\nexport function dateStartInDay(dateValue: DateValue) {\n return _dateStart(dateValue, 'D');\n}\n\n/\n 返回月级起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回月级起始时间，日期为当月第一天，时间部分为 0\n /\nexport function dateStartInMonth(dateValue: DateValue) {\n return _dateStart(dateValue, 'M');\n}\n\n/\n 返回年级起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回年级起始时间，月份为 1 月，日期为 1 日，时间部分为 0\n /\nexport function dateStartInYear(dateValue: DateValue) {\n return _dateStart(dateValue, 'Y');\n}\n\n/\n 各时间单位结束时间映射表\n * 包含将日期设置到单位结束时间的函数\n /\nconst dateOfEndMap: [_TDateOfSymbol, (date: DateLike) => unknown][] = [\n ['s', (d) => d.setMilliseconds(999)],\n ['m', (d) => d.setSeconds(59)],\n ['h', (d) => d.setMinutes(59)],\n ['D', (d) => d.setHours(23)],\n [\n 'M',\n (d) => {\n const d2 = dateParse(d);\n d2.setMonth(d.getMonth() + 1);\n d2.setDate(0);\n d.setDate(d2.getDate());\n },\n ],\n [\n 'Y',\n (d) => {\n d.setMonth(11);\n d.setDate(31);\n },\n ],\n];\n\n/\n 返回指定时间单位的结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param symbol - 时间单位符号，可选值为 'Y'（年）、'M'（月）、'D'（天）、'h'（小时）、'm'（分钟）、's'（秒），默认为 'D'\n * @returns 返回指定时间单位的结束时间\n * @example\n * ```typescript\n * const date = new Date(2023, 5, 15, 12, 30, 45, 500); // 2023-06-15 12:30:45.500\n \n // 返回秒级结束时间\n * dateOfEnd(date, 's'); // 2023-06-15 12:30:45.999\n \n // 返回分钟级结束时间\n * dateOfEnd(date, 'm'); // 2023-06-15 12:30:59.999\n \n // 返回小时级结束时间\n * dateOfEnd(date, 'h'); // 2023-06-15 12:59:59.999\n \n // 返回天级结束时间\n * dateOfEnd(date, 'D'); // 2023-06-15 23:59:59.999\n \n // 返回月级结束时间\n * dateOfEnd(date, 'M'); // 2023-06-30 23:59:59.999\n \n // 返回年级结束时间\n * dateOfEnd(date, 'Y'); // 2023-12-31 23:59:59.999\n \n // 默认返回天级结束时间\n * dateOfEnd(date); // 2023-06-15 23:59:59.999\n * ```\n /\nfunction _dateEnd(dateValue: DateValue, symbol: _TDateOfSymbol = 'D') {\n const date = dateParse(dateValue);\n\n for (const [sym, fn] of dateOfEndMap) {\n fn(date);\n if (symbol === sym) break;\n }\n\n return date;\n}\n\n/\n 返回秒级结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回秒级结束时间，毫秒部分为 999\n /\nexport function dateEndInSecond(dateValue: DateValue) {\n return _dateEnd(dateValue, 's');\n}\n\n/\n 返回分钟级结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回分钟级结束时间，秒为 59，毫秒为 999\n /\nexport function dateEndInMinute(dateValue: DateValue) {\n return _dateEnd(dateValue, 'm');\n}\n\n/\n 返回小时级结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回小时级结束时间，分钟为 59，秒为 59，毫秒为 999\n /\nexport function dateEndInHour(dateValue: DateValue) {\n return _dateEnd(dateValue, 'h');\n}\n\n/\n 返回天级结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回天级结束时间，小时为 23，分钟为 59，秒为 59，毫秒为 999\n /\nexport function dateEndInDay(dateValue: DateValue) {\n return _dateEnd(dateValue, 'D');\n}\n\n/\n 返回月级结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回月级结束时间，日期为当月最后一天，时间为 23:59:59.999\n /\nexport function dateEndInMonth(dateValue: DateValue) {\n return _dateEnd(dateValue, 'M');\n}\n\n/\n 返回年级结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回年级结束时间，月份为 12 月，日期为 31 日，时间为 23:59:59.999\n /\nexport function dateEndInYear(dateValue: DateValue) {\n return _dateEnd(dateValue, 'Y');\n}\n","import { DATE_DAY_MS } from './const';\nimport { type DateValue, dateParse } from './core';\nimport { dateEndInMonth, dateEndInYear, dateStartInMonth, dateStartInYear } from './start-end';\n\n/\n 计算指定日期所在年或月的天数\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param unit - 时间单位符号，可选值为 'Y'（年）、'M'（月），默认为 'M'\n * @returns 返回指定日期所在年或月的天数\n * @example\n * ```typescript\n * dateDays(new Date('2023-02-15')); // 28\n * dateDays(new Date('2024-02-15')); // 29 (闰年)\n * dateDays(new Date('2023-02-15'), 'Y'); // 365\n * dateDays(new Date('2024-02-15'), 'Y'); // 366 (闰年)\n * ```\n /\nfunction _dateDays(dateValue: DateValue, unit: 'Y' \| 'M') {\n const d = dateParse(dateValue);\n const ds = unit === 'M' ? dateStartInMonth(d) : dateStartInYear(d);\n const de = unit === 'M' ? dateEndInMonth(d) : dateEndInYear(d);\n return Math.ceil((de.getTime() - ds.getTime()) / DATE_DAY_MS);\n}\n\n/\n 计算指定日期所在月份的天数\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回指定日期所在月份的天数\n * @example\n * ```typescript\n * dateDaysInMonth(new Date('2023-02-15')); // 28\n * dateDaysInMonth(new Date('2024-02-15')); // 29 (闰年)\n * ```\n /\nexport function dateDaysInMonth(dateValue: DateValue) {\n return _dateDays(dateValue, 'M');\n}\n\n/\n 计算指定日期所在年份的天数\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回指定日期所在年份的天数\n * @example\n * ```typescript\n * dateDaysInYear(new Date('2023-02-15')); // 365\n * dateDaysInYear(new Date('2024-02-15')); // 366 (闰年)\n * ```\n /\nexport function dateDaysInYear(dateValue: DateValue) {\n return _dateDays(dateValue, 'Y');\n}\n","import { stringFormat } from '@/string';\nimport { isArray } from '@/type';\nimport { type DateValue, dateFormat, dateParse } from './core';\n\nexport type DateRelativeTemplate = [\n number /单位时间差，为 0 表示不计算单位差值，单位秒/,\n number /最大时间差，单位：秒/,\n string /过去模板字符串，%d 表述单位差值/,\n string? /将来模板字符串，%d 表述单位差值，可选/,\n];\nexport type DateRelativeTemplates = DateRelativeTemplate[];\n\nconst defaultDiffTemplates: DateRelativeTemplates = [\n [0, 10, '刚刚'],\n [1, 60, '{n} 秒前', '{n} 秒后'],\n [60, 60 60, '{n} 分钟前', '{n} 分钟后'],\n [60 * 60, 60 * 60 * 24, '{n} 小时前', '{n} 小时后'],\n [0, 60 * 60 * 24 * 2, '昨天', '明天'],\n [0, 60 * 60 * 24 * 3, '前天', '后天'],\n [60 * 60 * 24, 60 * 60 * 24 * 30, '{n} 天前', '{n} 天后'],\n [0, Number.POSITIVE_INFINITY, 'YYYY年MM月DD日'],\n];\n\n/*\n 相对时间\n * @param {DateValue} dateValue 比较的时间\n * @param {DateValue} [refDateValue] 相对的时间，默认为当前\n * @param {DateRelativeTemplates} [templates] 模板\n * @returns {string} 格式化后的相对时间字符串\n * @example\n * ```typescript\n * // 默认模板\n * dateRelative(new Date('2023-01-01')); // '刚刚'\n * dateRelative(new Date('2023-01-01'), new Date('2023-01-02')); // '昨天'\n * dateRelative(new Date('2023-01-01'), new Date('2023-01-04')); // '3 天前'\n * dateRelative(new Date('2023-01-01'), new Date('2023-02-01')); // '2023年01月01日'\n * ```\n * @example\n * ```typescript\n * // 自定义模板\n * const templates: DateRelativeTemplates = [\n * [0, 10, '刚刚'],\n * [1, 60, '{n} 秒前', '{n} 秒后'],\n * [60, 60 * 60, '{n} 分钟前', '{n} 分钟后'],\n * [60 * 60, 60 * 60 * 24, '{n} 小时前', '{n} 小时后'],\n * [0, 60 * 60 * 24 * 2, '昨天', '明天'],\n * [0, 60 * 60 * 24 * 3, '前天', '后天'],\n * [60 * 60 * 24, 60 * 60 * 24 * 30, '{n} 天前', '{n} 天后'],\n * [0, Number.POSITIVE_INFINITY, 'YYYY年MM月DD日'],\n * ];\n * dateRelative(new Date('2023-01-01'), new Date('2023-01-02'), templates); // '昨天'\n * dateRelative(new Date('2023-01-01'), new Date('2023-01-04'), templates); // '3 天前'\n * dateRelative(new Date('2023-01-01'), new Date('2023-02-01'), templates); // '2023年01月01日'\n * ```\n /\nexport function dateRelative(dateValue: DateValue, refDateValue: DateValue, templates: DateRelativeTemplates): string;\nexport function dateRelative(dateValue: DateValue, refDateValue: DateValue): string;\nexport function dateRelative(dateValue: DateValue, templates: DateRelativeTemplates): string;\nexport function dateRelative(dateValue: DateValue): string;\nexport function dateRelative(\n dateValue: DateValue,\n refDateValue?: DateValue \| DateRelativeTemplates,\n templates?: DateRelativeTemplates,\n): string {\n const now = Date.now();\n const refDateValueFinal = isArray(refDateValue) ? now : refDateValue \|\| now;\n const templatesFinal = isArray(templates) ? templates : isArray(refDateValue) ? refDateValue : defaultDiffTemplates;\n const d1 = dateParse(dateValue);\n const d2 = dateParse(refDateValueFinal);\n const diff = d1.getTime() - d2.getTime();\n const isAgo = diff < 0;\n const absDiff = Math.abs(diff);\n let relative = '';\n\n for (const [base, max, agoTemplate, featureTemplate] of templatesFinal) {\n const unitFinal = base 1000;\n const maxFinal = max * 1000;\n\n if (absDiff < maxFinal) {\n const template = isAgo ? agoTemplate : featureTemplate \|\| agoTemplate;\n const length = unitFinal === 0 ? 0 : Math.max(Math.floor(absDiff / unitFinal), 1);\n relative = unitFinal === 0 ? dateFormat(dateValue, template) : stringFormat(template, { n: length });\n break;\n }\n }\n\n return relative;\n}\n","import { type DateLike, type DateValue, dateParse } from './core';\n\n/*\n 判断给定的年份是否为闰年\n * @param year - 需要判断的年份\n * @returns 如果年份是闰年则返回 true，否则返回 false\n * @example\n * ```typescript\n * isLeapYear(2020); // true\n * isLeapYear(2021); // false\n * isLeapYear(2000); // true\n * isLeapYear(1900); // false\n * ```\n /\nexport function isLeapYear(year: number): boolean {\n if (year % 4 !== 0) return false;\n if (year % 100 !== 0) return true;\n if (year % 400 !== 0) return false;\n return true;\n}\n\n/\n 日期比较精度枚举类型\n * - Y = 年\n * - M = 月\n * - D = 天\n * - h = 小时\n * - m = 分钟\n * - s = 秒\n * - S = 毫秒\n /\ntype _DateSameSymbol = 'Y' \| 'M' \| 'D' \| 'h' \| 'm' \| 's' \| 'S';\n\n/\n 比较两个日期在指定精度下是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @param sameSymbol - 比较精度，默认为 'D'（天，即年月日天都相同）\n * @returns 如果两个日期在指定精度下相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15, 12, 30, 45, 500);\n * const date2 = new Date(2023, 5, 15, 13, 30, 45, 500);\n \n // 比较年份\n * isSameDate(date1, date2, 'Y'); // true\n \n // 比较月份（年份也要相同）\n * isSameDate(date1, date2, 'M'); // true\n \n // 比较日期（默认，年份、月份也要相同）\n * isSameDate(date1, date2); // true\n \n // 比较小时（年、月、日也要相同）\n * isSameDate(date1, date2, 'h'); // false\n \n // 比较分钟（年、月、日、小时也要相同）\n * isSameDate(date1, date2, 'm'); // false\n \n // 比较秒（年、月、日、小时、分钟也要相同）\n * isSameDate(date1, date2, 's'); // false\n \n // 比较毫秒（年、月、日、小时、分钟、秒数也要相同）\n * isSameDate(date1, date2, 'S'); // false\n * ```\n /\nfunction _isSameDateIn(date1: DateValue, date2: DateValue, sameSymbol: _DateSameSymbol = 'D') {\n const defines = [\n ['Y', (d: DateLike) => d.getFullYear()],\n ['M', (d: DateLike) => d.getMonth()],\n ['D', (d: DateLike) => d.getDate()],\n ['h', (d: DateLike) => d.getHours()],\n ['m', (d: DateLike) => d.getMinutes()],\n ['s', (d: DateLike) => d.getSeconds()],\n ['S', (d: DateLike) => d.getMilliseconds()],\n ] as const;\n\n const d1 = dateParse(date1);\n const d2 = dateParse(date2);\n\n for (const [sym, fn] of defines) {\n if (fn(d1) !== fn(d2)) {\n return false;\n }\n\n if (sym === sameSymbol) break;\n }\n\n return true;\n}\n\n/\n 比较两个日期的年份是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @returns 如果两个日期的年份相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15);\n * const date2 = new Date(2023, 6, 20);\n * isSameDateInYear(date1, date2); // true\n * ```\n /\nexport function isSameDateInYear(date1: DateValue, date2: DateValue) {\n return _isSameDateIn(date1, date2, 'Y');\n}\n\n/\n 比较两个日期的年份和月份是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @returns 如果两个日期的年份和月份相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15);\n * const date2 = new Date(2023, 5, 20);\n * isSameDateInMonth(date1, date2); // true\n * ```\n /\nexport function isSameDateInMonth(date1: DateValue, date2: DateValue) {\n return _isSameDateIn(date1, date2, 'M');\n}\n\n/\n 比较两个日期的年份、月份和天数是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @returns 如果两个日期的年份、月份和天数相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15);\n * const date2 = new Date(2023, 5, 15);\n * isSameDateInDay(date1, date2); // true\n * ```\n /\nexport function isSameDateInDay(date1: DateValue, date2: DateValue) {\n return _isSameDateIn(date1, date2, 'D');\n}\n\n/\n 比较两个日期的年份、月份、天数和小时是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @returns 如果两个日期的年份、月份、天数和小时相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15, 12);\n * const date2 = new Date(2023, 5, 15, 12);\n * isSameDateInHour(date1, date2); // true\n * ```\n /\nexport function isSameDateInHour(date1: DateValue, date2: DateValue) {\n return _isSameDateIn(date1, date2, 'h');\n}\n\n/\n 比较两个日期的年份、月份、天数、小时和分钟是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @returns 如果两个日期的年份、月份、天数、小时和分钟相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15, 12, 30);\n * const date2 = new Date(2023, 5, 15, 12, 30);\n * isSameDateInMinute(date1, date2); // true\n * ```\n /\nexport function isSameDateInMinute(date1: DateValue, date2: DateValue) {\n return _isSameDateIn(date1, date2, 'm');\n}\n\n/\n 比较两个日期的年份、月份、天数、小时、分钟和秒数是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @returns 如果两个日期的年份、月份、天数、小时、分钟和秒数相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15, 12, 30, 45);\n * const date2 = new Date(2023, 5, 15, 12, 30, 45);\n * isSameDateInSecond(date1, date2); // true\n * ```\n /\nexport function isSameDateInSecond(date1: DateValue, date2: DateValue) {\n return _isSameDateIn(date1, date2, 's');\n}\n","import { DATE_DAY_MS } from './const';\nimport { type DateValue, dateParse } from './core';\n\nexport enum EWeekStart {\n /\n 周日作为一周的起始日\n /\n sunday = 0,\n /\n 周一作为一周的起始日\n /\n monday = 1,\n /\n 周二作为一周的起始日\n /\n tuesday = 2,\n /\n 周三作为一周的起始日\n /\n wednesday = 3,\n /\n 周四作为一周的起始日\n /\n thursday = 4,\n /\n 周五作为一周的起始日\n /\n friday = 5,\n /\n 周六作为一周的起始日\n /\n saturday = 6,\n // /\n // 1号所在的周为第一周\n // /\n // firstDate = 7,\n // /\n // 完整7天表示第一周\n // /\n // firstFullWeek = 8,\n}\n\n/\n 计算指定日期所在年份或月份的周数\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param type - 计算范围，'Y' 表示年份，'M' 表示月份\n * @param weekStart - 一周的起始日，默认为 0（周日）\n * @returns 返回指定日期所在年份或月份的周数\n * @example\n * ```typescript\n * const date = new Date(2023, 0, 1); // 2023-01-01\n * _dateWeeks(date, 'Y'); // 1 (计算年份的周数)\n * _dateWeeks(date, 'M'); // 1 (计算月份的周数)\n * _dateWeeks(date, 'Y', 1); // 1 (周一作为一周的起始日，计算年份的周数)\n * ```\n /\nexport function _dateWeeks(dateValue: DateValue, type: 'Y' \| 'M', weekStart: EWeekStart = 0) {\n const date = dateParse(dateValue);\n\n const year = date.getFullYear();\n const month = date.getMonth();\n\n const firstDate = type === 'Y' ? new Date(year, 0, 1) : new Date(year, month, 1);\n const firstWeek = firstDate.getDay();\n const days = Math.ceil((date.getTime() - firstDate.getTime()) / DATE_DAY_MS);\n\n return Math.ceil((firstWeek + days - weekStart) / 7);\n}\n\n/\n 计算指定日期所在年份的周数\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param weekStart - 一周的起始日，默认为 0（周日）\n * @returns 返回指定日期所在年份的周数\n * @example\n * ```typescript\n * const date = new Date(2023, 0, 1); // 2023-01-01\n * weeksOfYear(date); // 1\n * weeksOfYear(date, 1); // 1 (周一作为一周的起始日)\n * ```\n /\nexport function weeksOfYear(dateValue: DateValue, weekStart: EWeekStart = 0) {\n return _dateWeeks(dateValue, 'Y', weekStart);\n}\n\n/\n 计算指定日期所在月份的周数\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param weekStart - 一周的起始日，默认为 0（周日）\n * @returns 返回指定日期所在月份的周数\n * @example\n * ```typescript\n * const date = new Date(2023, 0, 1); // 2023-01-01\n * weeksOfMonth(date); // 1\n * weeksOfMonth(date, 1); // 1 (周一作为一周的起始日)\n * ```\n */\nexport function weeksOfMonth(dateValue: DateValue, weekStart: EWeekStart = 0) {\n return _dateWeeks(dateValue, 'M', weekStart);\n}\n"],"names":["dateParse","DATE_DAY_MS","isArray","dateFormat","stringFormat","EWeekStart","type"],"mappings":"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"}
1	+ {"version":3,"file":"date.cjs","sources":["../src/date/start-end.ts","../src/date/days.ts","../src/date/relative.ts","../src/date/is.ts","../src/date/weeks.ts"],"sourcesContent":["import { type DateLike, type DateValue, dateParse } from './core';\n\n/*\n 时间单位符号枚举\n * - 'Y': 年\n * - 'M': 月\n * - 'D': 天\n * - 'W': 周\n * - 'h': 小时\n * - 'm': 分钟\n * - 's': 秒\n /\ntype _TDateOfSymbol = 'Y' \| 'M' \| 'D' \| 'W' \| 'h' \| 'm' \| 's';\n\n/\n 各时间单位起始时间映射表\n * 包含将日期设置到单位起始时间的函数\n /\nconst dateOfStartMap: [_TDateOfSymbol, (date: DateLike) => unknown][] = [\n ['s', (d) => d.setMilliseconds(0)],\n ['m', (d) => d.setSeconds(0)],\n ['h', (d) => d.setMinutes(0)],\n ['D', (d) => d.setHours(0)],\n ['W', (d) => d.setDate(d.getDate() - ((d.getDay() + 6) % 7))],\n ['M', (d) => d.setDate(1)],\n ['Y', (d) => d.setMonth(0)],\n];\n\n/\n 返回指定时间单位的起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param symbol - 时间单位符号，可选值为 'Y'（年）、'M'（月）、'W'（周）、'D'（天）、'h'（小时）、'm'（分钟）、's'（秒），默认为 'D'\n * @returns 返回指定时间单位的起始时间\n * @example\n * ```typescript\n * const date = new Date(2023, 5, 15, 12, 30, 45, 500); // 2023-06-15 12:30:45.500\n \n // 返回秒级起始时间\n * dateOfStart(date, 's'); // 2023-06-15 12:30:45.000\n \n // 返回分钟级起始时间\n * dateOfStart(date, 'm'); // 2023-06-15 12:30:00.000\n \n // 返回小时级起始时间\n * dateOfStart(date, 'h'); // 2023-06-15 12:00:00.000\n \n // 返回天级起始时间\n * dateOfStart(date, 'D'); // 2023-06-15 00:00:00.000\n \n // 返回周级起始时间（周一）\n * dateOfStart(date, 'W'); // 2023-06-12 00:00:00.000\n \n // 返回月级起始时间\n * dateOfStart(date, 'M'); // 2023-06-01 00:00:00.000\n \n // 返回年级起始时间\n * dateOfStart(date, 'Y'); // 2023-01-01 00:00:00.000\n \n // 默认返回天级起始时间\n * dateOfStart(date); // 2023-06-15 00:00:00.000\n * ```\n /\nfunction _dateStart(dateValue: DateValue, symbol: _TDateOfSymbol = 'D') {\n const date = dateParse(dateValue);\n\n for (const [sym, fn] of dateOfStartMap) {\n fn(date);\n if (symbol === sym) break;\n }\n\n return date;\n}\n\n/\n 返回秒级起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回秒级起始时间，毫秒部分为 0\n /\nexport function dateStartInSecond(dateValue: DateValue) {\n return _dateStart(dateValue, 's');\n}\n\n/\n 返回分钟级起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回分钟级起始时间，秒和毫秒部分为 0\n /\nexport function dateStartInMinute(dateValue: DateValue) {\n return _dateStart(dateValue, 'm');\n}\n\n/\n 返回小时级起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回小时级起始时间，分钟、秒和毫秒部分为 0\n /\nexport function dateStartInHour(dateValue: DateValue) {\n return _dateStart(dateValue, 'h');\n}\n\n/\n 返回天级起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回天级起始时间，小时、分钟、秒和毫秒部分为 0\n /\nexport function dateStartInDay(dateValue: DateValue) {\n return _dateStart(dateValue, 'D');\n}\n\n/\n 返回周级起始时间（周一 00:00:00.000）\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回当周周一的起始时间，时间部分为 0\n /\nexport function dateStartInWeek(dateValue: DateValue) {\n return _dateStart(dateValue, 'W');\n}\n\n/\n 返回月级起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回月级起始时间，日期为当月第一天，时间部分为 0\n /\nexport function dateStartInMonth(dateValue: DateValue) {\n return _dateStart(dateValue, 'M');\n}\n\n/\n 返回年级起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回年级起始时间，月份为 1 月，日期为 1 日，时间部分为 0\n /\nexport function dateStartInYear(dateValue: DateValue) {\n return _dateStart(dateValue, 'Y');\n}\n\n/\n 各时间单位结束时间映射表\n * 包含将日期设置到单位结束时间的函数\n /\nconst dateOfEndMap: [_TDateOfSymbol, (date: DateLike) => unknown][] = [\n ['s', (d) => d.setMilliseconds(999)],\n ['m', (d) => d.setSeconds(59)],\n ['h', (d) => d.setMinutes(59)],\n ['D', (d) => d.setHours(23)],\n ['W', (d) => d.setDate(d.getDate() + ((7 - d.getDay()) % 7))],\n [\n 'M',\n (d) => {\n const d2 = dateParse(d);\n d2.setMonth(d.getMonth() + 1);\n d2.setDate(0);\n d.setDate(d2.getDate());\n },\n ],\n [\n 'Y',\n (d) => {\n d.setMonth(11);\n d.setDate(31);\n },\n ],\n];\n\n/\n 返回指定时间单位的结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param symbol - 时间单位符号，可选值为 'Y'（年）、'M'（月）、'W'（周）、'D'（天）、'h'（小时）、'm'（分钟）、's'（秒），默认为 'D'\n * @returns 返回指定时间单位的结束时间\n * @example\n * ```typescript\n * const date = new Date(2023, 5, 15, 12, 30, 45, 500); // 2023-06-15 12:30:45.500\n \n // 返回秒级结束时间\n * dateOfEnd(date, 's'); // 2023-06-15 12:30:45.999\n \n // 返回分钟级结束时间\n * dateOfEnd(date, 'm'); // 2023-06-15 12:30:59.999\n \n // 返回小时级结束时间\n * dateOfEnd(date, 'h'); // 2023-06-15 12:59:59.999\n \n // 返回天级结束时间\n * dateOfEnd(date, 'D'); // 2023-06-15 23:59:59.999\n \n // 返回周级结束时间（周日）\n * dateOfEnd(date, 'W'); // 2023-06-18 23:59:59.999\n \n // 返回月级结束时间\n * dateOfEnd(date, 'M'); // 2023-06-30 23:59:59.999\n \n // 返回年级结束时间\n * dateOfEnd(date, 'Y'); // 2023-12-31 23:59:59.999\n \n // 默认返回天级结束时间\n * dateOfEnd(date); // 2023-06-15 23:59:59.999\n * ```\n /\nfunction _dateEnd(dateValue: DateValue, symbol: _TDateOfSymbol = 'D') {\n const date = dateParse(dateValue);\n\n for (const [sym, fn] of dateOfEndMap) {\n fn(date);\n if (symbol === sym) break;\n }\n\n return date;\n}\n\n/\n 返回秒级结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回秒级结束时间，毫秒部分为 999\n /\nexport function dateEndInSecond(dateValue: DateValue) {\n return _dateEnd(dateValue, 's');\n}\n\n/\n 返回分钟级结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回分钟级结束时间，秒为 59，毫秒为 999\n /\nexport function dateEndInMinute(dateValue: DateValue) {\n return _dateEnd(dateValue, 'm');\n}\n\n/\n 返回小时级结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回小时级结束时间，分钟为 59，秒为 59，毫秒为 999\n /\nexport function dateEndInHour(dateValue: DateValue) {\n return _dateEnd(dateValue, 'h');\n}\n\n/\n 返回天级结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回天级结束时间，小时为 23，分钟为 59，秒为 59，毫秒为 999\n /\nexport function dateEndInDay(dateValue: DateValue) {\n return _dateEnd(dateValue, 'D');\n}\n\n/\n 返回周级结束时间（周日 23:59:59.999）\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回当周周日的结束时间，时间为 23:59:59.999\n /\nexport function dateEndInWeek(dateValue: DateValue) {\n return _dateEnd(dateValue, 'W');\n}\n\n/\n 返回月级结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回月级结束时间，日期为当月最后一天，时间为 23:59:59.999\n /\nexport function dateEndInMonth(dateValue: DateValue) {\n return _dateEnd(dateValue, 'M');\n}\n\n/\n 返回年级结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回年级结束时间，月份为 12 月，日期为 31 日，时间为 23:59:59.999\n /\nexport function dateEndInYear(dateValue: DateValue) {\n return _dateEnd(dateValue, 'Y');\n}\n","import { DATE_DAY_MS } from './const';\nimport { type DateValue, dateParse } from './core';\nimport { dateEndInMonth, dateEndInYear, dateStartInMonth, dateStartInYear } from './start-end';\n\n/\n 计算指定日期所在年或月的天数\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param unit - 时间单位符号，可选值为 'Y'（年）、'M'（月），默认为 'M'\n * @returns 返回指定日期所在年或月的天数\n * @example\n * ```typescript\n * dateDays(new Date('2023-02-15')); // 28\n * dateDays(new Date('2024-02-15')); // 29 (闰年)\n * dateDays(new Date('2023-02-15'), 'Y'); // 365\n * dateDays(new Date('2024-02-15'), 'Y'); // 366 (闰年)\n * ```\n /\nfunction _dateDays(dateValue: DateValue, unit: 'Y' \| 'M') {\n const d = dateParse(dateValue);\n const ds = unit === 'M' ? dateStartInMonth(d) : dateStartInYear(d);\n const de = unit === 'M' ? dateEndInMonth(d) : dateEndInYear(d);\n return Math.ceil((de.getTime() - ds.getTime()) / DATE_DAY_MS);\n}\n\n/\n 计算指定日期所在月份的天数\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回指定日期所在月份的天数\n * @example\n * ```typescript\n * dateDaysInMonth(new Date('2023-02-15')); // 28\n * dateDaysInMonth(new Date('2024-02-15')); // 29 (闰年)\n * ```\n /\nexport function dateDaysInMonth(dateValue: DateValue) {\n return _dateDays(dateValue, 'M');\n}\n\n/\n 计算指定日期所在年份的天数\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回指定日期所在年份的天数\n * @example\n * ```typescript\n * dateDaysInYear(new Date('2023-02-15')); // 365\n * dateDaysInYear(new Date('2024-02-15')); // 366 (闰年)\n * ```\n /\nexport function dateDaysInYear(dateValue: DateValue) {\n return _dateDays(dateValue, 'Y');\n}\n","import { stringFormat } from '@/string';\nimport { isArray } from '@/type';\nimport { type DateValue, dateFormat, dateParse } from './core';\n\nexport type DateRelativeTemplate = [\n number /单位时间差，为 0 表示不计算单位差值，单位秒/,\n number /最大时间差，单位：秒/,\n string /过去模板字符串，%d 表述单位差值/,\n string? /将来模板字符串，%d 表述单位差值，可选/,\n];\nexport type DateRelativeTemplates = DateRelativeTemplate[];\n\nconst defaultDiffTemplates: DateRelativeTemplates = [\n [0, 10, '刚刚'],\n [1, 60, '{n} 秒前', '{n} 秒后'],\n [60, 60 60, '{n} 分钟前', '{n} 分钟后'],\n [60 * 60, 60 * 60 * 24, '{n} 小时前', '{n} 小时后'],\n [0, 60 * 60 * 24 * 2, '昨天', '明天'],\n [0, 60 * 60 * 24 * 3, '前天', '后天'],\n [60 * 60 * 24, 60 * 60 * 24 * 30, '{n} 天前', '{n} 天后'],\n [0, Number.POSITIVE_INFINITY, 'YYYY年MM月DD日'],\n];\n\n/*\n 相对时间\n * @param {DateValue} dateValue 比较的时间\n * @param {DateValue} [refDateValue] 相对的时间，默认为当前\n * @param {DateRelativeTemplates} [templates] 模板\n * @returns {string} 格式化后的相对时间字符串\n * @example\n * ```typescript\n * // 默认模板\n * dateRelative(new Date('2023-01-01')); // '刚刚'\n * dateRelative(new Date('2023-01-01'), new Date('2023-01-02')); // '昨天'\n * dateRelative(new Date('2023-01-01'), new Date('2023-01-04')); // '3 天前'\n * dateRelative(new Date('2023-01-01'), new Date('2023-02-01')); // '2023年01月01日'\n * ```\n * @example\n * ```typescript\n * // 自定义模板\n * const templates: DateRelativeTemplates = [\n * [0, 10, '刚刚'],\n * [1, 60, '{n} 秒前', '{n} 秒后'],\n * [60, 60 * 60, '{n} 分钟前', '{n} 分钟后'],\n * [60 * 60, 60 * 60 * 24, '{n} 小时前', '{n} 小时后'],\n * [0, 60 * 60 * 24 * 2, '昨天', '明天'],\n * [0, 60 * 60 * 24 * 3, '前天', '后天'],\n * [60 * 60 * 24, 60 * 60 * 24 * 30, '{n} 天前', '{n} 天后'],\n * [0, Number.POSITIVE_INFINITY, 'YYYY年MM月DD日'],\n * ];\n * dateRelative(new Date('2023-01-01'), new Date('2023-01-02'), templates); // '昨天'\n * dateRelative(new Date('2023-01-01'), new Date('2023-01-04'), templates); // '3 天前'\n * dateRelative(new Date('2023-01-01'), new Date('2023-02-01'), templates); // '2023年01月01日'\n * ```\n /\nexport function dateRelative(dateValue: DateValue, refDateValue: DateValue, templates: DateRelativeTemplates): string;\nexport function dateRelative(dateValue: DateValue, refDateValue: DateValue): string;\nexport function dateRelative(dateValue: DateValue, templates: DateRelativeTemplates): string;\nexport function dateRelative(dateValue: DateValue): string;\nexport function dateRelative(\n dateValue: DateValue,\n refDateValue?: DateValue \| DateRelativeTemplates,\n templates?: DateRelativeTemplates,\n): string {\n const now = Date.now();\n const refDateValueFinal = isArray(refDateValue) ? now : refDateValue \|\| now;\n const templatesFinal = isArray(templates) ? templates : isArray(refDateValue) ? refDateValue : defaultDiffTemplates;\n const d1 = dateParse(dateValue);\n const d2 = dateParse(refDateValueFinal);\n const diff = d1.getTime() - d2.getTime();\n const isAgo = diff < 0;\n const absDiff = Math.abs(diff);\n let relative = '';\n\n for (const [base, max, agoTemplate, featureTemplate] of templatesFinal) {\n const unitFinal = base 1000;\n const maxFinal = max * 1000;\n\n if (absDiff < maxFinal) {\n const template = isAgo ? agoTemplate : featureTemplate \|\| agoTemplate;\n const length = unitFinal === 0 ? 0 : Math.max(Math.floor(absDiff / unitFinal), 1);\n relative = unitFinal === 0 ? dateFormat(dateValue, template) : stringFormat(template, { n: length });\n break;\n }\n }\n\n return relative;\n}\n","import { type DateLike, type DateValue, dateParse } from './core';\n\n/*\n 判断给定的年份是否为闰年\n * @param year - 需要判断的年份\n * @returns 如果年份是闰年则返回 true，否则返回 false\n * @example\n * ```typescript\n * isLeapYear(2020); // true\n * isLeapYear(2021); // false\n * isLeapYear(2000); // true\n * isLeapYear(1900); // false\n * ```\n /\nexport function isLeapYear(year: number): boolean {\n if (year % 4 !== 0) return false;\n if (year % 100 !== 0) return true;\n if (year % 400 !== 0) return false;\n return true;\n}\n\n/\n 日期比较精度枚举类型\n * - Y = 年\n * - M = 月\n * - D = 天\n * - h = 小时\n * - m = 分钟\n * - s = 秒\n * - S = 毫秒\n /\ntype _DateSameSymbol = 'Y' \| 'M' \| 'D' \| 'h' \| 'm' \| 's' \| 'S';\n\n/\n 比较两个日期在指定精度下是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @param sameSymbol - 比较精度，默认为 'D'（天，即年月日天都相同）\n * @returns 如果两个日期在指定精度下相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15, 12, 30, 45, 500);\n * const date2 = new Date(2023, 5, 15, 13, 30, 45, 500);\n \n // 比较年份\n * isSameDate(date1, date2, 'Y'); // true\n \n // 比较月份（年份也要相同）\n * isSameDate(date1, date2, 'M'); // true\n \n // 比较日期（默认，年份、月份也要相同）\n * isSameDate(date1, date2); // true\n \n // 比较小时（年、月、日也要相同）\n * isSameDate(date1, date2, 'h'); // false\n \n // 比较分钟（年、月、日、小时也要相同）\n * isSameDate(date1, date2, 'm'); // false\n \n // 比较秒（年、月、日、小时、分钟也要相同）\n * isSameDate(date1, date2, 's'); // false\n \n // 比较毫秒（年、月、日、小时、分钟、秒数也要相同）\n * isSameDate(date1, date2, 'S'); // false\n * ```\n /\nfunction _isSameDateIn(date1: DateValue, date2: DateValue, sameSymbol: _DateSameSymbol = 'D') {\n const defines = [\n ['Y', (d: DateLike) => d.getFullYear()],\n ['M', (d: DateLike) => d.getMonth()],\n ['D', (d: DateLike) => d.getDate()],\n ['h', (d: DateLike) => d.getHours()],\n ['m', (d: DateLike) => d.getMinutes()],\n ['s', (d: DateLike) => d.getSeconds()],\n ['S', (d: DateLike) => d.getMilliseconds()],\n ] as const;\n\n const d1 = dateParse(date1);\n const d2 = dateParse(date2);\n\n for (const [sym, fn] of defines) {\n if (fn(d1) !== fn(d2)) {\n return false;\n }\n\n if (sym === sameSymbol) break;\n }\n\n return true;\n}\n\n/\n 比较两个日期的年份是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @returns 如果两个日期的年份相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15);\n * const date2 = new Date(2023, 6, 20);\n * isSameDateInYear(date1, date2); // true\n * ```\n /\nexport function isSameDateInYear(date1: DateValue, date2: DateValue) {\n return _isSameDateIn(date1, date2, 'Y');\n}\n\n/\n 比较两个日期的年份和月份是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @returns 如果两个日期的年份和月份相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15);\n * const date2 = new Date(2023, 5, 20);\n * isSameDateInMonth(date1, date2); // true\n * ```\n /\nexport function isSameDateInMonth(date1: DateValue, date2: DateValue) {\n return _isSameDateIn(date1, date2, 'M');\n}\n\n/\n 比较两个日期的年份、月份和天数是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @returns 如果两个日期的年份、月份和天数相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15);\n * const date2 = new Date(2023, 5, 15);\n * isSameDateInDay(date1, date2); // true\n * ```\n /\nexport function isSameDateInDay(date1: DateValue, date2: DateValue) {\n return _isSameDateIn(date1, date2, 'D');\n}\n\n/\n 比较两个日期的年份、月份、天数和小时是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @returns 如果两个日期的年份、月份、天数和小时相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15, 12);\n * const date2 = new Date(2023, 5, 15, 12);\n * isSameDateInHour(date1, date2); // true\n * ```\n /\nexport function isSameDateInHour(date1: DateValue, date2: DateValue) {\n return _isSameDateIn(date1, date2, 'h');\n}\n\n/\n 比较两个日期的年份、月份、天数、小时和分钟是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @returns 如果两个日期的年份、月份、天数、小时和分钟相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15, 12, 30);\n * const date2 = new Date(2023, 5, 15, 12, 30);\n * isSameDateInMinute(date1, date2); // true\n * ```\n /\nexport function isSameDateInMinute(date1: DateValue, date2: DateValue) {\n return _isSameDateIn(date1, date2, 'm');\n}\n\n/\n 比较两个日期的年份、月份、天数、小时、分钟和秒数是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @returns 如果两个日期的年份、月份、天数、小时、分钟和秒数相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15, 12, 30, 45);\n * const date2 = new Date(2023, 5, 15, 12, 30, 45);\n * isSameDateInSecond(date1, date2); // true\n * ```\n /\nexport function isSameDateInSecond(date1: DateValue, date2: DateValue) {\n return _isSameDateIn(date1, date2, 's');\n}\n","import { DATE_DAY_MS } from './const';\nimport { type DateValue, dateParse } from './core';\n\nexport enum EWeekStart {\n /\n 周日作为一周的起始日\n /\n sunday = 0,\n /\n 周一作为一周的起始日\n /\n monday = 1,\n /\n 周二作为一周的起始日\n /\n tuesday = 2,\n /\n 周三作为一周的起始日\n /\n wednesday = 3,\n /\n 周四作为一周的起始日\n /\n thursday = 4,\n /\n 周五作为一周的起始日\n /\n friday = 5,\n /\n 周六作为一周的起始日\n /\n saturday = 6,\n // /\n // 1号所在的周为第一周\n // /\n // firstDate = 7,\n // /\n // 完整7天表示第一周\n // /\n // firstFullWeek = 8,\n}\n\n/\n 计算指定日期所在年份或月份的周数\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param type - 计算范围，'Y' 表示年份，'M' 表示月份\n * @param weekStart - 一周的起始日，默认为 0（周日）\n * @returns 返回指定日期所在年份或月份的周数\n * @example\n * ```typescript\n * const date = new Date(2023, 0, 1); // 2023-01-01\n * _dateWeeks(date, 'Y'); // 1 (计算年份的周数)\n * _dateWeeks(date, 'M'); // 1 (计算月份的周数)\n * _dateWeeks(date, 'Y', 1); // 1 (周一作为一周的起始日，计算年份的周数)\n * ```\n /\nexport function _dateWeeks(dateValue: DateValue, type: 'Y' \| 'M', weekStart: EWeekStart = 0) {\n const date = dateParse(dateValue);\n\n const year = date.getFullYear();\n const month = date.getMonth();\n\n const firstDate = type === 'Y' ? new Date(year, 0, 1) : new Date(year, month, 1);\n const firstWeek = firstDate.getDay();\n const days = Math.ceil((date.getTime() - firstDate.getTime()) / DATE_DAY_MS);\n\n return Math.ceil((firstWeek + days - weekStart) / 7);\n}\n\n/\n 计算指定日期所在年份的周数\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param weekStart - 一周的起始日，默认为 0（周日）\n * @returns 返回指定日期所在年份的周数\n * @example\n * ```typescript\n * const date = new Date(2023, 0, 1); // 2023-01-01\n * weeksOfYear(date); // 1\n * weeksOfYear(date, 1); // 1 (周一作为一周的起始日)\n * ```\n /\nexport function weeksOfYear(dateValue: DateValue, weekStart: EWeekStart = 0) {\n return _dateWeeks(dateValue, 'Y', weekStart);\n}\n\n/\n 计算指定日期所在月份的周数\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param weekStart - 一周的起始日，默认为 0（周日）\n * @returns 返回指定日期所在月份的周数\n * @example\n * ```typescript\n * const date = new Date(2023, 0, 1); // 2023-01-01\n * weeksOfMonth(date); // 1\n * weeksOfMonth(date, 1); // 1 (周一作为一周的起始日)\n * ```\n */\nexport function weeksOfMonth(dateValue: DateValue, weekStart: EWeekStart = 0) {\n return _dateWeeks(dateValue, 'M', weekStart);\n}\n"],"names":["dateParse","DATE_DAY_MS","isArray","dateFormat","stringFormat","EWeekStart","type"],"mappings":"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"}

package/dist/date.mjs CHANGED Viewed

@@ -9,7 +9,7 @@ const dateOfStartMap = [
   ["m", (d2) => d2.setSeconds(0)],
   ["h", (d2) => d2.setMinutes(0)],
   ["D", (d2) => d2.setHours(0)],
-  ["W", (d2) => d2.setHours(0)],
+  ["W", (d2) => d2.setDate(d2.getDate() - (d2.getDay() + 6) % 7)],
   ["M", (d2) => d2.setDate(1)],
   ["Y", (d2) => d2.setMonth(0)]
 ];
@@ -33,6 +33,9 @@ function dateStartInHour(dateValue) {
 function dateStartInDay(dateValue) {
   return _dateStart(dateValue, "D");
 }
+function dateStartInWeek(dateValue) {
+  return _dateStart(dateValue, "W");
+}
 function dateStartInMonth(dateValue) {
   return _dateStart(dateValue, "M");
 }
@@ -44,6 +47,7 @@ const dateOfEndMap = [
   ["m", (d2) => d2.setSeconds(59)],
   ["h", (d2) => d2.setMinutes(59)],
   ["D", (d2) => d2.setHours(23)],
+  ["W", (d2) => d2.setDate(d2.getDate() + (7 - d2.getDay()) % 7)],
   [
     "M",
     (d2) => {
@@ -81,6 +85,9 @@ function dateEndInHour(dateValue) {
 function dateEndInDay(dateValue) {
   return _dateEnd(dateValue, "D");
 }
+function dateEndInWeek(dateValue) {
+  return _dateEnd(dateValue, "W");
+}
 function dateEndInMonth(dateValue) {
   return _dateEnd(dateValue, "M");
 }
@@ -217,6 +224,7 @@ export {
   dateEndInMinute,
   dateEndInMonth,
   dateEndInSecond,
+  dateEndInWeek,
   dateEndInYear,
   dateFormat,
   dateParse,
@@ -226,6 +234,7 @@ export {
   dateStartInMinute,
   dateStartInMonth,
   dateStartInSecond,
+  dateStartInWeek,
   dateStartInYear,
   isLeapYear,
   isSameDateInDay,

package/dist/date.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"date.mjs","sources":["../src/date/start-end.ts","../src/date/days.ts","../src/date/relative.ts","../src/date/is.ts","../src/date/weeks.ts"],"sourcesContent":["import { type DateLike, type DateValue, dateParse } from './core';\n\n/*\n 时间单位符号枚举\n * - 'Y': 年\n * - 'M': 月\n * - 'D': 天\n * - 'W': 周\n * - 'h': 小时\n * - 'm': 分钟\n * - 's': 秒\n /\ntype _TDateOfSymbol = 'Y' \| 'M' \| 'D' \| 'W' \| 'h' \| 'm' \| 's';\n\n/\n 各时间单位起始时间映射表\n * 包含将日期设置到单位起始时间的函数\n /\nconst dateOfStartMap: [_TDateOfSymbol, (date: DateLike) => unknown][] = [\n ['s', (d) => d.setMilliseconds(0)],\n ['m', (d) => d.setSeconds(0)],\n ['h', (d) => d.setMinutes(0)],\n ['D', (d) => d.setHours(0)],\n ['W', (d) => d.setHours(0)],\n ['M', (d) => d.setDate(1)],\n ['Y', (d) => d.setMonth(0)],\n];\n\n/\n 返回指定时间单位的起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param symbol - 时间单位符号，可选值为 'Y'（年）、'M'（月）、'D'（天）、'h'（小时）、'm'（分钟）、's'（秒），默认为 'D'\n * @returns 返回指定时间单位的起始时间\n * @example\n * ```typescript\n * const date = new Date(2023, 5, 15, 12, 30, 45, 500); // 2023-06-15 12:30:45.500\n \n // 返回秒级起始时间\n * dateOfStart(date, 's'); // 2023-06-15 12:30:45.000\n \n // 返回分钟级起始时间\n * dateOfStart(date, 'm'); // 2023-06-15 12:30:00.000\n \n // 返回小时级起始时间\n * dateOfStart(date, 'h'); // 2023-06-15 12:00:00.000\n \n // 返回天级起始时间\n * dateOfStart(date, 'D'); // 2023-06-15 00:00:00.000\n \n // 返回月级起始时间\n * dateOfStart(date, 'M'); // 2023-06-01 00:00:00.000\n \n // 返回年级起始时间\n * dateOfStart(date, 'Y'); // 2023-01-01 00:00:00.000\n \n // 默认返回天级起始时间\n * dateOfStart(date); // 2023-06-15 00:00:00.000\n * ```\n /\nfunction _dateStart(dateValue: DateValue, symbol: _TDateOfSymbol = 'D') {\n const date = dateParse(dateValue);\n\n for (const [sym, fn] of dateOfStartMap) {\n fn(date);\n if (symbol === sym) break;\n }\n\n return date;\n}\n\n/\n 返回秒级起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回秒级起始时间，毫秒部分为 0\n /\nexport function dateStartInSecond(dateValue: DateValue) {\n return _dateStart(dateValue, 's');\n}\n\n/\n 返回分钟级起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回分钟级起始时间，秒和毫秒部分为 0\n /\nexport function dateStartInMinute(dateValue: DateValue) {\n return _dateStart(dateValue, 'm');\n}\n\n/\n 返回小时级起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回小时级起始时间，分钟、秒和毫秒部分为 0\n /\nexport function dateStartInHour(dateValue: DateValue) {\n return _dateStart(dateValue, 'h');\n}\n\n/\n 返回天级起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回天级起始时间，小时、分钟、秒和毫秒部分为 0\n /\nexport function dateStartInDay(dateValue: DateValue) {\n return _dateStart(dateValue, 'D');\n}\n\n/\n 返回月级起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回月级起始时间，日期为当月第一天，时间部分为 0\n /\nexport function dateStartInMonth(dateValue: DateValue) {\n return _dateStart(dateValue, 'M');\n}\n\n/\n 返回年级起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回年级起始时间，月份为 1 月，日期为 1 日，时间部分为 0\n /\nexport function dateStartInYear(dateValue: DateValue) {\n return _dateStart(dateValue, 'Y');\n}\n\n/\n 各时间单位结束时间映射表\n * 包含将日期设置到单位结束时间的函数\n /\nconst dateOfEndMap: [_TDateOfSymbol, (date: DateLike) => unknown][] = [\n ['s', (d) => d.setMilliseconds(999)],\n ['m', (d) => d.setSeconds(59)],\n ['h', (d) => d.setMinutes(59)],\n ['D', (d) => d.setHours(23)],\n [\n 'M',\n (d) => {\n const d2 = dateParse(d);\n d2.setMonth(d.getMonth() + 1);\n d2.setDate(0);\n d.setDate(d2.getDate());\n },\n ],\n [\n 'Y',\n (d) => {\n d.setMonth(11);\n d.setDate(31);\n },\n ],\n];\n\n/\n 返回指定时间单位的结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param symbol - 时间单位符号，可选值为 'Y'（年）、'M'（月）、'D'（天）、'h'（小时）、'm'（分钟）、's'（秒），默认为 'D'\n * @returns 返回指定时间单位的结束时间\n * @example\n * ```typescript\n * const date = new Date(2023, 5, 15, 12, 30, 45, 500); // 2023-06-15 12:30:45.500\n \n // 返回秒级结束时间\n * dateOfEnd(date, 's'); // 2023-06-15 12:30:45.999\n \n // 返回分钟级结束时间\n * dateOfEnd(date, 'm'); // 2023-06-15 12:30:59.999\n \n // 返回小时级结束时间\n * dateOfEnd(date, 'h'); // 2023-06-15 12:59:59.999\n \n // 返回天级结束时间\n * dateOfEnd(date, 'D'); // 2023-06-15 23:59:59.999\n \n // 返回月级结束时间\n * dateOfEnd(date, 'M'); // 2023-06-30 23:59:59.999\n \n // 返回年级结束时间\n * dateOfEnd(date, 'Y'); // 2023-12-31 23:59:59.999\n \n // 默认返回天级结束时间\n * dateOfEnd(date); // 2023-06-15 23:59:59.999\n * ```\n /\nfunction _dateEnd(dateValue: DateValue, symbol: _TDateOfSymbol = 'D') {\n const date = dateParse(dateValue);\n\n for (const [sym, fn] of dateOfEndMap) {\n fn(date);\n if (symbol === sym) break;\n }\n\n return date;\n}\n\n/\n 返回秒级结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回秒级结束时间，毫秒部分为 999\n /\nexport function dateEndInSecond(dateValue: DateValue) {\n return _dateEnd(dateValue, 's');\n}\n\n/\n 返回分钟级结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回分钟级结束时间，秒为 59，毫秒为 999\n /\nexport function dateEndInMinute(dateValue: DateValue) {\n return _dateEnd(dateValue, 'm');\n}\n\n/\n 返回小时级结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回小时级结束时间，分钟为 59，秒为 59，毫秒为 999\n /\nexport function dateEndInHour(dateValue: DateValue) {\n return _dateEnd(dateValue, 'h');\n}\n\n/\n 返回天级结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回天级结束时间，小时为 23，分钟为 59，秒为 59，毫秒为 999\n /\nexport function dateEndInDay(dateValue: DateValue) {\n return _dateEnd(dateValue, 'D');\n}\n\n/\n 返回月级结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回月级结束时间，日期为当月最后一天，时间为 23:59:59.999\n /\nexport function dateEndInMonth(dateValue: DateValue) {\n return _dateEnd(dateValue, 'M');\n}\n\n/\n 返回年级结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回年级结束时间，月份为 12 月，日期为 31 日，时间为 23:59:59.999\n /\nexport function dateEndInYear(dateValue: DateValue) {\n return _dateEnd(dateValue, 'Y');\n}\n","import { DATE_DAY_MS } from './const';\nimport { type DateValue, dateParse } from './core';\nimport { dateEndInMonth, dateEndInYear, dateStartInMonth, dateStartInYear } from './start-end';\n\n/\n 计算指定日期所在年或月的天数\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param unit - 时间单位符号，可选值为 'Y'（年）、'M'（月），默认为 'M'\n * @returns 返回指定日期所在年或月的天数\n * @example\n * ```typescript\n * dateDays(new Date('2023-02-15')); // 28\n * dateDays(new Date('2024-02-15')); // 29 (闰年)\n * dateDays(new Date('2023-02-15'), 'Y'); // 365\n * dateDays(new Date('2024-02-15'), 'Y'); // 366 (闰年)\n * ```\n /\nfunction _dateDays(dateValue: DateValue, unit: 'Y' \| 'M') {\n const d = dateParse(dateValue);\n const ds = unit === 'M' ? dateStartInMonth(d) : dateStartInYear(d);\n const de = unit === 'M' ? dateEndInMonth(d) : dateEndInYear(d);\n return Math.ceil((de.getTime() - ds.getTime()) / DATE_DAY_MS);\n}\n\n/\n 计算指定日期所在月份的天数\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回指定日期所在月份的天数\n * @example\n * ```typescript\n * dateDaysInMonth(new Date('2023-02-15')); // 28\n * dateDaysInMonth(new Date('2024-02-15')); // 29 (闰年)\n * ```\n /\nexport function dateDaysInMonth(dateValue: DateValue) {\n return _dateDays(dateValue, 'M');\n}\n\n/\n 计算指定日期所在年份的天数\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回指定日期所在年份的天数\n * @example\n * ```typescript\n * dateDaysInYear(new Date('2023-02-15')); // 365\n * dateDaysInYear(new Date('2024-02-15')); // 366 (闰年)\n * ```\n /\nexport function dateDaysInYear(dateValue: DateValue) {\n return _dateDays(dateValue, 'Y');\n}\n","import { stringFormat } from '@/string';\nimport { isArray } from '@/type';\nimport { type DateValue, dateFormat, dateParse } from './core';\n\nexport type DateRelativeTemplate = [\n number /单位时间差，为 0 表示不计算单位差值，单位秒/,\n number /最大时间差，单位：秒/,\n string /过去模板字符串，%d 表述单位差值/,\n string? /将来模板字符串，%d 表述单位差值，可选/,\n];\nexport type DateRelativeTemplates = DateRelativeTemplate[];\n\nconst defaultDiffTemplates: DateRelativeTemplates = [\n [0, 10, '刚刚'],\n [1, 60, '{n} 秒前', '{n} 秒后'],\n [60, 60 60, '{n} 分钟前', '{n} 分钟后'],\n [60 * 60, 60 * 60 * 24, '{n} 小时前', '{n} 小时后'],\n [0, 60 * 60 * 24 * 2, '昨天', '明天'],\n [0, 60 * 60 * 24 * 3, '前天', '后天'],\n [60 * 60 * 24, 60 * 60 * 24 * 30, '{n} 天前', '{n} 天后'],\n [0, Number.POSITIVE_INFINITY, 'YYYY年MM月DD日'],\n];\n\n/*\n 相对时间\n * @param {DateValue} dateValue 比较的时间\n * @param {DateValue} [refDateValue] 相对的时间，默认为当前\n * @param {DateRelativeTemplates} [templates] 模板\n * @returns {string} 格式化后的相对时间字符串\n * @example\n * ```typescript\n * // 默认模板\n * dateRelative(new Date('2023-01-01')); // '刚刚'\n * dateRelative(new Date('2023-01-01'), new Date('2023-01-02')); // '昨天'\n * dateRelative(new Date('2023-01-01'), new Date('2023-01-04')); // '3 天前'\n * dateRelative(new Date('2023-01-01'), new Date('2023-02-01')); // '2023年01月01日'\n * ```\n * @example\n * ```typescript\n * // 自定义模板\n * const templates: DateRelativeTemplates = [\n * [0, 10, '刚刚'],\n * [1, 60, '{n} 秒前', '{n} 秒后'],\n * [60, 60 * 60, '{n} 分钟前', '{n} 分钟后'],\n * [60 * 60, 60 * 60 * 24, '{n} 小时前', '{n} 小时后'],\n * [0, 60 * 60 * 24 * 2, '昨天', '明天'],\n * [0, 60 * 60 * 24 * 3, '前天', '后天'],\n * [60 * 60 * 24, 60 * 60 * 24 * 30, '{n} 天前', '{n} 天后'],\n * [0, Number.POSITIVE_INFINITY, 'YYYY年MM月DD日'],\n * ];\n * dateRelative(new Date('2023-01-01'), new Date('2023-01-02'), templates); // '昨天'\n * dateRelative(new Date('2023-01-01'), new Date('2023-01-04'), templates); // '3 天前'\n * dateRelative(new Date('2023-01-01'), new Date('2023-02-01'), templates); // '2023年01月01日'\n * ```\n /\nexport function dateRelative(dateValue: DateValue, refDateValue: DateValue, templates: DateRelativeTemplates): string;\nexport function dateRelative(dateValue: DateValue, refDateValue: DateValue): string;\nexport function dateRelative(dateValue: DateValue, templates: DateRelativeTemplates): string;\nexport function dateRelative(dateValue: DateValue): string;\nexport function dateRelative(\n dateValue: DateValue,\n refDateValue?: DateValue \| DateRelativeTemplates,\n templates?: DateRelativeTemplates,\n): string {\n const now = Date.now();\n const refDateValueFinal = isArray(refDateValue) ? now : refDateValue \|\| now;\n const templatesFinal = isArray(templates) ? templates : isArray(refDateValue) ? refDateValue : defaultDiffTemplates;\n const d1 = dateParse(dateValue);\n const d2 = dateParse(refDateValueFinal);\n const diff = d1.getTime() - d2.getTime();\n const isAgo = diff < 0;\n const absDiff = Math.abs(diff);\n let relative = '';\n\n for (const [base, max, agoTemplate, featureTemplate] of templatesFinal) {\n const unitFinal = base 1000;\n const maxFinal = max * 1000;\n\n if (absDiff < maxFinal) {\n const template = isAgo ? agoTemplate : featureTemplate \|\| agoTemplate;\n const length = unitFinal === 0 ? 0 : Math.max(Math.floor(absDiff / unitFinal), 1);\n relative = unitFinal === 0 ? dateFormat(dateValue, template) : stringFormat(template, { n: length });\n break;\n }\n }\n\n return relative;\n}\n","import { type DateLike, type DateValue, dateParse } from './core';\n\n/*\n 判断给定的年份是否为闰年\n * @param year - 需要判断的年份\n * @returns 如果年份是闰年则返回 true，否则返回 false\n * @example\n * ```typescript\n * isLeapYear(2020); // true\n * isLeapYear(2021); // false\n * isLeapYear(2000); // true\n * isLeapYear(1900); // false\n * ```\n /\nexport function isLeapYear(year: number): boolean {\n if (year % 4 !== 0) return false;\n if (year % 100 !== 0) return true;\n if (year % 400 !== 0) return false;\n return true;\n}\n\n/\n 日期比较精度枚举类型\n * - Y = 年\n * - M = 月\n * - D = 天\n * - h = 小时\n * - m = 分钟\n * - s = 秒\n * - S = 毫秒\n /\ntype _DateSameSymbol = 'Y' \| 'M' \| 'D' \| 'h' \| 'm' \| 's' \| 'S';\n\n/\n 比较两个日期在指定精度下是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @param sameSymbol - 比较精度，默认为 'D'（天，即年月日天都相同）\n * @returns 如果两个日期在指定精度下相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15, 12, 30, 45, 500);\n * const date2 = new Date(2023, 5, 15, 13, 30, 45, 500);\n \n // 比较年份\n * isSameDate(date1, date2, 'Y'); // true\n \n // 比较月份（年份也要相同）\n * isSameDate(date1, date2, 'M'); // true\n \n // 比较日期（默认，年份、月份也要相同）\n * isSameDate(date1, date2); // true\n \n // 比较小时（年、月、日也要相同）\n * isSameDate(date1, date2, 'h'); // false\n \n // 比较分钟（年、月、日、小时也要相同）\n * isSameDate(date1, date2, 'm'); // false\n \n // 比较秒（年、月、日、小时、分钟也要相同）\n * isSameDate(date1, date2, 's'); // false\n \n // 比较毫秒（年、月、日、小时、分钟、秒数也要相同）\n * isSameDate(date1, date2, 'S'); // false\n * ```\n /\nfunction _isSameDateIn(date1: DateValue, date2: DateValue, sameSymbol: _DateSameSymbol = 'D') {\n const defines = [\n ['Y', (d: DateLike) => d.getFullYear()],\n ['M', (d: DateLike) => d.getMonth()],\n ['D', (d: DateLike) => d.getDate()],\n ['h', (d: DateLike) => d.getHours()],\n ['m', (d: DateLike) => d.getMinutes()],\n ['s', (d: DateLike) => d.getSeconds()],\n ['S', (d: DateLike) => d.getMilliseconds()],\n ] as const;\n\n const d1 = dateParse(date1);\n const d2 = dateParse(date2);\n\n for (const [sym, fn] of defines) {\n if (fn(d1) !== fn(d2)) {\n return false;\n }\n\n if (sym === sameSymbol) break;\n }\n\n return true;\n}\n\n/\n 比较两个日期的年份是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @returns 如果两个日期的年份相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15);\n * const date2 = new Date(2023, 6, 20);\n * isSameDateInYear(date1, date2); // true\n * ```\n /\nexport function isSameDateInYear(date1: DateValue, date2: DateValue) {\n return _isSameDateIn(date1, date2, 'Y');\n}\n\n/\n 比较两个日期的年份和月份是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @returns 如果两个日期的年份和月份相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15);\n * const date2 = new Date(2023, 5, 20);\n * isSameDateInMonth(date1, date2); // true\n * ```\n /\nexport function isSameDateInMonth(date1: DateValue, date2: DateValue) {\n return _isSameDateIn(date1, date2, 'M');\n}\n\n/\n 比较两个日期的年份、月份和天数是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @returns 如果两个日期的年份、月份和天数相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15);\n * const date2 = new Date(2023, 5, 15);\n * isSameDateInDay(date1, date2); // true\n * ```\n /\nexport function isSameDateInDay(date1: DateValue, date2: DateValue) {\n return _isSameDateIn(date1, date2, 'D');\n}\n\n/\n 比较两个日期的年份、月份、天数和小时是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @returns 如果两个日期的年份、月份、天数和小时相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15, 12);\n * const date2 = new Date(2023, 5, 15, 12);\n * isSameDateInHour(date1, date2); // true\n * ```\n /\nexport function isSameDateInHour(date1: DateValue, date2: DateValue) {\n return _isSameDateIn(date1, date2, 'h');\n}\n\n/\n 比较两个日期的年份、月份、天数、小时和分钟是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @returns 如果两个日期的年份、月份、天数、小时和分钟相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15, 12, 30);\n * const date2 = new Date(2023, 5, 15, 12, 30);\n * isSameDateInMinute(date1, date2); // true\n * ```\n /\nexport function isSameDateInMinute(date1: DateValue, date2: DateValue) {\n return _isSameDateIn(date1, date2, 'm');\n}\n\n/\n 比较两个日期的年份、月份、天数、小时、分钟和秒数是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @returns 如果两个日期的年份、月份、天数、小时、分钟和秒数相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15, 12, 30, 45);\n * const date2 = new Date(2023, 5, 15, 12, 30, 45);\n * isSameDateInSecond(date1, date2); // true\n * ```\n /\nexport function isSameDateInSecond(date1: DateValue, date2: DateValue) {\n return _isSameDateIn(date1, date2, 's');\n}\n","import { DATE_DAY_MS } from './const';\nimport { type DateValue, dateParse } from './core';\n\nexport enum EWeekStart {\n /\n 周日作为一周的起始日\n /\n sunday = 0,\n /\n 周一作为一周的起始日\n /\n monday = 1,\n /\n 周二作为一周的起始日\n /\n tuesday = 2,\n /\n 周三作为一周的起始日\n /\n wednesday = 3,\n /\n 周四作为一周的起始日\n /\n thursday = 4,\n /\n 周五作为一周的起始日\n /\n friday = 5,\n /\n 周六作为一周的起始日\n /\n saturday = 6,\n // /\n // 1号所在的周为第一周\n // /\n // firstDate = 7,\n // /\n // 完整7天表示第一周\n // /\n // firstFullWeek = 8,\n}\n\n/\n 计算指定日期所在年份或月份的周数\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param type - 计算范围，'Y' 表示年份，'M' 表示月份\n * @param weekStart - 一周的起始日，默认为 0（周日）\n * @returns 返回指定日期所在年份或月份的周数\n * @example\n * ```typescript\n * const date = new Date(2023, 0, 1); // 2023-01-01\n * _dateWeeks(date, 'Y'); // 1 (计算年份的周数)\n * _dateWeeks(date, 'M'); // 1 (计算月份的周数)\n * _dateWeeks(date, 'Y', 1); // 1 (周一作为一周的起始日，计算年份的周数)\n * ```\n /\nexport function _dateWeeks(dateValue: DateValue, type: 'Y' \| 'M', weekStart: EWeekStart = 0) {\n const date = dateParse(dateValue);\n\n const year = date.getFullYear();\n const month = date.getMonth();\n\n const firstDate = type === 'Y' ? new Date(year, 0, 1) : new Date(year, month, 1);\n const firstWeek = firstDate.getDay();\n const days = Math.ceil((date.getTime() - firstDate.getTime()) / DATE_DAY_MS);\n\n return Math.ceil((firstWeek + days - weekStart) / 7);\n}\n\n/\n 计算指定日期所在年份的周数\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param weekStart - 一周的起始日，默认为 0（周日）\n * @returns 返回指定日期所在年份的周数\n * @example\n * ```typescript\n * const date = new Date(2023, 0, 1); // 2023-01-01\n * weeksOfYear(date); // 1\n * weeksOfYear(date, 1); // 1 (周一作为一周的起始日)\n * ```\n /\nexport function weeksOfYear(dateValue: DateValue, weekStart: EWeekStart = 0) {\n return _dateWeeks(dateValue, 'Y', weekStart);\n}\n\n/\n 计算指定日期所在月份的周数\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param weekStart - 一周的起始日，默认为 0（周日）\n * @returns 返回指定日期所在月份的周数\n * @example\n * ```typescript\n * const date = new Date(2023, 0, 1); // 2023-01-01\n * weeksOfMonth(date); // 1\n * weeksOfMonth(date, 1); // 1 (周一作为一周的起始日)\n * ```\n */\nexport function weeksOfMonth(dateValue: DateValue, weekStart: EWeekStart = 0) {\n return _dateWeeks(dateValue, 'M', weekStart);\n}\n"],"names":["d","d2","EWeekStart"],"mappings":"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"}
1	+ {"version":3,"file":"date.mjs","sources":["../src/date/start-end.ts","../src/date/days.ts","../src/date/relative.ts","../src/date/is.ts","../src/date/weeks.ts"],"sourcesContent":["import { type DateLike, type DateValue, dateParse } from './core';\n\n/*\n 时间单位符号枚举\n * - 'Y': 年\n * - 'M': 月\n * - 'D': 天\n * - 'W': 周\n * - 'h': 小时\n * - 'm': 分钟\n * - 's': 秒\n /\ntype _TDateOfSymbol = 'Y' \| 'M' \| 'D' \| 'W' \| 'h' \| 'm' \| 's';\n\n/\n 各时间单位起始时间映射表\n * 包含将日期设置到单位起始时间的函数\n /\nconst dateOfStartMap: [_TDateOfSymbol, (date: DateLike) => unknown][] = [\n ['s', (d) => d.setMilliseconds(0)],\n ['m', (d) => d.setSeconds(0)],\n ['h', (d) => d.setMinutes(0)],\n ['D', (d) => d.setHours(0)],\n ['W', (d) => d.setDate(d.getDate() - ((d.getDay() + 6) % 7))],\n ['M', (d) => d.setDate(1)],\n ['Y', (d) => d.setMonth(0)],\n];\n\n/\n 返回指定时间单位的起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param symbol - 时间单位符号，可选值为 'Y'（年）、'M'（月）、'W'（周）、'D'（天）、'h'（小时）、'm'（分钟）、's'（秒），默认为 'D'\n * @returns 返回指定时间单位的起始时间\n * @example\n * ```typescript\n * const date = new Date(2023, 5, 15, 12, 30, 45, 500); // 2023-06-15 12:30:45.500\n \n // 返回秒级起始时间\n * dateOfStart(date, 's'); // 2023-06-15 12:30:45.000\n \n // 返回分钟级起始时间\n * dateOfStart(date, 'm'); // 2023-06-15 12:30:00.000\n \n // 返回小时级起始时间\n * dateOfStart(date, 'h'); // 2023-06-15 12:00:00.000\n \n // 返回天级起始时间\n * dateOfStart(date, 'D'); // 2023-06-15 00:00:00.000\n \n // 返回周级起始时间（周一）\n * dateOfStart(date, 'W'); // 2023-06-12 00:00:00.000\n \n // 返回月级起始时间\n * dateOfStart(date, 'M'); // 2023-06-01 00:00:00.000\n \n // 返回年级起始时间\n * dateOfStart(date, 'Y'); // 2023-01-01 00:00:00.000\n \n // 默认返回天级起始时间\n * dateOfStart(date); // 2023-06-15 00:00:00.000\n * ```\n /\nfunction _dateStart(dateValue: DateValue, symbol: _TDateOfSymbol = 'D') {\n const date = dateParse(dateValue);\n\n for (const [sym, fn] of dateOfStartMap) {\n fn(date);\n if (symbol === sym) break;\n }\n\n return date;\n}\n\n/\n 返回秒级起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回秒级起始时间，毫秒部分为 0\n /\nexport function dateStartInSecond(dateValue: DateValue) {\n return _dateStart(dateValue, 's');\n}\n\n/\n 返回分钟级起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回分钟级起始时间，秒和毫秒部分为 0\n /\nexport function dateStartInMinute(dateValue: DateValue) {\n return _dateStart(dateValue, 'm');\n}\n\n/\n 返回小时级起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回小时级起始时间，分钟、秒和毫秒部分为 0\n /\nexport function dateStartInHour(dateValue: DateValue) {\n return _dateStart(dateValue, 'h');\n}\n\n/\n 返回天级起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回天级起始时间，小时、分钟、秒和毫秒部分为 0\n /\nexport function dateStartInDay(dateValue: DateValue) {\n return _dateStart(dateValue, 'D');\n}\n\n/\n 返回周级起始时间（周一 00:00:00.000）\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回当周周一的起始时间，时间部分为 0\n /\nexport function dateStartInWeek(dateValue: DateValue) {\n return _dateStart(dateValue, 'W');\n}\n\n/\n 返回月级起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回月级起始时间，日期为当月第一天，时间部分为 0\n /\nexport function dateStartInMonth(dateValue: DateValue) {\n return _dateStart(dateValue, 'M');\n}\n\n/\n 返回年级起始时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回年级起始时间，月份为 1 月，日期为 1 日，时间部分为 0\n /\nexport function dateStartInYear(dateValue: DateValue) {\n return _dateStart(dateValue, 'Y');\n}\n\n/\n 各时间单位结束时间映射表\n * 包含将日期设置到单位结束时间的函数\n /\nconst dateOfEndMap: [_TDateOfSymbol, (date: DateLike) => unknown][] = [\n ['s', (d) => d.setMilliseconds(999)],\n ['m', (d) => d.setSeconds(59)],\n ['h', (d) => d.setMinutes(59)],\n ['D', (d) => d.setHours(23)],\n ['W', (d) => d.setDate(d.getDate() + ((7 - d.getDay()) % 7))],\n [\n 'M',\n (d) => {\n const d2 = dateParse(d);\n d2.setMonth(d.getMonth() + 1);\n d2.setDate(0);\n d.setDate(d2.getDate());\n },\n ],\n [\n 'Y',\n (d) => {\n d.setMonth(11);\n d.setDate(31);\n },\n ],\n];\n\n/\n 返回指定时间单位的结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param symbol - 时间单位符号，可选值为 'Y'（年）、'M'（月）、'W'（周）、'D'（天）、'h'（小时）、'm'（分钟）、's'（秒），默认为 'D'\n * @returns 返回指定时间单位的结束时间\n * @example\n * ```typescript\n * const date = new Date(2023, 5, 15, 12, 30, 45, 500); // 2023-06-15 12:30:45.500\n \n // 返回秒级结束时间\n * dateOfEnd(date, 's'); // 2023-06-15 12:30:45.999\n \n // 返回分钟级结束时间\n * dateOfEnd(date, 'm'); // 2023-06-15 12:30:59.999\n \n // 返回小时级结束时间\n * dateOfEnd(date, 'h'); // 2023-06-15 12:59:59.999\n \n // 返回天级结束时间\n * dateOfEnd(date, 'D'); // 2023-06-15 23:59:59.999\n \n // 返回周级结束时间（周日）\n * dateOfEnd(date, 'W'); // 2023-06-18 23:59:59.999\n \n // 返回月级结束时间\n * dateOfEnd(date, 'M'); // 2023-06-30 23:59:59.999\n \n // 返回年级结束时间\n * dateOfEnd(date, 'Y'); // 2023-12-31 23:59:59.999\n \n // 默认返回天级结束时间\n * dateOfEnd(date); // 2023-06-15 23:59:59.999\n * ```\n /\nfunction _dateEnd(dateValue: DateValue, symbol: _TDateOfSymbol = 'D') {\n const date = dateParse(dateValue);\n\n for (const [sym, fn] of dateOfEndMap) {\n fn(date);\n if (symbol === sym) break;\n }\n\n return date;\n}\n\n/\n 返回秒级结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回秒级结束时间，毫秒部分为 999\n /\nexport function dateEndInSecond(dateValue: DateValue) {\n return _dateEnd(dateValue, 's');\n}\n\n/\n 返回分钟级结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回分钟级结束时间，秒为 59，毫秒为 999\n /\nexport function dateEndInMinute(dateValue: DateValue) {\n return _dateEnd(dateValue, 'm');\n}\n\n/\n 返回小时级结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回小时级结束时间，分钟为 59，秒为 59，毫秒为 999\n /\nexport function dateEndInHour(dateValue: DateValue) {\n return _dateEnd(dateValue, 'h');\n}\n\n/\n 返回天级结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回天级结束时间，小时为 23，分钟为 59，秒为 59，毫秒为 999\n /\nexport function dateEndInDay(dateValue: DateValue) {\n return _dateEnd(dateValue, 'D');\n}\n\n/\n 返回周级结束时间（周日 23:59:59.999）\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回当周周日的结束时间，时间为 23:59:59.999\n /\nexport function dateEndInWeek(dateValue: DateValue) {\n return _dateEnd(dateValue, 'W');\n}\n\n/\n 返回月级结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回月级结束时间，日期为当月最后一天，时间为 23:59:59.999\n /\nexport function dateEndInMonth(dateValue: DateValue) {\n return _dateEnd(dateValue, 'M');\n}\n\n/\n 返回年级结束时间\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回年级结束时间，月份为 12 月，日期为 31 日，时间为 23:59:59.999\n /\nexport function dateEndInYear(dateValue: DateValue) {\n return _dateEnd(dateValue, 'Y');\n}\n","import { DATE_DAY_MS } from './const';\nimport { type DateValue, dateParse } from './core';\nimport { dateEndInMonth, dateEndInYear, dateStartInMonth, dateStartInYear } from './start-end';\n\n/\n 计算指定日期所在年或月的天数\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param unit - 时间单位符号，可选值为 'Y'（年）、'M'（月），默认为 'M'\n * @returns 返回指定日期所在年或月的天数\n * @example\n * ```typescript\n * dateDays(new Date('2023-02-15')); // 28\n * dateDays(new Date('2024-02-15')); // 29 (闰年)\n * dateDays(new Date('2023-02-15'), 'Y'); // 365\n * dateDays(new Date('2024-02-15'), 'Y'); // 366 (闰年)\n * ```\n /\nfunction _dateDays(dateValue: DateValue, unit: 'Y' \| 'M') {\n const d = dateParse(dateValue);\n const ds = unit === 'M' ? dateStartInMonth(d) : dateStartInYear(d);\n const de = unit === 'M' ? dateEndInMonth(d) : dateEndInYear(d);\n return Math.ceil((de.getTime() - ds.getTime()) / DATE_DAY_MS);\n}\n\n/\n 计算指定日期所在月份的天数\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回指定日期所在月份的天数\n * @example\n * ```typescript\n * dateDaysInMonth(new Date('2023-02-15')); // 28\n * dateDaysInMonth(new Date('2024-02-15')); // 29 (闰年)\n * ```\n /\nexport function dateDaysInMonth(dateValue: DateValue) {\n return _dateDays(dateValue, 'M');\n}\n\n/\n 计算指定日期所在年份的天数\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 返回指定日期所在年份的天数\n * @example\n * ```typescript\n * dateDaysInYear(new Date('2023-02-15')); // 365\n * dateDaysInYear(new Date('2024-02-15')); // 366 (闰年)\n * ```\n /\nexport function dateDaysInYear(dateValue: DateValue) {\n return _dateDays(dateValue, 'Y');\n}\n","import { stringFormat } from '@/string';\nimport { isArray } from '@/type';\nimport { type DateValue, dateFormat, dateParse } from './core';\n\nexport type DateRelativeTemplate = [\n number /单位时间差，为 0 表示不计算单位差值，单位秒/,\n number /最大时间差，单位：秒/,\n string /过去模板字符串，%d 表述单位差值/,\n string? /将来模板字符串，%d 表述单位差值，可选/,\n];\nexport type DateRelativeTemplates = DateRelativeTemplate[];\n\nconst defaultDiffTemplates: DateRelativeTemplates = [\n [0, 10, '刚刚'],\n [1, 60, '{n} 秒前', '{n} 秒后'],\n [60, 60 60, '{n} 分钟前', '{n} 分钟后'],\n [60 * 60, 60 * 60 * 24, '{n} 小时前', '{n} 小时后'],\n [0, 60 * 60 * 24 * 2, '昨天', '明天'],\n [0, 60 * 60 * 24 * 3, '前天', '后天'],\n [60 * 60 * 24, 60 * 60 * 24 * 30, '{n} 天前', '{n} 天后'],\n [0, Number.POSITIVE_INFINITY, 'YYYY年MM月DD日'],\n];\n\n/*\n 相对时间\n * @param {DateValue} dateValue 比较的时间\n * @param {DateValue} [refDateValue] 相对的时间，默认为当前\n * @param {DateRelativeTemplates} [templates] 模板\n * @returns {string} 格式化后的相对时间字符串\n * @example\n * ```typescript\n * // 默认模板\n * dateRelative(new Date('2023-01-01')); // '刚刚'\n * dateRelative(new Date('2023-01-01'), new Date('2023-01-02')); // '昨天'\n * dateRelative(new Date('2023-01-01'), new Date('2023-01-04')); // '3 天前'\n * dateRelative(new Date('2023-01-01'), new Date('2023-02-01')); // '2023年01月01日'\n * ```\n * @example\n * ```typescript\n * // 自定义模板\n * const templates: DateRelativeTemplates = [\n * [0, 10, '刚刚'],\n * [1, 60, '{n} 秒前', '{n} 秒后'],\n * [60, 60 * 60, '{n} 分钟前', '{n} 分钟后'],\n * [60 * 60, 60 * 60 * 24, '{n} 小时前', '{n} 小时后'],\n * [0, 60 * 60 * 24 * 2, '昨天', '明天'],\n * [0, 60 * 60 * 24 * 3, '前天', '后天'],\n * [60 * 60 * 24, 60 * 60 * 24 * 30, '{n} 天前', '{n} 天后'],\n * [0, Number.POSITIVE_INFINITY, 'YYYY年MM月DD日'],\n * ];\n * dateRelative(new Date('2023-01-01'), new Date('2023-01-02'), templates); // '昨天'\n * dateRelative(new Date('2023-01-01'), new Date('2023-01-04'), templates); // '3 天前'\n * dateRelative(new Date('2023-01-01'), new Date('2023-02-01'), templates); // '2023年01月01日'\n * ```\n /\nexport function dateRelative(dateValue: DateValue, refDateValue: DateValue, templates: DateRelativeTemplates): string;\nexport function dateRelative(dateValue: DateValue, refDateValue: DateValue): string;\nexport function dateRelative(dateValue: DateValue, templates: DateRelativeTemplates): string;\nexport function dateRelative(dateValue: DateValue): string;\nexport function dateRelative(\n dateValue: DateValue,\n refDateValue?: DateValue \| DateRelativeTemplates,\n templates?: DateRelativeTemplates,\n): string {\n const now = Date.now();\n const refDateValueFinal = isArray(refDateValue) ? now : refDateValue \|\| now;\n const templatesFinal = isArray(templates) ? templates : isArray(refDateValue) ? refDateValue : defaultDiffTemplates;\n const d1 = dateParse(dateValue);\n const d2 = dateParse(refDateValueFinal);\n const diff = d1.getTime() - d2.getTime();\n const isAgo = diff < 0;\n const absDiff = Math.abs(diff);\n let relative = '';\n\n for (const [base, max, agoTemplate, featureTemplate] of templatesFinal) {\n const unitFinal = base 1000;\n const maxFinal = max * 1000;\n\n if (absDiff < maxFinal) {\n const template = isAgo ? agoTemplate : featureTemplate \|\| agoTemplate;\n const length = unitFinal === 0 ? 0 : Math.max(Math.floor(absDiff / unitFinal), 1);\n relative = unitFinal === 0 ? dateFormat(dateValue, template) : stringFormat(template, { n: length });\n break;\n }\n }\n\n return relative;\n}\n","import { type DateLike, type DateValue, dateParse } from './core';\n\n/*\n 判断给定的年份是否为闰年\n * @param year - 需要判断的年份\n * @returns 如果年份是闰年则返回 true，否则返回 false\n * @example\n * ```typescript\n * isLeapYear(2020); // true\n * isLeapYear(2021); // false\n * isLeapYear(2000); // true\n * isLeapYear(1900); // false\n * ```\n /\nexport function isLeapYear(year: number): boolean {\n if (year % 4 !== 0) return false;\n if (year % 100 !== 0) return true;\n if (year % 400 !== 0) return false;\n return true;\n}\n\n/\n 日期比较精度枚举类型\n * - Y = 年\n * - M = 月\n * - D = 天\n * - h = 小时\n * - m = 分钟\n * - s = 秒\n * - S = 毫秒\n /\ntype _DateSameSymbol = 'Y' \| 'M' \| 'D' \| 'h' \| 'm' \| 's' \| 'S';\n\n/\n 比较两个日期在指定精度下是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @param sameSymbol - 比较精度，默认为 'D'（天，即年月日天都相同）\n * @returns 如果两个日期在指定精度下相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15, 12, 30, 45, 500);\n * const date2 = new Date(2023, 5, 15, 13, 30, 45, 500);\n \n // 比较年份\n * isSameDate(date1, date2, 'Y'); // true\n \n // 比较月份（年份也要相同）\n * isSameDate(date1, date2, 'M'); // true\n \n // 比较日期（默认，年份、月份也要相同）\n * isSameDate(date1, date2); // true\n \n // 比较小时（年、月、日也要相同）\n * isSameDate(date1, date2, 'h'); // false\n \n // 比较分钟（年、月、日、小时也要相同）\n * isSameDate(date1, date2, 'm'); // false\n \n // 比较秒（年、月、日、小时、分钟也要相同）\n * isSameDate(date1, date2, 's'); // false\n \n // 比较毫秒（年、月、日、小时、分钟、秒数也要相同）\n * isSameDate(date1, date2, 'S'); // false\n * ```\n /\nfunction _isSameDateIn(date1: DateValue, date2: DateValue, sameSymbol: _DateSameSymbol = 'D') {\n const defines = [\n ['Y', (d: DateLike) => d.getFullYear()],\n ['M', (d: DateLike) => d.getMonth()],\n ['D', (d: DateLike) => d.getDate()],\n ['h', (d: DateLike) => d.getHours()],\n ['m', (d: DateLike) => d.getMinutes()],\n ['s', (d: DateLike) => d.getSeconds()],\n ['S', (d: DateLike) => d.getMilliseconds()],\n ] as const;\n\n const d1 = dateParse(date1);\n const d2 = dateParse(date2);\n\n for (const [sym, fn] of defines) {\n if (fn(d1) !== fn(d2)) {\n return false;\n }\n\n if (sym === sameSymbol) break;\n }\n\n return true;\n}\n\n/\n 比较两个日期的年份是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @returns 如果两个日期的年份相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15);\n * const date2 = new Date(2023, 6, 20);\n * isSameDateInYear(date1, date2); // true\n * ```\n /\nexport function isSameDateInYear(date1: DateValue, date2: DateValue) {\n return _isSameDateIn(date1, date2, 'Y');\n}\n\n/\n 比较两个日期的年份和月份是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @returns 如果两个日期的年份和月份相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15);\n * const date2 = new Date(2023, 5, 20);\n * isSameDateInMonth(date1, date2); // true\n * ```\n /\nexport function isSameDateInMonth(date1: DateValue, date2: DateValue) {\n return _isSameDateIn(date1, date2, 'M');\n}\n\n/\n 比较两个日期的年份、月份和天数是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @returns 如果两个日期的年份、月份和天数相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15);\n * const date2 = new Date(2023, 5, 15);\n * isSameDateInDay(date1, date2); // true\n * ```\n /\nexport function isSameDateInDay(date1: DateValue, date2: DateValue) {\n return _isSameDateIn(date1, date2, 'D');\n}\n\n/\n 比较两个日期的年份、月份、天数和小时是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @returns 如果两个日期的年份、月份、天数和小时相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15, 12);\n * const date2 = new Date(2023, 5, 15, 12);\n * isSameDateInHour(date1, date2); // true\n * ```\n /\nexport function isSameDateInHour(date1: DateValue, date2: DateValue) {\n return _isSameDateIn(date1, date2, 'h');\n}\n\n/\n 比较两个日期的年份、月份、天数、小时和分钟是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @returns 如果两个日期的年份、月份、天数、小时和分钟相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15, 12, 30);\n * const date2 = new Date(2023, 5, 15, 12, 30);\n * isSameDateInMinute(date1, date2); // true\n * ```\n /\nexport function isSameDateInMinute(date1: DateValue, date2: DateValue) {\n return _isSameDateIn(date1, date2, 'm');\n}\n\n/\n 比较两个日期的年份、月份、天数、小时、分钟和秒数是否相同\n * @param date1 - 第一个日期，可以是数值、字符串或 Date 对象\n * @param date2 - 第二个日期，可以是数值、字符串或 Date 对象\n * @returns 如果两个日期的年份、月份、天数、小时、分钟和秒数相同则返回 true，否则返回 false\n * @example\n * ```typescript\n * const date1 = new Date(2023, 5, 15, 12, 30, 45);\n * const date2 = new Date(2023, 5, 15, 12, 30, 45);\n * isSameDateInSecond(date1, date2); // true\n * ```\n /\nexport function isSameDateInSecond(date1: DateValue, date2: DateValue) {\n return _isSameDateIn(date1, date2, 's');\n}\n","import { DATE_DAY_MS } from './const';\nimport { type DateValue, dateParse } from './core';\n\nexport enum EWeekStart {\n /\n 周日作为一周的起始日\n /\n sunday = 0,\n /\n 周一作为一周的起始日\n /\n monday = 1,\n /\n 周二作为一周的起始日\n /\n tuesday = 2,\n /\n 周三作为一周的起始日\n /\n wednesday = 3,\n /\n 周四作为一周的起始日\n /\n thursday = 4,\n /\n 周五作为一周的起始日\n /\n friday = 5,\n /\n 周六作为一周的起始日\n /\n saturday = 6,\n // /\n // 1号所在的周为第一周\n // /\n // firstDate = 7,\n // /\n // 完整7天表示第一周\n // /\n // firstFullWeek = 8,\n}\n\n/\n 计算指定日期所在年份或月份的周数\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param type - 计算范围，'Y' 表示年份，'M' 表示月份\n * @param weekStart - 一周的起始日，默认为 0（周日）\n * @returns 返回指定日期所在年份或月份的周数\n * @example\n * ```typescript\n * const date = new Date(2023, 0, 1); // 2023-01-01\n * _dateWeeks(date, 'Y'); // 1 (计算年份的周数)\n * _dateWeeks(date, 'M'); // 1 (计算月份的周数)\n * _dateWeeks(date, 'Y', 1); // 1 (周一作为一周的起始日，计算年份的周数)\n * ```\n /\nexport function _dateWeeks(dateValue: DateValue, type: 'Y' \| 'M', weekStart: EWeekStart = 0) {\n const date = dateParse(dateValue);\n\n const year = date.getFullYear();\n const month = date.getMonth();\n\n const firstDate = type === 'Y' ? new Date(year, 0, 1) : new Date(year, month, 1);\n const firstWeek = firstDate.getDay();\n const days = Math.ceil((date.getTime() - firstDate.getTime()) / DATE_DAY_MS);\n\n return Math.ceil((firstWeek + days - weekStart) / 7);\n}\n\n/\n 计算指定日期所在年份的周数\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param weekStart - 一周的起始日，默认为 0（周日）\n * @returns 返回指定日期所在年份的周数\n * @example\n * ```typescript\n * const date = new Date(2023, 0, 1); // 2023-01-01\n * weeksOfYear(date); // 1\n * weeksOfYear(date, 1); // 1 (周一作为一周的起始日)\n * ```\n /\nexport function weeksOfYear(dateValue: DateValue, weekStart: EWeekStart = 0) {\n return _dateWeeks(dateValue, 'Y', weekStart);\n}\n\n/\n 计算指定日期所在月份的周数\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param weekStart - 一周的起始日，默认为 0（周日）\n * @returns 返回指定日期所在月份的周数\n * @example\n * ```typescript\n * const date = new Date(2023, 0, 1); // 2023-01-01\n * weeksOfMonth(date); // 1\n * weeksOfMonth(date, 1); // 1 (周一作为一周的起始日)\n * ```\n */\nexport function weeksOfMonth(dateValue: DateValue, weekStart: EWeekStart = 0) {\n return _dateWeeks(dateValue, 'M', weekStart);\n}\n"],"names":["d","d2","EWeekStart"],"mappings":"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"}

package/dist/function.cjs CHANGED Viewed

@@ -36,16 +36,19 @@ function fnThrottle(fn, wait) {
   const throttled = function(...args) {
     if (canceled) return;
     const now = Date.now();
+    let executed = false;
     if (options.leading && lastTime === 0) {
       lastTime = now;
       fn.apply(this, args);
+      executed = true;
     } else if (lastTime > 0 && now - lastTime >= waitFinal) {
       lastTime = now;
       fn.apply(this, args);
+      executed = true;
     } else if (lastTime === 0) {
       lastTime = now;
     }
-    if (options.trailing) {
+    if (options.trailing && !executed) {
       clearTimeout(timer);
       timer = setTimeout(() => {
         fn.apply(this, args);

package/dist/function.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"function.cjs","sources":["../src/function.ts"],"sourcesContent":["import { isNumber } from './type';\nimport type { AnyFunction } from './types';\n\n/*\n 一个空操作函数，不执行任何操作。\n \n @example\n * ```typescript\n * fnNoop(); // 不执行任何操作\n * ```\n /\nexport function fnNoop() {\n //\n}\n\n/\n 防抖函数的配置选项。\n /\nexport type DebounceOptions = {\n /\n 等待时间（毫秒）。\n /\n wait: number;\n /\n 是否在等待开始时立即执行一次\n * @default false\n /\n leading?: boolean;\n};\n\n/\n 创建一个防抖函数，该函数会在指定的等待时间后执行，如果在等待时间内再次调用，则重新计时。\n \n @param fn - 需要防抖的函数。\n * @param wait - 等待时间（毫秒）或包含 `wait` 和 `leading` 选项的对象。\n * @returns 返回一个防抖函数，该函数具有 `cancel` 方法，用于取消防抖操作。\n \n @example\n * ```typescript\n * const debouncedFn = fnDebounce(() => {\n * console.log('Debounced!');\n * }, 100);\n \n debouncedFn(); // 不会立即执行\n * debouncedFn(); // 重新计时\n * debouncedFn.cancel(); // 取消防抖操作\n * ```\n /\nexport function fnDebounce<F extends AnyFunction>(fn: F, wait: number \| DebounceOptions) {\n const options: DebounceOptions = isNumber(wait) ? { wait } : wait;\n let canceled = false;\n // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n let timer: any;\n let leading = false;\n\n const debounced = function (this: unknown, ...args: Parameters<F>) {\n if (canceled) return;\n\n // 第一次执行\n if (options.leading && !leading) {\n leading = true;\n fn.apply(this, args);\n return;\n }\n\n // 最后一次执行\n clearTimeout(timer);\n timer = setTimeout(() => {\n if (canceled) return;\n\n fn.apply(this, args);\n }, options.wait);\n };\n\n debounced.cancel = () => {\n clearTimeout(timer);\n canceled = true;\n };\n\n return debounced;\n}\n\nexport type ThrottleOptions = {\n /\n 等待时间（毫秒）。\n /\n wait: number;\n\n /\n 是否在第一次调用时立即执行\n * @default false\n /\n leading?: boolean;\n\n /\n 是否在调用结束后等待一段时间再执行\n * @default false\n /\n trailing?: boolean;\n};\n\n/\n 创建一个节流函数，该函数会在指定的等待时间内最多执行一次，如果在等待时间内再次调用，则忽略后续调用。\n \n @param fn - 需要节流的函数。\n * @param wait - 等待时间（毫秒）或包含 `wait`、`leading` 和 `trailing` 选项的对象。\n * @returns 返回一个节流函数，该函数具有 `cancel` 方法，用于取消节流操作。\n \n @example\n * ```typescript\n * const throttledFn = fnThrottle(() => {\n * console.log('Throttled!');\n * }, 100);\n \n throttledFn(); // 立即执行\n * throttledFn(); // 忽略\n * throttledFn.cancel(); // 取消节流操作\n * ```\n /\nexport function fnThrottle<F extends AnyFunction>(fn: F, wait: number \| ThrottleOptions) {\n const options = isNumber(wait) ? { wait } : wait;\n const waitFinal = options.wait;\n let lastTime = 0;\n let canceled = false;\n // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n let timer: any;\n\n const throttled = function (this: unknown, ...args: Parameters<F>) {\n if (canceled) return;\n\n const now = Date.now();\n\n // 第一次执行\n if (options.leading && lastTime === 0) {\n lastTime = now;\n fn.apply(this, args);\n }\n\n // 中间控频执行\n else if (lastTime > 0 && now - lastTime >= waitFinal) {\n lastTime = now;\n fn.apply(this, args);\n }\n\n // 首次计时\n else if (lastTime === 0) {\n lastTime = now;\n }\n\n // ~~最后一次执行\~~n if (options.trailing) {\n clearTimeout(timer);\n timer = setTimeout(() => {\n fn.apply(this, args);\n }, waitFinal);\n }\n };\n\n throttled.cancel = () => {\n canceled = true;\n clearTimeout(timer);\n };\n\n return throttled;\n}\n\n/\n 创建一个只执行一次的函数，无论调用多少次，实际执行的函数体也只会执行一次。\n \n @param fn - 需要只执行一次的函数。\n * @returns 返回一个只执行一次的函数，该函数在第一次调用后会缓存结果并返回缓存的结果。\n \n @example\n * ```typescript\n * const onceFn = fnOnce(() => {\n * console.log('This will be logged only once.');\n * return 42;\n * });\n \n console.log(onceFn()); // 输出: This will be logged only once. 42\n * console.log(onceFn()); // 输出: 42\n * ```\n */\nexport function fnOnce<F extends AnyFunction>(fn: F) {\n let called = false;\n // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n let result: any;\n\n return function (this: unknown, ...args: Parameters<F>) {\n if (!called) {\n called = true;\n result = fn.apply(this, args);\n }\n\n return result;\n };\n}\n"],"names":["isNumber"],"mappings":";;;AAWO,SAAS,SAAS;AAEzB;AAmCgB,SAAA,WAAkC,IAAO,MAAgC;AACvF,QAAM,UAA2BA,KAAAA,SAAS,IAAI,IAAI,EAAE,KAAS,IAAA;AAC7D,MAAI,WAAW;AAEX,MAAA;AACJ,MAAI,UAAU;AAER,QAAA,YAAY,YAA4B,MAAqB;AACjE,QAAI,SAAU;AAGV,QAAA,QAAQ,WAAW,CAAC,SAAS;AACrB,gBAAA;AACP,SAAA,MAAM,MAAM,IAAI;AACnB;AAAA,IAAA;AAIF,iBAAa,KAAK;AAClB,YAAQ,WAAW,MAAM;AACvB,UAAI,SAAU;AAEX,SAAA,MAAM,MAAM,IAAI;AAAA,IAAA,GAClB,QAAQ,IAAI;AAAA,EACjB;AAEA,YAAU,SAAS,MAAM;AACvB,iBAAa,KAAK;AACP,eAAA;AAAA,EACb;AAEO,SAAA;AACT;AAuCgB,SAAA,WAAkC,IAAO,MAAgC;AACvF,QAAM,UAAUA,KAAAA,SAAS,IAAI,IAAI,EAAE,KAAS,IAAA;AAC5C,QAAM,YAAY,QAAQ;AAC1B,MAAI,WAAW;AACf,MAAI,WAAW;AAEX,MAAA;AAEE,QAAA,YAAY,YAA4B,MAAqB;AACjE,QAAI,SAAU;AAER,UAAA,MAAM,KAAK,IAAI;~~AAGjB~~,QAAA,QAAQ,WAAW,aAAa,GAAG;AAC1B,iBAAA;AACR,SAAA,MAAM,MAAM,IAAI;AAAA,~~IAIZ~~,WAAA,WAAW,KAAK,MAAM,YAAY,WAAW;AACzC,iBAAA;AACR,SAAA,MAAM,MAAM,IAAI;AAAA,IAAA,~~WAIZ~~,aAAa,GAAG;AACZ,iBAAA;AAAA,IAAA;~~AAIb~~,~~QAAI~~,QAAQ,UAAU;~~AACpB~~,mBAAa,KAAK;AAClB,cAAQ,WAAW,MAAM;AACpB,WAAA,MAAM,MAAM,IAAI;AAAA,SAClB,SAAS;AAAA,IAAA;AAAA,EAEhB;AAEA,YAAU,SAAS,MAAM;AACZ,eAAA;AACX,iBAAa,KAAK;AAAA,EACpB;AAEO,SAAA;AACT;AAmBO,SAAS,OAA8B,IAAO;AACnD,MAAI,SAAS;AAET,MAAA;AAEJ,SAAO,YAA4B,MAAqB;AACtD,QAAI,CAAC,QAAQ;AACF,eAAA;AACA,eAAA,GAAG,MAAM,MAAM,IAAI;AAAA,IAAA;AAGvB,WAAA;AAAA,EACT;AACF;;;;;"}
1	+ {"version":3,"file":"function.cjs","sources":["../src/function.ts"],"sourcesContent":["import { isNumber } from './type';\nimport type { AnyFunction } from './types';\n\n/*\n 一个空操作函数，不执行任何操作。\n \n @example\n * ```typescript\n * fnNoop(); // 不执行任何操作\n * ```\n /\nexport function fnNoop() {\n //\n}\n\n/\n 防抖函数的配置选项。\n /\nexport type DebounceOptions = {\n /\n 等待时间（毫秒）。\n /\n wait: number;\n /\n 是否在等待开始时立即执行一次\n * @default false\n /\n leading?: boolean;\n};\n\n/\n 创建一个防抖函数，该函数会在指定的等待时间后执行，如果在等待时间内再次调用，则重新计时。\n \n @param fn - 需要防抖的函数。\n * @param wait - 等待时间（毫秒）或包含 `wait` 和 `leading` 选项的对象。\n * @returns 返回一个防抖函数，该函数具有 `cancel` 方法，用于取消防抖操作。\n \n @example\n * ```typescript\n * const debouncedFn = fnDebounce(() => {\n * console.log('Debounced!');\n * }, 100);\n \n debouncedFn(); // 不会立即执行\n * debouncedFn(); // 重新计时\n * debouncedFn.cancel(); // 取消防抖操作\n * ```\n /\nexport function fnDebounce<F extends AnyFunction>(fn: F, wait: number \| DebounceOptions) {\n const options: DebounceOptions = isNumber(wait) ? { wait } : wait;\n let canceled = false;\n // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n let timer: any;\n let leading = false;\n\n const debounced = function (this: unknown, ...args: Parameters<F>) {\n if (canceled) return;\n\n // 第一次执行\n if (options.leading && !leading) {\n leading = true;\n fn.apply(this, args);\n return;\n }\n\n // 最后一次执行\n clearTimeout(timer);\n timer = setTimeout(() => {\n if (canceled) return;\n\n fn.apply(this, args);\n }, options.wait);\n };\n\n debounced.cancel = () => {\n clearTimeout(timer);\n canceled = true;\n };\n\n return debounced;\n}\n\nexport type ThrottleOptions = {\n /\n 等待时间（毫秒）。\n /\n wait: number;\n\n /\n 是否在第一次调用时立即执行\n * @default false\n /\n leading?: boolean;\n\n /\n 是否在调用结束后等待一段时间再执行\n * @default false\n /\n trailing?: boolean;\n};\n\n/\n 创建一个节流函数，该函数会在指定的等待时间内最多执行一次，如果在等待时间内再次调用，则忽略后续调用。\n \n @param fn - 需要节流的函数。\n * @param wait - 等待时间（毫秒）或包含 `wait`、`leading` 和 `trailing` 选项的对象。\n * @returns 返回一个节流函数，该函数具有 `cancel` 方法，用于取消节流操作。\n \n @example\n * ```typescript\n * const throttledFn = fnThrottle(() => {\n * console.log('Throttled!');\n * }, 100);\n \n throttledFn(); // 立即执行\n * throttledFn(); // 忽略\n * throttledFn.cancel(); // 取消节流操作\n * ```\n /\nexport function fnThrottle<F extends AnyFunction>(fn: F, wait: number \| ThrottleOptions) {\n const options = isNumber(wait) ? { wait } : wait;\n const waitFinal = options.wait;\n let lastTime = 0;\n let canceled = false;\n // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n let timer: any;\n\n const throttled = function (this: unknown, ...args: Parameters<F>) {\n if (canceled) return;\n\n const now = Date.now();\n let executed = false;\n\n // 第一次执行\n if (options.leading && lastTime === 0) {\n lastTime = now;\n fn.apply(this, args);\n executed = true;\n }\n\n // 中间控频执行\n else if (lastTime > 0 && now - lastTime >= waitFinal) {\n lastTime = now;\n fn.apply(this, args);\n executed = true;\n }\n\n // 首次计时\n else if (lastTime === 0) {\n lastTime = now;\n }\n\n // 最后一次执行，仅在本次未执行时才设置 trailing\n if (options.trailing && !executed) {\n clearTimeout(timer);\n timer = setTimeout(() => {\n fn.apply(this, args);\n }, waitFinal);\n }\n };\n\n throttled.cancel = () => {\n canceled = true;\n clearTimeout(timer);\n };\n\n return throttled;\n}\n\n/\n 创建一个只执行一次的函数，无论调用多少次，实际执行的函数体也只会执行一次。\n \n @param fn - 需要只执行一次的函数。\n * @returns 返回一个只执行一次的函数，该函数在第一次调用后会缓存结果并返回缓存的结果。\n \n @example\n * ```typescript\n * const onceFn = fnOnce(() => {\n * console.log('This will be logged only once.');\n * return 42;\n * });\n \n console.log(onceFn()); // 输出: This will be logged only once. 42\n * console.log(onceFn()); // 输出: 42\n * ```\n */\nexport function fnOnce<F extends AnyFunction>(fn: F) {\n let called = false;\n // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n let result: any;\n\n return function (this: unknown, ...args: Parameters<F>) {\n if (!called) {\n called = true;\n result = fn.apply(this, args);\n }\n\n return result;\n };\n}\n"],"names":["isNumber"],"mappings":";;;AAWO,SAAS,SAAS;AAEzB;AAmCgB,SAAA,WAAkC,IAAO,MAAgC;AACvF,QAAM,UAA2BA,KAAAA,SAAS,IAAI,IAAI,EAAE,KAAS,IAAA;AAC7D,MAAI,WAAW;AAEX,MAAA;AACJ,MAAI,UAAU;AAER,QAAA,YAAY,YAA4B,MAAqB;AACjE,QAAI,SAAU;AAGV,QAAA,QAAQ,WAAW,CAAC,SAAS;AACrB,gBAAA;AACP,SAAA,MAAM,MAAM,IAAI;AACnB;AAAA,IAAA;AAIF,iBAAa,KAAK;AAClB,YAAQ,WAAW,MAAM;AACvB,UAAI,SAAU;AAEX,SAAA,MAAM,MAAM,IAAI;AAAA,IAAA,GAClB,QAAQ,IAAI;AAAA,EACjB;AAEA,YAAU,SAAS,MAAM;AACvB,iBAAa,KAAK;AACP,eAAA;AAAA,EACb;AAEO,SAAA;AACT;AAuCgB,SAAA,WAAkC,IAAO,MAAgC;AACvF,QAAM,UAAUA,KAAAA,SAAS,IAAI,IAAI,EAAE,KAAS,IAAA;AAC5C,QAAM,YAAY,QAAQ;AAC1B,MAAI,WAAW;AACf,MAAI,WAAW;AAEX,MAAA;AAEE,QAAA,YAAY,YAA4B,MAAqB;AACjE,QAAI,SAAU;AAER,UAAA,MAAM,KAAK,IAAI;AACrB,QAAI,WAAW;AAGX,QAAA,QAAQ,WAAW,aAAa,GAAG;AAC1B,iBAAA;AACR,SAAA,MAAM,MAAM,IAAI;AACR,iBAAA;AAAA,IAIJ,WAAA,WAAW,KAAK,MAAM,YAAY,WAAW;AACzC,iBAAA;AACR,SAAA,MAAM,MAAM,IAAI;AACR,iBAAA;AAAA,IAAA,WAIJ,aAAa,GAAG;AACZ,iBAAA;AAAA,IAAA;AAIT,QAAA,QAAQ,YAAY,CAAC,UAAU;AACjC,mBAAa,KAAK;AAClB,cAAQ,WAAW,MAAM;AACpB,WAAA,MAAM,MAAM,IAAI;AAAA,SAClB,SAAS;AAAA,IAAA;AAAA,EAEhB;AAEA,YAAU,SAAS,MAAM;AACZ,eAAA;AACX,iBAAa,KAAK;AAAA,EACpB;AAEO,SAAA;AACT;AAmBO,SAAS,OAA8B,IAAO;AACnD,MAAI,SAAS;AAET,MAAA;AAEJ,SAAO,YAA4B,MAAqB;AACtD,QAAI,CAAC,QAAQ;AACF,eAAA;AACA,eAAA,GAAG,MAAM,MAAM,IAAI;AAAA,IAAA;AAGvB,WAAA;AAAA,EACT;AACF;;;;;"}

package/dist/function.mjs CHANGED Viewed

@@ -34,16 +34,19 @@ function fnThrottle(fn, wait) {
   const throttled = function(...args) {
     if (canceled) return;
     const now = Date.now();
+    let executed = false;
     if (options.leading && lastTime === 0) {
       lastTime = now;
       fn.apply(this, args);
+      executed = true;
     } else if (lastTime > 0 && now - lastTime >= waitFinal) {
       lastTime = now;
       fn.apply(this, args);
+      executed = true;
     } else if (lastTime === 0) {
       lastTime = now;
     }
-    if (options.trailing) {
+    if (options.trailing && !executed) {
       clearTimeout(timer);
       timer = setTimeout(() => {
         fn.apply(this, args);

package/dist/function.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"function.mjs","sources":["../src/function.ts"],"sourcesContent":["import { isNumber } from './type';\nimport type { AnyFunction } from './types';\n\n/*\n 一个空操作函数，不执行任何操作。\n \n @example\n * ```typescript\n * fnNoop(); // 不执行任何操作\n * ```\n /\nexport function fnNoop() {\n //\n}\n\n/\n 防抖函数的配置选项。\n /\nexport type DebounceOptions = {\n /\n 等待时间（毫秒）。\n /\n wait: number;\n /\n 是否在等待开始时立即执行一次\n * @default false\n /\n leading?: boolean;\n};\n\n/\n 创建一个防抖函数，该函数会在指定的等待时间后执行，如果在等待时间内再次调用，则重新计时。\n \n @param fn - 需要防抖的函数。\n * @param wait - 等待时间（毫秒）或包含 `wait` 和 `leading` 选项的对象。\n * @returns 返回一个防抖函数，该函数具有 `cancel` 方法，用于取消防抖操作。\n \n @example\n * ```typescript\n * const debouncedFn = fnDebounce(() => {\n * console.log('Debounced!');\n * }, 100);\n \n debouncedFn(); // 不会立即执行\n * debouncedFn(); // 重新计时\n * debouncedFn.cancel(); // 取消防抖操作\n * ```\n /\nexport function fnDebounce<F extends AnyFunction>(fn: F, wait: number \| DebounceOptions) {\n const options: DebounceOptions = isNumber(wait) ? { wait } : wait;\n let canceled = false;\n // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n let timer: any;\n let leading = false;\n\n const debounced = function (this: unknown, ...args: Parameters<F>) {\n if (canceled) return;\n\n // 第一次执行\n if (options.leading && !leading) {\n leading = true;\n fn.apply(this, args);\n return;\n }\n\n // 最后一次执行\n clearTimeout(timer);\n timer = setTimeout(() => {\n if (canceled) return;\n\n fn.apply(this, args);\n }, options.wait);\n };\n\n debounced.cancel = () => {\n clearTimeout(timer);\n canceled = true;\n };\n\n return debounced;\n}\n\nexport type ThrottleOptions = {\n /\n 等待时间（毫秒）。\n /\n wait: number;\n\n /\n 是否在第一次调用时立即执行\n * @default false\n /\n leading?: boolean;\n\n /\n 是否在调用结束后等待一段时间再执行\n * @default false\n /\n trailing?: boolean;\n};\n\n/\n 创建一个节流函数，该函数会在指定的等待时间内最多执行一次，如果在等待时间内再次调用，则忽略后续调用。\n \n @param fn - 需要节流的函数。\n * @param wait - 等待时间（毫秒）或包含 `wait`、`leading` 和 `trailing` 选项的对象。\n * @returns 返回一个节流函数，该函数具有 `cancel` 方法，用于取消节流操作。\n \n @example\n * ```typescript\n * const throttledFn = fnThrottle(() => {\n * console.log('Throttled!');\n * }, 100);\n \n throttledFn(); // 立即执行\n * throttledFn(); // 忽略\n * throttledFn.cancel(); // 取消节流操作\n * ```\n /\nexport function fnThrottle<F extends AnyFunction>(fn: F, wait: number \| ThrottleOptions) {\n const options = isNumber(wait) ? { wait } : wait;\n const waitFinal = options.wait;\n let lastTime = 0;\n let canceled = false;\n // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n let timer: any;\n\n const throttled = function (this: unknown, ...args: Parameters<F>) {\n if (canceled) return;\n\n const now = Date.now();\n\n // 第一次执行\n if (options.leading && lastTime === 0) {\n lastTime = now;\n fn.apply(this, args);\n }\n\n // 中间控频执行\n else if (lastTime > 0 && now - lastTime >= waitFinal) {\n lastTime = now;\n fn.apply(this, args);\n }\n\n // 首次计时\n else if (lastTime === 0) {\n lastTime = now;\n }\n\n // ~~最后一次执行\~~n if (options.trailing) {\n clearTimeout(timer);\n timer = setTimeout(() => {\n fn.apply(this, args);\n }, waitFinal);\n }\n };\n\n throttled.cancel = () => {\n canceled = true;\n clearTimeout(timer);\n };\n\n return throttled;\n}\n\n/\n 创建一个只执行一次的函数，无论调用多少次，实际执行的函数体也只会执行一次。\n \n @param fn - 需要只执行一次的函数。\n * @returns 返回一个只执行一次的函数，该函数在第一次调用后会缓存结果并返回缓存的结果。\n \n @example\n * ```typescript\n * const onceFn = fnOnce(() => {\n * console.log('This will be logged only once.');\n * return 42;\n * });\n \n console.log(onceFn()); // 输出: This will be logged only once. 42\n * console.log(onceFn()); // 输出: 42\n * ```\n */\nexport function fnOnce<F extends AnyFunction>(fn: F) {\n let called = false;\n // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n let result: any;\n\n return function (this: unknown, ...args: Parameters<F>) {\n if (!called) {\n called = true;\n result = fn.apply(this, args);\n }\n\n return result;\n };\n}\n"],"names":[],"mappings":";AAWO,SAAS,SAAS;AAEzB;AAmCgB,SAAA,WAAkC,IAAO,MAAgC;AACvF,QAAM,UAA2B,SAAS,IAAI,IAAI,EAAE,KAAS,IAAA;AAC7D,MAAI,WAAW;AAEX,MAAA;AACJ,MAAI,UAAU;AAER,QAAA,YAAY,YAA4B,MAAqB;AACjE,QAAI,SAAU;AAGV,QAAA,QAAQ,WAAW,CAAC,SAAS;AACrB,gBAAA;AACP,SAAA,MAAM,MAAM,IAAI;AACnB;AAAA,IAAA;AAIF,iBAAa,KAAK;AAClB,YAAQ,WAAW,MAAM;AACvB,UAAI,SAAU;AAEX,SAAA,MAAM,MAAM,IAAI;AAAA,IAAA,GAClB,QAAQ,IAAI;AAAA,EACjB;AAEA,YAAU,SAAS,MAAM;AACvB,iBAAa,KAAK;AACP,eAAA;AAAA,EACb;AAEO,SAAA;AACT;AAuCgB,SAAA,WAAkC,IAAO,MAAgC;AACvF,QAAM,UAAU,SAAS,IAAI,IAAI,EAAE,KAAS,IAAA;AAC5C,QAAM,YAAY,QAAQ;AAC1B,MAAI,WAAW;AACf,MAAI,WAAW;AAEX,MAAA;AAEE,QAAA,YAAY,YAA4B,MAAqB;AACjE,QAAI,SAAU;AAER,UAAA,MAAM,KAAK,IAAI;~~AAGjB~~,QAAA,QAAQ,WAAW,aAAa,GAAG;AAC1B,iBAAA;AACR,SAAA,MAAM,MAAM,IAAI;AAAA,~~IAIZ~~,WAAA,WAAW,KAAK,MAAM,YAAY,WAAW;AACzC,iBAAA;AACR,SAAA,MAAM,MAAM,IAAI;AAAA,IAAA,~~WAIZ~~,aAAa,GAAG;AACZ,iBAAA;AAAA,IAAA;~~AAIb~~,~~QAAI~~,QAAQ,UAAU;~~AACpB~~,mBAAa,KAAK;AAClB,cAAQ,WAAW,MAAM;AACpB,WAAA,MAAM,MAAM,IAAI;AAAA,SAClB,SAAS;AAAA,IAAA;AAAA,EAEhB;AAEA,YAAU,SAAS,MAAM;AACZ,eAAA;AACX,iBAAa,KAAK;AAAA,EACpB;AAEO,SAAA;AACT;AAmBO,SAAS,OAA8B,IAAO;AACnD,MAAI,SAAS;AAET,MAAA;AAEJ,SAAO,YAA4B,MAAqB;AACtD,QAAI,CAAC,QAAQ;AACF,eAAA;AACA,eAAA,GAAG,MAAM,MAAM,IAAI;AAAA,IAAA;AAGvB,WAAA;AAAA,EACT;AACF;"}
1	+ {"version":3,"file":"function.mjs","sources":["../src/function.ts"],"sourcesContent":["import { isNumber } from './type';\nimport type { AnyFunction } from './types';\n\n/*\n 一个空操作函数，不执行任何操作。\n \n @example\n * ```typescript\n * fnNoop(); // 不执行任何操作\n * ```\n /\nexport function fnNoop() {\n //\n}\n\n/\n 防抖函数的配置选项。\n /\nexport type DebounceOptions = {\n /\n 等待时间（毫秒）。\n /\n wait: number;\n /\n 是否在等待开始时立即执行一次\n * @default false\n /\n leading?: boolean;\n};\n\n/\n 创建一个防抖函数，该函数会在指定的等待时间后执行，如果在等待时间内再次调用，则重新计时。\n \n @param fn - 需要防抖的函数。\n * @param wait - 等待时间（毫秒）或包含 `wait` 和 `leading` 选项的对象。\n * @returns 返回一个防抖函数，该函数具有 `cancel` 方法，用于取消防抖操作。\n \n @example\n * ```typescript\n * const debouncedFn = fnDebounce(() => {\n * console.log('Debounced!');\n * }, 100);\n \n debouncedFn(); // 不会立即执行\n * debouncedFn(); // 重新计时\n * debouncedFn.cancel(); // 取消防抖操作\n * ```\n /\nexport function fnDebounce<F extends AnyFunction>(fn: F, wait: number \| DebounceOptions) {\n const options: DebounceOptions = isNumber(wait) ? { wait } : wait;\n let canceled = false;\n // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n let timer: any;\n let leading = false;\n\n const debounced = function (this: unknown, ...args: Parameters<F>) {\n if (canceled) return;\n\n // 第一次执行\n if (options.leading && !leading) {\n leading = true;\n fn.apply(this, args);\n return;\n }\n\n // 最后一次执行\n clearTimeout(timer);\n timer = setTimeout(() => {\n if (canceled) return;\n\n fn.apply(this, args);\n }, options.wait);\n };\n\n debounced.cancel = () => {\n clearTimeout(timer);\n canceled = true;\n };\n\n return debounced;\n}\n\nexport type ThrottleOptions = {\n /\n 等待时间（毫秒）。\n /\n wait: number;\n\n /\n 是否在第一次调用时立即执行\n * @default false\n /\n leading?: boolean;\n\n /\n 是否在调用结束后等待一段时间再执行\n * @default false\n /\n trailing?: boolean;\n};\n\n/\n 创建一个节流函数，该函数会在指定的等待时间内最多执行一次，如果在等待时间内再次调用，则忽略后续调用。\n \n @param fn - 需要节流的函数。\n * @param wait - 等待时间（毫秒）或包含 `wait`、`leading` 和 `trailing` 选项的对象。\n * @returns 返回一个节流函数，该函数具有 `cancel` 方法，用于取消节流操作。\n \n @example\n * ```typescript\n * const throttledFn = fnThrottle(() => {\n * console.log('Throttled!');\n * }, 100);\n \n throttledFn(); // 立即执行\n * throttledFn(); // 忽略\n * throttledFn.cancel(); // 取消节流操作\n * ```\n /\nexport function fnThrottle<F extends AnyFunction>(fn: F, wait: number \| ThrottleOptions) {\n const options = isNumber(wait) ? { wait } : wait;\n const waitFinal = options.wait;\n let lastTime = 0;\n let canceled = false;\n // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n let timer: any;\n\n const throttled = function (this: unknown, ...args: Parameters<F>) {\n if (canceled) return;\n\n const now = Date.now();\n let executed = false;\n\n // 第一次执行\n if (options.leading && lastTime === 0) {\n lastTime = now;\n fn.apply(this, args);\n executed = true;\n }\n\n // 中间控频执行\n else if (lastTime > 0 && now - lastTime >= waitFinal) {\n lastTime = now;\n fn.apply(this, args);\n executed = true;\n }\n\n // 首次计时\n else if (lastTime === 0) {\n lastTime = now;\n }\n\n // 最后一次执行，仅在本次未执行时才设置 trailing\n if (options.trailing && !executed) {\n clearTimeout(timer);\n timer = setTimeout(() => {\n fn.apply(this, args);\n }, waitFinal);\n }\n };\n\n throttled.cancel = () => {\n canceled = true;\n clearTimeout(timer);\n };\n\n return throttled;\n}\n\n/\n 创建一个只执行一次的函数，无论调用多少次，实际执行的函数体也只会执行一次。\n \n @param fn - 需要只执行一次的函数。\n * @returns 返回一个只执行一次的函数，该函数在第一次调用后会缓存结果并返回缓存的结果。\n \n @example\n * ```typescript\n * const onceFn = fnOnce(() => {\n * console.log('This will be logged only once.');\n * return 42;\n * });\n \n console.log(onceFn()); // 输出: This will be logged only once. 42\n * console.log(onceFn()); // 输出: 42\n * ```\n */\nexport function fnOnce<F extends AnyFunction>(fn: F) {\n let called = false;\n // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n let result: any;\n\n return function (this: unknown, ...args: Parameters<F>) {\n if (!called) {\n called = true;\n result = fn.apply(this, args);\n }\n\n return result;\n };\n}\n"],"names":[],"mappings":";AAWO,SAAS,SAAS;AAEzB;AAmCgB,SAAA,WAAkC,IAAO,MAAgC;AACvF,QAAM,UAA2B,SAAS,IAAI,IAAI,EAAE,KAAS,IAAA;AAC7D,MAAI,WAAW;AAEX,MAAA;AACJ,MAAI,UAAU;AAER,QAAA,YAAY,YAA4B,MAAqB;AACjE,QAAI,SAAU;AAGV,QAAA,QAAQ,WAAW,CAAC,SAAS;AACrB,gBAAA;AACP,SAAA,MAAM,MAAM,IAAI;AACnB;AAAA,IAAA;AAIF,iBAAa,KAAK;AAClB,YAAQ,WAAW,MAAM;AACvB,UAAI,SAAU;AAEX,SAAA,MAAM,MAAM,IAAI;AAAA,IAAA,GAClB,QAAQ,IAAI;AAAA,EACjB;AAEA,YAAU,SAAS,MAAM;AACvB,iBAAa,KAAK;AACP,eAAA;AAAA,EACb;AAEO,SAAA;AACT;AAuCgB,SAAA,WAAkC,IAAO,MAAgC;AACvF,QAAM,UAAU,SAAS,IAAI,IAAI,EAAE,KAAS,IAAA;AAC5C,QAAM,YAAY,QAAQ;AAC1B,MAAI,WAAW;AACf,MAAI,WAAW;AAEX,MAAA;AAEE,QAAA,YAAY,YAA4B,MAAqB;AACjE,QAAI,SAAU;AAER,UAAA,MAAM,KAAK,IAAI;AACrB,QAAI,WAAW;AAGX,QAAA,QAAQ,WAAW,aAAa,GAAG;AAC1B,iBAAA;AACR,SAAA,MAAM,MAAM,IAAI;AACR,iBAAA;AAAA,IAIJ,WAAA,WAAW,KAAK,MAAM,YAAY,WAAW;AACzC,iBAAA;AACR,SAAA,MAAM,MAAM,IAAI;AACR,iBAAA;AAAA,IAAA,WAIJ,aAAa,GAAG;AACZ,iBAAA;AAAA,IAAA;AAIT,QAAA,QAAQ,YAAY,CAAC,UAAU;AACjC,mBAAa,KAAK;AAClB,cAAQ,WAAW,MAAM;AACpB,WAAA,MAAM,MAAM,IAAI;AAAA,SAClB,SAAS;AAAA,IAAA;AAAA,EAEhB;AAEA,YAAU,SAAS,MAAM;AACZ,eAAA;AACX,iBAAa,KAAK;AAAA,EACpB;AAEO,SAAA;AACT;AAmBO,SAAS,OAA8B,IAAO;AACnD,MAAI,SAAS;AAET,MAAA;AAEJ,SAAO,YAA4B,MAAqB;AACtD,QAAI,CAAC,QAAQ;AACF,eAAA;AACA,eAAA,GAAG,MAAM,MAAM,IAAI;AAAA,IAAA;AAGvB,WAAA;AAAA,EACT;AACF;"}

package/dist/index.cjs CHANGED Viewed

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const VERSION = "1.18.0";
+const VERSION = "1.18.2";
 exports.VERSION = VERSION;
 //# sourceMappingURL=index.cjs.map

package/dist/index.mjs CHANGED Viewed

@@ -1,4 +1,4 @@
-const VERSION = "1.18.0";
+const VERSION = "1.18.2";
 export {
   VERSION
 };

package/dist/regexp.cjs CHANGED Viewed

@@ -30,7 +30,7 @@ function isIDNo(value) {
   }
   return residueList[sum % 11] === value.slice(-1);
 }
-const URL_RE = /^https?:\/\/(([a-z\d-]+\.)+[a-z]{2,5}|(\d{1,3}\.){3}\d{1,3})(:[1-9]\d{0,4})?(\/|\/[\w#!:.?+=&%@'/()-]+)?$/i;
+const URL_RE = /^https?:\/\//i;
 function isURL(value) {
   return URL_RE.test(value);
 }

package/dist/regexp.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"regexp.cjs","sources":["../src/regexp.ts"],"sourcesContent":["const specialRE = /[.+?^=!:${}()\|[\\]/\\\\-]/g;\n\n/\n 编码处理正则表达式\n * @example\n * ```js\n * reEscape('/$')\n * // => '\\\\/\\\\$'\n * ```\n * @param {string} string\n * @returns {string}\n /\nexport function regexpEscape(string: string): string {\n return string.replace(specialRE, '\\\\$&');\n}\n\n// 邮箱\nconst EMAIL_RE = /^\\w+[-+.\\w]@([a-z\\d-]+\\.)+[a-z]{2,5}$/i;\n/*\n 判断字符串是否为邮箱格式，不对邮箱真实性做验证，如域名是否正确等\n * @param {string} value\n * @returns {boolean}\n /\nexport function isEmail(value: string): boolean {\n return EMAIL_RE.test(value);\n}\n\n// 手机号码\nconst PHONE_RE = /^1\\d{10}$/;\n/\n 判断字符串是否为宽松手机格式，即首位为 1 的 11 位数字都属于手机号\n * @param {string} value\n * @returns {boolean}\n /\nexport function isPhone(value: string): boolean {\n return PHONE_RE.test(value);\n}\n\n// 身份证号码\n// http://www.stats.gov.cn/tjsj/tjbz/xzqhdm/\n// [\"北京市\", \"天津市\", \"河北省\", \"山西省\", \"内蒙古自治区\",\n// \"辽宁省\", \"吉林省\", \"黑龙江省\",\n// \"上海市\", \"江苏省\", \"浙江省\", \"安徽省\", \"福建省\", \"江西省\", \"山东省\",\n// \"河南省\", \"湖北省\", \"湖南省\", \"广东省\", \"广西壮族自治区\", \"海南省\",\n// \"重庆市\", \"四川省\", \"贵州省\", \"云南省\", \"西藏自治区\",\n// \"陕西省\", \"甘肃省\", \"青海省\",\"宁夏回族自治区\", \"新疆维吾尔自治区\",\n// \"台湾省\",\n// \"香港特别行政区\", \"澳门特别行政区\"]\n// [\"11\", \"12\", \"13\", \"14\", \"15\",\n// \"21\", \"22\", \"23\",\n// \"31\", \"32\", \"33\", \"34\", \"35\", \"36\", \"37\",\n// \"41\", \"42\", \"43\", \"44\", \"45\", \"46\",\n// \"50\", \"51\", \"52\", \"53\", \"54\",\n// \"61\", \"62\", \"63\", \"64\", \"65\",\n// \"71\",\n// \"81\", \"82\"]\n// 91 国外\nconst IDNO_RE =\n /^(1[1-5]\|2[1-3]\|3[1-7]\|4[1-6]\|5[0-4]\|6[1-5]\|7[1]\|8[1-2]\|9[1])\\d{4}(18\|19\|20)\\d{2}[01]\\d[0123]\\d{4}[\\dxX]$/;\n/\n 判断字符串是否为身份证号码格式\n * @param {string} value\n * @returns {boolean}\n /\nexport function isIDNo(value: string): boolean {\n const isSameFormat = IDNO_RE.test(value);\n\n if (!isSameFormat) return false;\n\n const year = Number(value.slice(6, 10));\n const month = Number(value.slice(10, 12));\n const date = Number(value.slice(12, 14));\n const d = new Date(year, month - 1, date);\n const isSameDate = d.getFullYear() === year && d.getMonth() + 1 === month && d.getDate() === date;\n\n if (!isSameDate) return false;\n\n // 将身份证号码前面的17位数分别乘以不同的系数；\n // 从第一位到第十七位的系数分别为：7－9－10－5－8－4－2－1－6－3－7－9－10－5－8－4－2\n // 将这17位数字和系数相乘的结果相加；\n // 用加出来和除以11，看余数是多少；\n // 余数只可能有0－1－2－3－4－5－6－7－8－9－10这11个数字；\n // 其分别对应的最后一位身份证的号码为1－0－X－9－8－7－6－5－4－3－2\n // 通过上面得知如果余数是2，就会在身份证的第18位数字上出现罗马数字的Ⅹ。如果余数是10，身份证的最后一位号码就是2。\n const coefficientList = [7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2];\n const residueList = ['1', '0', 'X', '9', '8', '7', '6', '5', '4', '3', '2'];\n let sum = 0;\n\n for (let start = 0; start < 17; start++) {\n sum += Number(value.slice(start, start + 1)) coefficientList[start];\n }\n\n return residueList[sum % 11] === value.slice(-1);\n}\n\n// url\nconst URL_RE ~~=\n~~ /^https~~?:\\/\\/(([a-z\\d-]+\\.)+[a-z]{2,5}\|(\\d{1,3}\\.){3}\\d{1,3})(:[1-9]\\d{0,4})?(\\/\|\\/[\\w#!:.?+=&%@'/()-]+)?$/~~i;\n/*\n 判断字符串是否为 url 格式，仅支持 http 协议，支持域名或者 ipV4\n * @param {string} value\n * @returns {boolean}\n /\nexport function isURL(value: string): boolean {\n return URL_RE.test(value);\n}\n\n// ipv4\nconst IPV4_RE = /^(?:(?:\\d\|[1-9]\\d\|1\\d\\d\|2[0-4]\\d\|25[0-5])\\.){3}(?:\\d\|[1-9]\\d\|1\\d\\d\|2[0-4]\\d\|25[0-5])$/;\n/\n 判断字符串是否为 IPV4 格式，不对 ip 真实性做验证\n * @param {string} value\n * @returns {boolean}\n /\nexport function isIPV4(value: string): boolean {\n return IPV4_RE.test(value);\n}\n\nconst INTEGER_RE = /^(-?[1-9]\\d\|0)$/;\n/*\n 判断字符串是否为整数（自然数），即 ...,-3,-2,-1,0,1,2,3,...\n * @param {string} value\n * @returns {boolean}\n /\nexport function isInteger(value: string): boolean {\n return INTEGER_RE.test(value);\n}\n\nconst FLOAT_RE = /^-?([1-9]\\d\|0)\\.\\d+$/;\n/*\n 判断字符串是否为浮点数，即必须有小数点的有理数\n * @param {string} value\n * @returns {boolean}\n /\nexport function isFloat(value: string): boolean {\n return FLOAT_RE.test(value);\n}\n\n/\n 判断字符串是否为正确数值，包括整数和浮点数\n * @param {string} value\n * @returns {boolean}\n /\nexport function isNumerical(value: string): boolean {\n return isInteger(value) \|\| isFloat(value);\n}\n\nconst DIGIT_RE = /^\\d+$/;\n/\n 判断字符串是否为数字，例如六位数字短信验证码（093031）\n * @param {string} value\n * @returns {boolean}\n */\nexport function isDigit(value: string): boolean {\n return DIGIT_RE.test(value);\n}\n"],"names":[],"mappings":";;AAAA,MAAM,YAAY;AAYX,SAAS,aAAa,QAAwB;AAC5C,SAAA,OAAO,QAAQ,WAAW,MAAM;AACzC;AAGA,MAAM,WAAW;AAMV,SAAS,QAAQ,OAAwB;AACvC,SAAA,SAAS,KAAK,KAAK;AAC5B;AAGA,MAAM,WAAW;AAMV,SAAS,QAAQ,OAAwB;AACvC,SAAA,SAAS,KAAK,KAAK;AAC5B;AAqBA,MAAM,UACJ;AAMK,SAAS,OAAO,OAAwB;AACvC,QAAA,eAAe,QAAQ,KAAK,KAAK;AAEnC,MAAA,CAAC,aAAqB,QAAA;AAE1B,QAAM,OAAO,OAAO,MAAM,MAAM,GAAG,EAAE,CAAC;AACtC,QAAM,QAAQ,OAAO,MAAM,MAAM,IAAI,EAAE,CAAC;AACxC,QAAM,OAAO,OAAO,MAAM,MAAM,IAAI,EAAE,CAAC;AACvC,QAAM,IAAI,IAAI,KAAK,MAAM,QAAQ,GAAG,IAAI;AACxC,QAAM,aAAa,EAAE,YAAY,MAAM,QAAQ,EAAE,SAAS,IAAI,MAAM,SAAS,EAAE,QAAc,MAAA;AAEzF,MAAA,CAAC,WAAmB,QAAA;AASxB,QAAM,kBAAkB,CAAC,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,CAAC;AAC5E,QAAM,cAAc,CAAC,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,GAAG;AAC1E,MAAI,MAAM;AAEV,WAAS,QAAQ,GAAG,QAAQ,IAAI,SAAS;AAChC,WAAA,OAAO,MAAM,MAAM,OAAO,QAAQ,CAAC,CAAC,IAAI,gBAAgB,KAAK;AAAA,EAAA;AAGtE,SAAO,YAAY,MAAM,EAAE,MAAM,MAAM,MAAM,EAAE;AACjD;AAGA,MAAM,~~SACJ~~;~~AAMK~~,SAAS,MAAM,OAAwB;AACrC,SAAA,OAAO,KAAK,KAAK;AAC1B;AAGA,MAAM,UAAU;AAMT,SAAS,OAAO,OAAwB;AACtC,SAAA,QAAQ,KAAK,KAAK;AAC3B;AAEA,MAAM,aAAa;AAMZ,SAAS,UAAU,OAAwB;AACzC,SAAA,WAAW,KAAK,KAAK;AAC9B;AAEA,MAAM,WAAW;AAMV,SAAS,QAAQ,OAAwB;AACvC,SAAA,SAAS,KAAK,KAAK;AAC5B;AAOO,SAAS,YAAY,OAAwB;AAClD,SAAO,UAAU,KAAK,KAAK,QAAQ,KAAK;AAC1C;AAEA,MAAM,WAAW;AAMV,SAAS,QAAQ,OAAwB;AACvC,SAAA,SAAS,KAAK,KAAK;AAC5B;;;;;;;;;;;"}
1	+ {"version":3,"file":"regexp.cjs","sources":["../src/regexp.ts"],"sourcesContent":["const specialRE = /[.+?^=!:${}()\|[\\]/\\\\-]/g;\n\n/\n 编码处理正则表达式\n * @example\n * ```js\n * reEscape('/$')\n * // => '\\\\/\\\\$'\n * ```\n * @param {string} string\n * @returns {string}\n /\nexport function regexpEscape(string: string): string {\n return string.replace(specialRE, '\\\\$&');\n}\n\n// 邮箱\nconst EMAIL_RE = /^\\w+[-+.\\w]@([a-z\\d-]+\\.)+[a-z]{2,5}$/i;\n/*\n 判断字符串是否为邮箱格式，不对邮箱真实性做验证，如域名是否正确等\n * @param {string} value\n * @returns {boolean}\n /\nexport function isEmail(value: string): boolean {\n return EMAIL_RE.test(value);\n}\n\n// 手机号码\nconst PHONE_RE = /^1\\d{10}$/;\n/\n 判断字符串是否为宽松手机格式，即首位为 1 的 11 位数字都属于手机号\n * @param {string} value\n * @returns {boolean}\n /\nexport function isPhone(value: string): boolean {\n return PHONE_RE.test(value);\n}\n\n// 身份证号码\n// http://www.stats.gov.cn/tjsj/tjbz/xzqhdm/\n// [\"北京市\", \"天津市\", \"河北省\", \"山西省\", \"内蒙古自治区\",\n// \"辽宁省\", \"吉林省\", \"黑龙江省\",\n// \"上海市\", \"江苏省\", \"浙江省\", \"安徽省\", \"福建省\", \"江西省\", \"山东省\",\n// \"河南省\", \"湖北省\", \"湖南省\", \"广东省\", \"广西壮族自治区\", \"海南省\",\n// \"重庆市\", \"四川省\", \"贵州省\", \"云南省\", \"西藏自治区\",\n// \"陕西省\", \"甘肃省\", \"青海省\",\"宁夏回族自治区\", \"新疆维吾尔自治区\",\n// \"台湾省\",\n// \"香港特别行政区\", \"澳门特别行政区\"]\n// [\"11\", \"12\", \"13\", \"14\", \"15\",\n// \"21\", \"22\", \"23\",\n// \"31\", \"32\", \"33\", \"34\", \"35\", \"36\", \"37\",\n// \"41\", \"42\", \"43\", \"44\", \"45\", \"46\",\n// \"50\", \"51\", \"52\", \"53\", \"54\",\n// \"61\", \"62\", \"63\", \"64\", \"65\",\n// \"71\",\n// \"81\", \"82\"]\n// 91 国外\nconst IDNO_RE =\n /^(1[1-5]\|2[1-3]\|3[1-7]\|4[1-6]\|5[0-4]\|6[1-5]\|7[1]\|8[1-2]\|9[1])\\d{4}(18\|19\|20)\\d{2}[01]\\d[0123]\\d{4}[\\dxX]$/;\n/\n 判断字符串是否为身份证号码格式\n * @param {string} value\n * @returns {boolean}\n /\nexport function isIDNo(value: string): boolean {\n const isSameFormat = IDNO_RE.test(value);\n\n if (!isSameFormat) return false;\n\n const year = Number(value.slice(6, 10));\n const month = Number(value.slice(10, 12));\n const date = Number(value.slice(12, 14));\n const d = new Date(year, month - 1, date);\n const isSameDate = d.getFullYear() === year && d.getMonth() + 1 === month && d.getDate() === date;\n\n if (!isSameDate) return false;\n\n // 将身份证号码前面的17位数分别乘以不同的系数；\n // 从第一位到第十七位的系数分别为：7－9－10－5－8－4－2－1－6－3－7－9－10－5－8－4－2\n // 将这17位数字和系数相乘的结果相加；\n // 用加出来和除以11，看余数是多少；\n // 余数只可能有0－1－2－3－4－5－6－7－8－9－10这11个数字；\n // 其分别对应的最后一位身份证的号码为1－0－X－9－8－7－6－5－4－3－2\n // 通过上面得知如果余数是2，就会在身份证的第18位数字上出现罗马数字的Ⅹ。如果余数是10，身份证的最后一位号码就是2。\n const coefficientList = [7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2];\n const residueList = ['1', '0', 'X', '9', '8', '7', '6', '5', '4', '3', '2'];\n let sum = 0;\n\n for (let start = 0; start < 17; start++) {\n sum += Number(value.slice(start, start + 1)) coefficientList[start];\n }\n\n return residueList[sum % 11] === value.slice(-1);\n}\n\n// url\nconst URL_RE = /^https?:\\/\\//i;\n/*\n 判断字符串是否为 url 格式，仅支持 http 协议，支持域名或者 ipV4\n * @param {string} value\n * @returns {boolean}\n /\nexport function isURL(value: string): boolean {\n return URL_RE.test(value);\n}\n\n// ipv4\nconst IPV4_RE = /^(?:(?:\\d\|[1-9]\\d\|1\\d\\d\|2[0-4]\\d\|25[0-5])\\.){3}(?:\\d\|[1-9]\\d\|1\\d\\d\|2[0-4]\\d\|25[0-5])$/;\n/\n 判断字符串是否为 IPV4 格式，不对 ip 真实性做验证\n * @param {string} value\n * @returns {boolean}\n /\nexport function isIPV4(value: string): boolean {\n return IPV4_RE.test(value);\n}\n\nconst INTEGER_RE = /^(-?[1-9]\\d\|0)$/;\n/*\n 判断字符串是否为整数（自然数），即 ...,-3,-2,-1,0,1,2,3,...\n * @param {string} value\n * @returns {boolean}\n /\nexport function isInteger(value: string): boolean {\n return INTEGER_RE.test(value);\n}\n\nconst FLOAT_RE = /^-?([1-9]\\d\|0)\\.\\d+$/;\n/*\n 判断字符串是否为浮点数，即必须有小数点的有理数\n * @param {string} value\n * @returns {boolean}\n /\nexport function isFloat(value: string): boolean {\n return FLOAT_RE.test(value);\n}\n\n/\n 判断字符串是否为正确数值，包括整数和浮点数\n * @param {string} value\n * @returns {boolean}\n /\nexport function isNumerical(value: string): boolean {\n return isInteger(value) \|\| isFloat(value);\n}\n\nconst DIGIT_RE = /^\\d+$/;\n/\n 判断字符串是否为数字，例如六位数字短信验证码（093031）\n * @param {string} value\n * @returns {boolean}\n */\nexport function isDigit(value: string): boolean {\n return DIGIT_RE.test(value);\n}\n"],"names":[],"mappings":";;AAAA,MAAM,YAAY;AAYX,SAAS,aAAa,QAAwB;AAC5C,SAAA,OAAO,QAAQ,WAAW,MAAM;AACzC;AAGA,MAAM,WAAW;AAMV,SAAS,QAAQ,OAAwB;AACvC,SAAA,SAAS,KAAK,KAAK;AAC5B;AAGA,MAAM,WAAW;AAMV,SAAS,QAAQ,OAAwB;AACvC,SAAA,SAAS,KAAK,KAAK;AAC5B;AAqBA,MAAM,UACJ;AAMK,SAAS,OAAO,OAAwB;AACvC,QAAA,eAAe,QAAQ,KAAK,KAAK;AAEnC,MAAA,CAAC,aAAqB,QAAA;AAE1B,QAAM,OAAO,OAAO,MAAM,MAAM,GAAG,EAAE,CAAC;AACtC,QAAM,QAAQ,OAAO,MAAM,MAAM,IAAI,EAAE,CAAC;AACxC,QAAM,OAAO,OAAO,MAAM,MAAM,IAAI,EAAE,CAAC;AACvC,QAAM,IAAI,IAAI,KAAK,MAAM,QAAQ,GAAG,IAAI;AACxC,QAAM,aAAa,EAAE,YAAY,MAAM,QAAQ,EAAE,SAAS,IAAI,MAAM,SAAS,EAAE,QAAc,MAAA;AAEzF,MAAA,CAAC,WAAmB,QAAA;AASxB,QAAM,kBAAkB,CAAC,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,CAAC;AAC5E,QAAM,cAAc,CAAC,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,GAAG;AAC1E,MAAI,MAAM;AAEV,WAAS,QAAQ,GAAG,QAAQ,IAAI,SAAS;AAChC,WAAA,OAAO,MAAM,MAAM,OAAO,QAAQ,CAAC,CAAC,IAAI,gBAAgB,KAAK;AAAA,EAAA;AAGtE,SAAO,YAAY,MAAM,EAAE,MAAM,MAAM,MAAM,EAAE;AACjD;AAGA,MAAM,SAAS;AAMR,SAAS,MAAM,OAAwB;AACrC,SAAA,OAAO,KAAK,KAAK;AAC1B;AAGA,MAAM,UAAU;AAMT,SAAS,OAAO,OAAwB;AACtC,SAAA,QAAQ,KAAK,KAAK;AAC3B;AAEA,MAAM,aAAa;AAMZ,SAAS,UAAU,OAAwB;AACzC,SAAA,WAAW,KAAK,KAAK;AAC9B;AAEA,MAAM,WAAW;AAMV,SAAS,QAAQ,OAAwB;AACvC,SAAA,SAAS,KAAK,KAAK;AAC5B;AAOO,SAAS,YAAY,OAAwB;AAClD,SAAO,UAAU,KAAK,KAAK,QAAQ,KAAK;AAC1C;AAEA,MAAM,WAAW;AAMV,SAAS,QAAQ,OAAwB;AACvC,SAAA,SAAS,KAAK,KAAK;AAC5B;;;;;;;;;;;"}

package/dist/regexp.mjs CHANGED Viewed

@@ -28,7 +28,7 @@ function isIDNo(value) {
   }
   return residueList[sum % 11] === value.slice(-1);
 }
-const URL_RE = /^https?:\/\/(([a-z\d-]+\.)+[a-z]{2,5}|(\d{1,3}\.){3}\d{1,3})(:[1-9]\d{0,4})?(\/|\/[\w#!:.?+=&%@'/()-]+)?$/i;
+const URL_RE = /^https?:\/\//i;
 function isURL(value) {
   return URL_RE.test(value);
 }

package/dist/regexp.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"regexp.mjs","sources":["../src/regexp.ts"],"sourcesContent":["const specialRE = /[.+?^=!:${}()\|[\\]/\\\\-]/g;\n\n/\n 编码处理正则表达式\n * @example\n * ```js\n * reEscape('/$')\n * // => '\\\\/\\\\$'\n * ```\n * @param {string} string\n * @returns {string}\n /\nexport function regexpEscape(string: string): string {\n return string.replace(specialRE, '\\\\$&');\n}\n\n// 邮箱\nconst EMAIL_RE = /^\\w+[-+.\\w]@([a-z\\d-]+\\.)+[a-z]{2,5}$/i;\n/*\n 判断字符串是否为邮箱格式，不对邮箱真实性做验证，如域名是否正确等\n * @param {string} value\n * @returns {boolean}\n /\nexport function isEmail(value: string): boolean {\n return EMAIL_RE.test(value);\n}\n\n// 手机号码\nconst PHONE_RE = /^1\\d{10}$/;\n/\n 判断字符串是否为宽松手机格式，即首位为 1 的 11 位数字都属于手机号\n * @param {string} value\n * @returns {boolean}\n /\nexport function isPhone(value: string): boolean {\n return PHONE_RE.test(value);\n}\n\n// 身份证号码\n// http://www.stats.gov.cn/tjsj/tjbz/xzqhdm/\n// [\"北京市\", \"天津市\", \"河北省\", \"山西省\", \"内蒙古自治区\",\n// \"辽宁省\", \"吉林省\", \"黑龙江省\",\n// \"上海市\", \"江苏省\", \"浙江省\", \"安徽省\", \"福建省\", \"江西省\", \"山东省\",\n// \"河南省\", \"湖北省\", \"湖南省\", \"广东省\", \"广西壮族自治区\", \"海南省\",\n// \"重庆市\", \"四川省\", \"贵州省\", \"云南省\", \"西藏自治区\",\n// \"陕西省\", \"甘肃省\", \"青海省\",\"宁夏回族自治区\", \"新疆维吾尔自治区\",\n// \"台湾省\",\n// \"香港特别行政区\", \"澳门特别行政区\"]\n// [\"11\", \"12\", \"13\", \"14\", \"15\",\n// \"21\", \"22\", \"23\",\n// \"31\", \"32\", \"33\", \"34\", \"35\", \"36\", \"37\",\n// \"41\", \"42\", \"43\", \"44\", \"45\", \"46\",\n// \"50\", \"51\", \"52\", \"53\", \"54\",\n// \"61\", \"62\", \"63\", \"64\", \"65\",\n// \"71\",\n// \"81\", \"82\"]\n// 91 国外\nconst IDNO_RE =\n /^(1[1-5]\|2[1-3]\|3[1-7]\|4[1-6]\|5[0-4]\|6[1-5]\|7[1]\|8[1-2]\|9[1])\\d{4}(18\|19\|20)\\d{2}[01]\\d[0123]\\d{4}[\\dxX]$/;\n/\n 判断字符串是否为身份证号码格式\n * @param {string} value\n * @returns {boolean}\n /\nexport function isIDNo(value: string): boolean {\n const isSameFormat = IDNO_RE.test(value);\n\n if (!isSameFormat) return false;\n\n const year = Number(value.slice(6, 10));\n const month = Number(value.slice(10, 12));\n const date = Number(value.slice(12, 14));\n const d = new Date(year, month - 1, date);\n const isSameDate = d.getFullYear() === year && d.getMonth() + 1 === month && d.getDate() === date;\n\n if (!isSameDate) return false;\n\n // 将身份证号码前面的17位数分别乘以不同的系数；\n // 从第一位到第十七位的系数分别为：7－9－10－5－8－4－2－1－6－3－7－9－10－5－8－4－2\n // 将这17位数字和系数相乘的结果相加；\n // 用加出来和除以11，看余数是多少；\n // 余数只可能有0－1－2－3－4－5－6－7－8－9－10这11个数字；\n // 其分别对应的最后一位身份证的号码为1－0－X－9－8－7－6－5－4－3－2\n // 通过上面得知如果余数是2，就会在身份证的第18位数字上出现罗马数字的Ⅹ。如果余数是10，身份证的最后一位号码就是2。\n const coefficientList = [7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2];\n const residueList = ['1', '0', 'X', '9', '8', '7', '6', '5', '4', '3', '2'];\n let sum = 0;\n\n for (let start = 0; start < 17; start++) {\n sum += Number(value.slice(start, start + 1)) coefficientList[start];\n }\n\n return residueList[sum % 11] === value.slice(-1);\n}\n\n// url\nconst URL_RE ~~=\n~~ /^https~~?:\\/\\/(([a-z\\d-]+\\.)+[a-z]{2,5}\|(\\d{1,3}\\.){3}\\d{1,3})(:[1-9]\\d{0,4})?(\\/\|\\/[\\w#!:.?+=&%@'/()-]+)?$/~~i;\n/*\n 判断字符串是否为 url 格式，仅支持 http 协议，支持域名或者 ipV4\n * @param {string} value\n * @returns {boolean}\n /\nexport function isURL(value: string): boolean {\n return URL_RE.test(value);\n}\n\n// ipv4\nconst IPV4_RE = /^(?:(?:\\d\|[1-9]\\d\|1\\d\\d\|2[0-4]\\d\|25[0-5])\\.){3}(?:\\d\|[1-9]\\d\|1\\d\\d\|2[0-4]\\d\|25[0-5])$/;\n/\n 判断字符串是否为 IPV4 格式，不对 ip 真实性做验证\n * @param {string} value\n * @returns {boolean}\n /\nexport function isIPV4(value: string): boolean {\n return IPV4_RE.test(value);\n}\n\nconst INTEGER_RE = /^(-?[1-9]\\d\|0)$/;\n/*\n 判断字符串是否为整数（自然数），即 ...,-3,-2,-1,0,1,2,3,...\n * @param {string} value\n * @returns {boolean}\n /\nexport function isInteger(value: string): boolean {\n return INTEGER_RE.test(value);\n}\n\nconst FLOAT_RE = /^-?([1-9]\\d\|0)\\.\\d+$/;\n/*\n 判断字符串是否为浮点数，即必须有小数点的有理数\n * @param {string} value\n * @returns {boolean}\n /\nexport function isFloat(value: string): boolean {\n return FLOAT_RE.test(value);\n}\n\n/\n 判断字符串是否为正确数值，包括整数和浮点数\n * @param {string} value\n * @returns {boolean}\n /\nexport function isNumerical(value: string): boolean {\n return isInteger(value) \|\| isFloat(value);\n}\n\nconst DIGIT_RE = /^\\d+$/;\n/\n 判断字符串是否为数字，例如六位数字短信验证码（093031）\n * @param {string} value\n * @returns {boolean}\n */\nexport function isDigit(value: string): boolean {\n return DIGIT_RE.test(value);\n}\n"],"names":[],"mappings":"AAAA,MAAM,YAAY;AAYX,SAAS,aAAa,QAAwB;AAC5C,SAAA,OAAO,QAAQ,WAAW,MAAM;AACzC;AAGA,MAAM,WAAW;AAMV,SAAS,QAAQ,OAAwB;AACvC,SAAA,SAAS,KAAK,KAAK;AAC5B;AAGA,MAAM,WAAW;AAMV,SAAS,QAAQ,OAAwB;AACvC,SAAA,SAAS,KAAK,KAAK;AAC5B;AAqBA,MAAM,UACJ;AAMK,SAAS,OAAO,OAAwB;AACvC,QAAA,eAAe,QAAQ,KAAK,KAAK;AAEnC,MAAA,CAAC,aAAqB,QAAA;AAE1B,QAAM,OAAO,OAAO,MAAM,MAAM,GAAG,EAAE,CAAC;AACtC,QAAM,QAAQ,OAAO,MAAM,MAAM,IAAI,EAAE,CAAC;AACxC,QAAM,OAAO,OAAO,MAAM,MAAM,IAAI,EAAE,CAAC;AACvC,QAAM,IAAI,IAAI,KAAK,MAAM,QAAQ,GAAG,IAAI;AACxC,QAAM,aAAa,EAAE,YAAY,MAAM,QAAQ,EAAE,SAAS,IAAI,MAAM,SAAS,EAAE,QAAc,MAAA;AAEzF,MAAA,CAAC,WAAmB,QAAA;AASxB,QAAM,kBAAkB,CAAC,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,CAAC;AAC5E,QAAM,cAAc,CAAC,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,GAAG;AAC1E,MAAI,MAAM;AAEV,WAAS,QAAQ,GAAG,QAAQ,IAAI,SAAS;AAChC,WAAA,OAAO,MAAM,MAAM,OAAO,QAAQ,CAAC,CAAC,IAAI,gBAAgB,KAAK;AAAA,EAAA;AAGtE,SAAO,YAAY,MAAM,EAAE,MAAM,MAAM,MAAM,EAAE;AACjD;AAGA,MAAM,~~SACJ~~;~~AAMK~~,SAAS,MAAM,OAAwB;AACrC,SAAA,OAAO,KAAK,KAAK;AAC1B;AAGA,MAAM,UAAU;AAMT,SAAS,OAAO,OAAwB;AACtC,SAAA,QAAQ,KAAK,KAAK;AAC3B;AAEA,MAAM,aAAa;AAMZ,SAAS,UAAU,OAAwB;AACzC,SAAA,WAAW,KAAK,KAAK;AAC9B;AAEA,MAAM,WAAW;AAMV,SAAS,QAAQ,OAAwB;AACvC,SAAA,SAAS,KAAK,KAAK;AAC5B;AAOO,SAAS,YAAY,OAAwB;AAClD,SAAO,UAAU,KAAK,KAAK,QAAQ,KAAK;AAC1C;AAEA,MAAM,WAAW;AAMV,SAAS,QAAQ,OAAwB;AACvC,SAAA,SAAS,KAAK,KAAK;AAC5B;"}
1	+ {"version":3,"file":"regexp.mjs","sources":["../src/regexp.ts"],"sourcesContent":["const specialRE = /[.+?^=!:${}()\|[\\]/\\\\-]/g;\n\n/\n 编码处理正则表达式\n * @example\n * ```js\n * reEscape('/$')\n * // => '\\\\/\\\\$'\n * ```\n * @param {string} string\n * @returns {string}\n /\nexport function regexpEscape(string: string): string {\n return string.replace(specialRE, '\\\\$&');\n}\n\n// 邮箱\nconst EMAIL_RE = /^\\w+[-+.\\w]@([a-z\\d-]+\\.)+[a-z]{2,5}$/i;\n/*\n 判断字符串是否为邮箱格式，不对邮箱真实性做验证，如域名是否正确等\n * @param {string} value\n * @returns {boolean}\n /\nexport function isEmail(value: string): boolean {\n return EMAIL_RE.test(value);\n}\n\n// 手机号码\nconst PHONE_RE = /^1\\d{10}$/;\n/\n 判断字符串是否为宽松手机格式，即首位为 1 的 11 位数字都属于手机号\n * @param {string} value\n * @returns {boolean}\n /\nexport function isPhone(value: string): boolean {\n return PHONE_RE.test(value);\n}\n\n// 身份证号码\n// http://www.stats.gov.cn/tjsj/tjbz/xzqhdm/\n// [\"北京市\", \"天津市\", \"河北省\", \"山西省\", \"内蒙古自治区\",\n// \"辽宁省\", \"吉林省\", \"黑龙江省\",\n// \"上海市\", \"江苏省\", \"浙江省\", \"安徽省\", \"福建省\", \"江西省\", \"山东省\",\n// \"河南省\", \"湖北省\", \"湖南省\", \"广东省\", \"广西壮族自治区\", \"海南省\",\n// \"重庆市\", \"四川省\", \"贵州省\", \"云南省\", \"西藏自治区\",\n// \"陕西省\", \"甘肃省\", \"青海省\",\"宁夏回族自治区\", \"新疆维吾尔自治区\",\n// \"台湾省\",\n// \"香港特别行政区\", \"澳门特别行政区\"]\n// [\"11\", \"12\", \"13\", \"14\", \"15\",\n// \"21\", \"22\", \"23\",\n// \"31\", \"32\", \"33\", \"34\", \"35\", \"36\", \"37\",\n// \"41\", \"42\", \"43\", \"44\", \"45\", \"46\",\n// \"50\", \"51\", \"52\", \"53\", \"54\",\n// \"61\", \"62\", \"63\", \"64\", \"65\",\n// \"71\",\n// \"81\", \"82\"]\n// 91 国外\nconst IDNO_RE =\n /^(1[1-5]\|2[1-3]\|3[1-7]\|4[1-6]\|5[0-4]\|6[1-5]\|7[1]\|8[1-2]\|9[1])\\d{4}(18\|19\|20)\\d{2}[01]\\d[0123]\\d{4}[\\dxX]$/;\n/\n 判断字符串是否为身份证号码格式\n * @param {string} value\n * @returns {boolean}\n /\nexport function isIDNo(value: string): boolean {\n const isSameFormat = IDNO_RE.test(value);\n\n if (!isSameFormat) return false;\n\n const year = Number(value.slice(6, 10));\n const month = Number(value.slice(10, 12));\n const date = Number(value.slice(12, 14));\n const d = new Date(year, month - 1, date);\n const isSameDate = d.getFullYear() === year && d.getMonth() + 1 === month && d.getDate() === date;\n\n if (!isSameDate) return false;\n\n // 将身份证号码前面的17位数分别乘以不同的系数；\n // 从第一位到第十七位的系数分别为：7－9－10－5－8－4－2－1－6－3－7－9－10－5－8－4－2\n // 将这17位数字和系数相乘的结果相加；\n // 用加出来和除以11，看余数是多少；\n // 余数只可能有0－1－2－3－4－5－6－7－8－9－10这11个数字；\n // 其分别对应的最后一位身份证的号码为1－0－X－9－8－7－6－5－4－3－2\n // 通过上面得知如果余数是2，就会在身份证的第18位数字上出现罗马数字的Ⅹ。如果余数是10，身份证的最后一位号码就是2。\n const coefficientList = [7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2];\n const residueList = ['1', '0', 'X', '9', '8', '7', '6', '5', '4', '3', '2'];\n let sum = 0;\n\n for (let start = 0; start < 17; start++) {\n sum += Number(value.slice(start, start + 1)) coefficientList[start];\n }\n\n return residueList[sum % 11] === value.slice(-1);\n}\n\n// url\nconst URL_RE = /^https?:\\/\\//i;\n/*\n 判断字符串是否为 url 格式，仅支持 http 协议，支持域名或者 ipV4\n * @param {string} value\n * @returns {boolean}\n /\nexport function isURL(value: string): boolean {\n return URL_RE.test(value);\n}\n\n// ipv4\nconst IPV4_RE = /^(?:(?:\\d\|[1-9]\\d\|1\\d\\d\|2[0-4]\\d\|25[0-5])\\.){3}(?:\\d\|[1-9]\\d\|1\\d\\d\|2[0-4]\\d\|25[0-5])$/;\n/\n 判断字符串是否为 IPV4 格式，不对 ip 真实性做验证\n * @param {string} value\n * @returns {boolean}\n /\nexport function isIPV4(value: string): boolean {\n return IPV4_RE.test(value);\n}\n\nconst INTEGER_RE = /^(-?[1-9]\\d\|0)$/;\n/*\n 判断字符串是否为整数（自然数），即 ...,-3,-2,-1,0,1,2,3,...\n * @param {string} value\n * @returns {boolean}\n /\nexport function isInteger(value: string): boolean {\n return INTEGER_RE.test(value);\n}\n\nconst FLOAT_RE = /^-?([1-9]\\d\|0)\\.\\d+$/;\n/*\n 判断字符串是否为浮点数，即必须有小数点的有理数\n * @param {string} value\n * @returns {boolean}\n /\nexport function isFloat(value: string): boolean {\n return FLOAT_RE.test(value);\n}\n\n/\n 判断字符串是否为正确数值，包括整数和浮点数\n * @param {string} value\n * @returns {boolean}\n /\nexport function isNumerical(value: string): boolean {\n return isInteger(value) \|\| isFloat(value);\n}\n\nconst DIGIT_RE = /^\\d+$/;\n/\n 判断字符串是否为数字，例如六位数字短信验证码（093031）\n * @param {string} value\n * @returns {boolean}\n */\nexport function isDigit(value: string): boolean {\n return DIGIT_RE.test(value);\n}\n"],"names":[],"mappings":"AAAA,MAAM,YAAY;AAYX,SAAS,aAAa,QAAwB;AAC5C,SAAA,OAAO,QAAQ,WAAW,MAAM;AACzC;AAGA,MAAM,WAAW;AAMV,SAAS,QAAQ,OAAwB;AACvC,SAAA,SAAS,KAAK,KAAK;AAC5B;AAGA,MAAM,WAAW;AAMV,SAAS,QAAQ,OAAwB;AACvC,SAAA,SAAS,KAAK,KAAK;AAC5B;AAqBA,MAAM,UACJ;AAMK,SAAS,OAAO,OAAwB;AACvC,QAAA,eAAe,QAAQ,KAAK,KAAK;AAEnC,MAAA,CAAC,aAAqB,QAAA;AAE1B,QAAM,OAAO,OAAO,MAAM,MAAM,GAAG,EAAE,CAAC;AACtC,QAAM,QAAQ,OAAO,MAAM,MAAM,IAAI,EAAE,CAAC;AACxC,QAAM,OAAO,OAAO,MAAM,MAAM,IAAI,EAAE,CAAC;AACvC,QAAM,IAAI,IAAI,KAAK,MAAM,QAAQ,GAAG,IAAI;AACxC,QAAM,aAAa,EAAE,YAAY,MAAM,QAAQ,EAAE,SAAS,IAAI,MAAM,SAAS,EAAE,QAAc,MAAA;AAEzF,MAAA,CAAC,WAAmB,QAAA;AASxB,QAAM,kBAAkB,CAAC,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,CAAC;AAC5E,QAAM,cAAc,CAAC,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,GAAG;AAC1E,MAAI,MAAM;AAEV,WAAS,QAAQ,GAAG,QAAQ,IAAI,SAAS;AAChC,WAAA,OAAO,MAAM,MAAM,OAAO,QAAQ,CAAC,CAAC,IAAI,gBAAgB,KAAK;AAAA,EAAA;AAGtE,SAAO,YAAY,MAAM,EAAE,MAAM,MAAM,MAAM,EAAE;AACjD;AAGA,MAAM,SAAS;AAMR,SAAS,MAAM,OAAwB;AACrC,SAAA,OAAO,KAAK,KAAK;AAC1B;AAGA,MAAM,UAAU;AAMT,SAAS,OAAO,OAAwB;AACtC,SAAA,QAAQ,KAAK,KAAK;AAC3B;AAEA,MAAM,aAAa;AAMZ,SAAS,UAAU,OAAwB;AACzC,SAAA,WAAW,KAAK,KAAK;AAC9B;AAEA,MAAM,WAAW;AAMV,SAAS,QAAQ,OAAwB;AACvC,SAAA,SAAS,KAAK,KAAK;AAC5B;AAOO,SAAS,YAAY,OAAwB;AAClD,SAAO,UAAU,KAAK,KAAK,QAAQ,KAAK;AAC1C;AAEA,MAAM,WAAW;AAMV,SAAS,QAAQ,OAAwB;AACvC,SAAA,SAAS,KAAK,KAAK;AAC5B;"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@cloudcome/utils-core",
-  "version": "1.18.1",
+  "version": "1.19.0",
   "description": "cloudcome core utils",
   "engines": {
     "node": ">=22"