MySQL Timestamp字段在django中的使用

阅读更多：MySQL 教程

背景

Django 是一个以 MVT（Model-View-Template）为架构的高层 Python Web框架，它能够轻松处理和管理大型 Web 应用的数据库交互。

如果你使用 MySQL 作为数据库后端，Django 提供了更为方便的 MySQL 时间戳（Timestamp）字段的处理方法。然而，在 django 中使用 MySQL 时间戳字段并不是一件简单的事情。本文将详细总结 MySQL 时间戳字段在 Django 中的使用方法，以便更好地管理我们的数据库时间戳数据。

MySQL中Timestamp字段的介绍

MySQL中的时间戳（Timestamp）字段用于在表中存储日期和时间。Timestamp字段内容是由一个4字节的整数来表示的，其精确度为秒级。另外，MySQL 还支持毫秒级、微秒级精度。Timestamp值使用从 1970 年 1 月 1 日至今的描述，并使用特定的格式进行存储。

MySQL中的 timestamp 是数据库自动产生的日期时间戳，每当对于 timestamp 类型的字段插入一条新数据时，MySQL 自动将这个字段赋上当前时间。因此，timestamp 这种类型的字段，最好不要赋初值，否则会引起一系列的问题。

Django中的TimestampField

在 Django 中，我们可以使用 TimestampField 来处理 MySQL 时间戳字段。TimestampField 是 DateTimeField 的子类，设计初衷是为了便于与 MySQL 时间戳类型交互。

在 models.py中引入 TimestampField 类型：

from django.db import models

class MyModel(models.Model):
    my_field = models.TimestampField(auto_now_add=True)

auto_now_add

在定义 TimestampField 时，我们可以使用 auto_now_add=True 参数来指定插入该记录时，该字段自动设置为当前时间。例如，我们在models.py中定义了一个事件的实体类，其创建时间在插入时自动赋值为当前时间：

from django.db import models

class Event(models.Model):
    name = models.CharField(max_length=50)
    create_time = models.TimestampField(auto_now_add=True)

这时，当我们插入一个新 Event 时，create_time 将被初始化为当前时间：

event = Event(name='my event')
event.save()
print(event.create_time)

输出结果如下：

2022-01-04 14:18:59

auto_now

与 auto_now_add 不同，auto_now 参数用来设置插入和更新时间字段是当前时间。这意味着，每次更新数据行，该字段都会自动更新为当前时间。如果我们在事件的实体类中定义了一个修改时间：

from django.db import models

class Event(models.Model):
    name = models.CharField(max_length=50)
    create_time = models.TimestampField(auto_now_add=True)
    update_time = models.TimestampField(auto_now=True)

这时，当我们修改 Event 的时候，update_time 将被设置为当前时间：

event = Event.objects.last()
event.name = 'new name'
event.save()
print(event.update_time)

输出结果如下：

2022-01-04 14:20:35

auto_now 和 auto_now_add 的不同

auto_now_add 是插入数据时自动赋值，auto_now 是插入和更新数据时自动设置当前时间。这是两个特性的区别。我们可以使用 Event 的实体类来测试出这两种方法的区别：

event = Event(name='my event')
event.save()
print(event.create_time) # 来自 auto_now_add
print(event.update_time) # 来自自动更新

这是输出的结果：

2022-01-04 14:23:21 # auto_now_add 自动赋值的时间
2022-01-04 14:23:21 # auto_now 更新的时间

数据库存储格式

TimestampField 用于将日期和时间存储到 MySQL 时间戳类型的字段中。在 MySQL 中，Timestamp的存储格式与其他类型略有不同，它采用了特定的格式来存储 Timestamp 值。具体而言，MySQL 将 Timestamp 转换为 Unix 时间戳格式存储，即从 1970 年 1 月 1 日 00:00:00 UTC 到特定时刻的秒数。

例如，2022 年 1月 1日 00:00:00 的 Unix 时间戳为 1640995200 秒。当我们将该值插入 Timestamp 字段时，MySQL 会自动将其转换为 Timestamp 类型的值。

可以使用以下命令创建一个使用 Timestamp 类型的表：

CREATE TABLE my_table (
  id INT UNSIGNED NOT NULL AUTO_INCREMENT,
  create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
  update_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
  PRIMARY KEY (id)
)ENGINE=InnoDB DEFAULT CHARSET=utf8

在该表中，我们定义了两个 Timestamp 字段：create_time 和 update_time。create_time 使用默认值 CURRENT_TIMESTAMP，即在插入数据时自动赋值为当前时间。update_time 定义了默认值 CURRENT_TIMESTAMP 和 ON UPDATE CURRENT_TIMESTAMP，即在插入和更新数据时都会自动更新为当前时间。