mysql：列类型之时间日期

环境：

window10
vs2022
.net 6
mysql 8.0.25
DBeaver

参考：
《MSDN：浮点数值类型（C# 引用）》
《mysql：11.2 Date and Time Data Types》

在mysql中表示日期时间的类型有 date、time、year、datetime、timstamp五种，列表如下：

五中列类型的一些特点

1. datetime和date的取值范围

mysql文档中声明了date和datetime的取值范围是 '1000-01-01' to '9999-12-31'和'1000-01-01 00:00:00' to '9999-12-31 23:59:59'，但也声明存储更早的时间或许可以，但不保证一定正确，如下：

需要注意的是，timestamp和year却是严格按照mysql指定的范围检查的，比如：我们不能将’1001’插入到year中，也不能将’0001-01-01 00:00:00’插入到timestamp中。

2. datetime、time和timestamp支持毫秒

可以使用datetime(f)、time(f)、timestamp(f)定义列，f取值范围是0-6，默认是0。
比如：当我们定义列类型datetime(6)时可以保存'2022-02-11 01:02:03.123456'，查询的结果显示：2022-02-11 01:02:03.123456
注意：虽然我们将'2022-02-11 01:02:03.123456'插入到datetime(0)不会报错，但mysql会丢弃掉毫秒部分。

3. 关于时区（datetime和timestamp的不同点之一）

mysql中不存储时区信息，但我们可以给mysql实例设一个整体的时区，也可以跟随服务器时区（默认就是跟随服务器时区）。
如：select @@time_zone输出：SYSTEM，表示跟随系统时区。

另外，我们可以在插入数据时指定时区信息，如：
insert into test(t_datetime) values('2022-02-11 08:30:01+08:00')

注意：
mysql 8.0.19及以上才允许insert时加时区；
还有，时间和时区之间不能有空格，要紧跟 ‘+’ 号，如：2022-02-11 00:30:01+00:00是正确的，而 2022-02-11 00:30:01 +00:00则会报错。
c#解析带时区数据的时候支持’+'号前有空格和无空格的两种形式。

当我们将指定时区的数据（如：北京时区'2022-02-11 08:30:01'）插入到mysql的datetime
时，如果mysql使用的时区也是北京时区那么直接存进去，如果是其他时区，比如：+09:00，那么mysql将它转换时区再存进去（转成：'2022-02-11 09:30:01'）
这样下次查询的时候将会得到'2022-02-11 09:30:01'。

另外，mysql存取timestamp和datetime的规则是不一样的：

datetime
mysql存数据到datetime时候，最多将指定了时区的数据转换到mysql使用的时区后再存储进去，取得时候就原封不动取出来。
timestamp
mysql存数据的时候，将数据先转换成UTC时间，当取出的时候再转换成mysql使用的时区。

举个例子：

先将机器时区调成 +09:00：

然后，将mysql服务器重启，执行select @@time_zone，是否输出SYSTEM，是的话表示mysql使用本机时区，即：+09:00。

然后，执行下面脚本，将数据'2022-02-11 08:30:01+08:00'插入到timestamp：

create table test(t_timestamp  timestamp
)
insert into test(t_timestamp) values('2022-02-11 08:30:01+08:00')
select * from test

输出结果：

解释下上面时区操作的情况：

当我们将'2022-02-11 08:30:01+08:00'插入到mysql的timestamp时，mysql首先将它转成+00:00时区（即：UTC时间）的数据（2022-02-11 00:30:01+00:00）,然后将它插入列 t_timestamp；
当我们执行查询时，mysql将读取到的2022-02-11 00:30:01+00:00转换成本机时区（+09:00）显示出来，转换结果为：2022-02-11 09:30:01，这个正是我们看到的输出结果。

然后，再接着实验：我们将机器时区调会北京时间（+08:00），然后重启mysql服务。

然后，我们再执行查询，输出结果：

解释上面输出的情况：

mysql的timestamp本身存储的是UTC时间（2022-02-11 00:30:01+00:00），读取后会将它转成本机时区（此时为：+08:00），转换后的结果是：2022-02-11 08:30:01，就是我们看到的样子。

最后总结：

