日付時刻書式モデル

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