Documentation Home
MySQL 8.4 Reference Manual
Related Documentation Download this Manual
PDF (US Ltr) - 39.8Mb
PDF (A4) - 39.9Mb
Man Pages (TGZ) - 257.9Kb
Man Pages (Zip) - 364.9Kb
Info (Gzip) - 4.0Mb
Info (Zip) - 4.0Mb


MySQL 8.4 Reference Manual  /  ...  /  The YEAR Type

13.2.4 年类型

YEAR 类型是一个 1 字节类型,用于表示年值。它可以被声明为 YEAR,隐式显示宽度为 4 个字符,或者等价地声明为 YEAR(4),显示宽度为明确的 4 个字符。

Note

使用明确显示宽度的 YEAR(4) 数据类型已经弃用,您应该预期在未来 MySQL 版本中将其支持删除。相反,请使用 YEAR 没有显示宽度,它们具有相同的含义。

MySQL 将 YEAR 值显示为 YYYY 格式,范围为 19012155,包括 0000

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

  • 4 位字符串,在范围 '1901''2155' 之间。

  • 4 位数字,在范围 19012155 之间。

  • 1-2 位字符串,在范围 '0''99' 之间。MySQL 将值在范围 '0''69''70''99' 的值转换为 YEAR 值在范围 2000206919701999 之间。

  • 1-2 位数字,在范围 099 之间。MySQL 将值在范围 1697099 的值转换为 YEAR 值在范围 2001206919701999 之间。

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

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

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

请参见 Section 13.2.9, “2-Digit Years in Dates”