如果mysql使用的时区不会中途更改的话，timestamp内部使用什么时区存储对我们来说是没有什么感觉的。因为，mysql会在存取时自行转换；
如果mysql使用的时区中途会发生更改，那么timestamp类型的数据是不用考虑旧数据的时区问题的，因为mysql存的是utc时间，取得时候直接转换成切换后的时区，而datetime类型的旧数据可能需要考虑转换时区；

4. 关于datetime和timestamp的自动更新

在mysql中，datetime和timestamp可以在定义时指定它自动更新机制。

不过，这种自动更新机制受参数@@explicit_defaults_for_timestamp影响。

当@@explicit_defaults_for_timestamp值为0的时候，timestamp列类型可以自动更新（新增和更新时），否则，timestamp列类型不会自动更新。

所以，为了兼容不同的模式，推荐使用下面的写法保持一致性：

create table test(t_timestamp  timestamp(3) default current_timestamp(3) on update current_timestamp(3),t_datetime   datetime(3) default current_timestamp(3) on update current_timestamp(3),name varchar(50)
)

5. 关于日期时间的零值

mysql中允许插入 “0000-00-00 01:02:03” 这样的日期值，但是这样的值其实是无意义的。
时间部分为0好理解，但日期怎么可能为0呢？对于此c#是直接报错的：

mysql中也允许通过修改配置阻止这种数据插入，涉及到mysql的模式参数：NO_ZERO_DATE、NO_ZERO_IN_DATE，以及是否是严格模式，可参考：《mysql：5.1.11 Server SQL Modes》

话说回来，不管mysql中是否允许0000-00-00 00:00:00这种数据，我们在用程序查询的时候得能读取出来吧？看下图：

为了不报错，我们需要修改连接字符串，如下：

这里注意：如果我们使用 AllowZeroDateTime=True
而不是ConvertZeroDateTime=True，那么读取数据也不会报错，但会得到一个 MySqlConnector.MySqlDateTime结构体（里面记录的时间是’0000-00-00 00:00:00’），如果后续需要将它转成DateTime的话还是很麻烦，所以建议直接使用ConvertZeroDateTime=True。

6. 关于time类型的范围

从上面的介绍中可以看出time的范围并不是00:00:00 - 23:59:59，而是'-838:59:59.000000' to '838:59:59.000000'。这让人难理解，但mysql文档的解释是time还要考虑存储一个时间段！引用《剑雨》中转轮王的一句话吐槽下：

“你要练变戏法就变戏法，练武功就练武功，你总是喜欢它们混为一谈，能活到今天，也算件奇事啊。”

不管怎么说吧，mysql这么设计了，我们在程序中想办法兼容吧，不过好在 MySqlConnector中读取后就是TimeSpan，所以我们在c#中记得用TimeSpan去接收就行了。

7. 在c#中使用时间日期列

上面说了5中日期时间类型的特点，下面就谈谈c#中应该怎样使用：

datetime和timestamp
因为mysql中不存储时区信息，所以我们在c#中直接使用datetime接收就行，不过当mysql中允许存在0000-00-00 00:00:00这种数据时，我们可以选择在连接字符串中添加ConvertZeroDateTime=True将它转为0001-01-01 00:00:00，或者是使用MySqlConnector.MySqlDateTime结构体接收。
date
一般我们使用datetime接收即可，但.net6出来后增加了dateonly结构体，我们的选择又多了，不过为了代码的兼容性，推荐使用datetime。
time
上面着重讲了，因为mysql中time既可以表示时间点又可以表示时间段，所以mysqlconnector直接翻译成了timespan，我们也没有其他的选择，直接使用timespan接收即可。
year
这个最简单的，使用int接收。

c#模型定义示例：

public class Model
{/// <summary>/// mysql列类型: year/// </summary>public int? t_year { get; set; }/// <summary>/// mysql列类型: date/// </summary>public DateTime? t_date { get; set; }/// <summary>/// mysql列类型: datetime ConvertZeroDateTime=True/// </summary>public DateTime? t_datetime { get; set; }/// <summary>/// mysql列类型: timestamp/// </summary>public DateTime? t_timestamp { get; set; }/// <summary>/// mysql列类型: time/// </summary>public TimeSpan? t_time { get; set; }
}