ORA_DST_AFFECTED

構文

目的

ORA_DST_AFFECTEDは、データベースのタイムゾーン・データファイルを変更するときに役立ちます。このファンクションは、引数として、TIMESTAMP WITH TIME ZONE値、またはTIMESTAMP WITH TIME ZONE値を含むVARRAYオブジェクトに解決される日時式を取ります。このファンクションは、新しいタイムゾーン・データを使用したときに、日時値が、存在しない時刻または重複時刻のエラーの影響を受けたり、いずれかのエラーになる場合は1を戻します。それ以外の場合は0を戻します。

このファンクションを発行できるのは、データベースのタイムゾーン・データファイルを変更してタイムゾーン・データ付きのタイムスタンプをアップグレードする場合のみです。さらに、DBMS_DST.BEGIN_PREPAREプロシージャを実行してからDBMS_DST.END_PREPAREプロシージャを実行するまでの間か、またはDBMS_DST.BEGIN_UPGRADEプロシージャを実行してからDBMS_DST.END_UPGRADEプロシージャを実行するまでの間にのみ発行できます。