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

この関数は、タイムスタンプが、base_date の最後のミリ秒までの月、2 か月、四半期、4 か月、半年のいずれかの期間の範囲内か確認します。タイムスタンプがその前後の期間に該当するか確認することもできます。

構文:

InMonths (n_months, timestamp, base_date, period_no[, first_month_of_year ])

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

inmonthstodate 関数を使用して、タイムスタンプが設定された時間セグメントに含まれるかどうかを識別する方法を示す図。 — inmonthstodate 関数の図。

引数
引数	説明
n_months	期間を定義する月数。整数、または計算結果が整数になる数式で次のうちのいずれかでなければならない。1 (inmonth() 関数と同機能)、2 (2 か月)、3 (inquarter() 関数と同機能)、4 (4 か月)、6 (半年)。
timestamp	base_date と比較する日付。
base_date	期間の評価に使用する日付。
period_no	期間は、period_no、整数、計算結果が整数になる数式を使用して補正できます。値 0 は base_date を含む期間を示します。period_no の値が負の場合は過去の期間を、正の場合は将来の期間を示します。
first_month_of_year	事業年度が 1 月以外の月に始まる場合は、first_month_of_year で 2 から 12 の間の値を指定します。

inmonthstodate() 関数では、base_date がそれが属する特定の年度セグメントの終了点として機能します。

例えば、1 年を三分割して、base_date を 5 月 15 日とした場合、1 月～4 月のタイムスタンプは、ブール値として FALSE を返します。5 月 1 日～5 月 15 日の日付は TRUE を返します。年のそれ以外の日付は FALSE を返します。

inmonthstodate 関数のブール値結果の範囲を示す図。 — inmonthstodate 関数のブール値結果範囲の図。

次の年のセグメントは、 n_month 引数として関数で使用できます。

n_month 引数
期間	月数
月	1
隔月	2
四半期	3
3 か月ごと	4
半年	6

使用に適しているケース

inmonthstodate() 関数はブール値の結果を返します。通常、このタイプの関数は if expression の条件として使用されます。inmonthstodate() 関数を使用することにより、評価する期間を選択できます。例えば、ユーザーが特定の期間までの月、四半期、6 か月に製造された製品を特定できるようにする入力変数を提供します。

地域の設定

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

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

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

関数の例
例	結果
inmonthstodate(4, '01/25/2013', '04/25/2013', 0)	timestamp の値 01/25/2013 は、01/01/2013 から 04/25/2013 末までに渡る 4 か月の範囲内であるため、True を返します。この期間には、base_date、04/25/2013 の値も含まれています。
inmonthstodate(4, '04/26/2013', '04/25/2006', 0)	04/26/2013 は、上の例の期間の範囲外であるため、False を返します。
inmonthstodate(4, '09/25/2005', '02/01/2006', -1)	period_no の値 -1が、比較対象の期間が 4 か月 (n-months の値) ずれて、検索期間が 01/09/2005～02/01/2006 になるため、True を返します。
inmonthstodate(4, '04/25/2006', '06/01/2006', 0, 3)	first_month_of_year の値に 3 が設定されており、比較対象の期間が 05/01/2006～06/01/2006 ではなく、03/01/2006～06/01/2006 になっているため、True を返します。

例 1 – 追加の引数なし

概要

データロードエディターを開き、以下のロードスクリプトを新しいタブに追加します。

ロードスクリプトには次が含まれています。

「Transactions」というテーブルにロードされる、2022 年の一連のトランザクションを含むデータセット。
DateFormat システム変数 ((MM/DD/YYYY)) 形式の日付項目。
次を含む先行する LOAD ステートメント:
- 項目 [in_months_to_date] として設定された inmonthstodate() 関数。これは、2022 年 5 月 15 日までの四半期に発生したトランザクションを決定します。

ロードスクリプト

SET DateFormat='MM/DD/YYYY'; 
						
Transactions: 
    Load 
    *, 
    inmonthstodate(3,date,'05/15/2022', 0) as in_months_to_date 
    ; 
