年初のタイムスタンプ

今年の始まり

年初のタイムスタンプは、年初来の集計、年次のまとめ、請求レポート、そして安定したカレンダー境界を必要とするテストフィクスチャに役立ちます。

UTC 境界

このページの年初の値は 1 月 1 日の 00:00:00 UTC です。ビジネスロジックが現地のビジネスタイムゾーンを使う場合は、データベースフィルターを書く前に境界を変換してください。

年初のタイムスタンプが役立つとき

年の始まりは、レポートとテストデータの一般的なアンカーです。年初来のダッシュボード、年次の請求範囲、リテンション計算、そしてカレンダーの変化に応じて自動的に更新されるべきフィクスチャを構築するために使ってください。完全な年次期間を照会するときは、翌年の境界と組み合わせてください。

• 年初来レポートの下限として yearStart を使う
• 完全な暦年の含まない上限として nextYearStart を使う
• レポートが複数の地域やバックエンドサービスにまたがる場合は UTC を使う
• 会計や製品のルールが年を現地で定義する場合のみビジネスタイムゾーンを使う

年初の値を検証する

タイムスタンプを UTC 日付に戻して変換し、今年の 1 月 1 日 00:00:00 を示すことを確認してください。レポートが会計年度や現地のビジネスタイムゾーンを使う場合は、UTC 暦年の値を再利用せず、そのルール用に別の境界を生成してください。選んだ定義をクエリのそばに残し、将来の保守担当者がなぜその境界が選ばれ、どのタイムゾーンが使われたかを分かるようにしてください。