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

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

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

構文:  

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

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

情報メモ

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

inlunarweek() 関数は、base_date がどの旧暦の週に当たるかを決定します。次に、base_date と同じ旧暦の週の間に各タイムスタンプ値が発生することが決定したら、ブール値を返します。

inlunarweek() 関数の図

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

使用に適しているケース

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

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

引数
引数 説明
timestamp base_date と比較する日付。
base_date 週周期の評価に使用する日付。
period_no 週周期は period_no によって補正することができます。period_no は整数で、値 0 は base_date を含む週周期を示します。period_no の値が負の場合は過去の週周期を、正の場合は将来の週周期を示します。
first_week_day 0 未満または 0 よりも大きい補正値。日数または 1 日未満の長さ、またはその両方を指定して、年の開始時点を変更できます。
関数の例
結果
inlunarweek('01/12/2013', '01/14/2013', 0) timestamp の値 01/12/201301/08/201301/14/2013 の週に当たるため、TRUE を返します。
inlunarweek('01/12/2013', '01/07/2013', 0) base_date 01/07/201301/01/201301/07/2013 と定義された旧暦の週に当たるため、FALSE を返します。
inlunarweek('01/12/2013', '01/14/2013', -1) FALSE を返します。period_noの値に-1 が指定されており、前の週である 01/01/2013 から 01/07/2013 に週がシフトしています。
inlunarweek('01/07/2013', 01/14/2013', -1) TRUE を返します。上の例と異なり、timestamp は過去へシフトするとタイムスタンプがその週の範囲内になります。
inlunarweek('01/11/2006', '01/08/2006', 0, 3) FALSE を返します。first_week_day に値 3 を指定すると、年の初めが 01/04/2013 から計算されます。そのため、base_date の値は最初の週に当たり、timestamp の値は 01/11/201301/17/2013 の週に当たります。

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

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

地域の設定

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

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

例 1 – 追加の引数なし

例 2 – period_no

例 3 – first_week_day

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

例 5 – シナリオ

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

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