YEAR

YEAR 関数は、指定された値の年の部分を戻します。

構文図を読む構文図をスキップする
>>-YEAR--(--expression--)--------------------------------------><

expression
日付、タイム・スタンプ、文字ストリング、グラフィック・ストリング、 または数値のいずれかの組み込みデータ・タイプの値を戻す式。
  • expression が 文字ストリングまたはグラフィック・ストリングの場合、その値は、日付またはタイム・スタンプの有効なストリング表現 でなければなりません。日付とタイム・スタンプのストリング表現の有効な形式に ついては、日付/時刻の値のストリング表記を参照してください。
  • が数値である場合は、その数値は日付期間またはタイム・スタンプ期間でなければなりません。 日時期間の有効な形式については、日付/時刻のオペランドと期間を参照してください。

この関数の結果は長精度整数になります。 引数が NULL になる可能性がある場合は、結果も NULL になる可能性があります。 引数が NULL の場合は、結果は NULL 値になります。

その他の規則は、引数のデータ・タイプに応じて以下のように異なります。

  • 引数が日付またはタイム・スタンプ、または、日付またはタイム ・スタンプの有効な文字ストリング表現である場合 :

    結果は、指定した値の年の部分 (1 から 9999 までの整数) になります。

  • 引数が日付期間またはタイム・スタンプ期間の場合 :

    結果は、指定した値の年の部分 (-9999 から 9999 までの整数) になります。ゼロ以外の結果の符号は、引数と同じになります。

  • 表 PROJECT から、開始 (PRSTDATE) と終了 (PRENDATE) が同じ年に予定されているプロジェクトをすべて選択します。
      SELECT *
        FROM PROJECT
        WHERE YEAR(PRSTDATE) = YEAR(PRENDATE)
  • 表 PROJECT から、1 年未満で完了するように予定されているプロジェクトをすべて選択します。
      SELECT *
        FROM PROJECT
        WHERE YEAR(PRENDATE - PRSTDATE) < 1