Pythonのdatetimeを完全攻略！日付の計算やタイムゾーンで迷わないために

公開日: 2026-04-24

プログラミングを学んでいると、必ずと言っていいほどぶつかる壁があります。

その代表格が、今回解説する日付や時刻の扱いです。

一見すると単純そうに見える日付ですが、実はとても奥が深く、多くのエンジニアを悩ませてきました。皆さんは、プログラムの中で1ヶ月後の日付を正しく計算できるでしょうか。

あるいは、海外のユーザーが使うアプリを作る際、時差をどう考慮すればいいかパッと思い浮かびますか。こうした悩みは、Pythonのdatetimeモジュールをマスターすることで、驚くほどスッキリ解決します。

この記事では、IT初心者の方でも今日から実践できるレベルまで、徹底的に詳しく解説していきます。

なぜ日付操作は難しいと感じてしまうのか¶

そもそも、なぜ私たちは日付や時刻の処理で混乱してしまうのでしょうか？

その理由は、私たちが普段使っている時間のルールが、意外と複雑だからです。

1ヶ月が30日だったり31日だったり、はたまた2月は28日だったりと、ルールが一定ではありません。さらに、うるう年やタイムゾーンという概念が、計算をさらに複雑にしています。

こうした複雑な計算を、自分ですべて実装しようとするのは現実的ではありません。そこで登場するのが、Python標準ライブラリのdatetimeという強力なツールです。

このモジュールを使えば、複雑なカレンダーのルールを意識することなく、安全に時間を操作できます。まずは、このモジュールで扱う主要なオブジェクトについて整理していきましょう。

datetimeモジュールの主要な登場人物¶

datetimeモジュールには、いくつかの重要なクラスが存在します。これらを適切に使い分けることが、混乱を防ぐための第一歩となります。

初心者のうちは、すべてを一度に覚えようとする必要はありません。まずは、以下の表にまとめた4つのメインキャラクターを把握しておけば十分です。

覚えておくべき4つのオブジェクト¶

クラス名	役割
date	日付（年・月・日）だけを扱う
time	時刻（時・分・秒・マイクロ秒）だけを扱う
datetime	日付と時刻の両方をセットで扱う
timedelta	2つの日付や時刻の差（期間）を表す

これらの中でも、最も頻繁に使うのはdatetimeクラスです。現在時刻を取得したり、特定のイベントが発生した時間を記録したりする際に欠かせません。

一方で、誕生日などの時刻が不要なデータにはdateクラスを使うのがスマートです。用途に合わせて最適な道具を選ぶのが、プロのエンジニアへの近道と言えるでしょう。

では、実際にこれらのクラスをどのようにコードで表現するのか見ていきます。まずは、今この瞬間の時間を取得する方法から試してみましょう。

from datetime import datetime, date, time

# 現在の年月日・時刻を取得
now = datetime.now()
print(now)

# 特定の日付を作成
today = date(2026, 4, 24)
print(today)

# 特定の時刻を作成
dinner_time = time(19, 30, 0)
print(dinner_time)

このように、直感的な記述で日付や時刻のオブジェクトを作ることができます。もしエラーが出た場合は、インポート文が正しく書かれているか確認してくださいね。

日付の計算をマスターする：timedeltaの魔法¶

日付の操作で最もワクワクするのが、未来や過去の時間を計算する瞬間です。今日から100日後は何曜日だろう？といった疑問も、Pythonなら一瞬で解決します。

ここで活躍するのが、先ほどの表にも登場したtimedeltaというクラスです。これは特定の時点ではなく、2日分や5時間といった時間の長さを表現します。

datetimeオブジェクトに対してtimedeltaを足したり引いたりすることで、自由に時間を移動できます。言葉で説明するよりも、実際のコードを見たほうがイメージが湧きやすいはずです。

from datetime import datetime, timedelta

# 現在時刻
now = datetime.now()

# 1週間後の時間を計算
next_week = now + timedelta(weeks=1)
print(next_week)

