whenwords核心功能全解析从timeago到date_range的完整教程【免费下载链接】whenwordsA relative time formatting library, with no code.项目地址: https://gitcode.com/gh_mirrors/wh/whenwordswhenwords是一个创新的开源时间格式化库它通过提供语言无关的规范和测试用例让开发者能够轻松实现五种核心时间处理功能timeago、duration、parse_duration、human_date和date_range。这个独特的库不包含实际代码而是通过详细的SPEC.md和tests.yaml文件指导在任何编程语言中的实现支持Ruby、Python、Rust、Elixir等多种语言。快速入门如何开始使用whenwords要开始使用whenwords首先需要将项目克隆到本地git clone https://gitcode.com/gh_mirrors/wh/whenwords安装过程异常简单只需将INSTALL.md中的提示粘贴到AI代码助手如Claude、Codex或Cursor中它将自动读取SPEC.md了解完整行为规范解析tests.yaml生成测试文件实现所有五个核心函数运行测试直到全部通过将实现代码放置到指定位置核心功能详解让时间处理更简单timeago智能生成相对时间描述 ⏱️timeago函数能将时间戳转换为自然语言相对时间字符串如3小时前或2天后。它通过比较目标时间戳与参考时间戳自动选择最合适的时间单位。基本用法示例45秒前 → 1 minute ago90分钟前 → 2 hours ago36小时前 → 2 days ago未来3小时 → in 3 hours实现关键点使用45秒作为just now和1 minute ago的分界点避免UI显示抖动采用四舍五入规则处理中间值如89秒→1分钟自动识别未来时间并使用in X格式测试用例可参考tests.yaml中timeago部分包含从just now到5 years ago的完整场景覆盖。duration将秒数格式化为人类可读时长 ⏳duration函数将秒数转换为易读的时长字符串支持标准和紧凑两种格式还可限制显示的时间单位数量。标准格式示例3661秒 → 1 hour, 1 minute9000秒 → 2 hours, 30 minutes93600秒 → 1 day, 2 hours紧凑格式示例3661秒 → 1h 1m9000秒 → 2h 30m45秒 → 45s高级选项max_units: 限制显示的最大单位数量默认293661秒 max_units3 → 1 day, 2 hours, 1 minute9000秒 max_units1 → 3hparse_duration解析自然语言时长字符串 parse_duration是duration的逆函数能将各种格式的时长字符串转换为秒数支持多种输入格式非常适合处理用户输入。支持的输入格式紧凑格式2h30m、2h 30m、2h, 30m详细格式2 hours 30 minutes、2 hours and 30 minutes小数表示2.5 hours、1.5h冒号表示2:30h:mm、2:30:00h:mm:ss单位别名90min、2d、1w、45sec示例转换2h30m → 9000秒1.5h → 5400秒2 days → 172800秒1d 2h 30m → 95400秒human_date上下文感知的日期显示 human_date函数根据参考日期生成上下文相关的日期字符串让日期显示更加直观自然。日期显示规则当天 → Today昨天 → Yesterday明天 → Tomorrow过去7天内 → Last {weekday}如Last Saturday未来7天内 → This {weekday}如This Wednesday同一年 → {Month} {day}如March 5不同年 → {Month} {day}, {year}如March 5, 2023示例参考日期为2024-01-15周一2024-01-14 → Yesterday2024-01-13 → Last Saturday2024-01-08 → January 82023-01-01 → January 1, 2023date_range智能格式化日期范围 date_range函数能将起始和结束时间戳格式化为简洁的日期范围字符串自动压缩冗余信息。范围格式化规则同一天 → March 5, 2024同一月 → March 5–7, 2024同一年 → March 5 – April 7, 2024不同年 → December 28, 2024 – January 3, 2025示例开始2024-01-15结束2024-01-22 → January 15–22, 2024开始2024-01-15结束2024-02-15 → January 15 – February 15, 2024开始2023-12-28结束2024-01-15 → December 28, 2023 – January 15, 2024测试与验证确保功能正确性 ✅whenwords提供了全面的测试用例集tests.yaml包含500个测试场景覆盖了所有函数的各种边界情况和正常使用场景。每个测试用例定义了输入和预期输出确保在任何语言中的实现都能保持一致的行为。测试类型正常功能测试验证典型输入的正确输出边界条件测试验证阈值附近的行为如44秒vs45秒错误处理测试验证对无效输入的处理格式变体测试验证对不同输入格式的支持总结whenwords带来的时间处理革命whenwords通过创新的无代码库理念解决了跨语言时间处理的一致性问题。它的五大核心功能覆盖了从相对时间、时长格式化到日期范围显示的常见需求而语言无关的设计让开发者可以在任何项目中轻松实现这些功能。无论是构建国际化应用、处理用户输入的时间数据还是需要在UI中显示友好的时间信息whenwords都能提供清晰、一致的解决方案。通过遵循SPEC.md并通过tests.yaml中的所有测试你可以确保时间处理功能在任何语言中都能表现出预期的行为。立即尝试whenwords体验更智能、更一致的时间处理方式【免费下载链接】whenwordsA relative time formatting library, with no code.项目地址: https://gitcode.com/gh_mirrors/wh/whenwords创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考