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

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

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

構文:  

weekyear(expression)

戻り値データ型: 整数

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

既定では、Qlik アプリが分離された週 (BrokenWeeks システム変数によって定義) を使用し、第 1 週は 1 月 1 日に始まり、年は第 52 週後に終了します。そのため、アプリケーションが分離された週を使用する場合、weekyear() 関数は week() 関数と同じ値を必ず返します。

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 ステートメントで指定されています。既定の日付書式は、地域の設定やその他の要因により、システムによって異なる場合があります。以下の例の書式は、要件に合わせて変更できます。または、これらの例に一致するようにロード スクリプトの書式を変更できます。

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

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

例 1 - 分離された週

例 2 - 未分離の週

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

例 4 – シナリオ

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

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