BINARY expr

BINARY 运算符将表达式转换为二进制字符串（一个具有 binary 字符集和 binary 排序规则的字符串）。BINARY 的常见用途是强制字符字符串比较以字节为单位，而不是以字符为单位。同时，BINARY 还会使尾部空格在比较中变得重要。关于 binary 字符集的排序规则和非二进制字符集的 _bin 排序规则之间的差异，见第12.8.5节，“The binary Collation Compared to _bin Collations”。

BINARY 运算符已弃用；您应该预期在 MySQL 的未来版本中删除它。请使用 CAST(... AS BINARY) 而不是。

mysql> SET NAMES utf8mb4 COLLATE utf8mb4_general_ci;
        -> OK
mysql> SELECT 'a' = 'A';
        -> 1
mysql> SELECT BINARY 'a' = 'A';
        -> 0
mysql> SELECT 'a' = 'a ';
        -> 1
mysql> SELECT BINARY 'a' = 'a ';
        -> 0

BINARY 在比较操作中影响整个操作；它可以在两个操作数前面使用，结果相同。

将字符串表达式转换为二进制字符串，这些构造是等价的：

CONVERT(expr USING BINARY)
CAST(expr AS BINARY)
BINARY expr

如果值是一个字符串字面量，可以不进行转换地将其指定为二进制字符串，使用 _binary 字符集引导符：

mysql> SELECT 'a' = 'A';
        -> 1
mysql> SELECT _binary 'a' = 'A';
        -> 0

关于引导符的信息，请参见第12.3.8节，“字符集引导符”。

BINARY 表达式操作符在表达式中与字符列定义中的BINARY 属性不同。对于以BINARY 属性定义的字符列，MySQL 将分配表默认字符集和该字符集的二进制（_bin）排序规则。每个非二进制字符集都有一个_bin 排序规则。例如，如果表默认字符集是 utf8mb4，以下两个列定义是等价的：

CHAR(10) BINARY
CHAR(10) CHARACTER SET utf8mb4 COLLATE utf8mb4_bin

在CHAR、VARCHAR 或TEXT 列定义中使用CHARACTER SET binary，导致该列被视为相应的二进制字符串数据类型。例如，以下两个定义对应：

CHAR(10) CHARACTER SET binary
BINARY(10)

VARCHAR(10) CHARACTER SET binary
VARBINARY(10)

TEXT CHARACTER SET binary
BLOB

如果从BINARY在mysql客户端中调用，二进制字符串将以十六进制表示，取决于--binary-as-hex的值。关于该选项的更多信息，请参见第6.5.1节，“mysql — MySQL 命令行客户端”.

CAST(expr AS type [ARRAY])

CAST(timestamp_value AT TIME ZONE timezone_specifier AS DATETIME[(precision)])

timezone_specifier: [INTERVAL] '+00:00' | 'UTC'

