FormKit Tempo 时间处理库新增年份边界函数支持

FormKit Tempo 是一个专注于日期时间处理的 JavaScript/TypeScript 库，它提供了一系列便捷的函数来处理各种时间格式和计算。在最近的版本更新中，该库新增了两个实用的时间处理函数：yearStart 和 yearEnd，用于快速获取任意日期的年份起始和结束时间点。

新增功能介绍

yearStart 函数能够返回给定日期所在年份的第一天（即1月1日）的起始时间点（00:00:00），而 yearEnd 函数则返回该年份最后一天的结束时间点（23:59:59）。这两个函数在处理需要按年统计或筛选数据的场景时特别有用。

技术实现细节

这两个函数的实现考虑了时区和本地时间的处理，确保返回的时间点准确反映用户所在时区的年份边界。在内部实现上，它们会：

1. 解析输入日期对象
2. 提取年份信息
3. 构造新的日期对象，分别设置为1月1日和12月31日
4. 调整时间为当天的开始或结束时刻

版本更新与类型支持

在最初的实现中，虽然功能代码已经完成，但类型声明文件(index.d.cts)中遗漏了对这两个新函数的导出声明，导致TypeScript项目无法正确识别和使用它们。这个问题在0.0.16版本中得到了修复，现在开发者可以安全地在TypeScript项目中使用这些函数并获得完整的类型提示。

使用示例

import { yearStart, yearEnd, format } from '@formkit/tempo'

const date = new Date('2023-06-15')
const start = yearStart(date)  // 返回2023-01-01 00:00:00
const end = yearEnd(date)      // 返回2023-12-31 23:59:59

console.log(format(start, 'YYYY-MM-DD HH:mm:ss')) // 输出: 2023-01-01 00:00:00
console.log(format(end, 'YYYY-MM-DD HH:mm:ss'))   // 输出: 2023-12-31 23:59:59

应用场景

这些函数特别适用于以下场景：

• 生成年度报表的时间范围
• 按年统计数据的查询条件
• 创建年度日历或计划表
• 实现基于年份的过滤功能

FormKit Tempo 通过不断添加这类实用的时间处理函数，帮助开发者更高效地处理各种日期时间相关的业务逻辑，减少自行编写时间处理代码的工作量和潜在错误。