日時

[Python] 日付(年月日)をdatetimeで扱う方法

2025-01-18更新日: 2025-01-18

Pythonで日付を扱う際、標準ライブラリのdatetimeモジュールが便利です。

datetimeクラスを使用することで、年、月、日を指定して日付オブジェクトを作成できます。

例えば、datetime.datetime(2023, 10, 5)とすることで、2023年10月5日を表すdatetimeオブジェクトが生成されます。

このオブジェクトは、日付の計算やフォーマットの変換など、さまざまな操作に利用できます。

また、dateクラスを使うと、時間情報を含まない日付のみのオブジェクトを作成することも可能です。

目次から探す

datetimeオブジェクトの生成

Pythonのdatetimeモジュールを使用すると、日付や時刻を簡単に扱うことができます。

ここでは、datetimeオブジェクトの生成方法について詳しく解説します。

現在の日付と時刻を取得する

現在の日付と時刻を取得するには、datetimeモジュールのdatetime.now()メソッドを使用します。

from datetime import datetime
# 現在の日付と時刻を取得
current_datetime = datetime.now()
print("現在の日付と時刻:", current_datetime)

現在の日付と時刻: 2023-10-05 14:23:45.678901

このコードは、現在のシステム時刻に基づいてdatetimeオブジェクトを生成し、コンソールに出力します。

特定の日付を指定して生成する

特定の日付を指定してdatetimeオブジェクトを生成するには、datetimeコンストラクタを使用します。

from datetime import datetime
# 特定の日付を指定して生成
specific_date = datetime(2023, 10, 5)
print("特定の日付:", specific_date)

特定の日付: 2023-10-05 00:00:00

このコードは、指定した年月日を持つdatetimeオブジェクトを生成します。

時刻が指定されていない場合、デフォルトで00:00:00が設定されます。

文字列からdatetimeオブジェクトを生成する

文字列からdatetimeオブジェクトを生成するには、datetime.strptime()メソッドを使用します。

このメソッドは、指定したフォーマットに従って文字列を解析します。

from datetime import datetime
# 文字列からdatetimeオブジェクトを生成
date_string = "2023-10-05 14:23:45"
date_object = datetime.strptime(date_string, "%Y-%m-%d %H:%M:%S")
print("文字列から生成した日付:", date_object)

文字列から生成した日付: 2023-10-05 14:23:45

このコードは、指定されたフォーマットに基づいて文字列を解析し、datetimeオブジェクトを生成します。

タイムゾーンを考慮したdatetimeオブジェクトの生成

タイムゾーンを考慮したdatetimeオブジェクトを生成するには、pytzライブラリを使用します。

pytzを使用すると、タイムゾーン情報を持つdatetimeオブジェクトを生成できます。

from datetime import datetime
import pytz
# タイムゾーンを考慮したdatetimeオブジェクトを生成
timezone = pytz.timezone('Asia/Tokyo')
timezone_aware_datetime = datetime.now(timezone)
print("タイムゾーンを考慮した日付と時刻:", timezone_aware_datetime)

タイムゾーンを考慮した日付と時刻: 2023-10-05 14:23:45.678901+09:00

このコードは、指定したタイムゾーンに基づいて現在の日時を取得し、タイムゾーン情報を持つdatetimeオブジェクトを生成します。

pytzライブラリを使用することで、異なるタイムゾーンの日時を簡単に扱うことができます。

datetimeオブジェクトの操作

datetimeオブジェクトを使用すると、日付や時刻の操作が簡単に行えます。

ここでは、datetimeオブジェクトを使った基本的な操作方法について解説します。

日付や時刻の加算と減算

日付や時刻の加算と減算には、timedeltaオブジェクトを使用します。

timedeltaは、日数や秒数を表現するためのオブジェクトです。

from datetime import datetime, timedelta
# 現在の日付と時刻を取得
current_datetime = datetime.now()
# 5日後の日付を計算
future_date = current_datetime + timedelta(days=5)
print("5日後の日付:", future_date)
# 3時間前の時刻を計算
past_time = current_datetime - timedelta(hours=3)
print("3時間前の時刻:", past_time)

5日後の日付: 2023-10-10 14:23:45.678901
3時間前の時刻: 2023-10-05 11:23:45.678901

