# yearstart スクリプトおよびチャート関数 この関数は、dateを含む年の最初の日の開始に対応するタイムスタンプを返します。デフォルトの出力形式は、スクリプトに設定されている DateFormat です。 構文: YearStart(date[, period\_no[, first\_month\_of\_year]]) つまり、`yearstart()` 関数は、日付がどの年に該当するかを判断します。次に、その年の最初のミリ秒のタイムスタンプを日付形式で返します。年の最初の月は既定で 1 月に設定されていますが、`yearstart()` 関数で `first_month_of_year` 引数を使用して、どの月を最初に設定するかを変更することができます。 関数がカバーできる時間の範囲を示す `yearstart()` 関数の図。 関数がカバーできる時間の範囲を示す `yearstart()` 関数の図。 関数がカバーできる時間の範囲を示す `yearstart()`yearstart() 関数の図。 ![yearstart() 関数が特定の年の期間内の日付を識別し、その特定の年に該当する日付の年初のタイムスタンプを返す様子を示した図。](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-yearstart-diagram.png) yearstart の使用目的 `yearstart()` 関数は、すでに経過した年の端数を計算に使用する場合に、数式の一部として使用されます。たとえば、年初来に累積した利息を計算する場合などです。 戻り値データ型： デュアル 引数 | 引数 | 説明 | | --- | --- | | date | 評価する日付またはタイムスタンプ。 | | period\_no | period\_no は整数で、値 0 は date を含む年を示します。period\_no の値が負の場合は過去の年を、正の場合は将来の年を示します。 | | first\_month\_of\_year | 事業年度が 1 月以外の月に始まる場合は、first\_month\_of\_year で 2 から 12 の間の値を指定します。 | 次の月は `first_month_of_year argument`で使用できます。 : first\_month\_of\_year values | 月 | 値 | | --- | --- | | 2 月 | 2 | | 3 月 | 3 | | 4 月 | 4 | | May | 5 | | 6 月 | 6 | | 7 月 | 7 | | 8 月 | 8 | | 9 月 | 9 | | 10 月 | 10 | | 11 月 | 11 | | 12 月 | 12 | ## リージョンの設定 特に指定のない限り、このトピックの例では 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)」を参照してください。 関数の例 | 例 | 結果 | | --- | --- | | `yearstart('10/19/2001')` | 01/01/2001 00:00:00 を返します。 | | `yearstart('10/19/2001',-1)` | 01/01/2000 00:00:00 を返します。 | | `yearstart('10/19/2001',0,4)` | 04/01/2001 00:00:00 を返します。 | ## 例 1 – 基本的な例 [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/yearstart.htm) #### ロード スクリプトと結果 概要 データ ロード エディターを開き、以下のロード スクリプトを新しいセクションに追加します。 ロード スクリプトには次が含まれています: * 2020 年～2022 年の一連のトランザクションを含むデータセットは、「`Transactions`」というテーブルにロードされます。 * 日付項目は `DateFormat` システム変数 (`MM/DD/YYYY`) 形式で提供されています。 * 次を含む、先行する LOAD ステートメント: * [`year_start`] 項目として設定されている `yearstart()` 関数。 * [`year_start_timestamp`] 項目として設定されている `Timestamp()` 関数 ロード スクリプト ``` SET DateFormat='MM/DD/YYYY'; Transactions: Load *, yearstart(date) as year_start, timestamp(yearstart(date)) as year_start_timestamp ; Load * Inline [ id,date,amount 8188,01/13/2020,37.23 8189,02/26/2020,17.17 8190,03/27/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,06/06/2022,46.23 8205,07/18/2022,84.21 8206,11/14/2022,96.24 8207,12/12/2022,67.67 ]; ``` 結果 データをロードしてシートを開きます。新しいテーブルを作成し、これらの項目を軸として追加します: * `id` * `date` * `year_start` * `year_start_timestamp` 結果テーブル | id | date | year\_start | year\_start\_timestamp | | --- | --- | --- | --- | | 8188 | 01/13/2020 | 01/01/2020 | 1/1/2020 12:00:00 AM | | 8189 | 02/26/2020 | 01/01/2020 | 1/1/2020 12:00:00 AM | | 8190 | 03/27/2020 | 01/01/2020 | 1/1/2020 12:00:00 AM | | 8191 | 04/16/2020 | 01/01/2020 | 1/1/2020 12:00:00 AM | | 8192 | 05/21/2020 | 01/01/2020 | 1/1/2020 12:00:00 AM | | 8193 | 08/14/2020 | 01/01/2020 | 1/1/2020 12:00:00 AM | | 8194 | 10/07/2020 | 01/01/2020 | 1/1/2020 12:00:00 AM | | 8195 | 12/05/2020 | 01/01/2020 | 1/1/2020 12:00:00 AM | | 8196 | 01/22/2021 | 01/01/2021 | 1/1/2021 12:00:00 AM | | 8197 | 02/03/2021 | 01/01/2021 | 1/1/2021 12:00:00 AM | | 8198 | 03/17/2021 | 01/01/2021 | 1/1/2021 12:00:00 AM | | 8199 | 04/23/2021 | 01/01/2021 | 1/1/2021 12:00:00 AM | | 8200 | 05/04/2021 | 01/01/2021 | 1/1/2021 12:00:00 AM | | 8201 | 06/30/2021 | 01/01/2021 | 1/1/2021 12:00:00 AM | | 8202 | 07/26/2021 | 01/01/2021 | 1/1/2021 12:00:00 AM | | 8203 | 12/27/2021 | 01/01/2021 | 1/1/2021 12:00:00 AM | | 8204 | 06/06/2022 | 01/01/2022 | 1/1/2022 12:00:00 AM | | 8205 | 07/18/2022 | 01/01/2022 | 1/1/2022 12:00:00 AM | | 8206 | 11/14/2022 | 01/01/2022 | 1/1/2022 12:00:00 AM | | 8207 | 12/12/2022 | 01/01/2022 | 1/1/2022 12:00:00 AM | [`year_start`] 項目は、`yearstart()` 関数を使用し、関数の引数として日付項目を渡すことにより、前の load ステートメントで作成されます。 `yearstart()` 関数は、最初に日付値がどの年に該当するかを識別し、その年の最初のミリ秒のタイムスタンプを返します。 `yearstart()` 関数とトランザクション 8199 の図。 `yearstart()` 関数とトランザクション 8199 の図。 `yearstart()`yearstart() 関数とトランザクション 8199 の図。 ![トランザクション 8199 が 2021 年 4 月 23 日に発生し、yearend() 関数がその年の初めを識別する様子を示した図。](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-yearstart-example1-diagram.png) トランザクション 8199 は 2021 年 4 月 23 日に発生しました。 `yearstart()` 関数は、その年の最後のミリ秒、つまり 1 月 1 日午前 12:00:00 を返します。 ## 例 2 – period\_no [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/yearstart.htm) #### ロード スクリプトと結果 概要 最初の例と同じデータセットとシナリオが使用されます。 ただし、この例のタスクは、トランザクションが発生する前の年の開始日付タイムスタンプを返す項目「`previous_year_start`」を作成することです。 ロード スクリプト ``` SET DateFormat='MM/DD/YYYY'; Transactions: Load *, yearstart(date,-1) as previous_year_start, timestamp(yearstart(date,-1)) as previous_year_start_timestamp ; Load * Inline [ id,date,amount 8188,01/13/2020,37.23 8189,02/26/2020,17.17 8190,03/27/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,06/06/2022,46.23 8205,07/18/2022,84.21 8206,11/14/2022,96.24 8207,12/12/2022,67.67 ]; ``` 結果 データをロードしてシートを開きます。新しいテーブルを作成し、これらの項目を軸として追加します: * `id` * `date` * `previous_year_start` * `previous_ year_start_timestamp` 結果テーブル | id | date | previous\_year\_start | previous\_year\_start\_timestamp | | --- | --- | --- | --- | | 8188 | 01/13/2020 | 01/01/2019 | 1/1/2019 12:00:00 AM | | 8189 | 02/26/2020 | 01/01/2019 | 1/1/2019 12:00:00 AM | | 8190 | 03/27/2020 | 01/01/2019 | 1/1/2019 12:00:00 AM | | 8191 | 04/16/2020 | 01/01/2019 | 1/1/2019 12:00:00 AM | | 8192 | 05/21/2020 | 01/01/2019 | 1/1/2019 12:00:00 AM | | 8193 | 08/14/2020 | 01/01/2019 | 1/1/2019 12:00:00 AM | | 8194 | 10/07/2020 | 01/01/2019 | 1/1/2019 12:00:00 AM | | 8195 | 12/05/2020 | 01/01/2019 | 1/1/2019 12:00:00 AM | | 8196 | 01/22/2021 | 01/01/2020 | 1/1/2020 12:00:00 AM | | 8197 | 02/03/2021 | 01/01/2020 | 1/1/2020 12:00:00 AM | | 8198 | 03/17/2021 | 01/01/2020 | 1/1/2020 12:00:00 AM | | 8199 | 04/23/2021 | 01/01/2020 | 1/1/2020 12:00:00 AM | | 8200 | 05/04/2021 | 01/01/2020 | 1/1/2020 12:00:00 AM | | 8201 | 06/30/2021 | 01/01/2020 | 1/1/2020 12:00:00 AM | | 8202 | 07/26/2021 | 01/01/2020 | 1/1/2020 12:00:00 AM | | 8203 | 12/27/2021 | 01/01/2020 | 1/1/2020 12:00:00 AM | | 8204 | 06/06/2022 | 01/01/2021 | 1/1/2021 12:00:00 AM | | 8205 | 07/18/2022 | 01/01/2021 | 1/1/2021 12:00:00 AM | | 8206 | 11/14/2022 | 01/01/2021 | 1/1/2021 12:00:00 AM | | 8207 | 12/12/2022 | 01/01/2021 | 1/1/2021 12:00:00 AM | この例では、`-1` の `period_no` が `yearstart()` 関数でオフセット引数として使用されたため、関数は最初にトランザクションが発生する年を識別します。次に、1 年前を調べて、その年の最初のミリ秒を識別します。 `period_no` が -1 の `yearstart()` 関数の図。 `period_no` が -1 の `yearstart()` 関数の図。 `period_no`period\_no が -1 の `yearstart()`yearstart() 関数の図。 ![period_no が -1 の yearstart() 関数が関数の年範囲を 1 年間に戻す様子を示した図。](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-yearstart-example2-diagram.png) トランザクション 8199 は 2021 年 4 月 23 日に発生しました。`yearstart()` 関数は、「`previous_year_start`」項目に対して、前の年の最初のミリ秒、つまり 1 月 1 日午前 12:00:00 を返します。 ## 例 3 – first\_month\_of\_year [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/yearstart.htm) #### ロード スクリプトと結果 概要 最初の例と同じデータセットとシナリオが使用されます。 ただしこの例では、会社の方針により年度が 4 月 1 日に始まります。 ロード スクリプト ``` SET DateFormat='MM/DD/YYYY'; Transactions: Load *, yearstart(date,0,4) as year_start, timestamp(yearstart(date,0,4)) as year_start_timestamp ; Load * Inline [ id,date,amount 8188,01/13/2020,37.23 8189,02/26/2020,17.17 8190,03/27/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,06/06/2022,46.23 8205,07/18/2022,84.21 8206,11/14/2022,96.24 8207,12/12/2022,67.67 ]; ``` 結果 データをロードしてシートを開きます。新しいテーブルを作成し、これらの項目を軸として追加します: * `id` * `date` * `year_start` * `year_start_timestamp` 結果テーブル | id | date | year\_start | year\_start\_timestamp | | --- | --- | --- | --- | | 8188 | 01/13/2020 | 04/01/2019 | 4/1/2019 12:00:00 AM | | 8189 | 02/26/2020 | 04/01/2019 | 4/1/2019 12:00:00 AM | | 8190 | 03/27/2020 | 04/01/2019 | 4/1/2019 12:00:00 AM | | 8191 | 04/16/2020 | 04/01/2020 | 4/1/2020 12:00:00 AM | | 8192 | 05/21/2020 | 04/01/2020 | 4/1/2020 12:00:00 AM | | 8193 | 08/14/2020 | 04/01/2020 | 4/1/2020 12:00:00 AM | | 8194 | 10/07/2020 | 04/01/2020 | 4/1/2020 12:00:00 AM | | 8195 | 12/05/2020 | 04/01/2020 | 4/1/2020 12:00:00 AM | | 8196 | 01/22/2021 | 04/01/2020 | 4/1/2020 12:00:00 AM | | 8197 | 02/03/2021 | 04/01/2020 | 4/1/2020 12:00:00 AM | | 8198 | 03/17/2021 | 04/01/2020 | 4/1/2020 12:00:00 AM | | 8199 | 04/23/2021 | 04/01/2021 | 4/1/2021 12:00:00 AM | | 8200 | 05/04/2021 | 04/01/2021 | 4/1/2021 12:00:00 AM | | 8201 | 06/30/2021 | 04/01/2021 | 4/1/2021 12:00:00 AM | | 8202 | 07/26/2021 | 04/01/2021 | 4/1/2021 12:00:00 AM | | 8203 | 12/27/2021 | 04/01/2021 | 4/1/2021 12:00:00 AM | | 8204 | 06/06/2022 | 04/01/2022 | 4/1/2022 12:00:00 AM | | 8205 | 07/18/2022 | 04/01/2022 | 4/1/2022 12:00:00 AM | | 8206 | 11/14/2022 | 04/01/2022 | 4/1/2022 12:00:00 AM | | 8207 | 12/12/2022 | 04/01/2022 | 4/1/2022 12:00:00 AM | この例では、`yearstart()` 関数で `4` の `first_month_of_year` 引数が使用されているため、年の最初の日は 4 月 1 日、年の最後の日が 3 月 31 日に設定されます。 4 月が最初の月に設定された `yearstart()` 関数の図。 4 月が最初の月に設定された `yearstart()` 関数の図。 4 月が最初の月に設定された `yearstart()`yearstart() 関数の図。 ![4 月が年の最初の月に設定された yearstart() 関数を示した図。](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-yearstart-example3-diagram.png) トランザクション 8199 は 2021 年 4 月 23 日に発生しました。`yearstart()` 関数は年度初めを 4 月 1 日に設定するため、トランザクションの「`year_start`」値として 4 月 1 日を返します。 ## 例 4 – チャート オブジェクトの例 [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/yearstart.htm) #### ロード スクリプトとチャートの数式 概要 最初の例と同じデータセットとシナリオが使用されます。 ただし、この例ではデータセットは変更されず、アプリケーションにロードされます。トランザクションが発生した年の初めのタイムスタンプを返す計算は、アプリケーションのチャート オブジェクトのメジャーとして作成されます。 ロード スクリプト ``` Transactions: Load * Inline [ id,date,amount 8188,01/13/2020,37.23 8189,02/26/2020,17.17 8190,03/27/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,06/06/2022,46.23 8205,07/18/2022,84.21 8206,11/14/2022,96.24 8207,12/12/2022,67.67 ]; ``` 結果 データをロードしてシートを開きます。新しいテーブルを作成し、これらの項目を軸として追加します: * `id` * `date` トランザクションが発生した年度を計算するには、次のメジャーを作成します。 * `=yearstart(date)` * `=timestamp(yearstart(date))` 結果テーブル | id | date | =yearstart(date) | =timestamp(yearstart(date)) | | --- | --- | --- | --- | | 8188 | 06/06/2022 | 01/01/2022 | 1/1/2022 12:00:00 AM | | 8189 | 07/18/2022 | 01/01/2022 | 1/1/2022 12:00:00 AM | | 8190 | 11/14/2022 | 01/01/2022 | 1/1/2022 12:00:00 AM | | 8191 | 12/12/2022 | 01/01/2022 | 1/1/2022 12:00:00 AM | | 8192 | 01/22/2021 | 01/01/2021 | 1/1/2021 12:00:00 AM | | 8193 | 02/03/2021 | 01/01/2021 | 1/1/2021 12:00:00 AM | | 8194 | 03/17/2021 | 01/01/2021 | 1/1/2021 12:00:00 AM | | 8195 | 04/23/2021 | 01/01/2021 | 1/1/2021 12:00:00 AM | | 8196 | 05/04/2021 | 01/01/2021 | 1/1/2021 12:00:00 AM | | 8197 | 06/30/2021 | 01/01/2021 | 1/1/2021 12:00:00 AM | | 8198 | 07/26/2021 | 01/01/2021 | 1/1/2021 12:00:00 AM | | 8199 | 12/27/2021 | 01/01/2021 | 1/1/2021 12:00:00 AM | | 8200 | 01/13/2020 | 01/01/2020 | 1/1/2020 12:00:00 AM | | 8201 | 02/26/2020 | 01/01/2020 | 1/1/2020 12:00:00 AM | | 8202 | 03/27/2020 | 01/01/2020 | 1/1/2020 12:00:00 AM | | 8203 | 04/16/2020 | 01/01/2020 | 1/1/2020 12:00:00 AM | | 8204 | 05/21/2020 | 01/01/2020 | 1/1/2020 12:00:00 AM | | 8205 | 08/14/2020 | 01/01/2020 | 1/1/2020 12:00:00 AM | | 8206 | 10/07/2020 | 01/01/2020 | 1/1/2020 12:00:00 AM | | 8207 | 12/05/2020 | 01/01/2020 | 1/1/2020 12:00:00 AM | 「`start_of_year`」メジャーは、`yearstart()` 関数を使用し、関数の引数として日付項目を渡すことにより、チャート オブジェクトで作成されます。 `yearstart()` 関数は、最初に日付値がどの年に該当するかを識別し、その年の最初のミリ秒のタイムスタンプを返します。 `yearstart()` 関数とトランザクション 8199 の図。 `yearstart()` 関数とトランザクション 8199 の図。 `yearstart()`yearstart() 関数とトランザクション 8199 の図。 ![yearend() 関数が、トランザクション 8199 が発生する年と、その年の初めのタイムスタンプを識別する様子を示した図。](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-yearstart-example4-diagram.png) トランザクション 8199 は 2021 年 4 月 23 日に発生しました。 `yearstart()` 関数は、その年の最後のミリ秒、つまり 1 月 1 日午前 12:00:00 を返します。 ## 例 5 – シナリオ [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/yearstart.htm) #### ロード スクリプトと結果 概要 データ ロード エディターを開き、以下のロード スクリプトを新しいセクションに追加します。 ロード スクリプトには次が含まれています: * 「Loans」というテーブルにロードされるデータセット。テーブルには次の項目が含まれています。 * ローン ID。 * 年度初めの残高。 * 年間の各ローンに課される単利率。 エンド ユーザーは、年初来の各ローンで発生した現在の利息をローン ID 別に表示するチャート オブジェクトを求めています。 ロード スクリプト ``` Loans: Load * Inline [ loan_id,start_balance,rate 8188,$10000.00,0.024 8189,$15000.00,0.057 8190,$17500.00,0.024 8191,$21000.00,0.034 8192,$90000.00,0.084 ]; ``` 結果 データをロードしてシートを開きます。新しいテーブルを作成し、これらの項目を軸として追加します: * loan\_id * start\_balance 累積利息を計算するには、次のメジャーを作成します。 =start\_balance\*(rate\*(today(1)-yearstart(today(1)))/365) メジャーの [数値書式] を [通貨] に設定します。 結果テーブル | loan\_id | start\_balance | =start\_balance\*(rate\*(today(1)-yearstart(today(1)))/365) | | --- | --- | --- | | 8188 | $10000.00 | $39.73 | | 8189 | $15000.00 | $339.66 | | 8190 | $17500.00 | $166.85 | | 8191 | $21000.00 | $283.64 | | 8192 | $90000.00 | $3003.29 | yearstart() 関数は、今日の日付を唯一の引数として使用することにより、現在の年の開始日を返します。その結果を現在の日付から減算することにより、数式は今年経過した日数を返します。 次に、この値に利率を乗算して 365 で除算すると、その期間の実効利率が返されます。次に、その期間の実効利率にローンの開始残高を掛けると、今年これまでに発生した利息を返されます。