使用CAST(expr AS type 语法，CAST() 函数将任何类型的表达式转换为指定类型的结果值。这一操作也可以用CONVERT(expr, type) 表达式来表示，两者等价。如果expr 是 NULL，CAST() 返回 NULL。

这些type 值是允许的：

InnoDB 允许在JSON 数组作为CREATE INDEX、CREATE TABLE 和ALTER TABLE 语句中使用额外的ARRAY 关键字。除非在这些语句中用于创建多值索引，否则不支持。ARRAY所指的列必须是类型为JSON 的列。使用ARRAY时，type 关键字后可以指定CAST() 支持的任何类型，除了BINARY、JSON 和YEAR。语法信息、示例和其他相关信息，请参见多值索引。

CAST() 支持将 TIMESTAMP 值作为 UTC 时间，使用 AT TIME ZONE 操作符。唯一支持的时区是 UTC，可以指定为 '+00:00' 或 'UTC'。该语法中唯一支持的返回类型是 DATETIME，且可选的精度指定在 0 到 6 之间，包括。

TIMESTAMP 值使用时区偏移也被支持。

mysql> SELECT @@system_time_zone;
+--------------------+
| @@system_time_zone |
+--------------------+
| EDT                |
+--------------------+
1 row in set (0.00 sec)

mysql> CREATE TABLE tz (c TIMESTAMP);
Query OK, 0 rows affected (0.41 sec)

mysql> INSERT INTO tz VALUES
    ->     ROW(CURRENT_TIMESTAMP),
    ->     ROW('2020-07-28 14:50:15+1:00');
Query OK, 1 row affected (0.08 sec)

mysql> TABLE tz;
+---------------------+
| c                   |
+---------------------+
| 2020-07-28 09:22:41 |
| 2020-07-28 09:50:15 |
+---------------------+
2 rows in set (0.00 sec)

mysql> SELECT CAST(c AT TIME ZONE '+00:00' AS DATETIME) AS u FROM tz;
+---------------------+
| u                   |
+---------------------+
| 2020-07-28 13:22:41 |
| 2020-07-28 13:50:15 |
+---------------------+
2 rows in set (0.00 sec)

mysql> SELECT CAST(c AT TIME ZONE 'UTC' AS DATETIME(2)) AS u FROM tz;
+------------------------+
| u                      |
+------------------------+
| 2020-07-28 13:22:41.00 |
| 2020-07-28 13:50:15.00 |
+------------------------+
2 rows in set (0.00 sec)

如果您使用 'UTC' 作为时间 zone 指定符号，并且服务器抛出错误，如Unknown or incorrect time zone: 'UTC'，可能需要安装 MySQL 时区表（见Populating the Time Zone Tables）。

AT TIME ZONE 不支持 ARRAY 关键字，并且不被CONVERT() 函数支持。

CONVERT(expr USING transcoding_name)

CONVERT(expr,type)

CONVERT(expr USING transcoding_name) 是标准SQL语法。非USING形式的CONVERT() 是 ODBC 语法，无论使用哪种语法，该函数都返回 NULL，如果 expr 是 NULL。

CONVERT(expr USING transcoding_name) 将数据转换为不同的字符集。在 MySQL 中，转码名与对应的字符集名称相同。例如，这个语句将默认字符集中的字符串 'abc' 转换到 utf8mb4 字符集中：

SELECT CONVERT('abc' USING utf8mb4);

CONVERT(expr, type) 语法（不含USING) 将表达式和类型值作为参数，生产指定类型的结果值。这一操作也可以用CAST(expr AS type) 表达式来表示，两者等价。更多信息，请参见CAST() 的描述。

从 Point 到：

从 LineString 到：

从 Polygon 到：

从 MultiPoint 到：

从 MultiLineString 到：

从 MultiPolygon 到：

从 GeometryCollection 到：

空间转换的通用条件

将结果转换为Point的条件

将结果转换为LineString的条件

将结果转换为Polygon的条件

将结果转换为MultiPoint的条件

将结果转换为MultiLineString的条件

将结果转换为MultiPolygon的条件

将类型转换到GeometryCollection的条件

转换结果在表达式的同一个空间参考系统(SRS)中。

对空间类型之间的转换不改变坐标值或顺序。

如果要转换的表达式是 NULL，函数结果也是 NULL。

JSON_VALUE() 函数使用指定空间类型的 RETURNING 子句进行转换不允许。

将空间类型转换到 ARRAY 类型不允许。

如果空间类型组合是允许的，但要转换的表达式不是语法正确的几何体，出现ER_GIS_INVALID_DATA 错误。

如果空间类型组合是允许的，但要转换的表达式是一个未定义的空间参考系统(SRS)中的语法正确几何体，出现ER_SRS_NOT_FOUND 错误。

如果要转换的表达式有地理空间 SRS，但经度或纬度超出范围，出现错误：

显示的范围是度数。如果一个SRS使用另一个单位，范围将使用该单位对应的值。由于浮点算术精度，实际范围限制会有轻微偏差。

如果要转换的表达式是一个良好地形状类型为Point，函数结果就是该Point。

如果要转换的表达式是一个良好地形状类型为MultiPoint，包含一个Point，函数结果就是该Point。如果表达式中包含多个Point，会出现ER_INVALID_CAST_TO_GEOMETRY错误。

