QUARTER

与えられた日付式で、その年の四半期を 1 から 4 までの整数値として返す、スカラ日付/時刻関数です。

Synopsis

{fn QUARTER(date-expression)}

引数

date-expression

列の名前や、他のスカラ関数の結果、または日付やタイムスタンプ・リテラルである式

概要

QUARTER は日付整数または日付/時刻文字列を受け取り、その年の四半期を整数として返します。日付/時刻文字列は、以下の形式で指定します。

yyyy-mm-dd hh:mm:ss

四半期の期間は以下の通りです。

四半期	期間
1	1 月 1 日から 3 月 31 日まで
2	4 月 1 日から 6 月 30 日まで
3	7 月 1 日から 9 月 30 日まで
4	10 月 1 日から 12 月 31 日まで

QUARTER は、日付/時刻文字列の月の部分のみを評価します。QUARTER は、ユーザの指定値に対して値や範囲チェックを実行しません。無効な月の値は、以下のように返されます。月 = 0 は 1 を返します。月 > 12 は 4 を返します。

DATEPART または DATENAME 関数を使用しても、同じ四半期情報が返されます。DATEPART および DATENAME は、正式な日付文字列上で値と範囲チェックを実行します。DATEADD または TIMESTAMPADD 関数を使用して、指定した四半期数で日付をインクリメントできます。

以下のメソッド・コールを使用することで、Caché ObjectScript からこの関数を呼び出すこともできます。

$SYSTEM.SQL.QUARTER(date-expression)

例

以下の例は、与えられた日付 (2 月 25 日) が 1 年の第 1 四半期内にあるので、どちらも 1 を返します。

SELECT DISTINCT {fn QUARTER('2004-02-25')} AS Q_Given
FROM Sample.Person

SELECT DISTINCT {fn QUARTER(59590)} AS Q_Given
FROM Sample.Person

以下の例は、現在の四半期を返します。

SELECT DISTINCT {fn QUARTER({fn NOW()})} AS Q_Now
FROM sample.person

SELECT DISTINCT {fn QUARTER(CURRENT_DATE)} AS Q_Now
FROM Sample.Person