MENU
  1. ホーム
  2. Python
  3. 文字列
  4. [Python] 日付の文字列をUTC基準でdatetimeに変換する方法

[Python] 日付の文字列をUTC基準でdatetimeに変換する方法

Pythonで日付の文字列をUTC基準でdatetimeオブジェクトに変換するには、datetimeモジュールとpytzライブラリ、またはzoneinfoモジュールを使用します。

まず、strptime関数で文字列をdatetimeオブジェクトに変換し、その後pytzのutcやzoneinfoのZoneInfo('UTC')を使ってUTCタイムゾーンに設定します。

Python 3.9以降ではzoneinfoが標準ライブラリに含まれているため、追加のインストールは不要です。

この記事でわかること
  • 日付の文字列をdatetimeに変換する方法
  • UTC基準での日時の扱い方
  • pytzとzoneinfoの使い方の違い
  • タイムゾーンを考慮した計算方法
  • 日付フォーマットの変更方法

目次から探す

日付の文字列をdatetimeに変換する方法

Pythonでは、日付の文字列をdatetimeオブジェクトに変換するために、主にdatetimeモジュールのstrptime関数を使用します。

この関数を使うことで、特定のフォーマットに従った文字列をdatetime型に変換することができます。

strptime関数の使い方

strptime関数は、文字列を指定したフォーマットに基づいてdatetimeオブジェクトに変換します。

基本的な構文は以下の通りです。

from datetime import datetime
# 文字列をdatetimeに変換
date_string = "2023-10-01 12:30:00"
date_format = "%Y-%m-%d %H:%M:%S"
date_object = datetime.strptime(date_string, date_format)
print(date_object)
2023-10-01 12:30:00

日付フォーマットの指定方法

strptime関数では、日付フォーマットを指定するために、特定の記号を使用します。

以下は、一般的に使用されるフォーマット指定子の一覧です。

スクロールできます
指定子説明例
%Y年(4桁)2023
%m月(01-12)10
%d日(01-31)01
%H時(00-23)12
%M分(00-59)30
%S秒(00-59)00

これらの指定子を組み合わせることで、さまざまな日付フォーマットを表現できます。

例：日付文字列をdatetimeに変換する

以下は、異なるフォーマットの日付文字列をdatetimeに変換する例です。

from datetime import datetime
# 異なるフォーマットの日付文字列
date_string1 = "2023/10/01"
date_string2 = "01-10-2023 15:45"
# フォーマットの指定
date_format1 = "%Y/%m/%d"
date_format2 = "%d-%m-%Y %H:%M"
# 変換
date_object1 = datetime.strptime(date_string1, date_format1)
date_object2 = datetime.strptime(date_string2, date_format2)
print(date_object1)
print(date_object2)
2023-10-01 00:00:00
2023-10-01 15:45:00

このように、strptime関数を使うことで、さまざまな形式の日付文字列を簡単にdatetimeオブジェクトに変換することができます。

UTC基準でのdatetime変換

日付や時間を扱う際、異なるタイムゾーンを考慮することが重要です。

特に、協定世界時(UTC)は、国際的な標準時間として広く使用されています。

ここでは、UTC基準でのdatetime変換について解説します。

UTCとは？(協定世界時の概要)

UTC(Coordinated Universal Time)は、世界中の標準時間の基準となる時間です。

UTCは、地球の自転に基づく時間であり、タイムゾーンの基準として使用されます。

UTCは、夏時間(DST)を考慮せず、常に一定の時間を保ちます。

これにより、異なる地域間での時間の調整が容易になります。

pytzライブラリを使ったUTC変換

pytzライブラリを使用すると、タイムゾーンを考慮した日付の操作が簡単に行えます。

以下は、pytzを使ってUTCに変換する方法です。

from datetime import datetime
import pytz
# 現在のローカル時間を取得
local_time = datetime.now()
# UTCタイムゾーンを取得
utc_timezone = pytz.utc
# ローカル時間をUTCに変換
utc_time = local_time.astimezone(utc_timezone)
print("ローカル時間:", local_time)
print("UTC時間:", utc_time)

このコードを実行すると、ローカル時間とUTC時間が表示されます。

ローカル時間: 2023-10-01 12:30:00.123456
UTC時間: 2023-10-01 03:30:00.123456+00:00

zoneinfoモジュールを使ったUTC変換(Python 3.9以降)

Python 3.9以降では、zoneinfoモジュールが標準ライブラリに追加され、タイムゾーンの操作がさらに簡単になりました。

以下は、zoneinfoを使ってUTCに変換する方法です。

from datetime import datetime
from zoneinfo import ZoneInfo
# 現在のローカル時間を取得
local_time = datetime.now()
# UTCタイムゾーンを指定
utc_timezone = ZoneInfo("UTC")
# ローカル時間をUTCに変換
utc_time = local_time.astimezone(utc_timezone)
print("ローカル時間:", local_time)
print("UTC時間:", utc_time)

