年初時間戳

目前年份的開始

年初時間戳記對於年初至今的彙總、年度匯總、帳單報表，以及需要穩定日曆邊界的測試夾具很有用。

UTC 邊界

本頁的年初值是 1 月 1 日 00:00:00 UTC。如果你的業務邏輯使用本地業務時區，請在編寫資料庫過濾器之前轉換該邊界。

年初時間戳記何時有用

年初是報表和測試資料的常用錨點。用它來建構年初至今的儀表板、年度帳單範圍、留存計算，以及應隨日曆變化自動更新的夾具。查詢完整的年度週期時，把它與下一年的邊界搭配。

• 把 yearStart 用作年初至今報表的下界
• 把 nextYearStart 用作完整日曆年的排他上界
• 當報表跨越多個地區或後端服務時使用 UTC
• 僅當會計或產品規則在本地定義年份時才使用業務時區

驗證年初值

把時間戳記轉換回 UTC 日期，確認它顯示目前年份的 1 月 1 日 00:00:00。如果你的報表使用財年或本地業務時區，請為該規則產生單獨的邊界，而不是重用 UTC 日曆年的值。把所選定義保留在查詢旁邊，以便未來的維護者知道為什麼選擇該邊界以及使用了哪個時區。