Load 
* 
Inline  
[ 
id,date,amount 
8188,'1/19/2022',37.23 
8189,'1/7/2022',17.17 
8190,'2/28/2022',88.27 
8191,'2/5/2022',57.42 
8192,'3/16/2022',53.80 
8193,'4/1/2022',82.06 
8194,'5/7/2022',40.39 
8195,'5/16/2022',87.21 
8196,'6/15/2022',95.93 
8197,'6/26/2022',45.89 
8198,'7/9/2022',36.23 
8199,'7/22/2022',25.66 
8200,'7/23/2022',82.77 
8201,'7/27/2022',69.98 
8202,'8/2/2022',76.11 
8203,'8/8/2022',25.12 
8204,'8/19/2022',46.23 
8205,'9/26/2022',84.21 
8206,'10/14/2022',96.24 
8207,'10/29/2022',67.67 
];

結果

データをロードしてシートを開きます。新しいテーブルを作成し、これらの項目を軸として追加します:

date
in_months_to_date

結果テーブル
日付	in_months_to_date
1/7/2022	0
1/19/2022	0
2/5/2022	0
2/28/2022	0
3/16/2022	0
4/1/2022	-1
5/7/2022	-1
5/16/2022	0
6/15/2022	0
6/26/2022	0
7/9/2022	0
7/22/2022	0
7/23/2022	0
7/27/2022	0
8/2/2022	0
8/8/2022	0
8/19/2022	0
9/26/2022	0
10/14/2022	0
10/29/2022	0

[in_months_to_date] 項目は、inmonthstodate() 関数を使用して、先行 Load ステートメントで作成されます。

提供される最初の引数は 3 で、年を四半期のセグメントに分割します。2 番目の引数は、評価される項目を識別します。第 3 引数は、5 月 15 日のハードコードされた日付です。これは base_date で、セグメントの終了境界を定義します。0 の period_no が最終引数です。

inmonthstodate 関数により TRUE と識別されたトランザクション範囲を示す図。 — 追加の引数がない inmonthstodate 関数の図。

4 月 1 日～5 月 15 日に発生したトランザクションは、TRUE のブール値の結果を返します。その期間外のトランザクション日付は FALSE を返します。

例 2 – period_no

概要

最初の例と同じデータセットとシナリオが使用されます。

ただし、この例のタスクは、トランザクションが 5 月 15 日より四半期前に発生するかどうかを決定する項目 [previous_qtr_to_date] を作成します。

ロードスクリプト

SET DateFormat='MM/DD/YYYY'; 
						
Transactions: 
    Load 
    *, 
    inmonthstodate(3,date,'05/15/2022', -1) as previous_qtr_to_date 
    ; 
Load 
* 
Inline  
[ 
id,date,amount 
8188,'1/19/2022',37.23 
8189,'1/7/2022',17.17 
8190,'2/28/2022',88.27 
8191,'2/5/2022',57.42 
8192,'3/16/2022',53.80 
8193,'4/1/2022',82.06 
8194,'5/7/2022',40.39 
8195,'5/16/2022',87.21 
8196,'6/15/2022',95.93 
8197,'6/26/2022',45.89 
8198,'7/9/2022',36.23 
8199,'7/22/2022',25.66 
8200,'7/23/2022',82.77 
8201,'7/27/2022',69.98 
8202,'8/2/2022',76.11 
8203,'8/8/2022',25.12 
8204,'8/19/2022',46.23 
8205,'9/26/2022',84.21 
8206,'10/14/2022',96.24 
8207,'10/29/2022',67.67 
];

結果

データをロードしてシートを開きます。新しいテーブルを作成し、これらの項目を軸として追加します:

date
previous_qtr_to_date

結果テーブル
日付	previous_qtr_to_date
1/7/2022	-1
1/19/2022	-1
2/5/2022	-1
2/28/2022	0
3/16/2022	0
4/1/2022	0
5/7/2022	0
5/16/2022	0
6/15/2022	0
6/26/2022	0
7/9/2022	0
7/22/2022	0
7/23/2022	0
7/27/2022	0
8/2/2022	0
8/8/2022	0
8/19/2022	0
9/26/2022	0
10/14/2022	0
10/29/2022	0

inmonthstodate() 関数で -1 を period_no 引数として使用することにより、関数は、比較対象年度の境界を四半期ずらします。

5 月 15 日はその年の第 2 四半期に分類されるため、セグメントは最初は 4 月 1 日～5 月 15 日に相当します。period_no 引数は、このセグメントを過去に 3 か月ずらします。日付境界が 1 月 1 日から 2 月 15 日になります。

period_no 引数が -1 に設定されたトランザクション範囲を示す図。 — period_no が -1 に設定された inmonthstodate 関数の図。

