文档首页
MySQL 8.4 参考手册
相关文档 下载本手册
PDF (US Ltr) - 39.9Mb
PDF (A4) - 40.0Mb
手册页 (TGZ) - 258.5Kb
手册页 (Zip) - 365.5Kb
信息 (Gzip) - 4.0Mb
信息 (Zip) - 4.0Mb


13.2.4 YEAR 类型

YEAR 类型是一种 1 字节类型,用于表示年份值。它可以声明为 YEAR,隐式显示宽度为 4 个字符,也可以等效地声明为 YEAR(4),显式显示宽度为 4 个字符。

注意

使用显式显示宽度的 YEAR(4) 数据类型已被弃用,您应该预计在未来版本的 MySQL 中将不再支持它。请改用不带显示宽度的 YEAR,它具有相同的含义。

MySQL 以 YYYY 格式显示 YEAR 值,范围为 19012155,以及 0000

YEAR 接受以下各种格式的输入值:

  • 作为范围在 '1901''2155' 之间的 4 位数字符串。

  • 作为范围在 19012155 之间的 4 位数字。

  • 作为范围在 '0''99' 之间的 1 位或 2 位数字符串。MySQL 将 '0''69''70''99' 范围内的值分别转换为 2000206919701999 范围内的 YEAR 值。

  • 作为范围在 099 之间的 1 位或 2 位数字。MySQL 将 1697099 范围内的值分别转换为 2001206919701999 范围内的 YEAR 值。

    插入数字 0 的结果的显示值为 0000,内部值为 0000。要插入零并将其解释为 2000,请将其指定为字符串 '0''00'

  • 作为函数的结果,该函数返回值在 YEAR 上下文中是可以接受的,例如 NOW()

如果未启用严格 SQL 模式,MySQL 会将无效的 YEAR 值转换为 0000。在严格 SQL 模式下,尝试插入无效的 YEAR 值会产生错误。

另请参阅 第 13.2.9 节“日期中的两位数年份”