Pythonで日付を扱う：datetime.date.__format__() メソッド完全解説

Python datetime.date.format() メソッド解説

datetime.date.__format__() メソッドは、date オブジェクトを指定された書式に従って文字列に変換します。これは、strftime() メソッドとほぼ同じ機能を提供しますが、より簡潔な構文で記述できます。

書式指定には、以下の文字列を使用できます。

これらの文字列を組み合わせて、さまざまな書式を指定できます。

例

from datetime import date

# 現在の日付を取得
today = date.today()

# 以下はすべて同じ文字列を出力します
print(today.__format__("%Y-%m-%d"))  # 出力: 2024-03-26
print(today.strftime("%Y-%m-%d"))  # 出力: 2024-03-26
print(f"{today:%Y-%m-%d}")  # 出力: 2024-03-26

補足

• 書式指定文字列の前に % を付けて、文字列をそのまま出力することもできます。

応用例

• 日付をファイル名に使用する場合
• 日付をログに出力する場合
• 日付をユーザーに表示する場合

datetime.date.format() メソッドのサンプルコード

書式指定文字列を使ったサンプル

from datetime import date

today = date.today()

# さまざまな書式で日付を出力
print(today.__format__("%Y年%m月%d日"))  # 出力: 2024年3月26日
print(today.__format__("%Y-%m-%d"))  # 出力: 2024-03-26
print(today.__format__("%a %b %d %Y"))  # 出力: 火 3月 26 2024
print(today.__format__("%A %B %d %Y"))  # 出力: 火曜日 3月 26 2024

f-文字列を使ったサンプル

from datetime import date

today = date.today()

# f-文字列で日付を出力
print(f"今日は {today:%Y年%m月%d日} です")  # 出力: 今日は 2024年3月26日 です
print(f"来週は {today + date(days=7):%Y-%m-%d}")  # 出力: 来週は 2024-04-02

日付をファイル名に使用

from datetime import date

today = date.today()

# 日付をファイル名に使用
filename = f"data_{today:%Y%m%d}.csv"

with open(filename, "w") as f:
    f.write("データ")

日付をログに出力

from datetime import date
import logging

logger = logging.getLogger(__name__)

today = date.today()

# 日付をログに出力
logger.info("処理を開始しました。 %s", today.__format__("%Y-%m-%d"))

# 処理

logger.info("処理を完了しました。 %s", today.__format__("%Y-%m-%d"))

日付をユーザーに表示

from datetime import date

today = date.today()

# 日付をユーザーに表示
print(f"本日の日付は {today:%Y年%m月%d日} です。")

# ユーザーの入力を受け付ける

# 処理

datetime.date オブジェクトを文字列に変換する他の方法

str() メソッド

from datetime import date

today = date.today()

# str() メソッドを使って日付を文字列に変換
str_today = str(today)

print(str_today)  # 出力: 2024-03-26

strftime() メソッド

from datetime import date

today = date.today()

# strftime() メソッドを使って日付を文字列に変換
formatted_today = today.strftime("%Y年%m月%d日")

print(formatted_today)  # 出力: 2024年3月26日

f-文字列

from datetime import date

today = date.today()

# f-文字列を使って日付を文字列に変換
message = f"今日は {today}"

print(message)  # 出力: 今日は 2024-03-26

• 簡潔な方法で日付を文字列に変換したい場合は、str() メソッドを使用します。
• より詳細な書式で日付を文字列に変換したい場合は、strftime() メソッドを使用します。
• 日付を他の文字列と組み合わせて出力したい場合は、f-文字列を使用します。

from datetime import date

def format_date(date_obj):
  """
  date オブジェクトを指定された書式で文字列に変換します。

  Args:
    date_obj: datetime.date オブジェクト

  Returns:
    書式化された文字列
  """
  return f"{date_obj.year}年{date_obj.month}月{date_obj.day}日"

today = date.today()

# 自作の関数を使って日付を文字列に変換
formatted_today = format_date(today)

print(formatted_today)  # 出力: 2024年3月26日

自作の関数を使う方法は、より柔軟な書式で日付を文字列に変換したい場合に便利です。

datetime.date オブジェクトを文字列に変換するには、さまざまな方法があります。どの方法を使用するかは、状況によって異なります。