环境:
- 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
而不是Cnotallow=True
,那么读取数据也不会报错,但会得到一个 MySqlConnector.MySqlDateTime
结构体(里面记录的时间是’0000-00-00 00:00:00’),如果后续需要将它转成DateTime的话还是很麻烦,所以建议直接使用Cnotallow=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; }
}