メイン コンテンツをスキップする

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

この関数は、date を含む週の初日の最初のミリ秒のタイムスタンプに対応する数値を基底として、年と週番号を表示する値を返します。

構文:  

WeekName(date[, period_no[,first_week_day]])

weekname() 関数は、日付が属する週を判別し、その週の週番号と年を返します。週の最初の曜日は、 FirstWeekDay システム変数によって決定されます。ただし、 weekname() 関数で first_week_day 引数を使用して、週の最初の曜日を変更することもできます。

既定で、Qlik Sense アプリケーションは分割された週 (BrokenWeeks システム変数で定義) を使用するため、発生日数に関係なく週数のカウントは 1 月 1 日に始まり、FirsWeekDay システム変数の前日に終了します。

weekname 関数の図。

weekname 関数で設定できる年と週の範囲を示す図。

ただし、アプリケーションが連続した週を使用している場合、第 1 週は前年または 1 月の最初の数日間に開始できます。これは、 ReferenceDay および FirstWeekDay システム変数の使用方法によって異なります。

weekname() 関数は、集計を週単位で比較する場合に便利です。

たとえば、製品の総売上高を週ごとに表示する場合などが考えられます。アプリケーションで BrokenWeeks システム変数との一貫性を維持するには、 weekname() の代わりに lunarweekname() を使用します。アプリケーションが連続週を使用している場合、第 1 週には前年の 12 月の日付が含まれるか、今年の 1 月の日付が除外されます。アプリケーションが分割された週を使用している場合、第 1 週 に含まれる日数が 7 日間を下回ることがあります。

戻り値データ型: dual

引数
引数 説明
date 評価する日付。
period_no shift は整数で、値 0 は date を含む週を示します。shift の値が負の場合は過去の週を、正の場合は将来の週を示します。
first_week_day

週の開始日を指定します。省略されている場合は、変数 FirstWeekDay の値が使用されます。

FirstWeekDay

次の値を使用して、first_week_day 引数で週が始まる日を設定できます。

first_week_day values
毎日
月曜日 0
火曜日 1
水曜日 2
木曜日 3
金曜日 4
土曜日 5
日曜日 6

地域の設定

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

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

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

関数の例
結果
weekname('01/12/2013') 2013/02 を返します。
weekname('01/12/2013', -1) Returns 2013/01.
weekname('01/12/2013', 0, 1) 2013/02 を返します。

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

例 2 – period_no

例 3 – first_week_day

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

例 5 – シナリオ