このコードを実行すると、pytzを使用した場合と同様に、ローカル時間とUTC時間が表示されます。

ローカル時間: 2023-10-01 12:30:00.123456
UTC時間: 2023-10-01 03:30:00.123456+00:00

UTC変換の具体例

以下は、特定のローカル時間をUTCに変換する具体例です。

ここでは、pytzとzoneinfoの両方を使用した例を示します。

pytzを使用した例

from datetime import datetime
import pytz
# 特定のローカル時間を指定
local_time = datetime(2023, 10, 1, 12, 30, 0)
# UTCタイムゾーンを取得
utc_timezone = pytz.utc
# ローカル時間をUTCに変換
utc_time = local_time.astimezone(utc_timezone)
print("指定したローカル時間:", local_time)
print("UTC時間:", utc_time)

zoneinfoを使用した例

from datetime import datetime
from zoneinfo import ZoneInfo
# 特定のローカル時間を指定
local_time = datetime(2023, 10, 1, 12, 30, 0)
# UTCタイムゾーンを指定
utc_timezone = ZoneInfo("UTC")
# ローカル時間をUTCに変換
utc_time = local_time.astimezone(utc_timezone)
print("指定したローカル時間:", local_time)
print("UTC時間:", utc_time)

これらのコードを実行すると、指定したローカル時間とそのUTC時間が表示されます。

これにより、異なるタイムゾーン間での時間の変換が容易に行えることがわかります。

pytzライブラリを使ったタイムゾーン操作

pytzライブラリは、Pythonでタイムゾーンを扱うための強力なツールです。

これを使用することで、異なるタイムゾーン間での日時の変換や、タイムゾーンを考慮した日付の比較が簡単に行えます。

pytzのインストール方法

pytzライブラリは、Pythonのパッケージ管理ツールであるpipを使用して簡単にインストールできます。

以下のコマンドを実行してください。

pip install pytz

これにより、pytzライブラリがインストールされ、Pythonプログラムで使用できるようになります。

pytzでのタイムゾーン設定

pytzを使用してタイムゾーンを設定する方法は非常にシンプルです。

以下の例では、特定のタイムゾーンを設定し、そのタイムゾーンに基づいた日時を作成します。

from datetime import datetime
import pytz
# タイムゾーンを設定(例：日本標準時)
japan_timezone = pytz.timezone("Asia/Tokyo")
# 現在の日本時間を取得
japan_time = datetime.now(japan_timezone)
print("日本時間:", japan_time)

このコードを実行すると、日本標準時に基づいた現在の日時が表示されます。

日本時間: 2023-10-01 21:30:00.123456+09:00

UTC以外のタイムゾーンへの変換

pytzを使用すると、UTC以外のタイムゾーンへの変換も簡単に行えます。

以下の例では、UTCから日本標準時(JST)への変換を示します。

from datetime import datetime
import pytz
# UTC時間を指定
utc_time = datetime(2023, 10, 1, 12, 0, 0, tzinfo=pytz.utc)
# 日本標準時に変換
japan_timezone = pytz.timezone("Asia/Tokyo")
japan_time = utc_time.astimezone(japan_timezone)
print("UTC時間:", utc_time)
print("日本時間:", japan_time)

このコードを実行すると、UTC時間と日本時間が表示されます。

UTC時間: 2023-10-01 12:00:00+00:00
日本時間: 2023-10-01 21:00:00+09:00

pytzを使った日付の比較

pytzを使用すると、異なるタイムゾーンの日時を比較することもできます。

以下の例では、異なるタイムゾーンの日時を比較して、どちらが早いかを判断します。

from datetime import datetime
import pytz
# UTC時間を指定
utc_time = datetime(2023, 10, 1, 12, 0, 0, tzinfo=pytz.utc)
# 日本標準時に変換
japan_timezone = pytz.timezone("Asia/Tokyo")
japan_time = utc_time.astimezone(japan_timezone)
# 比較
if utc_time < japan_time:
    print("UTC時間は日本時間よりも早いです。")
elif utc_time > japan_time:
    print("UTC時間は日本時間よりも遅いです。")
else:
    print("UTC時間と日本時間は同じです。")

このコードを実行すると、UTC時間が日本時間よりも早いことが示されます。

UTC時間は日本時間よりも早いです。

このように、pytzライブラリを使用することで、タイムゾーンの設定や変換、日付の比較が簡単に行えることがわかります。

zoneinfoモジュールを使ったタイムゾーン操作

Python 3.9以降、zoneinfoモジュールが標準ライブラリに追加され、タイムゾーンの操作がより簡単になりました。

