# yeartodate スクリプトおよびチャート関数 この関数は、入力したタイムスタンプがスクリプトが最後にロードされた日付の年に該当するかどうかを算出し、該当する場合は True を返し、該当しない場合は False を返します。スクリプトが最後にロードされた日付の年は、UTC 時間に基づいて評価されます。 構文: YearToDate(timestamp[ , yearoffset [ , firstmonth [ , todaydate] ] ]) 戻り値データ型： ブール値 情報メモ Qlik Sense では、真のブール値は -1 で表現され、偽の値は 0 で表現されます。 `yeartodate()` 関数の図の例 `yeartodate()` 関数の図の例 `yeartodate()`yeartodate() 関数の図の例 ![yeartodate 関数が TRUE または FALSE の値を返す日付値を表示している図。](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-function-yeartodate-overview.png) オプションのパラメータがどれも使用されていない場合、年初から当日までとは、さかのぼって直近の 1 月 1 日からスクリプトを最後に実行した日付までを含む 1 暦年以内のいずれかの日付を意味します。 つまり、`yeartodate()` 関数が、追加パラメータなしでトリガーされると、タイムスタンプを評価するために使用され、日付がリロードが発生した日付までのカレンダー年に発生したかどうかに基づいてブール値結果を返します。 ただし、`firstmonth` 引数を使用して年の開始日を上書きすることも、`yearoffset` 引数を使って前後の年と比較することもできます。 最後に、過去のデータセットの場合、`yeartodate()` 関数は `todaydate` を設定するパラメータを提供し、これによりタイムスタンプが `todaydate` 引数で提供された日付までのカレンダー年と比較されます。 引数 | 引数 | 説明 | | --- | --- | | timestamp | 評価するタイムスタンプ (例: '10/12/2012')。 | | yearoffset | yearoffset を指定することで、yeartodate は、別の年の同じ期間について True を返します。負の値の yearoffset は過去の年を示し、正の値の場合は将来の年を示します。前年 1 年間を取得するときは、yearoffset = -1 を指定します。省略された場合は、0 として処理されます。 | | firstmonth | firstmonth を 1～12 で指定することにより (省略した場合は 1)、年度の始めを任意の月の 1 日に動かすことができます。例えば、会計年度を 5 月 1 日から開始する場合には、firstmonth = 5 と指定します。 値 1 は、1 月 1 日に始まる会計年度を示し、値 12 は 12 月 1 日に始まる会計年度を示します。 | | todaydate | todaydate を指定することにより (省略した場合は最後にスクリプトを実行したタイムスタンプ)、期間の上限として使用する日付を移動できます。 | ## yeartodate の使用目的 `yeartodate()` 関数はブール値の結果を返します。通常、このタイプの関数は IF 式の条件として使用されます。これにより、評価された日付が、アプリケーションの前回のリロード日付を含む年度に発生したかどうかに応じて、集計または計算を返します。 例えば、YearToDate() 関数を使用して、現在の週のこれまでに製造されたすべての機器を識別することができます。 次の例では、最後のリロード時を 11/18/2011 としています。 関数の例 | 例 | 結果 | | --- | --- | | `yeartodate( '11/18/2010')` | の戻り値: False | | `yeartodate( '02/01/2011')` | の戻り値: True | | `yeartodate( '11/18/2011')` | の戻り値: True | | `yeartodate( '11/19/2011')` | の戻り値: False | | `yeartodate( '11/19/2011', 0, 1, '12/31/2011')` | の戻り値: True | | `yeartodate( '11/18/2010', -1)` | の戻り値: True | | `yeartodate( '11/18/2011', -1)` | の戻り値: False | | `yeartodate( '04/30/2011', 0, 5)` | の戻り値: False | | `yeartodate( '05/01/2011', 0, 5)` | の戻り値: True | ## リージョンの設定 特に指定のない限り、このトピックの例では MM/DD/YYYY の日付書式を使用しています。 日付書式は、データ ロード スクリプトの `SET DateFormat` ステートメントで指定されています。既定の日付書式は、リージョンの設定やその他の要因により、システムによって異なる場合があります。以下の例の書式は、要件に合わせて変更できます。または、これらの例に一致するようにロード スクリプトの書式を変更できます。詳しくは「[アプリケーションとスクリプトの地域設定の変更](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Apps/regional-settings-in-apps.htm)」を参照してください。 アプリケーションの既定のリージョン設定は、ユーザー プロファイルに基づいています。これらのリージョンの書式設定は、Qlik Cloud ユーザー インターフェースに表示される言語とは関係ありません。Qlik Cloud は使用しているブラウザと同じ言語で表示されます。 アプリケーションの作成者は、作成するアプリケーションの既定のリージョンを設定できます。詳細については、「[Qlik Cloud Analytics でアプリとスクリプトを作成するための優先地域設定の設定](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/UserInterface/Languages.htm#Setting)」を参照してください。 ## 例 1 – 基本的な例 [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/yeartodate.htm) #### ロード スクリプトと結果 概要 データ ロード エディターを開き、以下のロード スクリプトを新しいセクションに追加します。 ロード スクリプトには次が含まれています: * `Transactions` というテーブルにロードされる、2020 年～2022 年の一連のトランザクションを含むデータセット。 * `DateFormat` システム変数形式 (MM/DD/YYYY) で提供されている日付項目。 * 前回のリロード日付までのそのカレンダー年に発生したトランザクションを決定する項目 `year_to_date` の作成。 書き込み時には、日付は 2022 年 4 月 26 日です。 ロード スクリプト ``` SET DateFormat='MM/DD/YYYY'; Transactions: Load *, yeartodate(date) as year_to_date ; Load * Inline [ id,date,amount 8188,01/10/2020,37.23 8189,02/28/2020,17.17 8190,04/09/2020,88.27 8191,04/16/2020,57.42 8192,05/21/2020,53.80 8193,08/14/2020,82.06 8194,10/07/2020,40.39 8195,12/05/2020,87.21 8196,01/22/2021,95.93 8197,02/03/2021,45.89 8198,03/17/2021,36.23 8199,04/23/2021,25.66 8200,05/04/2021,82.77 8201,06/30/2021,69.98 8202,07/26/2021,76.11 8203,12/27/2021,25.12 8204,02/02/2022,46.23 8205,02/26/2022,84.21 8206,03/07/2022,96.24 8207,03/11/2022,67.67 ]; ``` 結果 データをロードしてシートを開きます。新しいテーブルを作成し、これらの項目を軸として追加します: * `date` * `year_to_date` 結果テーブル | date | year\_to\_date | | --- | --- | | 01/10/2020 | 0 | | 02/28/2020 | 0 | | 04/09/2020 | 0 | | 04/16/2020 | 0 | | 05/21/2020 | 0 | | 08/14/2020 | 0 | | 10/07/2020 | 0 | | 12/05/2020 | 0 | | 01/22/2021 | 0 | | 02/03/2021 | 0 | | 03/17/2021 | 0 | | 04/23/2021 | 0 | | 05/04/2021 | 0 | | 06/30/2021 | 0 | | 07/26/2021 | 0 | | 12/27/2021 | 0 | | 02/02/2022 | -1 | | 02/26/2022 | -1 | | 03/07/2022 | -1 | | 03/11/2022 | -1 | `yeartodate()` 関数の図、基本的な例 `yeartodate()` 関数の図、基本的な例 `yeartodate()`yeartodate() 関数の図、基本的な例 ![yeartodate 関数が TRUE または FALSE の値を返す日付値を表示している図。](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-function-yeartodate-examples-basic.png) `year_to_date` 項目は、`yeartodate()` 関数を使用し、関数の引数として `date` 項目を渡すことにより、先行する LOAD ステートメントで作成されます。 それ以外のパラメータは関数に渡されないため、`yeartodate()` 関数は最初にリロード日付、そして現在のカレンダー年 (1 月 1 日開始) の境界を特定し、ブール値結果 `TRUE` を返します。 したがって、1 月 1 日～4 月 26 日に発生したトランザクションの場合、リロード日付は `TRUE`のブール値の結果を返します。2022 年始めの前に発生したトランザクションは、ブール値結果 `FALSE` を返します。 ## 例 2 – yearoffset [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/yeartodate.htm) #### ロード スクリプトと結果 概要 データ ロード エディターを開き、以下のロード スクリプトを新しいセクションに追加します。 ロード スクリプトには次が含まれています: * 最初の例と同じデータセットとシナリオ。 * カレンダー年初来前 2 年間全体に発生したトランザクションを決定する項目 [`two_years_prior`] の作成。 ロード スクリプト ``` SET DateFormat='MM/DD/YYYY'; Transactions: Load *, yeartodate(date,-2) as two_years_prior ; Load * Inline [ id,date,amount 8188,01/10/2020,37.23 8189,02/28/2020,17.17 8190,04/09/2020,88.27 8191,04/16/2020,57.42 8192,05/21/2020,53.80 8193,08/14/2020,82.06 8194,10/07/2020,40.39 8195,12/05/2020,87.21 8196,01/22/2021,95.93 8197,02/03/2021,45.89 8198,03/17/2021,36.23 8199,04/23/2021,25.66 8200,05/04/2021,82.77 8201,06/30/2021,69.98 8202,07/26/2021,76.11 8203,12/27/2021,25.12 8204,02/02/2022,46.23 8205,02/26/2022,84.21 8206,03/07/2022,96.24 8207,03/11/2022,67.67 ]; ``` 結果 データをロードしてシートを開きます。新しいテーブルを作成し、これらの項目を軸として追加します: * `date` * `two_years_prior` 結果テーブル | date | two\_years\_prior | | --- | --- | | 01/10/2020 | -1 | | 02/28/2020 | -1 | | 04/09/2020 | -1 | | 04/16/2020 | -1 | | 05/21/2020 | 0 | | 08/14/2020 | 0 | | 10/07/2020 | 0 | | 12/05/2020 | 0 | | 01/22/2021 | 0 | | 02/03/2021 | 0 | | 03/17/2021 | 0 | | 04/23/2021 | 0 | | 05/04/2021 | 0 | | 06/30/2021 | 0 | | 07/26/2021 | 0 | | 12/27/2021 | 0 | | 02/02/2022 | 0 | | 02/26/2022 | 0 | | 03/07/2022 | 0 | | 03/11/2022 | 0 | `yeartodate()` 関数で -2 を `yearoffset` 引数として使用することにより、関数は、比較対象のカレンダー年の境界を 2 年間ずらします。最初、年セグメントは 2022 年 1 月 1 日～4 月 26 日に相当します。`yearoffset` 引数は次にこのセグメントを 2 年前にオフセットします。そうすると、日付の境界線は 2020 年 1 月 1 日～4 月 26 日に入ります。 `yeartodate()` 関数の図、yearoffset の例 `yeartodate()` 関数の図、yearoffset の例 `yeartodate()`yeartodate() 関数の図、yearoffset の例 ![yeartodate 関数が TRUE または FALSE の値を返す日付値を表示している図。](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-function-yeartodate-examples-yearoffset.png) したがって、1 月 1 日～4 月 26 日に発生したトランザクションは、`TRUE`のブール値の結果を返します。このセグメントの前後に発生されるトランザクションは `FALSE` を返します。 ## 例 3 – firstmonth [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/yeartodate.htm) #### ロード スクリプトと結果 概要 データ ロード エディターを開き、以下のロード スクリプトを新しいセクションに追加します。 ロード スクリプトには次が含まれています: * 最初の例と同じデータセットとシナリオ。 * 前回のリロード日付までのそのカレンダー年に発生したトランザクションを決定する項目 [`year_to_date`] の作成。 この例では、会計年度の開始を 7 月 1 日に設定します。 ロード スクリプト ``` SET DateFormat='MM/DD/YYYY'; Transactions: Load *, yeartodate(date,0,7) as year_to_date ; Load * Inline [ id,date,amount 8188,01/10/2020,37.23 8189,02/28/2020,17.17 8190,04/09/2020,88.27 8191,04/16/2020,57.42 8192,05/21/2020,53.80 8193,08/14/2020,82.06 8194,10/07/2020,40.39 8195,12/05/2020,87.21 8196,01/22/2021,95.93 8197,02/03/2021,45.89 8198,03/17/2021,36.23 8199,04/23/2021,25.66 8200,05/04/2021,82.77 8201,06/30/2021,69.98 8202,07/26/2021,76.11 8203,12/27/2021,25.12 8204,02/02/2022,46.23 8205,02/26/2022,84.21 8206,03/07/2022,96.24 8207,03/11/2022,67.67 ]; ``` 結果 データをロードしてシートを開きます。新しいテーブルを作成し、これらの項目を軸として追加します: * `date` * `year_to_date` 結果テーブル | date | year\_to\_date | | --- | --- | | 01/10/2020 | 0 | | 02/28/2020 | 0 | | 04/09/2020 | 0 | | 04/16/2020 | 0 | | 05/21/2020 | 0 | | 08/14/2020 | 0 | | 10/07/2020 | 0 | | 12/05/2020 | 0 | | 01/22/2021 | 0 | | 02/03/2021 | 0 | | 03/17/2021 | 0 | | 04/23/2021 | 0 | | 05/04/2021 | 0 | | 06/30/2021 | 0 | | 07/26/2021 | -1 | | 12/27/2021 | -1 | | 02/02/2022 | -1 | | 02/26/2022 | -1 | | 03/07/2022 | -1 | | 03/11/2022 | -1 | この例では、`yeartodate()` 関数で `firstmonth` 引数 7 が使用されているため、年の最初の日は 7 月 1 日、年の最後の日が 6 月 30 日に設定されます。 `yeartodate()` 関数、firstmonth 例の図 `yeartodate()` 関数、firstmonth 例の図 `yeartodate()`yeartodate() 関数、firstmonth 例の図 ![yeartodate 関数が TRUE または FALSE の値を返す日付値を表示している図。](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-function-yeartodate-examples-firstmonth.png) したがって、2021 年 7 月 1 日～2022 年 4 月 26 日に発生したトランザクションの場合、リロード日付は `TRUE`のブール値の結果を返します。2021 年 7 月 1 日の前に発生したトランザクションは、ブール値結果 `FALSE` を返します。 ## 例 4 – todaydate [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/yeartodate.htm) #### ロード スクリプトと結果 概要 データ ロード エディターを開き、以下のロード スクリプトを新しいセクションに追加します。 ロード スクリプトには次が含まれています: * 最初の例と同じデータセットとシナリオ。 * 前回のリロード日付までのそのカレンダー年に発生したトランザクションを決定する項目 [year\_to\_date] の作成。 ただし、この例では、2022 年 3 月 1 日までを含むカレンダー年に発生したすべてのトランザクションを特定する必要があります。 ロード スクリプト ``` SET DateFormat='MM/DD/YYYY'; Transactions: Load *, yeartodate(date, 0, 1, '03/01/2022') as year_to_date ; Load * Inline [ id,date,amount 8188,01/10/2020,37.23 8189,02/28/2020,17.17 8190,04/09/2020,88.27 8191,04/16/2020,57.42 8192,05/21/2020,53.80 8193,08/14/2020,82.06 8194,10/07/2020,40.39 8195,12/05/2020,87.21 8196,01/22/2021,95.93 8197,02/03/2021,45.89 8198,03/17/2021,36.23 8199,04/23/2021,25.66 8200,05/04/2021,82.77 8201,06/30/2021,69.98 8202,07/26/2021,76.11 8203,12/27/2021,25.12 8204,02/02/2022,46.23 8205,02/26/2022,84.21 8206,03/07/2022,96.24 8207,03/11/2022,67.67 ]; ``` 結果 データをロードしてシートを開きます。新しいテーブルを作成し、これらの項目を軸として追加します: * date * year\_to\_date 結果テーブル | date | year\_to\_date | | --- | --- | | 01/10/2020 | 0 | | 02/28/2020 | 0 | | 04/09/2020 | 0 | | 04/16/2020 | 0 | | 05/21/2020 | 0 | | 08/14/2020 | 0 | | 10/07/2020 | 0 | | 12/05/2020 | 0 | | 01/22/2021 | 0 | | 02/03/2021 | 0 | | 03/17/2021 | 0 | | 04/23/2021 | 0 | | 05/04/2021 | 0 | | 06/30/2021 | 0 | | 07/26/2021 | 0 | | 12/27/2021 | 0 | | 02/02/2022 | -1 | | 02/26/2022 | -1 | | 03/07/2022 | 0 | | 03/11/2022 | 0 | この場合、todaydate 引数 03/01/2022 が yeartodate() 関数で使用されるため、比較対象カレンダー年の終了境界線が 2022 年 3 月 1 日に設定されます。firstmonth パラメータ (1～2) を提供することが重要です。そうしないと、関数が null 結果を返すことになります。 todaydate 引数を使用している yeartodate() 関数の例の図 todaydate 引数を使用している yeartodate() 関数の例の図 todaydate 引数を使用している yeartodate()yeartodate() 関数の例の図 ![yeartodate 関数が TRUE または FALSE の値を返す日付値を表示している図。](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-function-yeartodate-examples-todaydate.png) したがって、2022 年 1 月 1 日～2022 年 3 月 1 日に発生したトランザクションの場合、todaydate パラメータはブール値の結果 TRUE を返します。2022 年 1 月 1 日の前、または 2022 年 3 月 1 日の後に発生したトランザクションは、ブール値結果 FALSE を返します。 ## 例 5 – Chart object example [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/yeartodate.htm) #### ロード スクリプトとチャートの数式 概要 データ ロード エディターを開き、以下のロード スクリプトを新しいタブに追加します。 ロード スクリプトには、最初の例と同じデータセットとシナリオが含まれます。 ただし、この例では、変更されていないデータセットがアプリケーションにロードされます。前回のリロードまでを含むカレンダー年に発生したトランザクションを決定する計算は、アプリケーションのチャート オブジェクトのメジャーとして作成されます。 ロード スクリプト ``` Transactions: Load * Inline [ id,date,amount 8188,01/10/2020,37.23 8189,02/28/2020,17.17 8190,04/09/2020,88.27 8191,04/16/2020,57.42 8192,05/21/2020,53.80 8193,08/14/2020,82.06 8194,10/07/2020,40.39 8195,12/05/2020,87.21 8196,01/22/2021,95.93 8197,02/03/2021,45.89 8198,03/17/2021,36.23 8199,04/23/2021,25.66 8200,05/04/2021,82.77 8201,06/30/2021,69.98 8202,07/26/2021,76.11 8203,12/27/2021,25.12 8204,02/02/2022,46.23 8205,02/26/2022,84.21 8206,03/07/2022,96.24 8207,03/11/2022,67.67 ]; ``` 結果 データをロードしてシートを開きます。新しいテーブルを作成し、この項目を軸として追加します: date。 次のメジャーを追加します。 =yeartodate(date) 結果テーブル | date | =yeartodate(date) | | --- | --- | | 01/10/2020 | 0 | | 02/28/2020 | 0 | | 04/09/2020 | 0 | | 04/16/2020 | 0 | | 05/21/2020 | 0 | | 08/14/2020 | 0 | | 10/07/2020 | 0 | | 12/05/2020 | 0 | | 01/22/2021 | 0 | | 02/03/2021 | 0 | | 03/17/2021 | 0 | | 04/23/2021 | 0 | | 05/04/2021 | 0 | | 06/30/2021 | 0 | | 07/26/2021 | 0 | | 12/27/2021 | 0 | | 02/02/2022 | -1 | | 02/26/2022 | -1 | | 03/07/2022 | -1 | | 03/11/2022 | -1 | [year\_to\_date] メジャーは、yeartodate() 関数を使用し、関数の引数として [ date] 項目を渡すことにより、チャート オブジェクトで作成されます。 それ以外のパラメータは関数に渡されないため、yeartodate() 関数は最初にリロード日付、そして現在のカレンダー年 (1 月 1 日開始) の境界を特定し、ブール値結果 TRUE を返します。 チャート オブジェクトを使用する yeartodate() 関数の例の図 チャート オブジェクトを使用する yeartodate() 関数の例の図 チャート オブジェクトを使用する yeartodate()yeartodate() 関数の例の図 ![yeartodate 関数が TRUE または FALSE の値を返す日付値を表示している図。](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-function-yeartodate-examples-chart-object.png) 1 月 1 日～4 月 26 日に発生したトランザクションの場合、リロード日付は TRUEのブール値の結果を返します。2022 年始めの前に発生したトランザクションは、ブール値結果 FALSE を返します。 ## 例 6 – シナリオ [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/yeartodate.htm) #### ロード スクリプトとチャートの数式 概要 データ ロード エディターを開き、以下のロード スクリプトを新しいセクションに追加します。 ロード スクリプトには次が含まれています: * Transactions というテーブルにロードされる、2020 年～2022 年の一連のトランザクションを含むデータセット。 * DateFormat システム変数形式 (MM/DD/YYYY) で提供されている日付項目。 エンド ユーザーは、2021 年の相当期間の総売上高を、前回のリロード時の現在の年初来として提示する KPI オブジェクトを求めています。 書き込み時には、日付は 2022 年 6 月 16 日です。 ロード スクリプト ``` SET DateFormat='MM/DD/YYYY'; Transactions: Load * Inline [ id,date,amount 8188,01/10/2020,37.23 8189,02/28/2020,17.17 8190,04/09/2020,88.27 8191,04/16/2020,57.42 8192,05/21/2020,53.80 8193,08/14/2020,82.06 8194,10/07/2020,40.39 8195,12/05/2020,87.21 8196,01/22/2021,95.93 8197,02/03/2021,45.89 8198,03/17/2021,36.23 8199,04/23/2021,25.66 8200,05/04/2021,82.77 8201,06/30/2021,69.98 8202,07/26/2021,76.11 8203,12/27/2021,25.12 8204,02/02/2022,46.23 8205,02/26/2022,84.21 8206,03/07/2022,96.24 8207,03/11/2022,67.67 ]; ``` 結果 次の手順を実行します。 1. KPI オブジェクトを作成します。 2. 総売上を計算するには、次の集計メジャーを作成します。 =sum(if(yeartodate(date,-1),amount,0)) 3. メジャーの [数値書式] を [通貨] に設定します。 2021 の KPI yeartodate() チャート 2021 の KPI yeartodate() チャート 2021 の KPI yeartodate()yeartodate() チャート ![yeartodate 関数を使って生成された 2021 年の売上データを表す KPI ビジュアライゼーション。](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-function-yeartodate-scenario-kpi.png) yeartodate() 関数は、各トランザクション ID の日付を評価するときにブール値を返します。リロードは 2022 年 6 月 16 日に発生したため、yeartodate 関数は年期間を 01/01/2022 と 06/16/2022 に区分します。ただし、period\_no 値 -1 が関数で使用されたため、これらも境界線は前の年に移動します。そのため、01/01/2021～06/16/2021 に発生したトランザクションについては、yeartodate() 関数がブール値 TRUE と金額の合計を返します。