inyeartodate - スクリプトおよびチャート関数
この関数は、timestamp が base_date のミリ秒単位まで正確に base_date を含む年の範囲内にある場合、True を返します。
構文:
InYearToDate (timestamp, base_date, period_no[, first_month_of_year])
戻り値データ型: ブール値
Qlik Sense では、真のブール値は -1 で表現され、偽の値は 0 で表現されます。
inyeartodate() 関数は base_date でその年度の特定の部分を分割し、その年度セグメントの最大許容日付の両方を識別します。関数は、日付項目または値がこのセグメントに該当するかどうかを評価し、ブール値の結果を返します。
引数 | 説明 |
---|---|
timestamp | base_date と比較する日付。 |
base_date | 年の評価に使用する日付。 |
period_no | 年は period_no によって補正することができます。period_no は整数で、値 0 は base_date を含む年を示します。period_no の値が負の場合は過去の年を、正の場合は将来の年を示します。 |
first_month_of_year | 事業年度が 1 月以外の月に始まる場合は、first_month_of_year で 2 から 12 の間の値を指定します。 |
使用に適しているケース
inyeartodate() 関数はブール値の結果を返します。通常、このタイプの関数は if 式の条件として使用されます。これにより、評価される日付が問題の日付を含む年度に発生したかどうかに応じて、集計または計算を返します。
例えば、inyeartodate() 関数を使用して、特定の日付を含む年度に製造されたすべての機器を識別することができます。
これらの例は、日付書式 DD/MM/YYYY を使用しています。日付書式は、データ ロード スクリプト上部の SET DateFormat ステートメントで指定されています。必要に応じて、書式を変更してください。
例 | 結果 |
---|---|
inyeartodate ('01/25/2013', '02/01/2013', 0) | TRUE を返します。 |
inyeartodate ('01/25/2012', '01/01/2013', 0) | FALSE を返します。 |
inyeartodate ('01/25/2012', '02/01/2013', -1) | TRUE を返します。 |
inyeartodate ('11/25/2012', '01/31/2013', 0, 4) |
TRUE を返します。 timestamp の値は、4 番目の月から始まる会計年度かつ base_date の値までの範囲内です。 |
inyeartodate ('3/31/2013', '01/31/2013', 0, 4 ) |
FALSE を返します。 上の例との違いは、timestamp の値が会計年度内ではあるものの base_date の値の後になることです。そのため、範囲外になります。 |
地域の設定
特に指定のない限り、このトピックの例では次の日付書式を使用しています: MM/DD/YYYY。日付書式は、データ ロード スクリプトの SET DateFormat ステートメントで指定されています。既定の日付書式は、地域の設定やその他の要因により、システムによって異なる場合があります。以下の例の書式は、要件に合わせて変更できます。または、これらの例に一致するようにロード スクリプトの書式を変更できます。詳しくは「アプリとスクリプトの地域設定の変更」を参照してください。
アプリの既定地域設定は、ユーザー プロファイルに基づいています。これらの地域の書式設定は、Qlik Cloud ユーザー インターフェースに表示される言語とは関係ありません。Qlik Cloud は使用しているブラウザと同じ言語で表示されます。
アプリの作成者は、作成するアプリの既定の地域を設定できます。詳細については、「Qlik Cloud Analytics でアプリとスクリプトを作成するための優先地域設定の設定」を参照してください。