Zenn
🕐

Railsアプリケーションにおけるタイムゾーン問題の解決

に公開
Rails
tech

はじめに

タイムゾーンの扱いは、グローバルなウェブアプリケーションにおいて避けては通れない問題の一つです。特にイベントのスケジューリングや時刻の記録を行う際、ローカル時刻とUTC（協定世界時）との間で問題が発生することがあります。本記事では、Railsアプリケーションで遭遇したタイムゾーンの問題とその解決方法を共有します。

問題の説明

私のRailsアプリケーションには、ユーザーがイベントを作成する機能があります。イベントの重複をチェックするロジックが含まれていましたが、実際に日本時間のタイムゾーン（+0900）でテストしたところ、イベントが誤って重複と判断されるバグに直面しました。

ログ出力例

Started POST "/events" for 127.0.0.1 at 2023-10-31 06:16:43 +0900
...
Parameters: {"start"=>"2023/10/12 17:00", "end"=>"2023/10/12 18:00", ...}
...
Executing SQL: SELECT "events".* FROM "events" WHERE "events"."user_id" = 34 AND (start < '2023-10-12 09:00:00' AND "end" > '2023-10-12 08:00:00')

問題の原因

この問題の根本原因は、タイムゾーンの変換が適切に行われていなかったことにありました。具体的には、データベースに保存されているUTC時刻と、ユーザーのローカルタイムゾーンで提供されたイベント時刻が不一致だったのです。

解決方法

問題を解決するために、次のステップを実行しました。
以下は問題を解決した具体的なコード変更です。

コード変更前

# app/controllers/concerns/event_overlap_checker.rb
...
query = user.events.where.not(id: event.id).where(
  'start < ? AND "end" > ?', event.start, event.end
)
...

コード変更後

# app/controllers/concerns/event_overlap_checker.rb
...
start_time_utc = event.start.in_time_zone('UTC')
end_time_utc = event.end.in_time_zone('UTC')

query = user.events.where.not(id: event.id).where(
  'start < ? AND "end" > ?', start_time_utc, end_time_utc
)
...

これにより、イベントの開始時刻と終了時刻をユーザーのローカルタイムゾーンからUTCに変換し、データベースの時刻と正しく比較することができるようになりました。

気をつけるべき点

タイムゾーンの問題を未然に防ぐためには、以下の点に注意が必要です。

・アプリケーションのデフォルトタイムゾーンを適切に設定する。
・ユーザーのローカルタイムゾーンを明示的に扱う。
・データベースとの時刻の比較では、常にUTCを使用する。

まとめ

タイムゾーンは複雑な問題ですが、Railsが提供するin_time_zoneのようなメソッドを活用することで、システム全体での時刻の一貫性を保つことが可能です。開発者は、異なるタイムゾーンを意識したテストを行うことで、このようなバグを未然に防ぐことができます。

この記事があなたのアプリケーションでのタイムゾーン問題の解決の一助となれば幸いです。

Discussion