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

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

この関数は、環境変数に基づいた週番号が含まれる年を返します。週番号の範囲は、1 からおよそ 52 となります。

構文:  

weekyear(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 を参照してください

weekyear() 関数は、日付が年のどの週に該当するかを判断します。次に、その週番号に対応する年を返します。

BrokenWeeks0 (false) に設定されると、weekyear()year() と同じ結果を返します。

weekyear() 関数範囲の図

weekyear() 関数が評価する範囲を示す図。

ただし、BrokenWeeks システム変数が未分離の週を使用するように設定されている場合、ReferenceDay システム変数で指定した値に基づいて、第 1 週は 1 月の特定の日数のみを含むことになります。

例えば、ReferenceDay4 が使用される場合、第 1 週は 1 月に少なくとも 4 日を含む必要があります。第 1 週が前年 12 月の日付を含むことも、1 年の最後の週番号が翌年 1 月の日付を含むことも考えられます。このような状況では、weekyear() 関数は year() 関数に異なる値を返します。

未分離の週を使用した場合の、weekyear() 関数の範囲の図

weekyear() 関数が未分離の週を処理する様子を表示した図

weekyear() 関数は、集計を年単位で比較する場合に便利です。たとえば、製品の総売上高を年ごとに表示する場合などが考えられます。ユーザーがアプリBrokenWeeks システム変数との一貫性を維持したい場合は、year() ではなく weekyear() 関数が選択されます。

地域の設定

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

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

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

関数の例
結果
weekyear('12/30/1996',0,0,4) 1997 を返します (1997 年の第 1 週は 12/30/1996 に開始するため)
weekyear('01/02/1997',0,0,4) 1997 を返します
weekyear('12/28/1997',0,0,4) 1997 を返します
weekyear('12/30/1997',0,0,4) 1998 を返します (1998 年の第 1 週は 12/29/1997 に開始するため)
weekyear('01/02/1999',0,0,4) 1998 を返します (1998 年の第 53 週は 01/03/1999 に終了するため)
関連トピック
トピック 相互作用
week - スクリプトおよびチャート関数 ISO 8601 に従って、週番号を表す整数を返します
year - スクリプトおよびチャート関数 expression が標準的な数値の解釈に従って日付と判断される場合に、年を表す整数を返します。

例 1 - 分離された週

例 2 - 未分離の週

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

例 4 – シナリオ

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

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