FIRST_DAY 标量函数

FIRST_DAY 函数返回表示自变量月份的第一天的日期或时间戳记。

Read syntax diagramSkip visual syntax diagramFIRST_DAY(expression )

该模式是 SYSIBM。

expression
一个表达式，用于指定用于计算月份的第一天的日期时间值。 该表达式必须返回 DATE、TIMESTAMP、CHAR 或 VARCHAR 数据类型的值。 在 Unicode 数据库中，该表达式也可以是 GRAPHIC 或 VARGRAPHIC 数据类型。 使用隐式强制类型转换，可以支持 CHAR、VARCHAR、GRAPHIC 和 VARGRAPHIC。 如果 expression 是 CHAR、VARCHAR、GRAPHIC 或 VARGRAPHIC 数据类型，那么它必须是 TIMESTAMP 标量函数接受的有效字符串。

如果 expression 是时间戳记，那么该函数的结果是具有与 expression 相同的精度的时间戳记。 否则，该函数的结果为日期。 如果自变量可以为空，那么结果可以为空；如果自变量为空，那么结果为空值。

示例

  1. 使用当前月份的第一天设置主变量 FIRST_OF_MONTH。
       SET :FIRST_OF_MONTH = FIRST_DAY(CURRENT_DATE)
    主变量 FIRST_OF_MONTH 使用表示当前月份开始的值进行设置。 如果当前日期为 2000-02-10 ，那么 FIRST_OF_MONTH 设置为 2000-02-01。
  2. 使用给定日期的 IBM® 欧洲标准格式的每月第一天设置主变量 FIRST_OF_MONTH。
       SET :FIRST_OF_MONTH = CHAR(FIRST_DAY(DATE '1965-07-07'), EUR)
    主变量 FIRST_OF_MONTH 设置为值 "01.07.1965"。