BINARY expr

BINARY 運算符會將表達式轉換為二進位字串（具有 binary 字元集和 binary 校對的字串）。BINARY 的常見用途是強制使用數值位元組值逐位元組進行字元串比較，而不是逐字元比較。BINARY 運算符還會使比較中的尾隨空格變得重要。有關 binary 字元集的 binary 校對與非二進位字元集的 _bin 校對之間的差異資訊，請參閱第 12.8.5 節，“binary 校對與 _bin 校對的比較”。

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 的值，使用十六進位表示法顯示。有關該選項的更多資訊，請參閱 Section 6.5.1, “mysql — The MySQL Command-Line Client”。

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 允許在 CREATE INDEX、CREATE TABLE 和 ALTER TABLE 語句中，使用額外的 ARRAY 關鍵字，為 JSON 陣列建立多值索引。ARRAY 僅在上述語句中用於建立多值索引時才受支援，且在這種情況下是必需的。被索引的欄位必須是 JSON 類型。使用 ARRAY 時，AS 關鍵字後面的 type 可以指定 CAST() 支援的任何類型，但 BINARY、JSON 和 YEAR 除外。有關語法資訊、範例和其他相關資訊，請參閱 多值索引。

CAST() 支援使用 AT TIMEZONE 運算子，以 UTC 時間擷取 TIMESTAMP 值。唯一支援的時區是 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)

如果您在此形式的 CAST() 中使用 'UTC' 作為時區指定符，並且伺服器拋出錯誤，例如 Unknown or incorrect time zone: 'UTC'，您可能需要安裝 MySQL 時區表（請參閱 填入時區表）。

AT TIME ZONE 不支援 ARRAY 關鍵字，且 CONVERT() 函式不支援此關鍵字。

CONVERT(expr USING transcoding_name)

CONVERT(expr,type)

CONVERT(expr USING transcoding_name) 是標準 SQL 語法。CONVERT() 的非 USING 形式是 ODBC 語法。無論使用何種語法，如果 expr 為 NULL，函式都會回傳 NULL。

CONVERT(expr USING transcoding_name) 會在不同的字元集之間轉換資料。在 MySQL 中，轉碼名稱與對應的字元集名稱相同。例如，此語句將預設字元集中的字串 'abc' 轉換為 utf8mb4 字元集中對應的字串

SELECT CONVERT('abc' USING utf8mb4);

CONVERT(expr, type) 語法（不含 USING）接受一個運算式和一個指定結果類型的 type 值，並產生指定類型結果值。此運算也可以表示為 CAST(expr AS type)，兩者等效。有關更多資訊，請參閱 CAST() 的說明。

從 Point 到

從 LineString 到

從 Polygon 到

從 MultiPoint 到

從 MultiLineString 到

從 MultiPolygon 到

從 GeometryCollection 到

空間轉換的一般條件

轉換為點的條件

轉換為線的條件

轉換為多邊形的條件

轉換為多點的條件

轉換為多線的條件

轉換為多邊形的條件

轉換為幾何圖形集合的條件

轉換的結果與要轉換的運算式具有相同的 SRS。

在空間類型之間轉換不會變更座標值或順序。

如果要轉換的運算式為 NULL，則函數結果為 NULL。

不允許使用 RETURNING 子句指定空間類型，並使用 JSON_VALUE() 函數轉換為空間類型。

不允許轉換為空間類型的 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 錯誤。

如果要轉換的運算式是類型為 MultiPoint 且至少包含兩個點的形式良好的幾何圖形，則函數結果是一個 LineString，其中包含 MultiPoint 的點，順序與它們在運算式中出現的順序相同。 如果運算式僅包含一個 Point，則會發生 ER_INVALID_CAST_TO_GEOMETRY 錯誤。

如果要轉換的運算式是類型為 MultiLineString 且包含單個 LineString 的形式良好的幾何圖形，則函數結果是該 LineString。 如果運算式包含多個 LineString，則會發生 ER_INVALID_CAST_TO_GEOMETRY 錯誤。

如果要轉換的運算式是類型為 GeometryCollection 且僅包含單個 LineString 的形式良好的幾何圖形，則函數結果是該 LineString。 如果運算式為空、包含多個 LineString 或包含其他幾何圖形類型，則會發生 ER_INVALID_CAST_TO_GEOMETRY 錯誤。

如果要轉換的運算式是類型為 LineString、Polygon、MultiPoint、MultiLineString 或 GeometryCollection 以外的其他類型的形式良好的幾何圖形，則會發生 ER_INVALID_CAST_TO_GEOMETRY 錯誤。

