inmonths - スクリプトおよびチャート関数
この関数は、タイムスタンプが基準日と同じ月、隔月、四半期、4 か月、または半年に該当するかどうかを確認します。タイムスタンプがその前後の期間に該当するか確認することもできます。
構文:
InMonths(n_months, timestamp, base_date, period_no [, first_month_of_year])
戻り値データ型: ブール値
Qlik Sense では、真のブール値は -1 で表現され、偽の値は 0 で表現されます。
inmonths() 関数は、指定された n_months 引数に基づいて年をセグメントに分割します。次に、評価する各タイムスタンプが base_date 引数と同じセグメントに当たるかどうかを評価します。ただし、period_no 引数が入力されると、関数はタイムスタンプが base_date の前と後のどちらの期間に入るかを決定します。
次の年のセグメントは、 n_month 引数として関数で使用できます。
期間 | 月数 |
---|---|
月 | 1 |
隔月 | 2 |
四半期 | 3 |
4 か月 | 4 |
半年 | 6 |
使用に適しているケース
inmonths() 関数はブール値の結果を返します。通常、このタイプの関数は if expression の条件として使用されます。inmonths() 関数を使用することにより、評価する期間を選択できます。例えば、ユーザーが特定の期間のその月、四半期、6 か月に製造された製品を特定できるようにします。
戻り値データ型: ブール値
Qlik Sense では、真のブール値は -1 で表現され、偽の値は 0 で表現されます。
引数 | 説明 |
---|---|
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 の間の値を指定します。 |
次の値を使用して、first_month_of_year 引数に年の最初の月を設定できます。
月 | 値 |
---|---|
February | 2 |
3 月 | 3 |
April | 4 |
May | 5 |
June | 6 |
7 月 | 7 |
8 月 | 8 |
September | 9 |
10 月 | 10 |
November | 11 |
12 月 | 12 |
地域の設定
特に指定のない限り、このトピックの例では次の日付書式を使用しています: MM/DD/YYYY。日付書式は、データ ロード スクリプトの SET DateFormat ステートメントで指定されています。既定の日付書式は、地域の設定やその他の要因により、システムによって異なる場合があります。以下の例の書式は、要件に合わせて変更できます。または、これらの例に一致するようにロード スクリプトの書式を変更できます。
App の既定の地域設定は、Qlik Sense がインストールされているコンピューターまたはサーバーの地域システム設定に基づいています。アクセスしている Qlik Sense サーバーがスウェーデンに設定されてい場合、データ ロード エディターは、日付、時間、および通貨にスウェーデンの地域設定を使用します。これらの地域の書式設定は、Qlik Sense ユーザー インターフェースに表示される言語とは関係ありません。Qlik Sense は使用しているブラウザと同じ言語で表示されます。
例 | 結果 |
---|---|
inmonths(4, '01/25/2013', '04/25/2013', 0) | TRUE を返します。日付と時刻の値 25/01/2013 は、01/01/2013 ~ 30/04/2013 までの 4 か月の期間内です。この期間には、base_date の値 25/04/2013 も含まれています。 |
inmonths(4, '05/25/2013', '04/25/2013', 0) | FALSE を返します。25/05/2013 は、前述の例にある期間の範囲外です。 |
inmonths(4, '11/25/2012', '02/01/2013', -1 ) | TRUE を返します。period_no の値が -1 のため、検索期間を 4 か月前 (n-months の値) にずらして、01/09/2012 ~ 31/12/2012 までの期間にします。 |
inmonths(4, '05/25/2006', '03/01/2006', 0, 3) | TRUE を返します。first_month_of_year の値が 3 に設定されているため、検索期間は 01/01/2006 ~ 30/04/2006 ではなく 01/03/2006 ~ 30/07/2006 になります。 |