日付と時刻 (datetime) | 生成AIxPythonで始める株式分析|Python×J-Quants

株価データはほぼ必ず日付と紐づきます。本記事では Python の標準ライブラリ datetime を使った、日付・期間・営業日まわりの基本処理を整理します。

3 つの主要クラス

datetime モジュールには、日付・時刻を表す 3 つの主要クラスがあります。

クラス	表すもの	例
`date`	日付(年月日)	2026-04-01
`time`	時刻(時分秒)	09:00:00
`datetime`	日付 + 時刻	2026-04-01 09:00:00

株価分析では date と datetime をよく使います。

今日の日付を取る

1
from datetime import date, datetime
2

3
print(date.today())         # 2026-05-11
4
print(datetime.now())       # 2026-05-11 14:30:45.123456

date.today() は時刻を含みません。日次の集計など「日付だけが欲しい」場面で使います。

文字列から日付を作る

CSV や JSON から読み込んだ日付は、最初は文字列です。strptime で日付型に変換します。

1
from datetime import datetime, date
2

3
s = "2026-04-01"
4
d = datetime.strptime(s, "%Y-%m-%d").date()
5
print(d)                     # 2026-04-01
6
print(type(d))               # <class 'datetime.date'>

ISO 8601 形式(YYYY-MM-DD)に限れば、date.fromisoformat のほうが簡潔です。

1
d = date.fromisoformat("2026-04-01")
2
print(d)                     # 2026-04-01

日付を文字列にする

逆方向は strftime または isoformat() です。

1
from datetime import date
2

3
d = date(2026, 4, 1)
4
print(d.isoformat())         # 2026-04-01
5
print(d.strftime("%Y/%m/%d"))    # 2026/04/01
6
print(d.strftime("%Y年%m月%d日"))  # 2026年04月01日

代表的な書式コードは次のとおりです。

書式	意味	例
`%Y`	西暦 4 桁	2026
`%m`	月(2 桁)	04
`%d`	日(2 桁)	01
`%H`	時(24 時間)	09
`%M`	分	30
`%S`	秒	00
`%a`	曜日(短縮)	Mon

日付の差を取る — timedelta

日付同士の差は timedelta 型になります。

1
from datetime import date, timedelta
2

3
start = date(2026, 4, 1)
4
end = date(2026, 4, 30)
5

6
diff = end - start
7
print(diff)                  # 29 days, 0:00:00
8
print(diff.days)             # 29

逆に「30 日後」「1 週間前」を計算するには timedelta を足します。

1
today = date(2026, 5, 11)
2
print(today + timedelta(days=30))   # 2026-06-10
3
print(today - timedelta(weeks=1))   # 2026-05-04

月や年の加算は注意

timedelta には「1 ヶ月」「1 年」という単位はありません。月をまたいだ計算は標準ライブラリだけだと面倒です。

1
from datetime import date
2

3
# 単純に「30 日後」は「1 ヶ月後」と同じではない
4
print(date(2026, 1, 31) + timedelta(days=30))   # 2026-03-02

正確な月単位の計算が必要なら、サードパーティの dateutil を使います(#3-12「pip と requirements.txt とパッケージ管理」で扱う pip でインストール)。

1
# pip install python-dateutil
2
from dateutil.relativedelta import relativedelta
3

4
print(date(2026, 1, 31) + relativedelta(months=1))   # 2026-02-28

営業日の扱い

株式市場は土日休みなので、営業日(weekday)の判定がよく必要になります。weekday() メソッドが曜日を返します。

戻り値	曜日
0	月曜
1	火曜
…	…
5	土曜
6	日曜

1
from datetime import date
2

3
def is_weekday(d: date) -> bool:
4
    return d.weekday() < 5
5

6
print(is_weekday(date(2026, 5, 11)))    # True (月)
7
print(is_weekday(date(2026, 5, 16)))    # False (土)

期間内の営業日リストを作る

「ある期間の営業日だけ取り出す」処理です。

1
from datetime import date, timedelta
2

3
def weekdays_between(start: date, end: date) -> list[date]:
4
    days = []
5
    current = start
6
    while current <= end:
7
        if current.weekday() < 5:
8
            days.append(current)
9
        current += timedelta(days=1)
10
    return days
11

12
period = weekdays_between(date(2026, 5, 1), date(2026, 5, 10))
13
for d in period:
14
    print(d, d.strftime("%a"))

「日本の祝日も除外したい」場合は、jpholiday などのライブラリを使います。

タイムゾーン

datetime.now() は タイムゾーン情報を持たない 値を返します。複数のシステムを跨ぐときは、タイムゾーンを明示するのが安全です。

1
from datetime import datetime, timezone, timedelta
2

3
JST = timezone(timedelta(hours=9))
4

5
now_jst = datetime.now(JST)
6
print(now_jst)               # 2026-05-11 14:30:45.123456+09:00
7
print(now_jst.isoformat())   # 2026-05-11T14:30:45.123456+09:00

J-Quants API のように日本市場のデータを扱うかぎり、JST(UTC+9)で統一しておけば困る場面は少なくなります。

株価データでよくある変換

文字列で受け取った日付列を、date のリストにする処理です。

1
from datetime import date
2

3
raw_dates = ["2026-04-01", "2026-04-02", "2026-04-03"]
4
parsed = [date.fromisoformat(s) for s in raw_dates]
5

6
for d in parsed:
7
    print(d, d.weekday())

リスト内包表記で 1 行にまとめる書き方は#3-10「リスト内包表記と lambda」で扱います。

生成AI へのプロンプト例

日付処理を生成AI に依頼する例です。

Python 3.12 標準ライブラリで、次の処理を書いてください。

引数: start (str, "YYYY-MM-DD"), days (int)
処理: start から「営業日(月-金)で days 日後」の date を返す。
      土日はスキップして数える(祝日は考慮しない)。
戻り値: datetime.date
- 関数名は: add_business_days
- 引数の文字列が不正な形式なら ValueError を再 raise する
- 簡単な使用例(doctest 形式) を関数の docstring に含める

「祝日を考慮しない」など条件を明示すると、過不足のないコードが返ります(#7-2「データ分析のためのプロンプト設計」)。

まとめ

date / datetime / timedelta の 3 つでほとんどの処理が書ける
文字列との相互変換は fromisoformat / isoformat がいちばん簡潔
月単位の計算は dateutil.relativedelta を使う
営業日判定は weekday() < 5、祝日が必要なら jpholiday

目次