我们在用Django创建models时,常常会涉及时间日期字段的处理,Django里日期相关Field有DateTimeField、DateField和TimeField三种类型,看似简单,但其中有一些容易出错的地方需要注意;另外,如果不习惯Django的默认时间格式,也可以自定义的修改。
DateTimeField、DateField和TimeField,其值分别对应着Python里的datetime.datetime、datetime.date和datetime.time三个实例,这三个Field里都有两个参数:auto_now和auto_now_add,默认值均为False。
auto_now参数说明:
每次保存对象时自动将字段值设置为当前时间,能够在保存该字段时,将其值设置为当前时间,并且每次修改model,都会自动更新。因此这个参数在需要存储“最后修改时间”的场景下,十分方便,常用类似“last-modified”或者"update_time"字段。
需要注意的是,该字段不能被手动修改覆盖;当设置为true时,只有每次调用Model.save()时,才会强制更新为当前时间点;当用其他方式更新其他字段时并不会更新:比如用QuerySet.update()方法,即使为该字段指定一个自定义的值,该字段也不会有所更改。比较直观的表现形式是,如果使用django自带的admin管理器,那么该字段在admin中是只读的,并且无法进行修改。示例代码如下:
class Datacenter(models.Model):
id = models.UUIDField('机房ID', default=uuid.uuid4, primary_key=True)
zone = models.ForeignKey(Zone, verbose_name='所在区域', on_delete=models.PROTECT)
dc_name = models.CharField('机房', max_length=128, unique=True)
networks = models.CharField('IP地址段', max_length=128, blank=True, unique=True)
update_time = models.DateTimeField('更新时间', auto_now=True)
def __str__(self):
return self.dc_name
class Meta:
verbose_name = '机房配置'
verbose_name_plural = '机房配置'
Datacenter的ModelAdmin代码:
class DatacenterAdmin(admin.ModelAdmin):
list_display = ['id', 'dc_name', 'zone', 'networks', 'update_time']
search_fields = ['dc_name', 'zone', 'networks']
list_filter = ['dc_name', 'zone']
ordering = ['networks', 'zone']
admin.site.register(models.Datacenter, DatacenterAdmin)
Admin界面效果图:
class Datacenter(models.Model):
id = models.UUIDField(‘机房ID’, default=uuid.uuid4, primary_key=True)
zone = models.ForeignKey(Zone, verbose_name=‘所在区域’, on_delete=models.PROTECT)
dc_name = models.CharField(‘机房’, max_length=128, unique=True)
networks = models.CharField(‘IP地址段’, max_length=128, blank=True, unique=True)
update_time = models.DateTimeField(‘更新时间’, default=timezone.now())
def __str__(self):
return self.dc_name
class Meta:
verbose_name = '机房配置'
verbose_name_plural = '机房配置'
这里'update_time'字段默认值改为timezone.now()后,再次编辑已经能看到相应‘更新时间’字段,并且可修改:
我们把时间天数加1天后,保存退出再观察‘更新时间’已经变为自定义时间:
自定义日期格式:
刚创建的Django应用,可能你看到的日期显示格式跟下图类似(跟LANGUAGE_CODE和TIME_ZONE有关):
![可能的默认日期格式](http://i2.51cto.com/images/blog/201803/23/164dc709843a56536c09c9142775a553.png?x-oss-process=image/watermark,size_16,text_QDUxQ1RP5Y2a5a6i,color_FFFFFF,t_100,g_se,x_10,y_10,shadow_90,type_ZmFuZ3poZW5naGVpdGk=)
如果不习惯这种格式,自己定义显示格式的配置如下,更改Django的setting.py文件:
USE_L10N = False
DATE_FORMAT = 'Y-m-d'
DATETIME_FORMAT = 'Y-m-d H:i:s'
注意事项:如果USE_L10N设置为了True,那么语言环境规定的格式具有更高的优先级并将被应用,即DATE_FORMAT不生效。
这里可用的格式化字符串的其他写法参见Django官方文档:
;
Available format strings,部分截图:
另外在Django页面渲染的时候,html页面从数据库中读出DateTimeField字段时,显示的时间格式和数据库中存放的格式不一致,另外一个解决办法:可以在页面格式化时间,添加{ { Datacenter.updatetime|date:"Y-m-d H:i:s" }}类似的过滤器。之后刷新页面,即可正常显示。