datetime.datetime.combine()：Pythonで日付と時刻を組み合わせてdatetimeオブジェクトを作成する

Python Data Types: datetime.datetime.combine() 完全解説

Pythonのdatetimeモジュールには、日付と時刻を扱うための様々なクラスと関数があります。その中でもdatetime.datetime.combine()は、日付と時刻を組み合わせてdatetimeオブジェクトを作成する便利な関数です。

datetime.datetime.combine()は、2つの引数を受け取り、それらを組み合わせて新しいdatetimeオブジェクトを作成します。

• 1つ目の引数はdate型またはdatetime型オブジェクトで、日付を表します。
• 2つ目の引数はtime型オブジェクトで、時刻を表します。

例：

from datetime import date, time, datetime

# 日付と時刻を個別に作成
date_obj = date(2024, 3, 30)
time_obj = time(10, 16)

# combine()を使って日付と時刻を組み合わせて新しいdatetimeオブジェクトを作成
datetime_obj = datetime.combine(date_obj, time_obj)

# 出力：2024-03-30 10:16:00
print(datetime_obj)

引数について

• date_obj:
  • date型またはdatetime型オブジェクト
  • 省略された場合は、現在の日のdateオブジェクトが使用されます。
• time_obj:
  • time型オブジェクト
  • 省略された場合は、time(0, 0, 0) (午前0時0分0秒) が使用されます。

tzinfo

datetime.datetime.combine()は、tzinfo属性も考慮します。

• 1つ目の引数 (date_obj) にtzinfo属性が設定されている場合、その値が新しいdatetimeオブジェクトのtzinfo属性に設定されます。
• 2つ目の引数 (time_obj) にtzinfo属性が設定されている場合、その値は無視されます。

例：

from datetime import date, time, datetime, timezone

# タイムゾーン情報付きの日付と時刻を作成
date_obj = date(2024, 3, 30, tzinfo=timezone.utc)
time_obj = time(10, 16, tzinfo=timezone.utc)

# combine()を使って日付と時刻を組み合わせて新しいdatetimeオブジェクトを作成
datetime_obj = datetime.combine(date_obj, time_obj)

# 出力：2024-03-30 10:16:00+00:00
print(datetime_obj)

datetime.datetime.combine()は、日付と時刻を組み合わせてdatetimeオブジェクトを作成する便利な関数です。引数やtzinfo属性の扱いについて理解することで、より柔軟に日付時刻を扱うことができます。

datetime.datetime.combine() サンプルコード集

基本的な使い方

from datetime import date, time, datetime

# 日付と時刻を個別に作成
date_obj = date(2024, 3, 30)
time_obj = time(10, 16)

# combine()を使って日付と時刻を組み合わせて新しいdatetimeオブジェクトを作成
datetime_obj = datetime.combine(date_obj, time_obj)

# 出力：2024-03-30 10:16:00
print(datetime_obj)

引数を省略する

from datetime import datetime

# combine()の引数を省略
datetime_obj = datetime.combine()

# 出力：2024-03-30 00:00:00
print(datetime_obj)

tzinfo属性を設定する

from datetime import date, time, datetime, timezone

# タイムゾーン情報付きの日付と時刻を作成
date_obj = date(2024, 3, 30, tzinfo=timezone.utc)
time_obj = time(10, 16, tzinfo=timezone.utc)

# combine()を使って日付と時刻を組み合わせて新しいdatetimeオブジェクトを作成
datetime_obj = datetime.combine(date_obj, time_obj)

# 出力：2024-03-30 10:16:00+00:00
print(datetime_obj)

文字列からdatetimeオブジェクトを作成

from datetime import datetime

# 文字列からdatetimeオブジェクトを作成
datetime_obj = datetime.strptime("2024-03-30 10:16:00", "%Y-%m-%d %H:%M:%S")

# 出力：2024-03-30 10:16:00
print(datetime_obj)

datetimeオブジェクトから日付と時刻を取得

from datetime import datetime

# datetimeオブジェクトから日付と時刻を取得
datetime_obj = datetime.combine(date(2024, 3, 30), time(10, 16))

# 日付を取得
date_obj = datetime_obj.date()

# 出力：2024-03-30
print(date_obj)

# 時刻を取得
time_obj = datetime_obj.time()

# 出力：10:16:00
print(time_obj)

datetimeオブジェクトの比較

from datetime import datetime

# datetimeオブジェクトを比較
datetime_obj1 = datetime.combine(date(2024, 3, 30), time(10, 16))
datetime_obj2 = datetime.combine(date(2024, 3, 30), time(10, 17))

# 比較結果：True
print(datetime_obj1 < datetime_obj2)

datetimeオブジェクトの加算減算

# datetimeオブジェクトにtimedeltaオブジェクトを加算
datetime_obj = datetime.combine(date(2024, 3, 30), time(10, 16))
timedelta_obj = timedelta(days=1)

datetime_obj2 = datetime_obj + timedelta_obj

# 出力：2024-03-31 10:16:00
print(datetime_obj2)

# datetimeオブジェクトからtimedeltaオブジェクトを減算
datetime_obj3 = datetime_obj - timedelta_obj

# 出力：2024-03-29 10:16:00
print(datetime_obj3)

datetime.datetime.combine() の代替方法

datetimeコンストラクタを使用する

from datetime import datetime

# datetimeコンストラクタを使って日付と時刻を直接指定
datetime_obj = datetime(2024, 3, 30, 10, 16)

# 出力：2024-03-30 10:16:00
print(datetime_obj)

strptime()を使用する

from datetime import datetime

# 文字列からdatetimeオブジェクトを作成
datetime_obj = datetime.strptime("2024-03-30 10:16:00", "%Y-%m-%d %H:%M:%S")

# 出力：2024-03-30 10:16:00
print(datetime_obj)

dateとtimeオブジェクトを組み合わせてreplace()を使用する

from datetime import date, time, datetime

# 日付と時刻を個別に作成
date_obj = date(2024, 3, 30)
time_obj = time(10, 16)

# datetimeオブジェクトを作成
datetime_obj = datetime.now()

# replace()を使ってdatetimeオブジェクトの日付と時刻を置き換える
datetime_obj = datetime_obj.replace(date=date_obj, time=time_obj)

# 出力：2024-03-30 10:16:00
print(datetime_obj)

これらの方法は、それぞれ異なる利点と欠点があります。

• datetimeコンストラクタ: 最も簡潔な方法ですが、引数の順番を間違えやすいという欠点があります。
• strptime(): 文字列からdatetimeオブジェクトを作成する必要がある場合に便利です。
• dateとtimeオブジェクトを組み合わせてreplace()を使用する: より柔軟な方法ですが、コードが冗長になるという欠点があります。

状況に応じて、最も適切な方法を選択してください。