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

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

この関数は、入力された日付に対応する週番号を表す整数を返します。

構文:  

week(timestamp [, first_week_day [, broken_weeks [, reference_day]]])

戻り値データ型: integer

引数
引数 説明
timestamp 評価する日付またはタイムスタンプ。
first_week_day

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

first_week_day には、0 が月曜日、1 が火曜日、2 が水曜日、3 が木曜日、4 が金曜日、5 が土曜日、6 が日曜日の値を使用できます。

システム変数の詳細については、FirstWeekDay を参照してください。

broken_weeks

broken_weeksが指定されていない場合は、変数BrokenWeeksの値を使用して、週が分離しているかどうかを定義します。

システム変数の詳細については、BrokenWeeks を参照してください

reference_day

reference_day が指定されていない場合は、変数 ReferenceDay の値を使用して、第 1 週を定義する参照日として設定する 1 月の日を定義します。デフォルトでは、Qlik Sense 関数は 4 を参照日として使用します。これは、第 1 週に必ず 1 月 4 日が含まれる、または第 1 週に少なくとも 1 月の 4 日間が常に含まれることを意味します。

システム変数の詳細については、ReferenceDay を参照してください

week() 関数は、日付が属する週を判別し、その週の週番号を返します。

Qlik Sense では、アプリ設定時に地域設定がフェッチされ、対応する設定は環境変数としてスクリプトに保管されます。これらは、週番号を決定するために使用されます。

これはつまり、大部分のヨーロッパのアプリ開発者は、ISO 8601 定義に対応する次の環境変数を取得するということです。

Set FirstWeekDay =0; // Monday as first week day Set BrokenWeeks =0; // Use unbroken weeks Set ReferenceDay =4; // Jan 4th is always in week 1

北米のアプリ開発者は、頻繁に次の環境変数を取得します。

Set FirstWeekDay =6; // Sunday as first week day Set BrokenWeeks =1; // Use broken weeks Set ReferenceDay =1; // Jan 1st is always in week 1

週の最初の曜日は、 FirstWeekDay システム変数によって決定されます。 week() 関数で first_week_day 引数を使用して、週の最初の曜日を変更することもできます。

アプリケーションが分割された週を使用する場合、発生日数に関係なく週数のカウントは 1 月 1 日に始まり、FirstWeekDay システム変数の前日に終了します。

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

使用に適しているケース

The week() 関数は、集計を週単位で比較する場合に便利です。例えば、製品の総売上高を週ごとに表示する場合などに使用できます。week() 関数は、ユーザーがアプリケーションの BrokenWeeksFirstWeekDay、または ReferenceDay システム変数を必ずしも使用せずに計算を行いたい場合に、weekname() よりも優先して選択されます。

たとえば、製品の総売上高を週ごとに表示する場合などが考えられます。

アプリケーションが連続週を使用している場合、第 1 週には前年の 12 月の日付が含まれるか、今年の 1 月の日付が除外されます。アプリケーションが分割された週を使用している場合、第 1 週 に含まれる日数が 7 日間を下回ることがあります。

地域の設定

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

App の既定の地域設定は、Qlik Sense がインストールされているコンピューターまたはサーバーの地域システム設定に基づいています。アクセスしている Qlik Sense サーバーがスウェーデンに設定されてい場合、データ ロード エディターは、日付、時間、および通貨にスウェーデンの地域設定を使用します。これらの地域の書式設定は、Qlik Sense ユーザー インターフェースに表示される言語とは関係ありません。Qlik Sense は使用しているブラウザと同じ言語で表示されます。

下記の例では

Set DateFormat= 'MM/DD/YYYY'; Set FirstWeekDay=0; Set BrokenWeeks=0; Set ReferenceDay=4;
関数の例
結果

week('12/28/2021')

52 を返すとみなされます。

week(44614) これは、02/22/2022 のシリアル番号であるため、8 を返します。number for .
week('01/03/2021') 53 を返すと推測されます。
week('01/03/2021',6) 1 を返します。

例 1 - 既定システムの変数

例 2 – first_week_day

例 3 – unbroken_weeks

例 4 – reference_day

例 5 – Chart object example

例 6 – シナリオ

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

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