DateField – Django模型
DateField是一个存储日期的字段,在Python中由一个datetime.date实例表示。顾名思义,这个字段是用来存储在Python中创建的日期对象的。这个字段的默认窗体部件是一个TextInput。管理员可以明确地添加一个JavaScript日历和一个 “今天 “的快捷方式。
语法:
field_name = models.DateField(**options)
DateField有以下额外的可选参数:
DateField.auto_now
- 每次保存对象时,自动将该字段设置为现在。对 “最后修改 “的时间戳很有用。注意,总是使用当前日期;它不仅仅是一个你可以覆盖的默认值。
该字段只有在调用Model.save()时才会自动更新。当以其他方式对其他字段进行更新时,如QuerySet.update(),该字段不会被更新,尽管你可以在这样的更新中为该字段指定一个自定义值。
DateField.auto_now_add
- 当对象首次创建时,自动将该字段设置为现在。对创建时间戳很有用。注意,总是使用当前日期;它不仅仅是一个你可以覆盖的默认值。所以即使你在创建对象时为这个字段设置了一个值,它也会被忽略。如果你想能够修改这个字段,请设置以下内容,而不是auto_now_add=True。
- 对于DateField:default=date.day – from datetime.date.day()
- 对于DateTimeField:default=timezone.now – from django.utils.timezone.now()
注意:选项auto_now_add、auto_now和default是互斥的。这些选项的任何组合都会导致一个错误。
Django模型的DateField解释
用一个例子说明DateField的情况。考虑一个名为geeksforgeeks的项目,它有一个名为geeks的应用程序。
在geeks应用程序的models.py文件中输入以下代码。
from django.db import models
from django.db.models import Model
# Create your models here.
class GeeksModel(Model):
geeks_field = models.DateField()
在INSTALLED_APPS中增加geek的应用程序。
# Application definition
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'geeks',
]
现在,当我们从终端运行makemigrations命令时。
Python manage.py makemigrations
在geeks目录下将创建一个名为migrations的新文件夹,其中有一个名为0001_initial.py的文件。
# Generated by Django 2.2.5 on 2019-09-25 06:00
from django.db import migrations, models
class Migration(migrations.Migration):
initial = True
dependencies = [
]
operations = [
migrations.CreateModel(
name ='GeeksModel',
fields =[
('id',
models.AutoField(
auto_created = True,
primary_key = True,
serialize = False,
verbose_name ='ID'
)),
('geeks_field', models.DateField()),
],
),
]
运行,
Python manage.py migrate
因此,当你在项目上运行迁移时,会创建一个geeks_field DateField。它是一个用来存储datetime.date python对象的字段。
如何使用DateField
DateField用于在数据库中存储Python datetime.date实例。人们可以使用同样的方法在数据库中存储任何类型的日期。让我们尝试在上面创建的模型中存储一个日期。
# importing the model
# from geeks app
from geeks.models import GeeksModel
# importing datetime module
import datetime
# creating an instance of
# datetime.date
d = datetime.date(1997, 10, 19)
# creating an instance of
# GeeksModel
geek_object = GeeksModel.objects.create(geeks_field = d)
geek_object.save()
现在让我们在管理服务器中检查一下。我们已经创建了一个GeeksModel的实例。
字段选项
字段选项是给每个字段的参数,用于应用一些约束或赋予特定字段以特定的特征。例如,在DateField中添加参数null = True将使它能够在关系型数据库中为该表存储空值。
下面是一个DateField可以使用的字段选项和属性。
字段选项 | 描述 |
---|---|
Null | 如果为真,Django将在数据库中把空值存储为NULL。默认为假。 |
Blank | 如果为真,该字段允许为空白。默认为 “假”。 |
db_column | 这个字段要使用的数据库列的名称。如果没有给出,Django将使用该字段的名称。 |
db_index | 如果为真,将为该字段创建一个数据库索引。 |
db_tablespace | 如果这个字段有索引的话,这个字段的索引要使用的数据库表空间的名称。默认是项目的DEFAULT_INDEX_TABLESPACE设置(如果设置了),或者模型的db_tablespace(如果有)。如果后端不支持索引的表空间,这个选项会被忽略。 |
Default | 该字段的默认值。这可以是一个值或一个可调用对象。如果是可调用的,它将在每次创建新对象时被调用。 |
help_text | 额外的 “帮助 “文本将显示在表单部件上。即使你的字段不在表单中使用,它对文档也很有用。 |
primary_key | 如果为真,这个字段就是模型的主键。 |
editable | 如果是假的,该字段将不会显示在管理员或任何其他 ModelForm 中。它们也会在模型验证过程中被跳过。默认为True。 |
error_messages | error_messages参数让你覆盖字段将产生的默认信息。传入一个字典,其键值与你想覆盖的错误信息相匹配。 |
help_text | 额外的 “帮助 “文本将显示在表单部件上。即使你的字段不在表单中使用,它对文档也很有用。 |
verbose_name | 该字段的一个人类可读的名字。如果没有给出verbose名称,Django会使用字段的属性名称自动创建它,并将下划线转换为空格。 |
validators | 对该字段运行的验证器列表。更多信息请参见验证器文档。 |
Unique | 如果为真,这个字段在整个表中必须是唯一的。 |