メインコンテンツへスキップ
見出し画像

画面は10月1日、CSVは9月30日|日本時間の日付を照合する6件のテスト

海外製SaaSから注文一覧を出したら、画面では10月1日の注文が、CSVでは9月30日になっている。月別に数える前に、どちらの日付を使えばよいか迷う場面です。

ここで「CSVの日付を1日進める」と直す前に、見たいものがあります。CSVに入っているのは時刻まで含むデータか、日付だけのデータか。さらに、その列は何を表す約束になっているか。

この記事は、海外製SaaSの日本担当者、品質を確認するQA担当者、CSV出力を検品する運用担当者向けです。日本時間の注文日を例に、画面とCSVの違いを調べ、開発担当へ渡せる記録にまとめます。

日付が違っても、同じ瞬間を表していることがある

次の二つは、同じ瞬間を表す説明用の値です。

  • 日本時間:2026年10月1日 00:30

  • UTC:2026年9月30日 15:30

UTCは協定世界時です。日本標準時(JST)はUTCより9時間進んでいます。NICTの説明で確認できます。

CSVの値が「2026-09-30T15:30:00Z」なら、日本時間の10月1日00:30と対応します。この例の「Z」はUTCで表した時刻に付く記号です。「+09:00」のような数値はUTCとの時差を示します。日時表記の根拠はRFC 3339の5.6・5.7節です。

一方、「日本時間の注文日」を出す約束の列に「2026-09-30」とだけ入っていたら、確認すべき結果が違います。この注文の日本時間の日付は10月1日です。

まず1件、表計算ソフトに取り込む前のCSVをテキストエディタで開き、列名と値を確認してください。 日時の表記が違う問題と、日付だけを取り出した結果が違う問題を分けるのが、最初の判断です。

この記事で作れるもの

有料部分には、日付の切り替わりを調べるテスト6件と期待結果、架空の記入済み報告、コピー用の空欄シート、仕様が分からないときの問い合わせ文を載せています。本文からコピーして使えます。

材料は公開仕様と、説明用に作った日時データです。掲載する時刻の対応はプログラムでも照合しました。特定のSaaSで発生した障害や、筆者の導入改善実績ではありません。

対象は「ある瞬間から、日本時間の暦日を求める」確認です。誕生日や納品希望日のような日付そのもの、午前5時締めなどの営業日、他国の夏時間は扱いません。実サービスの自動修正ツールや、製品別の画面操作説明も含みません。

 
 
Web系エンジニアの瞳です。AI・仕事の工夫から、ガジェット、美容、暮らしまで。選ぶとき・使うときに迷うポイントを、具体例とともにわかりやすく。日々の「どう選ぶ?」「どう進める?」に役立つ記事を届けます。

あなたへのおすすめ