QUARTER (SQL)

Synopsis

{fn QUARTER(date-expression)}

概要

QUARTER は 1 ～ 4 の整数を返します。四半期は、InterSystems IRIS 日付整数、$HOROLOG 値や $ZTIMESTAMP 値、ODBC 形式の日付文字列、またはタイムスタンプに基づいて計算されます。

date-expression タイムスタンプには、データ型 %Library.PosixTimeOpens in a new tab (エンコードされた 64 ビットの符号付き整数) またはデータ型 %Library.TimeStampOpens in a new tab (yyyy-mm-dd hh:mm:ss.fff) のいずれかを指定できます。

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

QUARTER は、日付/時刻文字列の月の部分に基づきます。ただし、date-expression のすべてが検証され、1 から12 までの範囲の月、および指定した月と年の有効な日の値を含む必要があります。それ以外の場合には、SQLCODE -400 エラー <ILLEGAL VALUE> が生成されます。date-expression の時刻部分は省略可能ですが、存在する場合は有効である必要があります。

DATEPART または DATENAME 関数を使用しても、同じ四半期情報を取得できます。DATEADD または TIMESTAMPADD 関数を使用して、指定した四半期数で日付をインクリメントできます。

この関数は、ObjectScript から QUARTER()Opens in a new tab メソッド・コールを使用して呼び出すこともできます。

$SYSTEM.SQL.Functions.QUARTER(date-expression)

例

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

SELECT {fn QUARTER('2018-02-22')} AS ODBCDateQ

SELECT {fn QUARTER(64701)} AS HorologDateQ

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

SELECT {fn QUARTER({fn NOW()})} AS Q_Now,
       {fn QUARTER(CURRENT_DATE)} AS Q_CurrD,
       {fn QUARTER(CURRENT_TIMESTAMP)} AS Q_CurrTstamp,
       {fn QUARTER($ZTIMESTAMP)} AS Q_ZTstamp,
       {fn QUARTER($HOROLOG)} AS Q_Horolog

関連項目

• SQL 関数 ： DATENAME、DATEPART、DATEADD、MONTH、TO_DATE

• ObjectScript 関数： $ZDATE

• ObjectScript 特殊変数： $HOROLOG、$ZTIMESTAMP