ExtractMonth関数を使ったその他のサンプルコード

Django の django.db.models.functions.ExtractMonth の解説

django.db.models.functions.ExtractMonth は、django.db.models モジュールで提供される関数で、日付フィールドから月を抽出するために使用されます。

使い方

ExtractMonth 関数は、以下の引数を受け取ります。

• date_field: 月を抽出したい日付フィールド

例

from django.db.models import F, Q, Avg, Subquery, OuterRef, Count, IntegerField
from django.db.models.functions import ExtractMonth, ExtractYear

# 2023年12月から2024年3月までの各月の売上を抽出する
qs = Sale.objects.filter(
    date__gte=F(date_field__year=2023, date_field__month=12),
    date__lte=F(date_field__year=2024, date_field__month=3),
)

# 月と売上をグループ化する
qs = qs.annotate(
    month=ExtractMonth('date'),
    total_sales=Sum('sales'),
)

# 結果を月順に並べ替える
qs = qs.order_by('month')

# 結果:
# [
#     {'month': 12, 'total_sales': 1000},
#     {'month': 1, 'total_sales': 1200},
#     {'month': 2, 'total_sales': 1500},
#     {'month': 3, 'total_sales': 1800},
# ]

その他の機能

ExtractMonth 関数は、以下の機能も提供します。

• year: 年を抽出する
• week: 週を抽出する
• day: 日を抽出する
• hour: 時を抽出する
• minute: 分を抽出する
• second: 秒を抽出する

詳細は、Django 公式ドキュメントの Database Functions: https://docs.djangoproject.com/en/5.0/ref/models/database-functions/ を参照してください。

Django の django.db.models.functions.ExtractMonth を使ったサンプルコード

過去3ヶ月間の各月の売上と前月比を抽出する

from django.db.models import F, Q, Avg, Subquery, OuterRef, Count, IntegerField
from django.db.models.functions import ExtractMonth, ExtractYear

# 過去3ヶ月間の売上を抽出する
qs = Sale.objects.filter(
    date__gte=F(date_field__year=2024, date_field__month=1),
    date__lte=F(date_field__year=2024, date_field__month=3),
)

# 月と売上をグループ化する
qs = qs.annotate(
    month=ExtractMonth('date'),
    total_sales=Sum('sales'),
    # 前月比を計算する
    previous_month_sales=SubquerySum(
        'total_sales',
        filter=Q(date__month=OuterRef('month') - 1),
    ),
    # 前月比をパーセンテージで表示する
    month_over_month_growth=F('total_sales') / F('previous_month_sales') * 100 - 100,
)

# 結果を月順に並べ替える
qs = qs.order_by('month')

# 結果:
# [
#     {'month': 1, 'total_sales': 1200, 'previous_month_sales': 1000, 'month_over_month_growth': 20.0},
#     {'month': 2, 'total_sales': 1500, 'previous_month_sales': 1200, 'month_over_month_growth': 25.0},
#     {'month': 3, 'total_sales': 1800, 'previous_month_sales': 1500, 'month_over_month_growth': 20.0},
# ]

年月別に売上をグループ化し、各月の売上と前年同月比を抽出する

from django.db.models import F, Q, Avg, Subquery, OuterRef, Count, IntegerField
from django.db.models.functions import ExtractMonth, ExtractYear

# 過去2年間の売上を抽出する
qs = Sale.objects.filter(
    date__gte=F(date_field__year=2022),
    date__lte=F(date_field__year=2023),
)

# 年月と売上をグループ化する
qs = qs.annotate(
    year=ExtractYear('date'),
    month=ExtractMonth('date'),
    total_sales=Sum('sales'),
    # 前年同月売上を計算する
    previous_year_sales=SubquerySum(
        'total_sales',
        filter=Q(date__year=OuterRef('year') - 1, date__month=OuterRef('month')),
    ),
    # 前年同月比をパーセンテージで表示する
    year_over_year_growth=F('total_sales') / F('previous_year_sales') * 100 - 100,
)

