メイン コンテンツをスキップする 補完的コンテンツへスキップ

quartername - スクリプトおよびチャート関数

この関数は、四半期の初日の最初のミリ秒のタイムスタンプに対応する値を基底として、四半期の月数 (MonthNames スクリプト変数に従った書式) および年の表示値を返します。

構文:  

QuarterName(date[, period_no[, first_month_of_year]])

戻り値データ型: dual

quartername() 関数の図

入力日付を、その日付が発生する四半期に含まれる月の範囲に変換する quartername 関数の例を示す図。

quartername() 関数は、日付がどの四半期に該当するかを判断します。次に、この四半期と年の開始と終了月を示す値を返します。この結果の基礎となる数値は、四半期の最初のミリ秒です。

引数
引数 説明
date 評価する日付またはタイムスタンプ。
period_no period_no は整数で、値 0 は date を含む四半期を示します。period_no の値が負の場合は過去の四半期を、正の場合は将来の四半期を示します。
first_month_of_year 事業年度が 1 月以外の月に始まる場合は、first_month_of_year で 2 から 12 の間の値を指定します。

使用に適しているケース

quartername() 関数は、集計を四半期単位で比較する場合に便利です。たとえば、製品の総売上高を四半期ごとに表示する場合などが考えられます。

この関数は、マスター カレンダー テーブルに項目を作成することにより、ロード スクリプトで作成できます。あるいは、計算としてチャートで直接使用することもできます。

これらの例は、日付書式 DD/MM/YYYY を使用しています。日付書式は、データ ロード スクリプト上部の SET DateFormat ステートメントで指定されています。必要に応じて、書式を変更してください。

関数の例
結果
quartername('10/29/2013') Oct-Dec 2013 を返します。
quartername('10/29/2013', -1) Jul-Sep 2013 を返します。
quartername('10/29/2013', 0, 3) Sep-Nov 2013 を返します。

地域の設定

特に指定のない限り、このトピックの例では次の日付書式を使用しています: MM/DD/YYYY。日付書式は、データ ロード スクリプトの SET DateFormat ステートメントで指定されています。既定の日付書式は、地域の設定やその他の要因により、システムによって異なる場合があります。以下の例の書式は、要件に合わせて変更できます。または、これらの例に一致するようにロード スクリプトの書式を変更できます。詳しくは「アプリとスクリプトの地域設定の変更」を参照してください。

アプリの既定地域設定は、ユーザー プロファイルに基づいています。これらの地域の書式設定は、Qlik Cloud ユーザー インターフェースに表示される言語とは関係ありません。Qlik Cloud は使用しているブラウザと同じ言語で表示されます。

アプリの作成者は、作成するアプリの既定の地域を設定できます。詳細については、「Qlik Cloud Analytics でアプリとスクリプトを作成するための優先地域設定の設定」を参照してください。

例 1 – 追加の引数がない日付

例 2 – period_no 引数を持つ日付

例 3 – first_week_day 引数を持つ日付

例 4 – チャート オブジェクトの例

例 5 – シナリオ

このページは役に立ちましたか?

このページまたはコンテンツに、タイポ、ステップの省略、技術的エラーなどの問題が見つかった場合は、お知らせください。改善に役立たせていただきます。