如果要转换的表达式是一个良好地形状类型为 GeometryCollection，且只包含一个 Point，函数结果就是那个 Point。如果表达式为空、包含多个 Point 或包含其他几何类型，会出现ER_INVALID_CAST_TO_GEOMETRY 错误。

如果要转换的表达式是一个良好地形状类型除 Point、MultiPoint、GeometryCollection 之外的其他几何类型，会出现ER_INVALID_CAST_TO_GEOMETRY 错误。

如果要转换的表达式是一个良好地形状类型为 LineString，函数结果就是那个 LineString。

如果要转换的表达式是一个良好地形状类型为 Polygon，且没有内环，函数结果是一个包含外环点的顺序相同的 LineString。如果表达式有内环，会出现ER_INVALID_CAST_TO_GEOMETRY 错误。

如果要转换的表达式是一个良好形成的多点几何体，至少包含两个点，那么函数结果是一个包含该多点几何体中点的顺序的线字符串。如果要转换的表达式只包含一个点，则发生ER_INVALID_CAST_TO_GEOMETRY错误。

如果要转换的表达式是一个良好形成的多线字符串，包含一个线字符串，那么函数结果就是该线字符串。如果要转换的表达式包含多个线字符串，则发生ER_INVALID_CAST_TO_GEOMETRY错误。

如果要转换的表达式是一个良好形成的几何体集合，包含一个线字符串，那么函数结果就是该线字符串。如果要转换的表达式为空、包含多个线字符串或包含其他几何类型，则发生ER_INVALID_CAST_TO_GEOMETRY错误。

如果要转换的表达式是一个非LineString、Polygon、MultiPoint、MultiLineString或GeometryCollection类型的良好几何体，会出现ER_INVALID_CAST_TO_GEOMETRY错误。

如果要转换的表达式是一个良好几何体类型为LineString，且是一个环（即开始和结束点相同），函数结果是一个以LineString点的顺序相同的Polygon。如果不是环，会出现ER_INVALID_CAST_TO_GEOMETRY错误。如果环不正确顺序（外部环必须是逆时针），会出现ER_INVALID_CAST_POLYGON_RING_DIRECTION错误。

如果要转换的表达式是一个良好几何体类型为Polygon，函数结果就是那个Polygon。

如果要转换的表达式是一个良好形成的多线性几何类型MultiLineString，其中所有元素都是环，那么函数结果是一个Polygon，第一个LineString作为外部环，任何额外的LineString值作为内部环。如果表达式中的任何元素不是环，出现ER_INVALID_CAST_TO_GEOMETRY错误。 如果环的顺序不正确（外部环必须是逆时针，内部环必须是顺时针），出现ER_INVALID_CAST_POLYGON_RING_DIRECTION错误。

如果要转换的表达式是一个良好形成的多多边形几何类型MultiPolygon，包含一个Polygon，那么函数结果就是那个Polygon。如果表达式中包含多个Polygon，出现ER_INVALID_CAST_TO_GEOMETRY错误。

如果要转换的表达式是一个良好形成的几何类型为GeometryCollection，且仅包含一个Polygon，函数结果就是该Polygon。如果表达式为空、包含多个Polygon或包含其他几何类型，会出现ER_INVALID_CAST_TO_GEOMETRY错误。

如果要转换的表达式是一个良好形成的几何类型，除LineString、Polygon、MultiLineString、MultiPolygon或GeometryCollection外的其他类型，会出现ER_INVALID_CAST_TO_GEOMETRY错误。

如果要转换的表达式是一个良好形成的几何类型为Point，函数结果是一个包含该Point作为唯一元素的MultiPoint。

如果要转换的表达式是一个良好形成的几何类型为LineString，函数结果是一个包含LineString中的点顺序相同的MultiPoint。

如果要转换的表达式是一个良好形成的几何类型为MultiPoint，函数结果就是该MultiPoint。

