Django筆記二十五之資料庫函式之日期函式

XHunter發表於2023-04-19
Django筆記資料庫函式

本文首發於公眾號：Hunter後端
原文連結：Django筆記二十五之資料庫函式之日期函式

日期函式主要介紹兩個大類，Extract() 和 Trunc()

Extract() 函式作用是提取日期，比如我們可以提取一個日期欄位的年份，月份，日等資料

Trunc() 的作用則是擷取，比如 2022-06-18 12:12:12，我們可以根據需求獲取到日期 2020-06-18，或者更細粒度到時分秒

這次我們用到下面這個 model：

class Experiment(models.Model):
    start_datetime = models.DateTimeField()
    start_date = models.DateField(null=True, blank=True)
    start_time = models.TimeField(null=True, blank=True)
    end_datetime = models.DateTimeField(null=True, blank=True)
    end_date = models.DateField(null=True, blank=True)
    end_time = models.TimeField(null=True, blank=True)

我們還是將其放到 blog/models.py 下，相關的 migration 操作這裡不多做介紹

  1. Extract()
  2. Trunc()

1、Extract()

這個函式接受日期時間欄位名稱，和查詢的年、月、日、時、分、秒等作為引數，提取出相應的值以整數型別返回

日期型別欄位包括：DateTimeField，DateField，TimeField
提取的型別列舉如下：

  • year——年份
  • quarter——季度
  • month——月份
  • day——某日
  • week——週數，一年的第幾周
  • weekday——周幾，週日的值是1，週一是2，一直到週六是7
  • hour——小時
  • minute——分鐘
  • second——秒數

首先建立測試用的資料：

from datetime import datetime
start = datetime(2015, 6, 15, 12, 30, 56)
end = datetime(2015, 7, 2, 17, 21, 43)

from blog.models import Experiment
Experiment.objects.create(
    start_datetime=start, start_date=start.date(),
    end_datetime=end, end_date=end.date())

新增欄位獲取開始時間的年份，週數，周幾以及該天的小時數

from blog.models import Experiment
from django.db.models.functions import Extract

experiment = Experiment.objects.annotate(
    start_year=Extract('start_datetime', 'year'),
    start_week=Extract('start_datetime', 'week'),
    start_week_day=Extract('start_datetime', 'week_day'),
	start_hour=Extract('start_datetime', 'hour')
).get(id=1)

print(experiment.start_year)
print(experiment.start_week)
print(experiment.start_week_day)
print(exprtiment.start_hour)

搜尋特定年份資料

Extract() 函式的用法也可以用於搜尋特定的日期的某一項，比如某年，某月等

Experiment.objects.filter(start_datetime__year=Extract('end_datetime', 'year'))

具體到日期某一項的用法

前面介紹了 Extract() 函式的用法是，接收欄位名和日期項，Django 同時提供了另一種簡便的、比Extract()函式更具體的用法。

比如我們需要需要搜尋年，可以直接使用函式為 ExtractYear()

搜尋月，使用函式 ExtractMonth()等等。

每一種在我們上面可接收的引數都有其對應的函式，傳參為需要處理的欄位，以下是使用示例：

from blog.models import Experiment
from django.db.models.functions import ExtractYear, ExtractWeek
expriment = Experiment.objects.annotate(
    start_year=ExtractYear('start_datetime'),
    start_week=ExtractWeek('start_datetime')
).get(id=1)

print(expriment.start_year)
print(expriment.start_week)

如果是週數、時、分、秒的操作，函式名將上面的年月日的英文替換即可

2、Trunc()

這是一個對日期和時間擷取的函式，我們可以將時間精確到 年、季度、月、日、時、分、秒

接受三個引數：

  • expression: 欄位，可以是 DateField, DateTimeField, TimeField 等
  • kind: 精確到的程度，可以是 year，day，quarter等
  • output_field: 輸出格式，可以根據 kind 的值設定到最小值，如果不傳這個引數，則預設是expression 的值

假設一個日期時間為 2022–05-16 12:34:56

我們可以挨個處理一下：

# 建立資料
from datetime import datetime
start_datetime = datetime(year=2022, month=5, day=16, hour=12, minute=34, second=56)

Experiment.objects.create(start_datetime=start_datetime)

from django.db.models.functions import Trunc
from django.db import models

experiment = Experiment.objects.annotate(
    start_year=Trunc('start_datetime', 'year', output_field=models.DateField()),
    start_quarter=Trunc('start_datetime', 'quarter', output_field=models.DateField()),
    start_month=Trunc('start_datetime', 'month', output_field=models.DateField()),
    start_day=Trunc('start_datetime', 'day', output_field=models.DateField()),
    start_hour=Trunc('start_datetime', 'hour', output_field=models.DateTimeField()),
    start_minute=Trunc('start_datetime', 'minute', output_field=models.DateTimeField()),
    start_second=Trunc('start_datetime', 'second', output_field=models.DateTimeField()),
).get(id=2)

然後挨個 print() 他們的結果如下：

>>> print(experiment.start_year)
2022-01-01
>>> print(experiment.start_quarter)
2022-04-01
>>> print(experiment.start_month)
2022-05-01
>>> print(experiment.start_day)
2022-05-16
>>> print(experiment.start_hour)
2022-05-16 12:00:00+00:00
>>> print(experiment.start_minute)
2022-05-16 12:34:00+00:00
>>> print(experiment.start_second)
2022-05-16 12:34:56+00:00

需要注意的是，擷取到年、月、季度的資料，因為不關心當前時間刻度之下的資料，所以日期的日，都會被置為1，時間都會是0

從輸出的結果看，日期時間都精確到了我們設定的細度，那麼我們就可以利用這個來進行年度、月度、季度、以及日度等一些資料的統計

接下來以日度資料為例，我們做一下統計，統計每一天的資料的數量：

from django.db.models import Count
Experiment.objects.annotate(start_day=Trunc("start_datetime", "day", output_field=models.DateField())).values("start_day").annotate(count_day=Count("id"))

與 Extract() 函式類似，Trunc() 函式也有一些可以直接操作到時間的函式，比如 TruncYear()， TruncMonth() 這種，這裡就不展開介紹了。

以上就是本篇筆記全部內容，下一篇將介紹資料庫函式里計算公式相關函式。

如果想獲取更多後端相關文章，可掃碼關注閱讀：

image

相關文章