東京でテレワークをしている僕にニューヨークの同僚から電話。
「現地時間（２０２０年）４月２７日午前９時３０分から会議をするから、ちゃんと出席してね」。
さて、僕は何時にテレビ会議システムの前にいなきゃダメなんだろう？


タイムゾーンが関係するほとんど全ての問題には pytz モジュールが使用できます。





このパッケージは、多くの言語やオペレーティングシステムが標準のタイムゾーン情報として採用しているオルソンタイムゾーンデータベース ( Olson time zone database ) を利用しています。


pytz の最も一般的な使用場面は、datetime 日時からローカル日時を取得することでしょう。


ただ、誤解しないでください。


ここでいっている「ローカル日時を取得」とは、タイムゾーン情報を持っている日時オブジェクト (すなわち aware なオブジェクト) を取得する、という意味です。


タイムゾーン情報を持っていない日時オブジェクト (すなわち naive なオブジェクト) 同士で、「ここは１２時だから、あそこは前日の２３時だ」という意味合いではありません。




New York のローカル時間は？




取得したローカル日時を元にして、他のタイムゾーンへ変換することができます。
日本時間を取得してみましょう。




ここでは astimezone() を利用して、アメリカ東部夏時間から日本時間を取得しています。
ニューヨークで２０２０年４月２７日午前９時３０分から行われるテレビ会議に出席するためには、日本にいる私は２０２０年４月２７日午後１０時３０分に机に向かっていなければいけないようです。


タイムゾーンを考慮した日時オブジェクトで計算を行う際は、サマータイム等の特殊事項も考慮する必要があります。


例えば、２０２０年のアメリカ東部時間における夏時間は 2020-3-8(Sun)2:00:00 から 2020-11-1(Sun)2:00:00 までとなっています。


タイムゾーンを考慮しない日時オブジェクトでこの時期を含む計算を行うと正確な日時を取得することができません。




違いますね。


３月８日午前２時からは夏時間に突入して１時間早まりますから、03:15:00 にならなくてはいけません。
このような時には normalize() メソッドが使えます。




タイムゾーンが絡んだ処理でいい思い出を持っている方はほとんどいないのではないでしょうか？


混乱を防ぐための一般的な戦略は、コード内でも、データベースへの保存時でも、日時はすべて UTC で処理をすることです。


すべてが UTC で統一されていればサマータイム等の特殊事情も考慮する必要がありませんから、その時点でまずは通常の演算を行ってしまいます。


そしてその結果に対して、必要に応じてタイムゾーンを適用して必要なローカル日時を取得するようにします。




タイムゾーンを扱う上でほぼ常に付きまとう疑問は、「タイムゾーン名は何？」ではないでしょうか。


pytz.country_timezones ディクショナリーに key 名として ISO 3166 の国別コードを指定することでタイムゾーン名を取得することができます。