このコードは、現在の日時に対して日数や時間を加算・減算し、新しいdatetimeオブジェクトを生成します。

日付の差を計算する

2つのdatetimeオブジェクト間の日付の差を計算するには、単純に引き算を行います。

結果はtimedeltaオブジェクトとして返されます。

from datetime import datetime
# 2つの日付を指定
date1 = datetime(2023, 10, 5)
date2 = datetime(2023, 9, 25)
# 日付の差を計算
difference = date1 - date2
print("日付の差:", difference.days, "日")

日付の差: 10 日

このコードは、2つの日付の差を計算し、日数として出力します。

曜日や月の名前を取得する

datetimeオブジェクトから曜日や月の名前を取得するには、strftimeメソッドを使用します。

from datetime import datetime
# 現在の日付を取得
current_date = datetime.now()
# 曜日と月の名前を取得
weekday_name = current_date.strftime("%A")
month_name = current_date.strftime("%B")
print("曜日:", weekday_name)
print("月の名前:", month_name)

曜日: Thursday
月の名前: October

このコードは、現在の日付から曜日と月の名前を文字列として取得します。

datetimeオブジェクトの属性を取得する

datetimeオブジェクトの各属性(年、月、日、時、分、秒)を取得するには、対応する属性を参照します。

from datetime import datetime
# 現在の日付と時刻を取得
current_datetime = datetime.now()
# 各属性を取得
year = current_datetime.year
month = current_datetime.month
day = current_datetime.day
hour = current_datetime.hour
minute = current_datetime.minute
second = current_datetime.second
print("年:", year)
print("月:", month)
print("日:", day)
print("時:", hour)
print("分:", minute)
print("秒:", second)

年: 2024
月: 8
日: 10
時: 0
分: 50
秒: 13

このコードは、datetimeオブジェクトから各属性を取得し、それぞれの値を出力します。

datetimeオブジェクトのフォーマット

datetimeオブジェクトは、さまざまなフォーマットで文字列に変換したり、文字列から生成したりすることができます。

ここでは、datetimeオブジェクトのフォーマットに関する基本的な操作方法を解説します。

datetimeオブジェクトを文字列に変換する

datetimeオブジェクトを文字列に変換するには、strftimeメソッドを使用します。

このメソッドは、指定したフォーマットに従ってdatetimeオブジェクトを文字列に変換します。

from datetime import datetime
# 現在の日付と時刻を取得
current_datetime = datetime.now()
# datetimeオブジェクトを文字列に変換
formatted_string = current_datetime.strftime("%Y-%m-%d %H:%M:%S")
print("フォーマットされた日付と時刻:", formatted_string)

フォーマットされた日付と時刻: 2024-08-10 00:50:22

このコードは、datetimeオブジェクトを指定したフォーマットで文字列に変換し、出力します。

strftimeメソッドの使い方

strftimeメソッドは、さまざまなフォーマットコードを使用してdatetimeオブジェクトを文字列に変換します。

以下は、よく使用されるフォーマットコードの一覧です。

フォーマットコード	説明
`%Y`	4桁の年
`%m`	2桁の月
`%d`	2桁の日
`%H`	2桁の時(24時間)
`%M`	2桁の分
`%S`	2桁の秒
`%A`	曜日名
`%B`	月名

例として、異なるフォーマットで日付を表示するコードを示します。

from datetime import datetime
# 現在の日付と時刻を取得
current_datetime = datetime.now()
# 異なるフォーマットで表示
formatted_date1 = current_datetime.strftime("%Y/%m/%d")
formatted_date2 = current_datetime.strftime("%A, %B %d, %Y")
print("フォーマット1:", formatted_date1)
print("フォーマット2:", formatted_date2)

フォーマット1: 2024/08/10
フォーマット2: Saturday, August 10, 2024

文字列からdatetimeオブジェクトに変換する

文字列からdatetimeオブジェクトに変換するには、strptimeメソッドを使用します。

このメソッドは、指定したフォーマットに従って文字列を解析し、datetimeオブジェクトを生成します。

from datetime import datetime
# 文字列からdatetimeオブジェクトに変換
date_string = "2023-10-05 14:23:45"
date_object = datetime.strptime(date_string, "%Y-%m-%d %H:%M:%S")
print("文字列から生成したdatetimeオブジェクト:", date_object)

文字列から生成したdatetimeオブジェクト: 2023-10-05 14:23:45

