THIS_YEAR スカラー関数

THIS_YEAR 関数は、指定した日付の年の最初の日を戻します。

Read syntax diagramSkip visual syntax diagramTHIS_YEAR(datetime-expression )

スキーマは SYSIBM です。

日時式 (datetime-expression)
日付を指定する式。その日付の年の最初の日が戻されます。 式は DATE、TIMESTAMP、CHAR、 または VARCHAR データ・タイプの値を戻す必要があります。 Unicode データベースでは、 式は GRAPHIC または VARGRAPHIC のデータ・タイプにすることもできます。 CHAR、VARCHAR、GRAPHIC、および VARGRAPHIC は、暗黙的キャストを介してサポートされます。 datetime-expression が CHAR、VARCHAR、GRAPHIC、または VARGRAPHIC のデータ・タイプである場合は、TIMESTAMP スカラー関数で使用できる有効なストリングでなければなりません。

関数の結果は DATE です。 引数が NULL になる可能性がある場合、結果も NULL になる可能性があります。 引数が NULL の場合、結果は NULL 値になります。

例

以下の例では、入力で指定した日付の年の最初の日の日付値を戻します。
values this_year('2007-02-18')
      Result: 2007-01-01