如果要轉換的運算式是類型為環的 LineString (也就是說，起點和終點相同) 的形式良好的幾何圖形，則函數結果是一個 Polygon，其外部環由 LineString 的點組成，順序相同。 如果運算式不是環，則會發生 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 的形式良好的幾何圖形，則函數結果是一個 MultiPoint，其中包含該 Point 作為其唯一元素。

如果要轉換的運算式是類型為 LineString 的形式良好的幾何圖形，則函數結果是一個 MultiPoint，其中包含 LineString 的點，順序相同。

如果要轉換的運算式是類型為 MultiPoint 的形式良好的幾何圖形，則函數結果是該 MultiPoint。

如果轉換的運算式是格式正確的 GeometryCollection 類型幾何，且僅包含點，則函數結果會是一個包含這些點的 MultiPoint。如果 GeometryCollection 為空或包含其他幾何類型，則會發生 ER_INVALID_CAST_TO_GEOMETRY 錯誤。

如果轉換的運算式是格式正確的幾何，且類型不是 Point、LineString、MultiPoint 或 GeometryCollection，則會發生 ER_INVALID_CAST_TO_GEOMETRY 錯誤。

如果轉換的運算式是格式正確的 LineString 類型幾何，則函數結果會是一個 MultiLineString，其中包含該 LineString 作為其唯一元素。

如果轉換的運算式是格式正確的 Polygon 類型幾何，則函數結果會是一個 MultiLineString，其中包含該 Polygon 的外環作為其第一個元素，以及任何內環，按照它們在運算式中出現的順序作為額外的元素。

如果轉換的運算式是格式正確的 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，其中包含該 Polygon 作為其唯一元素。

如果轉換的運算式是格式正確的 MultiLineString 類型幾何，其中所有元素都是環，則函數結果會是一個 MultiPolygon，其中包含一個 Polygon，該 Polygon 僅包含運算式每個元素的外環。如果任何元素不是環，則會發生 ER_INVALID_CAST_TO_GEOMETRY 錯誤。如果任何環的順序不正確（外環必須為逆時針方向），則會發生 ER_INVALID_CAST_POLYGON_RING_DIRECTION 錯誤。

如果轉換的運算式是格式正確的 MultiPolygon 類型幾何，則函數結果會是該 MultiPolygon。

如果轉換的運算式是格式正確的 GeometryCollection 類型幾何，且僅包含多邊形，則函數結果會是一個包含這些多邊形的 MultiPolygon。如果運算式為空或包含其他幾何類型，則會發生 ER_INVALID_CAST_TO_GEOMETRY 錯誤。

如果轉換的運算式是格式正確的幾何，且類型不是 Polygon、MultiLineString、MultiPolygon 或 GeometryCollection，則會發生 ER_INVALID_CAST_TO_GEOMETRY 錯誤。

GeometryCollection 和 GeomCollection 是同一結果類型的同義詞。

如果轉換的運算式是格式正確的 Point 類型幾何，則函數結果會是一個 GeometryCollection，其中包含該 Point 作為其唯一元素。

如果轉換的運算式是格式正確的 LineString 類型幾何，則函數結果會是一個 GeometryCollection，其中包含該 LineString 作為其唯一元素。

如果轉換的運算式是格式正確的 Polygon 類型幾何，則函數結果會是一個 GeometryCollection，其中包含該 Polygon 作為其唯一元素。

如果轉換的運算式是格式正確的 MultiPoint 類型幾何，則函數結果會是一個 GeometryCollection，其中包含按照它們在運算式中出現的順序排列的點。

如果轉換的運算式是格式正確的 MultiLineString 類型幾何，則函數結果會是一個 GeometryCollection，其中包含按照它們在運算式中出現的順序排列的線字串。

如果轉換的運算式是格式正確的 MultiPolygon 類型幾何，則函數結果會是一個 GeometryCollection，其中包含按照它們在運算式中出現的順序排列的 MultiPolygon 元素。

如果轉換的運算式是格式正確的 GeometryCollection 類型幾何，則函數結果會是該 GeometryCollection。

若要將「零」日期字串轉換為日期，當啟用 NO_ZERO_DATE SQL 模式時，CONVERT() 和 CAST() 會傳回 NULL 並產生警告。

對於整數減法，如果啟用 NO_UNSIGNED_SUBTRACTION SQL 模式，即使任何運算元都不帶正負號，減法結果也會帶正負號。