もうタイムゾーンで迷わない!Pythonの「Pendulum」で美しく直感的な日時処理を

投稿者: | 2026-11-19

日時の計算やタイムゾーンの処理は、プログラミングにおいて思わぬバグを生みやすい繊細な領域ですよね。Python標準の datetime モジュールも優秀ですが、タイムゾーンの扱いが少し複雑に感じられたり、コードの可読性に悩んだりした経験をお持ちの方も多いのではないでしょうか。

今回は、標準の datetime と互換性を保ちながら、より直感的でエレガントに日時を操作できるライブラリ「Pendulum」をご紹介します。

Pendulumの概要

Pendulum(振り子)は、Pythonにおける日時操作をよりシンプルかつスマートに行うために設計されたサードパーティライブラリです。

最大の特徴は、標準の datetime.datetime クラスを継承して作られているため、既存のコードと親和性が高い点にあります。また、タイムゾーンの取り扱いが徹底的に洗練されており、サマータイム(夏時間)の考慮や地域間の時差変換を、直感的かつ安全に記述することができます。

標準ライブラリの datetime ではタイムゾーンの考慮漏れ(naiveとawareの混在)が起きやすいですが、Pendulumなら最初から安全な形で扱えるのが嬉しいポイントですね。

Pendulumを選ぶメリット

  1. タイムゾーンの直感的な制御
    標準ライブラリのように複雑な手順を踏むことなく、都市名を指定するだけで安全にタイムゾーンを設定・変換できます。デフォルトでタイムゾーンが認識される設計(Timezone-aware)になっているため、意図しないオフセットのずれを防げます。
  2. 流れるように書ける日時の加減算
    .add(days=3) や .subtract(hours=2) のように、可読性の高いチェーンメソッドで日時の加算・減算が可能です。
  3. 強力なフォーマット機能と人間らしい相対表示
    「3時間前」や「明日」といった自然な表現(相対時間)を、.diff_for_humans() を呼び出すだけで簡単に日本語対応で出力できます。

サンプルコード

まずはライブラリをインストールしましょう。

pip install pendulum

基本的な日時生成、タイムゾーン変換、加減算、相対時間の表示を行うサンプルコードです。

import pendulum

# 1. タイムゾーンを指定して現在日時を取得
now_tokyo = pendulum.now("Asia/Tokyo")
print(f"東京の現在時刻: {now_tokyo}")

# 2. 他のタイムゾーンへ瞬時に変換
paris_time = now_tokyo.in_timezone("Europe/Paris")
print(f"パリの現在時刻: {paris_time}")

# 3. 日時の加減算(メソッドチェーン)
future_date = now_tokyo.add(days=5, hours=3)
print(f"5日3時間後: {future_date.to_datetime_string()}")

# 4. 人間にとって読みやすい相対時間の表示(多言語対応)
past_date = now_tokyo.subtract(hours=4)
print(f"相対表示: {past_date.diff_for_humans(locale='ja')}")
東京の現在時刻: 2026-11-08 18:19:33.608735+09:00
パリの現在時刻: 2026-11-08 10:19:33.608735+01:00
5日3時間後: 2026-11-13 21:19:33
相対表示: 4 時間前

diff_for_humans(locale='ja') を指定するだけで、自然な日本語の相対表記が得られます。Webアプリケーションのタイムライン表示などにそのまま活用できますよ。

みーちゃんのワンポイント

Pendulumは標準の datetime と高い互換性を持っていますが、型判定で isinstance(obj, datetime) を使う場合は通るものの、一部のフレームワーク(SQLAlchemyなど)と組み合わせる際に内部型で不整合が起きるケースがあります。データベースへ保存する直前には、.to_datetime() や標準の datetime に明示的にキャストして渡すとトラブルを未然に防げますよ。