メインコンテンツまでスキップ
バージョン: 26.x

ST_X

デスクリプション​

ポイントが有効なPOINT型の場合、対応するX座標値を返します。

Sytax​

ST_X( <point>)

パラメータ​

Parameterデスクリプション
<point>X座標を抽出する幾何オブジェクト。有効なPOINT型（2次元点）である必要があり、X（経度）の範囲は[-180, 180]、Y（緯度）の範囲は[-90, 90]です。

戻り値​

幾何座標のX値。倍精度浮動小数点数（Double）型です。

  • 入力が有効なPOINTオブジェクトの場合、点のX座標（倍精度浮動小数点数、Double）を返します。
  • 入力がNULL、POINT型以外のオブジェクト、空の点（POINT EMPTY）、または無効な点（例：3次元点）の場合、NULLを返します。

Example​

有効な点のX座標を抽出する

SELECT ST_X(ST_Point(24.7, 56.7));
+----------------------------+
| st_x(st_point(24.7, 56.7)) |
+----------------------------+
|                       24.7 |
+----------------------------+

入力は空のポイント（POINT EMPTY）です

mysql> SELECT ST_X(ST_GeometryFromText("POINT EMPTY"));
+------------------------------------------+
| ST_X(ST_GeometryFromText("POINT EMPTY")) |
+------------------------------------------+
|                                     NULL |
+------------------------------------------+

入力は3Dポイントです（サポートされていません）


mysql> SELECT ST_X(ST_GeometryFromText("POINT (10 20 30)"));
+-----------------------------------------------+
| ST_X(ST_GeometryFromText("POINT (10 20 30)")) |
+-----------------------------------------------+
|                                          NULL |
+-----------------------------------------------+

入力がNULLです

mysql> SELECT ST_X(NULL);
+------------+
| ST_X(NULL) |
+------------+
|       NULL |
+------------+

経度が範囲外です

mysql> SELECT ST_X(ST_Point(244.7, 56.7));
+-----------------------------+
| ST_X(ST_Point(244.7, 56.7)) |
+-----------------------------+
|                        NULL |
+-----------------------------+

緯度が範囲外です

mysql> SELECT ST_X(ST_Point(44.7, 156.7));
+-----------------------------+
| ST_X(ST_Point(44.7, 156.7)) |
+-----------------------------+
|                        NULL |
+-----------------------------+