日付と時刻の開発要件|締切・日跨ぎ・集計のずれを防ぐ
日付と時刻のシステム要件を、業務日・締切境界・利用者の時差・月末集計・履歴表示に分け、見積依頼と納品時に確認できる受入表へ落とし込み、追加範囲の判断まで整理します。
執筆・確認株式会社adding 編集部
order-guide / contract
日付と時刻のシステム要件は、「日時を入力できること」だけでは検収できません。予約の締切なら、どの地域の時計を基準にするのか、境界ちょうどを受け付けるのか、利用者にはどの時刻を見せるのかまで決めて、初めて期待結果が一つになります。
見積依頼の前にそろえるべきなのは、日時項目の一覧よりも、各項目が「日付そのもの」「将来の予定」「発生済みの瞬間」のどれかという区別です。さらに、業務日の切替、月末への帰属、履歴の表示を別々の受入条件にします。ただし、同じ予約日時でも保存・判定・表示では必要な基準が異なるため、一つの欄にまとめないことが重要です。
日付と時刻のシステム要件は三つに分ける
日付に見える値が、すべて同じ性質とは限りません。誕生日や対象月のように、閲覧場所が変わっても同じ日付で扱いたい値があります。一方、予約や締切は特定地域の壁時計に従う将来予定です。操作履歴は、すでに発生した瞬間として前後を比較したい値です。
W3Cの「Working with Time and Timezones」は、タイムゾーンや特定の瞬間に結び付かず、どのタイムゾーンでも同じ日付・時刻として扱う値を「floating time」と区別しています。オフセットのない値を瞬間として扱うと誤りの原因になるとも説明しています(2025年7月26日時点)。
また、RFC 3339が扱うタイムスタンプは、UTCとの関係を示すオフセットを持ち、一つの瞬間を表すものです。期間や間隔まで同じ規格で表すものではありません(2026年9月21日確認)。つまり「日付」「将来予定」「履歴」を、タイムスタンプという一語で済ませると、必要な判断が隠れます。
運用上の提案として、要件一覧には少なくとも次の分類欄を設けます。
- 日付として固定:閲覧者の所在地によって日付を動かさない値
- 将来の壁時計時刻:特定地域の時計で実施・終了する予約や締切
- 発生済みの瞬間:操作、送信、更新などの履歴
この分類を先に決めると、項目ごとに保存形式、比較の基準、表示に必要な情報を確認できます。
見積依頼に添える日時要件の受入表
次の表は、業務日・締切境界・利用者の時差・月末・履歴時刻を混同しないための受入表です。記載内容は、発注者と開発者が期待結果をそろえるための運用上の提案であり、製品共通の必須仕様を示すものではありません。自社の規則に合わせて各欄を埋め、決められない項目は未決定として明示します。
| 判断対象 | 発注者が指定する条件 | 受入時に与える状態 | 合格とする結果 | 追加範囲になり得る条件 |
|---|---|---|---|---|
| 業務日 | 業務日を決めるタイムゾーン、日付の切替条件 | 切替の前・境界・後に当たる日時 | 各データが指定した業務日に帰属する | 拠点や利用者ごとに業務日が異なる |
| 予約・締切 | 基準タイムゾーン、境界を含むか、規則変更後も壁時計時刻を維持するか | 締切の前・境界・後、異なる所在地からの操作 | 受付可否が指定条件と一致する | 地域別の締切、保存済み予定の再確認や更新 |
| 利用者への表示 | 基準地域のまま見せるか、利用者側へ変換するか、地域名等を示すか | 基準地域と異なるタイムゾーンで閲覧 | 日付、時刻、地域の表示が指定どおりになる | 利用者ごとのタイムゾーン設定や表示切替 |
| 月末集計 | 集計の基準タイムゾーン、月への帰属条件 | 月の切替前後に発生したデータ | 指定した月へ重複・欠落なく帰属する | 複数の基準地域をまたぐ集計 |
| 操作履歴 | 発生順を比較する基準、画面・帳票の表示タイムゾーン | 異なる所在地から行われた複数の操作 | 発生順を保ち、指定地域の時刻で表示する | 地域名・略称の表示、出力先ごとの変換 |
表の「追加範囲になり得る条件」は、実装が必ず追加になるという意味ではありません。見積時の前提に含まれているかを確認し、含まれていなければ変更対象として合意するための欄です。システム要件定義のチェックリストと併用し、機能名、対象利用者、権限、例外時の扱いと同じ粒度で日時条件も記載すると、検収条件を追跡しやすくなります。
締切は「何時まで」だけで決めない
締切では、時計の数字とともに基準地域を先に固定します。W3Cは、将来の壁時計時刻が夏時間などの規則に依存するため、将来予定にはタイムゾーンが必要であり、単なるUTCオフセットでは足りないとしています。規則が変わった場合、予定していた壁時計時刻を保つために、保存済みの値を確認・更新する必要が生じることもあります(2025年7月26日時点)。
IANAのタイムゾーン情報によれば、タイムゾーンデータベースは各地のローカル時刻の履歴を表し、政府による境界や夏時間規則の変更を反映するため定期的に更新されます。主要なエントリは通常、地域と代表都市の名前で識別されます(2026年9月21日時点)。
そのため、運用上の提案として、将来の予約・締切は固定オフセットの指定だけで完了としません。基準となるIANAタイムゾーン、境界時刻を受付側に含めるか、異なる所在地の利用者へどう表示するか、規則変更後も元の壁時計時刻を維持するかを受入行へ記載します。
境界の受入確認では、締切より前、境界ちょうど、締切より後という条件を用意します。自社が採用する境界条件を入れ、各状態の受付可否が一意になることを確認します。「締切日まで」という文言だけでは、日付が変わる基準地域も境界を含むかも判定できません。
日跨ぎと月末は帰属先を検収する
日跨ぎの問題は、画面の日付だけを見ても発見しにくいものです。保存された瞬間が正しくても、どのタイムゾーンで日付へ区切るかによって、業務日や集計月の帰属が変わり得るからです。
W3Cは、日付や時刻が特定のオフセットまたはタイムゾーン規則に結び付かない場合にfloating time型を使うことを推奨し、瞬間として集めた統計を継続的な時間区分へまとめる用途も例示しています(2025年7月26日時点)。これは特定の集計方式を一律に必須とする説明ではありません。業務上の日付と、発生した瞬間から作る集計区分を分けて考える根拠になります。
運用上の提案として、業務日は「基準タイムゾーン」と「日付の切替条件」を、月末集計は「月への帰属条件」を独立した行にします。日付だけで意味が固定される値をいったんUTCの瞬間へ変換し、再び日付へ戻す前提は置きません。期待する業務日が変わらないと確認できる場合に限って、その処理を受け入れます。
検収データは、切替前・境界・切替後という状態を対象にします。月末も同様に、月の切替をまたぐデータがどちらの月へ入るかを確認します。画面表示、検索条件、一覧、集計結果のすべてが同じ帰属規則を使っていることが合格条件です。業務日とカレンダー日を別々に扱うなら、その双方を画面・出力のどこで使うかも範囲へ含めます。
履歴は保存と表示を別の条件にする
操作履歴では、まず発生した瞬間を比較できることが必要です。RFC 3339の対象は、インターネット上のイベントを表すタイムスタンプであり、各時刻はUTCとの関係を示すオフセットを持って一つの瞬間を表します(2026年9月21日確認)。この性質は、業務日そのものを保存する要件とは異なります。
W3Cは、過去のイベントではUTCに対するローカルオフセットが確定するため、瞬間とオフセットから壁時計時刻を再現できると説明しています。一方、表示にタイムゾーン名や略称を正確に含めるには、タイムゾーン識別子が必要です(2025年7月26日時点)。
そこで運用上の提案として、履歴の受入条件を二つに分けます。一つは、異なる所在地からの操作でも発生順を比較できること。もう一つは、画面や帳票で指定したタイムゾーンへ変換して表示できることです。地域名や略称も表示するなら、その要件を明記し、オフセットだけで足りるとは決めません。
見積範囲と納品時確認を同じ表で結ぶ
受入表は、見積依頼時と納品時で同じ行を使います。依頼時には、各行について「決定済み」「開発者から提案を受けて決める」「今回の対象外」を区別します。納品時には、指定した状態と合格結果を実際に照合します。途中で基準地域、境界の包含、表示変換、月への帰属が変わった場合は、元の受入行との差分として扱います。
見積書では「日時対応」「タイムゾーン対応」という項目名に加え、どの受入行が含まれるかを確認してください。複数地域への表示、地域別締切、保存済み予定への規則変更対応、出力先ごとの表示変換が未記載なら、追加範囲かどうかを合意します。見積項目の読み合わせには、システム開発の見積もりで確認するポイントも利用できます。
検収基準として固定するのは、業務日の切替、締切境界の包含、所在地が異なる利用者への表示、月末データの帰属、履歴を表示する地域です。この五つを受入表の別行にし、前・境界・後の状態で期待結果を照合します。そうすれば、予約や締切の受付可否と表示結果を、見積依頼時に合意した条件のまま納品時に確認できます。
費用、期間、契約、法務・税務上の扱いは条件により異なります。記事の確認日とリンク先の一次情報を確認し、個別判断は専門家へご相談ください。
システム開発・発注ガイドへ戻る