年初时间戳

当前年份的开始

年初时间戳对于年初至今的聚合、年度汇总、账单报表，以及需要稳定日历边界的测试夹具很有用。

UTC 边界

本页的年初值是 1 月 1 日 00:00:00 UTC。如果你的业务逻辑使用本地业务时区，请在编写数据库过滤器之前转换该边界。

年初时间戳何时有用

年初是报表和测试数据的常用锚点。用它来构建年初至今的仪表盘、年度账单范围、留存计算，以及应随日历变化自动更新的夹具。查询完整的年度周期时，把它与下一年的边界搭配。

• 把 yearStart 用作年初至今报表的下界
• 把 nextYearStart 用作完整日历年的排他上界
• 当报表跨越多个地区或后端服务时使用 UTC
• 仅当会计或产品规则在本地定义年份时才使用业务时区

验证年初值

把时间戳转换回 UTC 日期，确认它显示当前年份的 1 月 1 日 00:00:00。如果你的报表使用财年或本地业务时区，请为该规则生成单独的边界，而不是重用 UTC 日历年的值。把所选定义保留在查询旁边，以便未来的维护者知道为什么选择该边界以及使用了哪个时区。