したがって、1 月 1 日～2 月 15 日に発生したトランザクションは、TRUE のブール値の結果を返します。

例 3 – first_month_of_year

概要

最初の例と同じデータセットとシナリオが使用されます。

この例では、組織ポリシーでは 3 月が会計期間の開始月に定められています。

2022 年 5 月 15 日まで同四半期に発生したトランザクションを決定する項目 [in_months_to_date] を作成します。

ロードスクリプト

SET DateFormat='MM/DD/YYYY'; 
						
Transactions: 
    Load 
    *, 
    inmonthstodate(3,date,'05/15/2022', 0,3) as in_months_to_date 
    ; 
Load 
* 
Inline  
[ 
id,date,amount 
8188,'1/19/2022',37.23 
8189,'1/7/2022',17.17 
8190,'2/28/2022',88.27 
8191,'2/5/2022',57.42 
8192,'3/16/2022',53.80 
8193,'4/1/2022',82.06 
8194,'5/7/2022',40.39 
8195,'5/16/2022',87.21 
8196,'6/15/2022',95.93 
8197,'6/26/2022',45.89 
8198,'7/9/2022',36.23 
8199,'7/22/2022',25.66 
8200,'7/23/2022',82.77 
8201,'7/27/2022',69.98 
8202,'8/2/2022',76.11 
8203,'8/8/2022',25.12 
8204,'8/19/2022',46.23 
8205,'9/26/2022',84.21 
8206,'10/14/2022',96.24 
8207,'10/29/2022',67.67 
];

結果

データをロードしてシートを開きます。新しいテーブルを作成し、これらの項目を軸として追加します:

date
in_months_to_date

結果テーブル
日付	previous_qtr_to_date
1/7/2022	0
1/19/2022	0
2/5/2022	0
2/28/2022	0
3/16/2022	-1
4/1/2022	-1
5/7/2022	-1
5/16/2022	0
6/15/2022	0
6/26/2022	0
7/9/2022	0
7/22/2022	0
7/23/2022	0
7/27/2022	0
8/2/2022	0
8/8/2022	0
8/19/2022	0
9/26/2022	0
10/14/2022	0
10/29/2022	0

inmonthstodate() 関数の first_month_of_year 引数に 3 を使用することにより、関数は 3 月 1 日に年度を開始し、次に入力された第 1 引数に基づいてその年度を四半期に分割します。したがって、四半期セグメントは次のとおりです。

3 月～5 月
6 月～8 月
9 月～11 月
12 月～2 月

次に、5 月 15 日の base_date は、5 月 15 日に終了境界を設定することにより、3 月～5 月の四半期をセグメント化します。

年度の最初の月が 3 月に設定されたトランザクションの範囲を示す図。 — 3 月が年の最初の月に設定された inmonthstodate 関数の図。

したがって、3 月 1 日～5 月 15 日に発生したトランザクションは TRUE のブール値の結果を返しますが、これらの境界外の日付のトランザクションは FALSE の値を返します。

例 4 – チャートの例

概要

最初の例と同じデータセットとシナリオが使用されます。

この例では、データセットは変更されず、アプリにロードされます。タスクは、アプリのチャートのメジャーとして、トランザクションが 5 月 15 日と同じ四半期に発生したかどうかを判断する計算を作成することです。

ロードスクリプト

SET DateFormat='MM/DD/YYYY'; 
						 
Transactions: 
Load 
* 
Inline  
[ 
id,date,amount 
8188,'1/19/2022',37.23 
8189,'1/7/2022',17.17 
8190,'2/28/2022',88.27 
8191,'2/5/2022',57.42 
8192,'3/16/2022',53.80 
8193,'4/1/2022',82.06 
8194,'5/7/2022',40.39 
8195,'5/16/2022',87.21 
8196,'6/15/2022',95.93 
8197,'6/26/2022',45.89 
8198,'7/9/2022',36.23 
8199,'7/22/2022',25.66 
8200,'7/23/2022',82.77 
8201,'7/27/2022',69.98 
8202,'8/2/2022',76.11 
8203,'8/8/2022',25.12 
8204,'8/19/2022',46.23 
8205,'9/26/2022',84.21 
8206,'10/14/2022',96.24 
8207,'10/29/2022',67.67 
];

結果

データをロードしてシートを開きます。新しいテーブルを作成し、この項目を軸として追加します:

