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

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

この関数は、timestampbase_date のミリ秒単位まで正確に base_date を含む週の範囲内にある場合、True を返します。

構文:  

InWeekToDate (timestamp, base_date, period_no [, first_week_day])

戻り値データ型: ブール値

情報メモ

Qlik Sense では、真のブール値は -1 で表現され、偽の値は 0 で表現されます。

inweektodate 関数の図

inweektodate 関数が TRUE の値を返す日付範囲の例の図。

inweektodate() 関数は、 base_date パラメータを使用して、 FirstWeekDay システム変数 (またはユーザー定義の first_week_day パラメータ) に基づいて、週セグメントの最大境界日と、それに対応する週の開始日を識別します。この週セグメントが定義されると、指定された日付値をそのセグメントと比較する際、関数はブール値の結果を返します。

使用に適しているケース

inweektodate() 関数はブール値の結果を返します。通常、このタイプの関数は if 式の条件として使用されます。これにより、評価された日付が特定の日付を含む問題の週に発生したかどうかに応じて、集計または計算を返します。

たとえば、 inweektodate() 関数を使用して、指定された週の特定の日付までのすべての売上を計算できます。

引数
引数 説明
timestamp base_date と比較する日付。
base_date 週の評価に使用する日付。
period_no 週は period_no によって補正することができます。period_no は整数で、値 0 は base_date を含む週を示します。period_no の値が負の場合は過去の週を、正の場合は将来の週を示します。
first_week_day

既定では、週の最初の曜日は日曜日 (FirstWeekDay システム変数で決定) で、土曜日と日曜日の間の午前 0 時に始まります。 first_week_day パラメータは FirstWeekDay 変数に取って代わります。別の曜日から始まる週を指定するには、0~6 でフラグを指定します。

月曜日で始まり日曜日で終わる週の場合、月曜日は 0、火曜日は 1、水曜日は 2、木曜日は 3、金曜日は 4、土曜日は 5、日曜日は 6 のフラグを使用します。

 

関数の例
相互作用
inweektodate('01/12/2006', '01/12/2006', 0) TRUE を返します。
inweektodate('01/12/2006', '01/11/2006', 0) FALSE を返します。
inweektodate('01/12/2006', '01/18/2006', -1) FALSE を返します。
period_no-1 が指定されているため、timestampと比較する日付は 01/11/2006 になります。
inweektodate('01/11/2006', '01/12/2006', 0, 3 ) FALSE を返します。first_week_day3 (木曜日) が指定されているので、01/12/200601/12/2006 を含む週の次の週の初日になります。

この関数を使用する際に便利なトピックには次のようなものがあります。

関連トピック
トピック 既定 フラグ / 値 説明
FirstWeekDay 6 / 日曜日 各週の開始日を定義します。

地域の設定

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

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

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

例 1 – 追加の引数なし

例 2 – period_no

例 3 – first_week_day

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

例 5 – シナリオ