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

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

この関数は、date を含む暦週の初日の最初のミリ秒のタイムスタンプに対応する値を返します。デフォルトの出力形式は、スクリプトに設定されている DateFormat です。

構文:  

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

戻り値データ型: dual

weekstart() 関数の図

weekstart 関数が、入力日を、その日付が発生する週の最初のミリ秒のタイムスタンプに変換する方法を示した例の図。

weekstart() 関数は、日付がどの週に該当するかを判断します。次に、その年の最初のミリ秒のタイムスタンプを日付形式で返します。週の最初の曜日は、 FirstWeekDay 環境変数によって決定されます。ただし、weekstart() 関数ではこれより first_week_day 引数が優先されます。

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

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

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

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

使用に適しているケース

weekstart() 関数は、ユーザーがこれまで経過した週の端数を計算に使用する場合に、数式の一部として一般的に使用されます。例えば、その週でこれまでに従業員が稼いだ合計賃金を計算したい場合に使用できます。

関数の例
結果
weekstart('01/12/2013') 01/07/2013 を返します。
weekstart('01/12/2013', -1 ) 11/31/2012 を返します。
weekstart('01/12/2013', 0, 1) 01/08/2013 を返します。

地域の設定

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

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

例 1 – 追加の引数なし

例 2 – period_no

例 3 – first_week_day

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

例 5 – シナリオ

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

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