如果要转换的表达式是一个类型为GeometryCollection的良好几何形状，且只包含点，那么函数结果是一个包含这些点的MultiPoint。如果GeometryCollection为空或包含其他几何形状类型，会出现ER_INVALID_CAST_TO_GEOMETRY错误。

如果要转换的表达式是一个类型不是Point、LineString、MultiPoint或GeometryCollection的良好几何形状，那么会出现ER_INVALID_CAST_TO_GEOMETRY错误。

如果要转换的表达式是一个类型为LineString的良好几何形状，那么函数结果是一个包含该LineString作为其唯一元素的MultiLineString。

如果要转换的表达式是一个类型为Polygon的良好几何形状，那么函数结果是一个包含该Polygon外环作为其第一个元素，且包含该Polygon中的所有内环作为顺序出现的额外元素的MultiLineString。

如果要转换的表达式是一个类型为MultiLineString的良好几何形状，那么函数结果就是该MultiLineString。

如果要转换的表达式是一个良好形成的多边形类型MultiPolygon，只包含不含内环的多边形，那么函数结果是一个MultiLineString，包含表达式中出现的多边形环顺序。如果表达式包含任何多边形有内环，会发生ER_WRONG_PARAMETERS_TO_STORED_FCT错误。

如果要转换的表达式是一个良好形成的几何类型GeometryCollection，只包含线字符串，那么函数结果是一个MultiLineString，包含这些线字符串。如果表达式为空或包含其他几何类型，会发生ER_INVALID_CAST_TO_GEOMETRY错误。

如果要转换的表达式是一个除LineString、Polygon、MultiLineString、MultiPolygon或GeometryCollection之外的几何类型，会发生ER_INVALID_CAST_TO_GEOMETRY错误。

如果要转换的表达式是一个良好形成的多边形类型Polygon，函数结果是一个MultiPolygon，包含该多边形作为其唯一元素。

如果要转换的表达式是一个良好形成的多线性几何类型MultiLineString，其中所有元素都是环，那么函数结果是一个MultiPolygon，包含每个元素的一个Polygon，只有外部环。任何一个元素不是环，或者环的顺序不正确（外部环必须是逆时针），都会出现ER_INVALID_CAST_TO_GEOMETRY错误。

如果要转换的表达式是一个良好形成的多多边形几何类型MultiPolygon，那么函数结果就是那个MultiPolygon。

如果要转换的表达式是一个良好形成的几何集合类型GeometryCollection，只包含多边形，那么函数结果是一个MultiPolygon，包含那些多边形。如果表达式为空或包含其他几何类型，会出现ER_INVALID_CAST_TO_GEOMETRY错误。

如果要转换的表达式是一个非Polygon、MultiLineString、MultiPolygon或GeometryCollection类型的良好几何体，会出现ER_INVALID_CAST_TO_GEOMETRY错误。

GeometryCollection和GeomCollection是同一个结果类型的同义词。

如果要转换的表达式是一个良好几何体类型为Point，函数结果是一个包含该Point作为唯一元素的GeometryCollection。

如果要转换的表达式是一个良好几何体类型为LineString，函数结果是一个包含该LineString作为唯一元素的GeometryCollection。

如果要转换的表达式是一个良好几何体类型为Polygon，函数结果是一个包含该Polygon作为唯一元素的GeometryCollection。

如果要转换的表达式是一个良好几何体类型为MultiPoint，函数结果是一个包含表达式中点的顺序的GeometryCollection。

如果要转换的表达式是一个良好形成的几何类型MultiLineString，函数结果是一个包含线estring顺序出现的GeometryCollection。

如果要转换的表达式是一个良好形成的几何类型MultiPolygon，函数结果是一个包含MultiPolygon顺序出现的GeometryCollection。

如果要转换的表达式是一个良好形成的几何类型GeometryCollection，函数结果就是该GeometryCollection。

将“零”日期字符串转换为日期时，CONVERT() 和 CAST() 返回 NULL 并在启用NO_ZERO_DATE SQL 模式时产生警告。

对于整数减法，如果启用了NO_UNSIGNED_SUBTRACTION SQL 模式，结果即使其中任何操作数是无符号的，也会是有符号的。