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

「昨日分」のはずが1日ズレる? 自動化で時刻・タイムゾーンを曖昧にしない業務設計

    「10月10日のデータを取ったはずなのに、CSVでは10月9日になっている」

    処理を間違えたのか。

    取得条件を1日ずらしてしまったのか。

    そう思って確認してみると、データそのものは合っている。

    違っていたのは、何月何日として扱っているかだった。

    クラウドサービスや外部APIを使った自動化では、こうした日付ズレが起こる。

    日本にいる人から見れば10月10日でも、相手のシステムではまだ10月9日。

    さらに業務上は「10月9日分」として集計したい。

    同じ瞬間なのに、3つの日付が登場することさえある。

    問題は時計が狂っていることではない。

    どの時刻を、何のための日付として使うのか決まっていないことにある。


    日本時間の10月10日は、UTCでは10月9日になる

    海外サービスやクラウドを使っていると、UTCという言葉をよく見かける。

    UTCは「協定世界時」と呼ばれる、世界で時刻をそろえるための基準となる時間だ。

    日本時間はJSTと呼ばれ、UTCより9時間進んでいる。

    たとえば、

    日本時間
    10月10日 0:30

    という瞬間は、

    UTC
    10月9日 15:30

    になる。

    同じ瞬間だが、カレンダー上の日付は違う。

    APIがUTCで時刻を返しているのに、日本時間だと思って日付部分だけを取り出せば、

    「10月10日のデータを取得したのに、10月9日になった」

    ということが起きる。

    自動化のバグに見えて、実際には時刻の解釈ルールが違うだけ、というケースも珍しくない。


    日付だけ保存すると、あとから判断できなくなる

    たとえばデータに、

    2026-10-09

    とだけ保存されていたとする。

    一見、分かりやすい。

    しかし、この日付が何を表しているのかは分からない。

    データが作られた日なのか。

    APIから取得した日なのか。

    日本時間の日付なのか。

    UTCの日付なのか。

    売上を計上する業務日付なのか。

    日付だけになった瞬間、元の情報が消えてしまうことがある。

    特に注意したいのが、時刻から日付を作る処理だ。

    元データが、

    2026-10-09 15:30 UTC

    だったとしても、日本時間へ直せば、

    2026-10-10 00:30 JST

    になる。

    先に「2026-10-09」という日付へ切り落としてしまえば、あとから日本時間へ直すことはできない。

    時刻を扱う自動化では、

    日付へ変換する前に、その時刻がどのタイムゾーンなのか確認する

    という順序が重要になる。


    「全部日本時間にする」だけでは解決しない

    日本国内の業務なら、全部JSTへ変換すればよさそうに見える。

    しかし、それだけでは足りない。

    時刻には少なくとも、

    • 保存するための時刻

    • 人が見るための時刻

    • 業務上どの日に所属させるか

    という3つの役割がある。

    この3つを同じものとして扱うと、設計が分かりにくくなる。

    たとえばシステム内部ではUTCで保存する。

    画面や帳票ではJSTへ変換して表示する。

    そして売上集計では、会社の締め時刻に従って業務日付を決める。

    この形でも問題はない。

    むしろ複数の地域や外部サービスを扱うなら、保存時刻を一つの基準へ統一しておくほうが扱いやすい場合もある。

    大切なのは「日本時間かUTCか」の二択ではない。

    保存時刻・表示時刻・業務日付を混ぜないことだ。


    「昨日分」とは、いつからいつまでなのか

    日次処理でよく使う言葉に、

    「昨日分を集計する」

    がある。

    人同士なら何となく通じる。

    しかし、自動化へ渡す条件としては曖昧だ。

    10月10日の午前8時に処理するとして、

    昨日分とは、

    10月9日 0:00〜23:59なのか。

    UTCの10月9日なのか。

    業務上の締め時刻を基準にした10月9日なのか。

    ここを決める必要がある。

    たとえば24時間営業のサービスで、毎日午前4時を締め時刻にしているとする。

    この場合、

    10月10日 2:00

    の売上を、カレンダー上の10月10日ではなく、

    10月9日分の売上

    として扱うこともある。

    つまり、

    日付が変わる時刻と、業務日付が変わる時刻は同じとは限らない。

    0時を境界にするのは一つのルールにすぎない。


    APIの取得時刻と、データの業務日付も別物

    API連携では、さらに別の時刻が登場する。

    10月10日 8:00にAPIを実行した。

    だから10月10日分のデータ。

    とは限らない。

    APIを呼び出した時刻は、あくまで取得した時刻だ。

    取得されたレコード自体は10月9日の取引かもしれない。

    相手サービスがUTCで日付を区切っている可能性もある。

    前日分のデータが数時間遅れて確定するサービスもある。

    そこで、

    取得した時刻

    と、

    そのデータが何日分なのか

    を分けて持つ。

    たとえば、

    取得時刻:10月10日 8:00 JST
    対象業務日:10月9日
    API基準時刻:UTC

    という情報を分ける。

    これだけでも、あとで数字を確認するときの混乱は大きく減る。


    ログにもタイムゾーンを残す

    トラブル調査でよく困るのが、

    2026-10-10 00:15 処理開始

    のようなログだ。

    日本時間なのかUTCなのか分からない。

    実行したPCのローカル時間なのか、クラウド側の時刻なのかも分からない。

    時刻を記録するなら、タイムゾーンまで判断できる形にしておく。

    たとえば、

    2026-10-10T00:15:00+09:00

    なら日本時間。

    2026-10-09T15:15:00Z

    ならUTC。

    難しい日時ライブラリを覚えることが目的ではない。

    あとから見た人が、その時刻を一意に解釈できることが重要になる。


    ファイル名の日付も意外と危ない

    日次処理では、

    売上_20261010.csv

    のようなファイル名を作ることがある。

    ここでも、その日付が何を表すのか決めておきたい。

    ファイルを作成した日なのか。

    取得した日なのか。

    中に入っているデータの業務日付なのか。

    たとえば10月10日の朝に、10月9日分の売上CSVを作る場合。

    作成日を使えば、

    売上_20261010.csv

    になる。

    業務日付を使えば、

    売上_20261009.csv

    になる。

    どちらでも構わない。

    問題になるのは、ルールが決まっていないことだ。

    担当者によって解釈が違えば、

    「10月9日分のファイルはどっち?」

    という確認が毎回発生する。

    ファイル名の日付にも意味を持たせる。

    小さなルールだが、日次運用ではかなり効く。


    海外サービスと連携するなら、境界を確認する

    海外サービスを使うときは、

    「画面では日本時間に見えているから大丈夫」

    とも限らない。

    画面だけ利用者のタイムゾーンへ変換され、APIはUTCで返すサービスもある。

    管理画面のレポートとAPIの集計期間で基準時刻が違うこともある。

    確認したいのは、

    • APIの日時は何基準か

    • 日次集計は何時に切り替わるか

    • 管理画面の表示時刻は何基準か

    • DBには何時刻で保存されているか

    • 日付指定の検索条件はどのタイムゾーンか

    といった点。

    「10月9日を指定した」というだけでは不十分だ。

    10月9日の何時から何時までなのかまで確認する。


    自動化の前に決めたい3つの時刻

    日時を扱う業務なら、最低限この3つを分けておくと整理しやすい。

    1. 保存時刻

    システム内部で、出来事が起きた瞬間をどう保存するか。

    UTCで統一するのか。

    タイムゾーン付きで保存するのか。

    2. 表示時刻

    利用者へ何時として見せるか。

    日本の担当者向けならJSTで表示する、といったルール。

    3. 業務日付

    そのデータを何月何日の売上、申請、注文、集計として扱うか。

    これは時計そのものではなく、業務ルールで決まる。

    この3つを同じ列、同じ変数、同じ意味で扱わない。

    それだけで日時周りの事故はかなり減らせる。


    時刻のズレより怖いのは「正しくズレ続ける」こと

    日時の問題は、処理がエラーで止まるとは限らない。

    むしろ怖いのは、

    毎日正常終了している。

    CSVも作られている。

    件数もそれらしく見える。

    でも毎日1日ずれたデータを集計している。

    という状態だ。

    システムから見れば正常。

    業務から見れば間違い。

    だから、日時は単なるプログラム上のデータ型としてではなく、業務ルールとして決めておく必要がある。

    「昨日分を取る」

    ではなく、

    「JSTの午前4時を業務日の境界とし、前回の業務日を取得する」

    のように定義する。

    「10月9日」

    だけではなく、

    「どのタイムゾーンの、どの範囲を10月9日と呼んでいるのか」

    まで決める。

    時計は正しくても、日付の意味はシステムごとに違う。

    自動化するなら、その違いを曖昧なまま機械へ渡さない。

    それが、日次処理を長く安定して回すための土台になる。


    業務改善ツールと、お仕事のご相談

    Yokoyama Labでは、Excel・CSVの確認、データ整理、Web情報の収集など、毎日の地味な手作業を減らす仕組みを作っています。

    🛒 業務改善ツール

    すぐ使える小さな業務改善ツールをBOOTHで公開しています。

    ▶ BOOTH|Yokoyama Lab
    https://automationlab.booth.pm/

    🔧 業務改善・自動化のご相談

    「この手作業、自動化できる?」
    「毎月のExcel作業を減らしたい」
    「こういうツールを作ってほしい」

    といった段階からご相談いただけます。

    Python、Excel/VBA、Google Apps Scriptなどを使い、現在の業務に合わせた小規模な自動化・業務改善をお手伝いしています。

    Yokoyama Lab公式HP:
    https://yokoyama-lab.com

     
     
    Excel・CSVの整理や確認など、日々の手作業を減らす工夫を発信 自動化の頼み方や、導入・運用でつまずかないための考え方も紹介 業務改善・開発のご相談はYokoyama Labへ https://yokoyama-lab.com

    あなたへのおすすめ