yearstart - 脚本和图表函数

概述

打开数据加载编辑器，并将下面的加载脚本添加到新选项卡。

加载脚本包含：

• 包含 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

通过使用 yearstart() 函数并将日期字段作为函数的参数传递，在前面的 LOAD 语句中创建了 ‘year_start’ 字段。

yearstart() 函数最初确定日期值属于哪一年，并返回该年第一毫秒的时间戳。

交易 8199 发生在 2021 年 4 月 23 日。yearstart() 函数返回该年的第一毫秒，即 1 月 1 日上午 12:00:00。

概述

使用与第一个 相同的数据集和场景。

但是，在本例中，任务是创建一个字段 ‘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

在本例中，由于 yearstart() 函数中使用了 -1 的 period_no 作为偏移参数，因此函数首先标识交易发生的年。然后，它查找前一年，并确定该年的第一一毫秒。

交易 8199 发生在 2021 年 4 月 23 日。yearstart() 函数返回 ‘previous_year_start’ 字段上一年（2020 年 1 月 1 日午夜 12:00:00）的第一毫秒。

概述

使用与第一个 相同的数据集和场景。

然而，在本例中，公司政策是从 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

在本例中，由于 yearstart() 函数中使用了 4 的 first_month_of_year 参数，因此它将一年中的第一天设置为 4 月 1 日，将一年的最后一天设置为 3 月 31 日。

交易 8199 发生在 2021 年 4 月 23 日。由于 yearstart() 函数将年初设置为 4 月 1 日，因此将它返回作为交易的 ‘year_start’ 值。

概述

使用与第一个 相同的数据集和场景。

然而，在本例中，未更改的数据集被加载到应用程序中。返回交易发生年份的开始日期时间戳的计算是作为应用程序的图表对象中的度量创建的。

加载脚本

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))

通过使用 yearstart()函数并将日期字段作为函数的参数传递，在图表对象中创建了 ‘start_of_year’ 度量。

yearstart() 函数最初确定日期值属于哪一年，并返回该年第一毫秒的时间戳。

交易 8199 发生在 2021 年 4 月 23 日。yearstart() 函数返回该年的第一毫秒，即 1 月 1 日上午 12:00:00。

概述

打开数据加载编辑器，并将下面的加载脚本添加到新选项卡。

加载脚本包含：

• 数据集加载到名为 ‘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)

将度量的数字格式设置为金额。

yearstart() 函数使用今天的日期作为唯一参数，返回当前年份的开始日期。通过从当前日期中减去该结果，表达式将返回今年迄今为止经过的天数。

然后将该值乘以利率并除以 365，以返回该期间的实际利率。然后将该期间的实际利率乘以贷款的起始余额，以返回今年迄今为止的应计利息。