Python の日時 (Datetime)

1. Python の日時 (Datetime)

Python において、日付（Date）そのものは独自のデータ型として定義されていません。しかし、datetime という名前のモジュール（Module）をインポートすることで、日付をオブジェクト（Object）として扱うことが可能になります。

1.1 datetime モジュールのインポート

datetime モジュールをインポートして、現在の日時を表示する例です。

import datetime

# 現在の日時を取得
x = datetime.datetime.now()
print(x)

2. 日時の出力 (Date Output)

上記のように日時を出力すると、年、月、日、時、分、秒、およびマイクロ秒が含まれた形で返されます。

datetime モジュールには、オブジェクトに関する情報を返すための多くのメソッドが用意されています。

2.1 特定の要素を抽出する例

「年」や「曜日」の名前を個別に取得するコードです。

import datetime

x = datetime.datetime.now()

# 年を表示
print(x.year)

# 曜日を表示（フルネーム）
print(x.strftime("%A"))

3. 日時オブジェクトの作成

日付オブジェクトを作成するには、datetime モジュールの datetime() クラス（コンストラクタ）を使用します。

datetime() クラスは、日付を作成するために「年、月、日」の 3 つのパラメータを必要とします。

3.1 日時指定のインスタンス化

特定の日付を指定してオブジェクトを作成する例です。

import datetime

# 2020年5月17日のオブジェクトを作成
x = datetime.datetime(2020, 5, 17)

print(x)

datetime() クラスは、時間とタイムゾーン（時、分、秒、マイクロ秒、tzone）のパラメータも受け取ることができますが、これらはオプションであり、デフォルト値は 0（タイムゾーンの場合は None）となっています。

4. strftime() メソッド

datetime オブジェクトには、日付オブジェクトを読み取り可能な文字列にフォーマット（整形）するためのメソッドが用意されています。それが strftime() メソッドです。

このメソッドは、返される文字列の形式を指定するための「フォーマット（Format）」という引数を一つ取ります。

4.1 strftime() の使用例

月の名前を表示する例です。

import datetime

x = datetime.datetime(2018, 6, 1)

# 月のフルネーム（June）を表示
print(x.strftime("%B"))

4.2 主要なフォーマットコード一覧

以下は、実務で頻繁に使用されるフォーマットコードのリストです。