日付時刻書式モデル

日付時刻書式モデル（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