このコードは、指定されたフォーマットに基づいて文字列を解析し、datetimeオブジェクトを生成します。

strptimeメソッドの使い方

strptimeメソッドは、strftimeと同様にフォーマットコードを使用して文字列を解析します。

以下は、strptimeメソッドの使用例です。

from datetime import datetime
# 文字列からdatetimeオブジェクトに変換
date_string = "05/10/2023 14:23"
date_object = datetime.strptime(date_string, "%d/%m/%Y %H:%M")
print("文字列から生成したdatetimeオブジェクト:", date_object)

文字列から生成したdatetimeオブジェクト: 2023-10-05 14:23:00

このコードは、日付と時刻のフォーマットを指定して文字列を解析し、datetimeオブジェクトを生成します。

strptimeメソッドを使用することで、さまざまなフォーマットの文字列をdatetimeオブジェクトに変換できます。

応用例

datetimeモジュールを活用することで、日付に関するさまざまな応用的な操作を行うことができます。

ここでは、日付の範囲生成、リストのソート、フィルタリング、グルーピングについて解説します。

日付の範囲を生成する

日付の範囲を生成するには、timedeltaを使用してループを作成し、指定した範囲の日付をリストに追加します。

from datetime import datetime, timedelta
# 開始日と終了日を指定
start_date = datetime(2023, 10, 1)
end_date = datetime(2023, 10, 5)
# 日付の範囲を生成
date_range = []
current_date = start_date
while current_date <= end_date:
    date_range.append(current_date)
    current_date += timedelta(days=1)
# 日付の範囲を表示
for date in date_range:
    print(date.strftime("%Y-%m-%d"))

このコードは、指定した開始日から終了日までの日付をリストに追加し、出力します。

日付のリストをソートする

日付のリストをソートするには、Pythonの組み込み関数sorted()を使用します。

from datetime import datetime
# 日付のリストを作成
date_list = [
    datetime(2024, 10, 5),
    datetime(2024, 9, 25),
    datetime(2024, 10, 1)
]
# 日付のリストをソート
sorted_dates = sorted(date_list)
# ソートされた日付を表示
for date in sorted_dates:
    print(date.strftime("%Y-%m-%d"))

2024-09-25
2024-10-01
2024-10-05

このコードは、日付のリストを昇順にソートし、出力します。

日付のフィルタリングを行う

特定の条件に基づいて日付をフィルタリングするには、リスト内包表記を使用します。

from datetime import datetime
# 日付のリストを作成
date_list = [
    datetime(2024, 10, 5),
    datetime(2024, 9, 25),
    datetime(2024, 10, 1)
]
# 10月の日付のみをフィルタリング
october_dates = Sun, 03 Nov 2024 18:43:43 +0000
# フィルタリングされた日付を表示
for date in october_dates:
    print(date.strftime("%Y-%m-%d"))

2024-10-05
2024-10-01

このコードは、10月の日付のみをフィルタリングし、出力します。

日付のグルーピングを行う

日付を特定の単位でグルーピングするには、itertools.groupbyを使用します。

ここでは、日付を月ごとにグルーピングする例を示します。

from datetime import datetime
from itertools import groupby
# 日付のリストを作成
date_list = [
    datetime(2024, 10, 5),
    datetime(2024, 9, 25),
    datetime(2024, 10, 1),
    datetime(2024, 9, 30)
]
# 月ごとに日付をグルーピング
date_list.sort(key=lambda x: x.month)  # まず月でソート
grouped_dates = groupby(date_list, key=lambda x: x.month)
# グルーピングされた日付を表示
for month, dates in grouped_dates:
    print(f"月: {month}")
    for date in dates:
        print(f"  {date.strftime('%Y-%m-%d')}")

このコードは、日付を月ごとにグルーピングし、各グループの日付を出力します。

groupbyを使用する前に、リストをグループ化のキーでソートする必要があります。

まとめ

Pythonのdatetimeモジュールは、日付と時刻を扱うための強力なツールです。

この記事では、datetimeオブジェクトの生成、操作、フォーマット、応用例について詳しく解説しました。

これらの知識を活用することで、日付や時刻に関するさまざまなタスクを効率的に処理できるようになります。

ぜひ、実際のプロジェクトでこれらのテクニックを試してみてください。