date

5 月 15 日までの同じ四半期にトランザクションが発生したかどうかを計算するには、次のメジャーを作成します。

=inmonthstodate(3,date,'05/15/2022', 0)

結果テーブル
日付	=inmonthstodate(3,date,'05/15/2022', 0)
1/7/2022	0
1/19/2022	0
2/5/2022	0
2/28/2022	0
3/16/2022	0
4/1/2022	-1
5/7/2022	-1
5/16/2022	0
6/15/2022	0
6/26/2022	0
7/9/2022	0
7/22/2022	0
7/23/2022	0
7/27/2022	0
8/2/2022	0
8/8/2022	0
8/19/2022	0
9/26/2022	0
10/14/2022	0
10/29/2022	0

‘in_months_to_date メジャーは、 inmonthstodate() 関数を使用してチャートに作成されます。

TRUE ブール値を返すトランザクションの範囲を示す図。 — 四半期セグメントの inmonthstodate 関数の図。

4 月 1 日～5 月 15 日に発生したトランザクションは、TRUE のブール値の結果を返します。そのセグメント外のトランザクション日付は FALSE を返します。

例 5 – シナリオ

概要

この例では、「Sales」という名前のテーブルにデータセットがロードされます。テーブルには次の項目が含まれています。

製品 ID
製品の種類
販売日付
販売価格

エンドユーザーは、2022 年 12 月 24 日までの期間に販売された製品の売上を、製品タイプ別に表示するグラフを希望しています。ユーザーは期間の長さを定義したいと考えています。

ロードスクリプト

SET vPeriod = 1; 

Products: 
Load 
* 
Inline  
[ 
product_id,product_type,sales_date,sales_price 
8188,product A,'9/19/2022',37.23 
8189,product D,'10/27/2022',17.17 
8190,product C,'10/30/2022',88.27 
8191,product B,'10/31/2022',57.42 
8192,product D,'11/16/2022',53.80 
8193,product D,'11/28/2022',82.06 
8194,product A,'12/2/2022',40.39 
8195,product B,'12/5/2022',87.21 
8196,product C,'12/15/2022',95.93 
8197,product B,'12/16/2022',45.89 
8198,product C,'12/19/2022',36.23 
8199,product D,'12/22/2022',25.66 
8200,product D,'12/23/2022',82.77 
8201,product A,'12/24/2022',69.98 
8202,product A,'12/24/2022',76.11 
8203,product B,'12/26/2022',25.12 
8204,product B,'12/27/2022',46.23 
8205,product B,'12/27/2022',84.21 
8206,product C,'12/28/2022',96.24 
8207,product D,'12/29/2022',67.67 
];

結果

データをロードしてシートを開きます。

ロードスクリプトの開始時には、変数入力コントロールに関連付けられる変数 (vPeriod) が作成されます。

以下を実行します。

アセットパネルで、[カスタムオブジェクト] をクリックします。
[Qlik ダッシュボードバンドル] を選択して、シートに [変数入力] を追加します。
チャートのタイトルを入力します。
[変数] で、[名前] に [vPeriod] を選択し、オブジェクトを [ドロップダウン] として表示するように設定します。
[値] で、[ダイナミック] 値をクリックします。以下を入力します。
```
='1~month|2~bi-month|3~quarter|4~tertial|6~half-year'.
```
新しいテーブルをシートに追加します。
プロパティパネルの [データ] から、軸として product_type を追加します。
次の数式をメジャーとして追加します:

=sum(if(inmonthstodate($(vPeriod),sales_date,makedate(2022,12,24),0),sales_price,0))
メジャーの [数値書式] を [通貨] に設定します。

結果テーブル
product_type	=sum(if(inmonthstodate($(vPeriod),sales_date,makedate(2022,12,24),0),sales_price,0))
製品 A	$186.48
製品 B	$190.52
製品 C	$220.43
製品 D	$261.46

inmonthstodate() 関数は、ユーザー入力を引数として使用し、年の開始セグメントのサイズを定義します。

関数は各製品の販売日付を inmonthstodate() 関数の第 3 引数として渡します。inmonthstodate() 関数で 12 月 24 日を第 3 引数として使用することにより、12 月 24 日までの定義済み期間に発生した販売日付を持つ製品は TRUE のブール値を返します。sum 関数はこれらの製品の売上を合計します。

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

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

こちらにフィードバックをお寄せください