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

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

この関数は、timestampbase_date の最後のミリ秒までの週周期の範囲内か確認します。Qlik Sense の旧暦の週は、1 月 1 日を週の初日として数えるよう定義され、1 年の最終週を除いて正確に 7 日構成となります。

構文:  

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

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

情報メモ

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

inlunarweektodate() 関数の図の例

入力情報に即して TRUE 値を返す日付を表示した、inlunarweektodate 関数の図の例。

inlunarweektodate() 関数は、旧暦の週の終了点として機能します。一方、inlunarweek() 関数は、base_date がどの旧暦の週に当たるかを決定します。例えば、base_date が 1 月 5 日で、1 月 1 日~1 月 5 日のタイムスタンプはブール値の結果 TRUE を返しますが、1 月 6 日と 7 日以降はブール値 FALSE を返します。

引数
引数 説明
timestamp base_date と比較する日付。
base_date 週周期の評価に使用する日付。
period_no 週周期は period_no によって補正することができます。period_no は整数で、値 0 は base_date を含む週周期を示します。period_no の値が負の場合は過去の週周期を、正の場合は将来の週周期を示します。
first_week_day 0 未満または 0 よりも大きい補正値。日数または 1 日未満の長さ、またはその両方を指定して、年の開始時点を変更できます。

使用に適しているケース

inlunarweektodate() 関数はブール値の結果を返します。通常、このタイプの関数は IF 式の条件として使用されます。inlunarweektodate() 関数は、評価された日付が対象の週の特定のセグメントに発生したかどうかに応じて、集計または計算を返すようにユーザーが希望する場合に使用されます。

例えば、inlunarweektodate() 関数を使用して、特定の日付までの週に製造されたすべての機器を識別することができます。

関数の例
結果
inlunarweektodate('01/12/2013', '01/13/2013', 0) timestamp の値 01/12/201301/08/201301/13/2013 の週の一部に当たるため、TRUE を返します。
inlunarweektodate('01/12/2013', '01/11/2013', 0) 2 つの日付が 01/12/2012 の同じ旧暦の週にありますが、timestamp の値が base_date の値より後であるため、FALSE を返します。
inlunarweektodate('01/12/2006', '01/05/2006', 1) TRUE を返します。period_no に 1 を指定すると base_date を 1 週間先にシフトするので、timestamp の値がその週周期の範囲内になります。

inlunarweektodate() 関数は、多くの場合、次の関数と組み合わせて使用されます。

関連する関数
関数 相互作用
lunarweekname - スクリプトおよびチャート関数 この関数は、入力された日付が属する年の旧暦の週番号を決定するために使用されます。

地域の設定

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

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

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

例 1 – 追加の引数なし

例 2 – period_no

例 3 – first_week_day

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

例 5 – シナリオ

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

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