このモジュールを使用することで、タイムゾーンを考慮した日時の操作が容易に行えます。

zoneinfoモジュールの概要

zoneinfoモジュールは、IANAタイムゾーンデータベースに基づいて、タイムゾーンを扱うためのクラスを提供します。

これにより、異なるタイムゾーンの日時を簡単に作成、変換、比較することができます。

zoneinfoは、特にpytzライブラリを使用せずに、標準ライブラリだけでタイムゾーンを扱いたい場合に便利です。

ZoneInfoクラスの使い方

zoneinfoモジュールの中心となるクラスはZoneInfoです。

このクラスを使用して、特定のタイムゾーンを指定し、そのタイムゾーンに基づいた日時を作成します。

以下は、ZoneInfoクラスの基本的な使い方の例です。

from datetime import datetime
from zoneinfo import ZoneInfo
# タイムゾーンを設定(例：日本標準時)
japan_timezone = ZoneInfo("Asia/Tokyo")
# 現在の日本時間を取得
japan_time = datetime.now(tz=japan_timezone)
print("日本時間:", japan_time)

このコードを実行すると、日本標準時に基づいた現在の日時が表示されます。

日本時間: 2023-10-01 21:30:00.123456+09:00

UTC以外のタイムゾーンへの変換

zoneinfoを使用すると、UTC以外のタイムゾーンへの変換も簡単に行えます。

以下の例では、UTCから日本標準時(JST)への変換を示します。

from datetime import datetime
from zoneinfo import ZoneInfo
# UTC時間を指定
utc_time = datetime(2023, 10, 1, 12, 0, 0, tzinfo=ZoneInfo("UTC"))
# 日本標準時に変換
japan_timezone = ZoneInfo("Asia/Tokyo")
japan_time = utc_time.astimezone(japan_timezone)
print("UTC時間:", utc_time)
print("日本時間:", japan_time)

このコードを実行すると、UTC時間と日本時間が表示されます。

UTC時間: 2023-10-01 12:00:00+00:00
日本時間: 2023-10-01 21:00:00+09:00

zoneinfoを使った日付の比較

zoneinfoを使用すると、異なるタイムゾーンの日時を比較することもできます。

以下の例では、異なるタイムゾーンの日時を比較して、どちらが早いかを判断します。

from datetime import datetime
from zoneinfo import ZoneInfo
# UTC時間を指定
utc_time = datetime(2023, 10, 1, 12, 0, 0, tzinfo=ZoneInfo("UTC"))
# 日本標準時に変換
japan_timezone = ZoneInfo("Asia/Tokyo")
japan_time = utc_time.astimezone(japan_timezone)
# 比較
if utc_time < japan_time:
    print("UTC時間は日本時間よりも早いです。")
elif utc_time > japan_time:
    print("UTC時間は日本時間よりも遅いです。")
else:
    print("UTC時間と日本時間は同じです。")

このコードを実行すると、UTC時間が日本時間よりも早いことが示されます。

UTC時間は日本時間よりも早いです。

このように、zoneinfoモジュールを使用することで、タイムゾーンの設定や変換、日付の比較が簡単に行えることがわかります。

応用例：日付の文字列を他のタイムゾーンに変換

日付の文字列を異なるタイムゾーンに変換することは、国際的なアプリケーションやシステムで非常に重要です。

ここでは、具体的な例を通じて、日付の文字列を日本標準時(JST)や米国東部標準時(EST)に変換する方法を解説します。

JST(日本標準時)への変換

日本標準時(JST)への変換は、pytzやzoneinfoを使用して簡単に行えます。

以下は、UTCからJSTに変換する例です。

from datetime import datetime
import pytz
# UTC時間を指定
utc_time = datetime(2023, 10, 1, 12, 0, 0, tzinfo=pytz.utc)
# 日本標準時に変換
japan_timezone = pytz.timezone("Asia/Tokyo")
japan_time = utc_time.astimezone(japan_timezone)
print("UTC時間:", utc_time)
print("日本標準時:", japan_time)

このコードを実行すると、UTC時間と日本標準時が表示されます。

UTC時間: 2023-10-01 12:00:00+00:00
日本標準時: 2023-10-01 21:00:00+09:00

EST(米国東部標準時)への変換

米国東部標準時(EST)への変換も同様に行えます。

以下は、UTCからESTに変換する例です。

from datetime import datetime
import pytz
# UTC時間を指定
utc_time = datetime(2023, 10, 1, 12, 0, 0, tzinfo=pytz.utc)
# 米国東部標準時に変換
est_timezone = pytz.timezone("America/New_York")
est_time = utc_time.astimezone(est_timezone)
print("UTC時間:", utc_time)
print("米国東部標準時:", est_time)

このコードを実行すると、UTC時間とESTが表示されます。

