日付時刻フォーマットモデル

日付時刻フォーマットモデル（Datetime Format Models）とは、データベースに格納される日付時刻データの形式を指定するものです。

日付時刻フォーマットモデルの全長は22文字を超えてはなりません。デフォルトではない形式の文字列値を日付時刻形式の値に変換する必要がある場合、関数内で日付時刻フォーマットモデルを使用できます。

日付時刻フォーマットモデルは、以下の関数で使用できます：

• デフォルトではない形式の文字列値を日付時刻値に変換する際には、TO_DATE、TO_TIMESTAMP、および TO_TIMESTAMP_TZ 関数のパラメータで日付時刻の形式を指定する必要があります。

• 日付時刻値をデフォルトではない形式の文字列値に変換する際には、TO_CHAR 関数のパラメータで出力文字列の形式を指定する必要があります。

ユーザーが形式を指定しない場合、デフォルトの形式で変換が行われます。デフォルトの日付時刻形式は、システム変数 NLS_DATE_FORMAT、NLS_TIMESTAMP_FORMAT、または NLS_TIMESTAMP_TZ_FORMAT を使用して明示的に指定できます。これらの変数の値は、V$NLS_PARAMETERS システムビューで確認でき、また ALTER SESSION または ALTER SYSTEM コマンドで変数の値を変更できます。

日付時刻形式モデルの要素

日付時刻形式モデルは、1つまたは複数の日付時刻形式モデル要素で構成されます。OceanBaseデータベースがサポートする形式モデル要素については、日付時刻形式モデル要素表を参照してください。

• 書式が入力文字列の解析に使用される場合、同一の書式要素を2回使用したり、類似情報を表す書式要素を組み合わせたりすることはできません。例えば、日付時刻形式でSYYYYとBCの両方の要素を同時に使用することはできません。このルールは、情報の重複による競合を避けるためです。

• 一部の要素は、TO_CHAR、TO_DATE、TO_TIMESTAMP、およびTO_TIMESTAMP_TZ関数では使用できません。

• 日付時刻形式モデル要素FF、TZD、TZH、TZM、およびTZRは、タイムスタンプおよび間隔型の形式に含めることができますが、DATE型の形式には含めることができません。

• 一部の要素は固定長の文字列を生成し、長さが不足している場合は末尾にスペースが追加されます。

  注意

  4桁の年要素(YYYY)を使用することを推奨します。短い年要素は、年が実行時にのみ決定できるため、クエリの最適化に影響を与えます。

日付時刻フォーマット要素表

フォーマット文字列から一部の要素が欠落している場合、システムからエラーメッセージが返されます。

obclient> SELECT TO_DATE( '31 Aug 2020', 'DD MON YYY' ) FROM DUAL;
OBE-01830: date format picture ends before converting entire input string

日付フォーマットモデル要素の大文字

フォーマット内の要素の大文字と小文字は、生成される文字列の大文字と小文字に影響します。例えば、日付フォーマット要素 DAY が生成する MONDAY は大文字であり、Day が生成する Monday は大文字であり、day が生成する小文字の monday は小文字です。例を以下に示します。

obclient> SELECT TO_CHAR(sysdate,'mon')  AS nowMonth FROM DUAL;
+----------+
| NOWMONTH |
+----------+
| mar      |
+----------+
1 row in set

obclient> SELECT TO_CHAR(sysdate,'MON')  AS nowMonth FROM DUAL;
+----------+
| NOWMONTH |
+----------+
| MAR      |
+----------+
1 row in set

日付時刻フォーマットモデルにおける句読点と文字列定数

ユーザーはフォーマットに以下の文字を含めることができます。これらの文字は、返される値内でフォーマットモデル内の文字と同じ位置に現れます。

• 句読点。例えばハイフン、スラッシュ、カンマ、ピリオド、コロンなどです。

• 文字列定数は、ダブルクォーテーションマークで囲まれます。

OceanBaseデータベースは、文字列を柔軟に日付に変換できます。TO_DATE関数を使用する場合、入力文字列の各数字要素がフォーマットモデルで許可されている最大桁数を含む場合、フォーマット文字列は入力された文字列と一致します。

例

• 例1：フォーマット要素MM/YYでは、02はMMに、07はYYに対応します。

  obclient> SELECT TO_CHAR(TO_DATE('0207','MM/YY'),'MM/YY') FROM DUAL;
  +------------------------------------------+
  | TO_CHAR(TO_DATE('0207','MM/YY'),'MM/YY') |
  +------------------------------------------+
  | 02/07                                    |
  +------------------------------------------+
  1 row in set
  

• 例2：OceanBaseデータベースは、アルファベット数字以外の文字とフォーマット内の句読点文字のマッチングを許可しており、#は/に対応します。

  obclient> SELECT TO_CHAR (TO_DATE('02#07','MM/YY'), 'MM/YY') FROM DUAL;
  +-------------------------------------------+
  | TO_CHAR(TO_DATE('02#07','MM/YY'),'MM/YY') |
  +-------------------------------------------+
  | 02/07                                     |
  +-------------------------------------------+
  1 row in set