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

この関数は、dateを含む年の最初の日の開始に対応するタイムスタンプを返します。デフォルトの出力形式は、スクリプトに設定されている DateFormat です。

構文:

YearStart(date[, period_no[, first_month_of_year]])

つまり、 yearstart() 関数は、日付がどの年に該当するかを判断します。次に、その年の最初のミリ秒のタイムスタンプを日付形式で返します。年の最初の月は既定で 1 月に設定されていますが、yearstart() 関数で first_month_of_year 引数を使用して、どの月を最初に設定するかを変更することができます。

yearstart() 関数が特定の年の期間内の日付を識別し、その特定の年に該当する日付の年初のタイムスタンプを返す様子を示した図。 — 関数がカバーできる時間の範囲を示す yearstart() 関数の図。

使用に適しているケース

yearstart() 関数は、すでに経過した年の端数を計算に使用する場合に、数式の一部として使用されます。たとえば、年初来に累積した利息を計算する場合などです。

戻り値データ型： dual

引数
引数	説明
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
April	4
May	5
June	6
7 月	7
8 月	8
September	9
10 月	10
11 月	11
12 月	12

地域の設定

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

App の既定の地域設定は、Qlik Sense がインストールされているコンピューターまたはサーバーの地域システム設定に基づいています。アクセスしている Qlik Sense サーバーがスウェーデンに設定されてい場合、データロードエディターは、日付、時間、および通貨にスウェーデンの地域設定を使用します。これらの地域の書式設定は、Qlik Sense ユーザーインターフェースに表示される言語とは関係ありません。Qlik Sense は使用しているブラウザと同じ言語で表示されます。

関数の例
例	結果
yearstart('10/19/2001')	Returns 01/01/2001 00:00:00.
yearstart('10/19/2001',-1)	Returns 01/01/2000 00:00:00.
yearstart('10/19/2001',0,4)	Returns 04/01/2001 00:00:00.

例 1 – 基本的な例

概要

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

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

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	日付	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() 関数は、最初に日付値がどの年に該当するかを識別し、その年の最初のミリ秒のタイムスタンプを返します。

トランザクション 8199 が 2021 年 4 月 23 日に発生し、yearend() 関数がその年の初めを識別する様子を示した図。 — yearstart() 関数とトランザクション 8199 の図。

トランザクション 8199 は 2021 年 4 月 23 日に発生しました。 yearstart() 関数は、その年の最後のミリ秒、つまり 1 月 1 日午前 12:00:00 を返します。

例 2 – period_no

概要

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

ただし、この例のタスクは、トランザクションが発生する前の年の開始日付タイムスタンプを返す項目「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	日付	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() 関数が関数の年範囲を 1 年間に戻す様子を示した図。 — period_no が -1 の yearstart() 関数の図。

トランザクション 8199 は 2021 年 4 月 23 日に発生しました。yearstart() 関数は、「previous_year_start」項目に対して、前の年の最初のミリ秒、つまり 1 月 1 日午前 12:00:00 を返します。

例 3 – first_month_of_year

概要

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

ただしこの例では、会社の方針により年度が 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	日付	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() 関数の図。

トランザクション 8199 は 2021 年 4 月 23 日に発生しました。yearstart() 関数は年度初めを 4 月 1 日に設定するため、トランザクションの「year_start」値として 4 月 1 日を返します。

例 4 – チャートオブジェクトの例

概要

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

ただし、この例では、データセットは変更されず、アプリケーションにロードされます。トランザクションが発生した年の初めのタイムスタンプを返す計算は、アプリケーションのチャートオブジェクトのメジャーとして作成されます。

ロードスクリプト

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	日付	=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() 関数は、最初に日付値がどの年に該当するかを識別し、その年の最初のミリ秒のタイムスタンプを返します。

yearend() 関数が、トランザクション 8199 が発生する年と、その年の初めのタイムスタンプを識別する様子を示した図。 — yearstart() 関数とトランザクション 8199 の図。

トランザクション 8199 は 2021 年 4 月 23 日に発生しました。 yearstart() 関数は、その年の最後のミリ秒、つまり 1 月 1 日午前 12:00:00 を返します。

例 5 – シナリオ

概要

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

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

「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 で除算すると、その期間の実効利率が返されます。次に、その期間の実効利率にローンの開始残高を掛けると、今年これまでに発生した利息を返されます。

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

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

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

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

地域の設定

例 1 – 基本的な例

例 2 – period_no

例 3 – first_month_of_year

例 4 – チャート オブジェクトの例

例 5 – シナリオ

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

例 4 – チャートオブジェクトの例