日期函數(shù)主要介紹兩個大類赊抖，Extract() 和 Trunc()
Extract() 函數(shù)作用是提取日期统倒，比如我們可以提取一個日期字段的年份，月份氛雪，日等數(shù)據(jù)
Trunc() 的作用則是截取房匆，比如 2022-06-18 12:12:12，我們可以根據(jù)需求獲取到日期 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 操作這里不多做介紹
- Extract()
- Trunc()
1、Extract()
這個函數(shù)接受日期時間字段名稱弦追，和查詢的年岳链、月、日劲件、時掸哑、分、秒等作為參數(shù)零远，提取出相應的值以整數(shù)類型返回
日期類型字段包括：DateTimeField苗分，DateField，TimeField
提取的類型列舉如下：
- year——年份
- quarter——季度
- month——月份
- day——某日
- week——周數(shù)牵辣，一年的第幾周
- weekday——周幾摔癣，周日的值是1，周一是2服猪，一直到周六是7
- hour——小時
- minute——分鐘
- second——秒數(shù)
首先創(chuàng)建測試用的數(shù)據(jù)：
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())
新增字段獲取開始時間的年份供填，周數(shù)，周幾以及該天的小時數(shù)
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)
搜索特定年份數(shù)據(jù)
Extract() 函數(shù)的用法也可以用于搜索特定的日期的某一項罢猪，比如某年近她，某月等
Experiment.objects.filter(start_datetime__year=Extract('end_datetime', 'year'))
具體到日期某一項的用法
前面介紹了 Extract() 函數(shù)的用法是，接收字段名和日期項膳帕，Django 同時提供了另一種簡便的粘捎、比Extract()函數(shù)更具體的用法。
比如我們需要需要搜索年危彩，可以直接使用函數(shù)為 ExtractYear()
搜索月攒磨，使用函數(shù) ExtractMonth()等等。
每一種在我們上面可接收的參數(shù)都有其對應的函數(shù)汤徽，傳參為需要處理的字段娩缰，以下是使用示例：
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)
如果是周數(shù)、時谒府、分拼坎、秒的操作浮毯，函數(shù)名將上面的年月日的英文替換即可
2、Trunc()
這是一個對日期和時間截取的函數(shù)泰鸡，我們可以將時間精確到 年债蓝、季度、月盛龄、日饰迹、時、分余舶、秒
接受三個參數(shù)：
- expression: 字段啊鸭，可以是 DateField, DateTimeField, TimeField 等
- kind: 精確到的程度，可以是 year欧芽，day莉掂，quarter等
- output_field: 輸出格式，可以根據(jù) kind 的值設置到最小值千扔，如果不傳這個參數(shù)憎妙，則默認是expression 的值
假設一個日期時間為 2022–05-16 12:34:56
我們可以挨個處理一下：
# 創(chuàng)建數(shù)據(jù)
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
需要注意的是，截取到年曲楚、月厘唾、季度的數(shù)據(jù)，因為不關心當前時間刻度之下的數(shù)據(jù)龙誊，所以日期的日抚垃，都會被置為1，時間都會是0
從輸出的結果看趟大，日期時間都精確到了我們設置的細度鹤树，那么我們就可以利用這個來進行年度、月度逊朽、季度罕伯、以及日度等一些數(shù)據(jù)的統(tǒng)計
接下來以日度數(shù)據(jù)為例，我們做一下統(tǒng)計叽讳，統(tǒng)計每一天的數(shù)據(jù)的數(shù)量：
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() 函數(shù)類似追他，Trunc() 函數(shù)也有一些可以直接操作到時間的函數(shù)，比如 TruncYear()岛蚤， TruncMonth() 這種邑狸，這里就不展開介紹了。
以上就是本篇筆記全部內容涤妒，下一篇將介紹數(shù)據(jù)庫函數(shù)里計算公式相關函數(shù)单雾。
