Django笔记二十五之数据库函数之日期函数

把鼻

本文首发于公众号：Hunter后端
原文链接：Django笔记二十五之数据库函数之日期函数

日期函数主要介绍两个大类，Extract() 和 Trunc()
Extract() 函数作用是提取日期，比如我们可以提取一个日期字段的年份，月份，日等数据
Trunc() 的作用则是截取，比如 2022-06-18 12:12:12，我们可以根据需求获取到日期 2020-06-18，或者更细粒度到时分秒
这次我们用到下面这个 model：

1. class Experiment(models.Model):
2.     start_datetime = models.DateTimeField()
3.     start_date = models.DateField(null=True, blank=True)
4.     start_time = models.TimeField(null=True, blank=True)
5.     end_datetime = models.DateTimeField(null=True, blank=True)
6.     end_date = models.DateField(null=True, blank=True)
7.     end_time = models.TimeField(null=True, blank=True)

复制代码

我们还是将其放到 blog/models.py 下，相关的 migration 操作这里不多做介绍

• Extract()
  
• Trunc()
  

1、Extract()

这个函数接受日期时间字段名称，和查询的年、月、日、时、分、秒等作为参数，提取出相应的值以整数类型返回
日期类型字段包括：DateTimeField，DateField，TimeField
提取的类型列举如下：

• year——年份
  
• quarter——季度
  
• month——月份
  
• day——某日
  
• week——周数，一年的第几周
  
• weekday——周几，周日的值是1，周一是2，一直到周六是7
  
• hour——小时
  
• minute——分钟
  
• second——秒数
  

首先创建测试用的数据：

1. from datetime import datetime
2. start = datetime(2015, 6, 15, 12, 30, 56)
3. end = datetime(2015, 7, 2, 17, 21, 43)
5. from blog.models import Experiment
6. Experiment.objects.create(
7.     start_datetime=start, start_date=start.date(),
8.     end_datetime=end, end_date=end.date())

复制代码

新增字段获取开始时间的年份，周数，周几以及该天的小时数

1. from blog.models import Experiment
2. from django.db.models.functions import Extract
4. experiment = Experiment.objects.annotate(
5.     start_year=Extract('start_datetime', 'year'),
6.     start_week=Extract('start_datetime', 'week'),
7.     start_week_day=Extract('start_datetime', 'week_day'),
8.         start_hour=Extract('start_datetime', 'hour')
9. ).get(id=1)
11. print(experiment.start_year)
12. print(experiment.start_week)
13. print(experiment.start_week_day)
14. print(exprtiment.start_hour)

复制代码

搜索特定年份数据
Extract() 函数的用法也可以用于搜索特定的日期的某一项，比如某年，某月等

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

复制代码

具体到日期某一项的用法
前面介绍了 Extract() 函数的用法是，接收字段名和日期项，Django 同时提供了另一种简便的、比Extract()函数更具体的用法。
比如我们需要需要搜索年，可以直接使用函数为 ExtractYear()
搜索月，使用函数 ExtractMonth()等等。
每一种在我们上面可接收的参数都有其对应的函数，传参为需要处理的字段，以下是使用示例：

1. from blog.models import Experiment
2. from django.db.models.functions import ExtractYear, ExtractWeek
3. expriment = Experiment.objects.annotate(
4.     start_year=ExtractYear('start_datetime'),
5.     start_week=ExtractWeek('start_datetime')
6. ).get(id=1)
8. print(expriment.start_year)
9. print(expriment.start_week)

复制代码

如果是周数、时、分、秒的操作，函数名将上面的年月日的英文替换即可
2、Trunc()

这是一个对日期和时间截取的函数，我们可以将时间精确到 年、季度、月、日、时、分、秒
接受三个参数：

• expression: 字段，可以是 DateField, DateTimeField, TimeField 等
  
• kind: 精确到的程度，可以是 year，day，quarter等
  
• output_field: 输出格式，可以根据 kind 的值设置到最小值，如果不传这个参数，则默认是expression 的值
  

假设一个日期时间为 2022–05-16 12:34:56
我们可以挨个处理一下：

1. # 创建数据
2. from datetime import datetime
3. start_datetime = datetime(year=2022, month=5, day=16, hour=12, minute=34, second=56)
5. Experiment.objects.create(start_datetime=start_datetime)
7. from django.db.models.functions import Trunc
8. from django.db import models
10. experiment = Experiment.objects.annotate(
11.     start_year=Trunc('start_datetime', 'year', output_field=models.DateField()),
12.     start_quarter=Trunc('start_datetime', 'quarter', output_field=models.DateField()),
13.     start_month=Trunc('start_datetime', 'month', output_field=models.DateField()),
14.     start_day=Trunc('start_datetime', 'day', output_field=models.DateField()),
15.     start_hour=Trunc('start_datetime', 'hour', output_field=models.DateTimeField()),
16.     start_minute=Trunc('start_datetime', 'minute', output_field=models.DateTimeField()),
17.     start_second=Trunc('start_datetime', 'second', output_field=models.DateTimeField()),
18. ).get(id=2)

复制代码

然后挨个 print() 他们的结果如下：

1. >>> print(experiment.start_year)
2. 2022-01-01
3. >>> print(experiment.start_quarter)
4. 2022-04-01
5. >>> print(experiment.start_month)
6. 2022-05-01
7. >>> print(experiment.start_day)
8. 2022-05-16
9. >>> print(experiment.start_hour)
10. 2022-05-16 12:00:00+00:00
11. >>> print(experiment.start_minute)
12. 2022-05-16 12:34:00+00:00
13. >>> print(experiment.start_second)
14. 2022-05-16 12:34:56+00:00

复制代码

需要注意的是，截取到年、月、季度的数据，因为不关心当前时间刻度之下的数据，所以日期的日，都会被置为1，时间都会是0
从输出的结果看，日期时间都精确到了我们设置的细度，那么我们就可以利用这个来进行年度、月度、季度、以及日度等一些数据的统计
接下来以日度数据为例，我们做一下统计，统计每一天的数据的数量：

1. from django.db.models import Count
2. 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() 这种，这里就不展开介绍了。
以上就是本篇笔记全部内容，下一篇将介绍数据库函数里计算公式相关函数。
如果想获取更多后端相关文章，可扫码关注阅读：

来源:https://www.cnblogs.com/hunterxiong/p/17334992.html
免责声明：由于采集信息均来自互联网，如果侵犯了您的权益，请联系我们【E-Mail:cb@itdo.tech】 我们会及时删除侵权内容，谢谢合作！