# 10日前を計算
ten_days_ago = now - timedelta(days=10)
print(ten_days_ago)

# 3時間30分後を計算
later = now + timedelta(hours=3, minutes=30)
print(later)

いかがでしょうか。驚くほど簡単に未来や過去の時間を算出できましたね。

もしこれが、2026年2月28日の1日後を計算する場合でも、Pythonは自動的に3月1日だと判断してくれます。こうした細かい判定をすべて任せられるのが、標準ライブラリを使う最大のメリットです。

2つの日付の差を求める¶

未来の時間を計算するだけでなく、2つの日付の間がどれくらい離れているかを知りたい場面もあります。例えば、期限まであと何日あるかを表示するようなケースです。

この場合、単にdatetimeオブジェクト同士を引き算するだけで、結果としてtimedeltaが得られます。日常の算数と同じ感覚で扱えるのが、Pythonらしくて素晴らしい点ですね。

# 期限の日付
deadline = datetime(2026, 12, 31)

# 現在との差を求める
diff = deadline - now

print(f"残り時間は {diff.days} 日です")

このように、.daysという属性を使えば、日数の部分だけを簡単に取り出すことができます。実務では、ユーザーの会員期限のチェックや、記事の投稿日からの経過時間の表示によく使われます。

文字列と日付を変換する：相互変換のルール¶

プログラムを組んでいると、日付をそのまま扱うだけでなく、文字列として表示したいことがよくあります。あるいは、ユーザーが入力した文字列を日付オブジェクトに変換したいこともあるでしょう。

ここで登場するのが、初心者の方が最も呪文のように感じるstrftimeとstrptimeです。名前が似ているので混乱しがちですが、役割は明確に分かれています。

strftime: 日付オブジェクトを文字列に変換する（Formatting）
strptime: 文字列を日付オブジェクトに変換する（Parsing）

これらを使い分ける際に必要になるのが、%Yや%mといった書式化コードです。よく使うコードを以下の表にまとめました。

よく使う書式化コード一覧¶

コード	意味	例
%Y	西暦4桁	2026
%y	西暦の下2桁	26
%m	月（0埋め）	04
%d	日（0埋め）	24
%H	時（24時間表記）	16
%M	分	56
%S	秒	47
%A	曜日（フルネーム）	Friday

これらを組み合わせることで、どんな形式の文字列でも自由自在に作り出すことができます。実際の変換例を見て、感覚を掴んでみましょう。

# オブジェクトを文字列にする例（strftime）
now = datetime.now()
formatted_time = now.strftime("%Y年%m月%d日 %H時%M分")
print(formatted_time) # 2026年04月24日 16時56分

# 文字列をオブジェクトにする例（strptime）
date_str = "2026-04-24"
parsed_date = datetime.strptime(date_str, "%Y-%m-%d")
print(parsed_date)

エンジニア歴10年の私でも、これらの記号をすべて暗記しているわけではありません。必要になるたびにリファレンスを確認したり、AIに聞いたりして、間違えないようにしています。

特に大文字のMは分（Minute）で小文字のmは月（month）といった区別は間違いやすいポイントです。

タイムゾーンの壁を乗り越える：現代の正解¶

Pythonの日付操作において、最も多くの初心者が挫折し、かつベテランも頭を抱えるのがタイムゾーンです。実は、これまでのコードで扱ってきたdatetimeには、タイムゾーンの情報が含まれていません。

タイムゾーン情報を持たないオブジェクトをnaive（ナイーブ）と呼び、持っているものをaware（アウェア）と呼びます。グローバルなサービスを作る場合、サーバーがどの国の時間で動いているかを意識しなければなりません。

かつてはpytzという外部ライブラリを使うのが一般的でしたが、今のPythonにはより良い方法があります。 Python 3.9から導入されたzoneinfoモジュールを使うのが、2026年現在のベストプラクティスです。

日本標準時（JST）を扱う方法¶

