{"_id":"@caolib/time-util","name":"@caolib/time-util","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@caolib/time-util","version":"1.0.0","description":"A lightweight JavaScript utility library for date and time formatting","main":"index.js","type":"module","scripts":{"test":"node test.js","build":"echo 'No build step required'","prepublishOnly":"npm test"},"keywords":["date","time","format","utility","javascript","relative-time","timestamp"],"author":{"name":"caolib"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/caolib/time-util.git"},"bugs":{"url":"https://github.com/caolib/time-util/issues"},"homepage":"https://github.com/caolib/time-util#readme","publishConfig":{"access":"public"},"engines":{"node":">=14.0.0"},"exports":{".":{"import":"./index.js","require":"./index.cjs"}},"_id":"@caolib/time-util@1.0.0","gitHead":"4d30592421bfbc767aab972fc4a74be7ddbdd591","_nodeVersion":"22.16.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-QnMzWpmBfisFjc25gw1YVP3O8ioVVWjZpjo18pFcSCYVObamikUJe9PeGRwxhN1yxmE9BPCwR03uY/IpvxUSXA==","shasum":"8bef72bf77bb977f5e48585855ccd282c014fd4d","tarball":"https://registry.npmjs.org/@caolib/time-util/-/time-util-1.0.0.tgz","fileCount":7,"unpackedSize":18567,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIH6i8oOEAPRUle6q55IJ1MAOMoin1k8zNDPifO9zLkNSAiEA2FJRqmGZ7BguYAt+O0Dn+TSao4ALX/cknUxsgosmzkI="}]},"_npmUser":{"name":"caolib","email":"1265501579@qq.com"},"directories":{},"maintainers":[{"name":"caolib","email":"1265501579@qq.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/time-util_1.0.0_1757123164191_0.26913024164572774"},"_hasShrinkwrap":false}},"time":{"created":"2025-09-06T01:46:04.065Z","1.0.0":"2025-09-06T01:46:04.446Z","modified":"2025-09-06T01:46:04.769Z"},"maintainers":[{"name":"caolib","email":"1265501579@qq.com"}],"description":"A lightweight JavaScript utility library for date and time formatting","homepage":"https://github.com/caolib/time-util#readme","keywords":["date","time","format","utility","javascript","relative-time","timestamp"],"repository":{"type":"git","url":"git+https://github.com/caolib/time-util.git"},"author":{"name":"caolib"},"bugs":{"url":"https://github.com/caolib/time-util/issues"},"license":"MIT","readme":"# @caolib/time-util\n\n一个轻量级的JavaScript日期时间工具库，提供简单易用的日期格式化、相对时间计算等功能。\n\n## 特性\n\n- 🚀 零依赖，轻量级\n- 📦 支持ES模块和CommonJS\n- 🎯 简单易用的API\n- 🌍 中文友好的相对时间描述\n- ⚡ 高性能日期处理\n\n## 安装\n\n```bash\nnpm install @caolib/time-util\n```\n\n## 快速开始\n\n### ES模块\n```javascript\nimport { formatDate, getCurrentDate } from '@caolib/time-util';\n\n// 或者使用默认导入\nimport timeUtil from '@caolib/time-util';\n```\n\n### CommonJS\n```javascript\nconst { formatDate, getCurrentDate } = require('@caolib/time-util');\n```\n\n## API文档\n\n### formatDate(input)\n格式化时间戳或日期字符串为相对时间或绝对时间。\n\n**参数**\n- `input` {number|string} - 时间戳（毫秒）或日期字符串\n\n**返回值**\n- {string} 格式化后的时间字符串\n\n**示例**\n```javascript\nformatDate(Date.now() - 60000); // \"1分钟前\"\nformatDate('2023-10-26'); // \"2023-10-26\"（如果超过一个月）\nformatDate('2023-01-01T12:00:00'); // \"2023-01-01 12:00:00\"\n```\n\n### getCurrentDate()\n获取当前日期，格式为 `YYYY.MM.DD`。\n\n**返回值**\n- {string} 当前日期字符串\n\n**示例**\n```javascript\ngetCurrentDate(); // \"2024.05.12\"\n```\n\n### formatDateCustom(date, format)\n自定义格式化日期。\n\n**参数**\n- `date` {Date|string|number} - 日期对象、日期字符串或时间戳\n- `format` {string} - 格式字符串，默认为 `'yyyy-MM-dd HH:mm:ss'`\n\n**返回值**\n- {string} 格式化后的日期字符串\n\n**示例**\n```javascript\nformatDateCustom(new Date(), 'yyyy年MM月dd日'); // \"2024年05月12日\"\nformatDateCustom('2023-10-26', 'MM/dd/yyyy'); // \"10/26/2023\"\n```\n\n### getRelativeTime(start, end)\n获取两个日期之间的相对时间描述。\n\n**参数**\n- `start` {Date|string|number} - 开始日期\n- `end` {Date|string|number} - 结束日期（默认为当前时间）\n\n**返回值**\n- {string} 相对时间描述\n\n**示例**\n```javascript\ngetRelativeTime('2023-01-01', '2024-01-01'); // \"1年\"\ngetRelativeTime(Date.now() - 3600000); // \"1小时\"\n```\n\n### isToday(date)\n检查日期是否为今天。\n\n**参数**\n- `date` {Date|string|number} - 要检查的日期\n\n**返回值**\n- {boolean} 是否为今天\n\n**示例**\n```javascript\nisToday(new Date()); // true\nisToday('2023-10-26'); // false\n```\n\n### getDaysInMonth(year, month)\n获取指定月份的天数。\n\n**参数**\n- `year` {number} - 年份\n- `month` {number} - 月份（1-12）\n\n**返回值**\n- {number} 该月的天数\n\n**示例**\n```javascript\ngetDaysInMonth(2024, 2); // 29（2024年是闰年）\ngetDaysInMonth(2023, 11); // 30\n```\n\n### getTimestamp(date)\n获取时间戳（毫秒）。\n\n**参数**\n- `date` {Date|string|number} - 日期对象、日期字符串或时间戳（默认为当前时间）\n\n**返回值**\n- {number} 时间戳（毫秒）\n\n**示例**\n```javascript\ngetTimestamp(); // 当前时间戳\ngetTimestamp('2023-10-26'); // 指定日期的时间戳\n```\n\n## 使用示例\n\n### 基本使用\n```javascript\nimport { \n    formatDate, \n    getCurrentDate, \n    formatDateCustom, \n    getRelativeTime \n} from '@caolib/time-util';\n\n// 格式化相对时间\nconsole.log(formatDate(Date.now() - 5 * 60 * 1000)); // \"5分钟前\"\n\n// 获取当前日期\nconsole.log(getCurrentDate()); // \"2024.05.12\"\n\n// 自定义格式化\nconsole.log(formatDateCustom(new Date(), 'yyyy-MM-dd HH:mm')); // \"2024-05-12 15:30\"\n\n// 计算相对时间\nconsole.log(getRelativeTime('2023-01-01', new Date())); // \"1年\"\n```\n\n### 高级用法\n```javascript\nimport { \n    isToday, \n    getDaysInMonth, \n    getTimestamp \n} from '@caolib/time-util';\n\n// 检查是否为今天\nif (isToday('2024-05-12')) {\n    console.log('就是今天！');\n}\n\n// 获取某月天数\nconst daysInFeb = getDaysInMonth(2024, 2); // 29\n\n// 获取时间戳\nconst timestamp = getTimestamp('2024-05-12 15:30:00');\n```\n\n## TypeScript支持\n\n本库包含完整的TypeScript类型定义，无需额外安装类型包。\n\n## 浏览器兼容性\n\n- Chrome 61+\n- Firefox 60+\n- Safari 10.1+\n- Edge 16+\n\n## Node.js兼容性\n\n- Node.js 14.0.0+\n\n## 许可证\n\nMIT License\n\n## 贡献\n\n欢迎提交Issue和Pull Request！\n\n## 更新日志\n\n### v1.0.0\n- ✨ 初始版本发布\n- 🎉 支持日期格式化、相对时间计算、自定义格式等功能\n- 📦 支持ES模块和CommonJS\n- 🚀 零依赖，轻量级","readmeFilename":"README.md","_rev":"1-a48f903cf7983109fe7520703917ca5f"}