# 結果を年月順に並べ替える
qs = qs.order_by('year', 'month')

# 結果:
# [
#     {'year': 2022, 'month': 1, 'total_sales': 1000, 'previous_year_sales': 900, 'year_over_year_growth': 11.11},
#     {'year': 2022, 'month': 2, 'total_sales': 1200, 'previous_year_sales': 1100, 'year_over_year_growth': 9.09},
#     {'year': 2022, 'month': 3, 'total_sales': 1500, 'previous_year_sales': 1300, 'year_over_year_growth': 15.38},
#     {'year': 2023, 'month': 1, 'total_sales': 1200, 'previous_year_sales': 1000, 'year_over_year_growth': 20.0},
#     {'year

Django の django.db.models.functions.ExtractMonth を使ったその他の方法

月別売上推移グラフを作成する

from django.db.models import F, Q, Avg, Subquery, OuterRef, Count, IntegerField
from django.db.models.functions import ExtractMonth, ExtractYear
from matplotlib import pyplot as plt

# 過去1年間の売上を抽出する
qs = Sale.objects.filter(
    date__gte=F(date_field__year=2023),
)

# 月と売上をグループ化する
qs = qs.annotate(
    month=ExtractMonth('date'),
    total_sales=Sum('sales'),
)

# 月別売上リストを作成
months = []
sales = []
for row in qs:
    months.append(row.month)
    sales.append(row.total_sales)

# グラフを描画する
plt.plot(months, sales)
plt.xlabel('月')
plt.ylabel('売上')
plt.show()

月別売上トップ10の製品を抽出する

from django.db.models import F, Q, Avg, Subquery, OuterRef, Count, IntegerField
from django.db.models.functions import ExtractMonth, ExtractYear

# 過去1年間の売上を抽出する
qs = Sale.objects.filter(
    date__gte=F(date_field__year=2023),
)

# 月と売上をグループ化する
qs = qs.annotate(
    month=ExtractMonth('date'),
    total_sales=Sum('sales'),
)

# 月別売上トップ10の製品を抽出する
qs = qs.annotate(
    rank=WindowRank(
        order_by=F('total_sales').desc(),
    ),
)

# 結果を月順に並べ替える
qs = qs.filter(rank__lte=10).order_by('month')

# 結果:
# [
#     {'month': 1, 'total_sales': 1000, 'rank': 1, 'product_id': 1},
#     {'month': 1, 'total_sales': 900, 'rank': 2, 'product_id': 2},
#     {'month': 1, 'total_sales': 800, 'rank': 3, 'product_id': 3},
#     {'month': 2, 'total_sales': 1200, 'rank': 1, 'product_id': 4},
#     {'month': 2, 'total_sales': 1100, 'rank': 2, 'product_id': 5},
#     {'month': 2, 'total_sales': 1000, 'rank': 3, 'product_id': 6},
#     ...
# ]

月別売上平均と標準偏差を計算する

from django.db.models import F, Q, Avg, Subquery, OuterRef, Count, IntegerField
from django.db.models.functions import ExtractMonth, ExtractYear

# 過去1年間の売上を抽出する
qs = Sale.objects.filter(
    date__gte=F(date_field__year=2023),
)

# 月と売上をグループ化する
qs = qs.annotate(
    month=ExtractMonth('date'),
    total_sales=Sum('sales'),
    # 月別売上平均を計算する
    average_sales=Avg('sales'),
    # 月別売上標準偏差を計算する
    stddev_sales=StdDev('sales'),
)

# 結果を月順に並べ替える
qs = qs.order_by('month')

# 結果:
# [
#     {'month': 1, 'total_sales': 1000, 'average_sales': 333.33, 'stddev_sales': 235.70},
#     {'month': 2, 'total_sales': 1200, 'average_sales': 400.00, 'stddev_sales': 282.84},
#     {'month': 3, 'total_sales': 1500, 'average_sales': 500.00, 'stddev_sales': 353.55},
#     ...
# ]