日期时间格式模型

日期时间格式模型（Datetime Format Models）指定了存储在数据库中日期时间数据的格式。

日期时间格式模型的总长度不能超过 22 个字符。当您需要将非默认格式的字符值转换为日期时间格式的值时，可以使用函数中的日期时间格式模型。

日期时间格式模型由一个或多个日期时间格式化元素组成，如果要将字符串值转换为日期值，需要遵从一定的转换规则，请参见 字符串到日期的转换规则。

RR 日期时间格式化元素类似于 YY 日期时间格式化元素，但它为跨世纪日期值的存储提供了额外的灵活性，关于 RR 日式格式化元素，请参见 RR 日期时间格式化元素。

函数中的日期时间格式模型

日期时间格式模型可以在以下函数中使用：

• 将非默认格式的字符值转换为日期时间值时，需要使用 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 命令修改变量的值。

日期时间格式模型的元素

日期时间格式模型由一个或多个日期时间格式模型元素组成。OceanBase 数据库支持的格式模型元素请查阅 日期时间格式模型元素表 。

• 如果格式用于解析输入的字符串，相同的格式化元素不能出现两次，表示类似信息的格式化元素不能组合。例如，您不能在一个日期时间格式中同时使用 SYYYY 和 BC 元素。这条规则是为了避免信息冗余导致冲突。

• 部分元素不能在 TO_CHAR、TO_DATE、TO_TIMESTAMP 和 TO_TIMESTAMP_TZ 函数中使用。

• 日期时间格式模型元素 FF、TZD、TZH、TZM 和 TZR 可以出现在时间戳和间隔类型的格式中，但不能出现在 DATE 类型的格式中。

• 部分元素会生成固定长度的字符串，长度不足时会在末尾补充空格。

注意

建议您使用 4 位数的年份元素（YYYY），较短的年份元素会影响查询优化，因为年份只能在运行时确定。

日期时间格式化元素表

说明

日期时间函数指的是 TO_CHAR、TO_DATE、TO_TIMESTAMP 和 TO_TIMESTAMP_TZ 。 注意

• 表格中展示的转化要求输入的字符串日期能够与格式元素相匹配，否则会报错。
• OceanBase 数据库中默认的日期格式为 DD-MON-RR ，如果要显示为上面的格式，可以通过执行 ALTER SESSION SET NLS_DATE_FORMAT = 'YYYY-MM-DD HH24:MI:SS'; 修改当前会话的日期时间格式。

当您的格式字符串漏掉了一些元素时，会得到系统的报错信息：

obclient> SELECT TO_DATE( '31 Aug 2020', 'DD MON YYY' ) FROM DUAL;
ORA-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
  

日期格式化元素与全球化支持

在 OceanBase 数据库中，日期时间格式化元素的语言可以通过参数 NLS_DATE_LANGUAGE 和 NLS_LANGUAGE 指定。默认值是 AMERICAN，不支持修改，所以不支持全球化。

示例 ：日期时间格式化的语言参数默认是 American，不支持其他语言。

SELECT TO_CHAR (SYSDATE, 'DD/MON/YYYY', 'nls_date_language=''Traditional Chinese'' ') FROM DUAL;

查询结果报错，语言参数不支持。

ORA-12702: invalid NLS parameter string used in SQL function