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界面效果圖:
點擊編輯頁面,會發現找不到‘更新時間’的編輯處,因為此字段是只讀,且不允許手動修改,效果圖如下:
當頁面“save”之後,再觀察現在的‘更新時間’發現時間已經被修改:
auto_now_add參數說明:
設置為True時,會在model對象第一次被創建時,將字段的值設置為創建時的時間,以後修改對象時,字段的值不會再更新。該屬性通常被用在存儲“創建時間”的場景下。與auto_now類似,auto_now_add也具有強制性,一旦被設置為True,就無法在程序中手動為字段賦值,在admin中字段也會成為只讀的。
繼續沿用剛才的代碼示例,‘update_time‘的‘auto_now‘改完‘auto_now_add‘,其他代碼不變:
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_add=True)
編輯更新北京聯通機房的IP地址段之後保存:
更改之後‘更新時間’並未發生改變(見下圖),因為‘auto_now_add’在對象創建完成後即不再更新:
如何實現可編輯
auto_now和auto_now_add被設置為True後,這樣做會導致字段成為editable=False和blank=True的狀態。editable=False將導致字段不會被呈現在admin中,blank=Ture表示允許在表單中不輸入值。此時,如果在admin的fields或fieldset中強行加入該日期時間字段,那麽程序會報錯,admin無法打開;如果在admin中修改對象時,想要看到日期和時間,可以將日期時間字段添加到admin類的readonly_fields中:
readonly_fields = (‘save_date‘, ‘mod_date‘,)
那麽問題來了。實際場景中,往往既希望在對象的創建時間默認被設置為當前值,又希望能在日後修改它。怎麽實現這種需求呢?
django中所有的model字段都擁有一個default參數,用來給字段設置默認值。可以用default=timezone.now來替換auto_now=True或auto_now_add=True。timezone.now對應著django.utils.timezone.now(),代碼示例:
from django.utils import timezone
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官方文檔:
<https://docs.djangoproject.com/en/2.0/ref/templates/builtins/#date>
Available format strings,部分截圖:
另外在Django頁面渲染的時候,html頁面從數據庫中讀出DateTimeField字段時,顯示的時間格式和數據庫中存放的格式不一致,另外一個解決辦法:可以在頁面格式化時間,添加{{ Datacenter.updatetime|date:"Y-m-d H:i:s" }}類似的過濾器。之後刷新頁面,即可正常顯示。
相關文檔:
https://docs.djangoproject.com/en/2.0/ref/settings/
https://docs.djangoproject.com/en/2.0/ref/templates/builtins/#std:templatefilter-date
Django中的日期處理註意事項和自定義時間格式轉換