すべてのプロダクト
Search
ドキュメントセンター

ApsaraDB RDS:ST_TimeZone

最終更新日:Dec 11, 2024

ポイントオブジェクトのタイムゾーン情報を取得します。

構文

cstring ST_TimeZone(geometry point, boolean timezoneId, integer timezonePrecision);
cstring ST_TimeZone(geography point, boolean timezoneId, integer timezonePrecision);

パラメーター

パラメーター

説明

point

ジオメトリオブジェクト。The geometry object. 次の要件を満たす必要があります。

  • ポイントデータ型です。

  • その空間参照系はWGS84(srid=4326) である。

timezoneId

タイムゾーンを名前形式で返すかどうかを指定します。 有効な値:

  • true (デフォルト): タイムゾーンを名前形式で返します。 例: アジア /上海

  • falseで、標準GMT形式のタイムゾーンです。 例: Etc/GMT + 8

timezonePrecision

タイムゾーンのデータ精度。 このパラメーターは、timezoneIdパラメーターがtrueに設定されている場合に有効です。 有効な値:

  • 16 (デフォルト): 精度は0.0055 (〜500m) です。

  • 21: 精度は0.00017 (〜20m) です。

戻り値

タイムゾーン文字列が返されます。

説明

ポイントオブジェクトのタイムゾーン情報を取得します。 タイムゾーンの地理的境界データは、Timezone boundary Builderプロジェクトから取得します。

SELECT ST_TimeZone('SRID=4326;POINT(121 37)'::geometry);
----
Asia/Shanghai

SELECT ST_TimeZone('POINT(60 37)'::geography);
----
Asia/Tehran


-- A simple time zone string is returned.
SELECT ST_TimeZone('SRID=4326;POINT(121 37)'::geometry, false);
----
Etc/GMT+8


-- The data precision is required.
SELECT ST_TimeZone('SRID=4326;POINT(-121 37)'::geometry, true, 21);
----
America/Los_Angeles


-- The longitude must be greater than 180°.
SELECT ST_TimeZone(('SRID=4326;POINT(400 37)'::geometry));
----
Europe/Istanbul