日本の時刻を正確に取得するには、まずJST（Asia/Tokyo）の時間を使うことを明示する必要があります。これを行うことで、夏時間のある国とのやり取りでもバグが発生しにくくなります。

from datetime import datetime
from zoneinfo import ZoneInfo

# 日本の現在時刻を取得
tokyo_now = datetime.now(ZoneInfo("Asia/Tokyo"))
print(tokyo_now)

# ニューヨークの現在時刻を取得
ny_now = datetime.now(ZoneInfo("America/New_York"))
print(ny_now)

このようにZoneInfoを指定するだけで、自動的に適切な時差が適用された時間を取得できます。これさえ知っていれば、もう時間が9時間ズレている！とパニックになることはありません。

ちなみに、データベースにはUTC（世界協定時）で保存し、表示するときにユーザーの地域の時間に変えるのが定石です。世界中のエンジニアが辿り着いた、最もトラブルが少ない運用方法なので、ぜひ覚えておいてください。

現場で役立つ！10年選手が教える実践テクニック¶

ここまで基本的な使い方を解説してきましたが、実際の開発現場ではさらなる工夫が求められます。私がこれまでのキャリアで学んだ、実務をスムーズにするためのヒントをいくつか共有しますね。

まず一つ目は、ISO 8601形式という世界標準のフォーマットを積極的に活用することです。 2026-04-24T16:56:47+09:00のような形式を見たことはありませんか。

この形式は、多くのWebシステムやAPIで標準的に採用されています。 Pythonなら.isoformat()メソッドを呼ぶだけで簡単に作成でき、読み込みも.fromisoformat()で一発です。

# 世界標準の形式で出力
iso_str = tokyo_now.isoformat()
print(iso_str)

# 読み込みも簡単
restored_date = datetime.fromisoformat(iso_str)

二つ目は、比較の際の注意点です。タイムゾーンがあるオブジェクト（aware）と、ないオブジェクト（naive）を直接比較すると、Pythonはエラーを出します。

混ぜるな危険と覚えておきましょう。必ずどちらかに統一してから比較を行うことが、予期せぬエラーを防ぐ最大のコツです。

三つ目は、コードの可読性を高めるために型ヒントを活用することです。関数が日付を受け取るのか、あるいは文字列を受け取るのかを明示するだけで、コードの質がグッと上がります。

AI時代のdatetime活用術¶

2026年の今、AIを活用してコードを書くのが当たり前の時代になりました。 CursorやChatGPTを使えば、複雑な日付計算のロジックも一瞬で提案してくれます。

しかし、AIが生成したコードが常に正しいとは限りません。特にタイムゾーンの扱いや、特定のライブラリに依存した古い記述が混ざることもあります。

だからこそ、この記事で学んだような基礎知識という審美眼が重要になります。 AIが書いたコードに対して、ここではzoneinfoを使おうと指摘できるエンジニアこそが、今求められている存在です。

道具は便利になりましたが、最終的な責任を持つのは私たち人間です。基礎をしっかり固めた上で、AIという強力なパートナーを使いこなしていきましょう。

まとめ：時間を味方につけるために¶

今回はPythonのdatetimeモジュールについて、基礎から実践的なテクニックまで幅広く解説しました。最後に、この記事のポイントを振り返ってみましょう。

日付操作の基本はdatetimeクラスであり、期間はtimedeltaで表す。
文字列への変換はstrftime、文字列からの変換はstrptimeを使う。
タイムゾーンはzoneinfoを使い、常にawareな状態を意識する。
実務ではISO 8601形式を基準にするとトラブルが少ない。

最初は記号やクラス名の多さに戸惑うかもしれませんが、何度も使っているうちに自然と指が動くようになります。日付が自由に操れるようになると、作れるアプリケーションの幅がぐんと広がりますよ。

まずは今日の日付を表示するだけの、小さなプログラムから書いてみてください。その一歩が、あなたのエンジニアとしての未来を大きく変えるはずです。

ここまでお読みいただきありがとうございました！

#python #学習

メニュー