UTC時間: 2023-10-01 12:00:00+00:00
米国東部標準時: 2023-10-01 08:00:00-04:00

タイムゾーンを考慮した日付の計算

タイムゾーンを考慮した日付の計算も可能です。

以下の例では、JSTの日時に1日を加算する方法を示します。

from datetime import datetime, timedelta
import pytz
# 日本標準時を設定
japan_timezone = pytz.timezone("Asia/Tokyo")
# 現在の日本時間を取得
japan_time = datetime.now(japan_timezone)
# 1日を加算
new_japan_time = japan_time + timedelta(days=1)
print("現在の日本時間:", japan_time)
print("1日後の日本時間:", new_japan_time)

このコードを実行すると、現在の日本時間と1日後の日本時間が表示されます。

現在の日本時間: 2023-10-01 21:30:00.123456+09:00
1日後の日本時間: 2023-10-02 21:30:00.123456+09:00

日付のフォーマットを変更して出力する方法

日付のフォーマットを変更して出力することも可能です。

以下の例では、JSTの日時を特定のフォーマットで表示します。

from datetime import datetime
import pytz
# 日本標準時を設定
japan_timezone = pytz.timezone("Asia/Tokyo")
# 現在の日本時間を取得
japan_time = datetime.now(japan_timezone)
# 日付のフォーマットを変更
formatted_date = japan_time.strftime("%Y年%m月%d日 %H時%M分")
print("フォーマット変更後の日本時間:", formatted_date)

このコードを実行すると、フォーマットを変更した日本時間が表示されます。

フォーマット変更後の日本時間: 2023年10月01日 21時30分

このように、日付の文字列を他のタイムゾーンに変換する方法や、タイムゾーンを考慮した日付の計算、フォーマットの変更が簡単に行えることがわかります。

よくある質問

pytzとzoneinfoの違いは何ですか？

pytzとzoneinfoはどちらもPythonでタイムゾーンを扱うためのライブラリですが、いくつかの違いがあります。

  • 依存関係: pytzは外部ライブラリであり、インストールが必要です。

一方、zoneinfoはPython 3.9以降の標準ライブラリに含まれているため、追加のインストールは不要です。

  • 使用方法: pytzでは、タイムゾーンを設定する際にlocalizeメソッドを使用する必要がありますが、zoneinfoではZoneInfoクラスを直接使用してタイムゾーンを指定できます。
  • タイムゾーンデータ: pytzはIANAタイムゾーンデータベースを使用していますが、zoneinfoも同様にIANAデータベースを使用しており、最新のタイムゾーン情報を提供します。

UTCとローカルタイムの違いは何ですか？

UTC(協定世界時)とローカルタイムは、時間の表現方法において異なります。

  • UTC: 世界中の標準時間の基準であり、夏時間(DST)を考慮せず、常に一定の時間を保ちます。

UTCは、国際的な通信やデータ処理において広く使用されます。

  • ローカルタイム: 各地域や国における標準時間であり、UTCからのオフセット(±時間)を持ちます。

ローカルタイムは、夏時間を考慮する場合もあり、地域によって異なる時間帯が存在します。

例えば、日本標準時(JST)はUTC+9時間であり、米国東部標準時(EST)はUTC-5時間です。

日付の文字列が不正な場合、どう処理すればいいですか？

日付の文字列が不正な場合、strptime関数を使用するとValueErrorが発生します。

このエラーを適切に処理するためには、例外処理を使用することが推奨されます。

以下は、日付の文字列が不正な場合の処理方法の例です。

from datetime import datetime
date_string = "2023-10-32"  # 不正な日付
try:
    date_object = datetime.strptime(date_string, "%Y-%m-%d")
    print("変換成功:", date_object)
except ValueError as e:
    print("エラー:", e)

このコードを実行すると、以下のようなエラーメッセージが表示されます。

エラー: day is out of range for month

このように、例外処理を使用することで、不正な日付の文字列に対して適切なエラーメッセージを表示し、プログラムがクラッシュするのを防ぐことができます。

まとめ

この記事では、Pythonを使用して日付の文字列をUTC基準でdatetimeに変換する方法や、タイムゾーンを考慮した日付の操作について詳しく解説しました。

特に、pytzやzoneinfoを利用したタイムゾーンの設定や変換、日付の計算方法について具体的な例を通じて説明しました。

これらの知識を活用して、実際のアプリケーションやシステムでの日時管理をより効率的に行うことができるでしょう。

今後は、実際のプロジェクトでこれらの技術を試し、タイムゾーンを意識したプログラミングを実践してみてください。

目次に戻る

当サイトはリンクフリーです。出典元を明記していただければ、ご自由に引用していただいて構いません。

C言語
C++
Python
HTML
Java
HTTP

関連カテゴリーから探す

文字列
  • URLをコピーしました！

関連記事

目次から探す