衍生指标计算公式相关说明¶

衍生指标由一个或多个已发布的派生指标叠加计算而成。参照以下语法说明及条件填写衍生指标计算公式：

计算公式中引用的派生指标需均为单值指标或均为多值指标。
如果计算公式中引用的派生指标都是多值指标，则所有派生指标关联的维度和统计周期必须相同。
如果计算公式中引用的派生指标都是单值指标，则所有派生指标关联的维度必须相同，统计周期可以不同，衍生指标的统计周期最终按优先级确定（优先级由高到低：全生命周期、当年自然完整年、当年、当月自然完整月、当月、当周、当日）。
计算公式中引用的维度属性必须是派生指标所关联的维度的属性。
计算公式中的派生指标 ID 和维度属性 ID 不可重复。
计算公式中引用的派生指标必须已经关联查询映射配置。
使用正则表达式进行截取，指标需要以 # 开头，维度属性需要以 $ 开头，函数需要以 @ 开头。
使用合法的算术运算表达式，支持：加 +、减 -、乘 *、除 /、取余 %、幂 ^ 。

例：#metric_id_1+#metric_id_2*$dim_attr%$dim_attr^3

支持使用以下特殊函数及函数表达式。表达式中仅支持使用统计周期为 当日、当周、当月、当年 的单值派生指标和统计周期为 年、月、周、天 的多值派生指标。

函数名称	函数表达式格式及说明	含义
同比增减额	`@yearOnYear(#metric, yyyy)` 其中，`yyyy` 可以不填，不填默认计算与去年的同比增减额	同比增减额函数用于获取指标在本期与上年同期或指定时间的比较差值。当 `metric` 为单值派生指标时：可调用该函数直接获取指标当月与某年该月的同比增减额。当 `metric` 为多值派生指标时：需先指定开始时间和结束时间，才能查询并获取同比增减额。例如，需先在接口中传入从 2022 年 03 月到 2022 年 06 月的每月发电量指标，才可以得到 3 月、4 月、5 月和 6 月的同比增减额。
同比增长率	`@yearOnYearRate(#metric, yyyy)` 其中，`yyyy` 可以不填，不填默认计算与去年的同比增长率。	同比增长率即同比增幅=((本期衍生指标值-去年同期或指定时间的衍生指标值)/去年同期或指定时间的衍生指标值)x100%，例如，某指标 2022 年 01 月与去年相比的同比增长率 = ((指标在 2022 年 01 月值-指标在 2021 年 01 月值)/指标在 2021 年 01 月值)x100%。当 `metric` 为单值派生指标时：可调用该函数直接获取指标在当月与某年该月的同比增长率。当 `metric` 为多值派生指标时：需先指定开始时间和结束时间，才能查询并获取增长率，例如，需先在接口中传入从 2022 年 03 月到 2022 年 06 月的每月发电量指标值，才可以得到 3 月、4 月、5 月和 6 月发电量的同比增长率。当公式中分母的值为 0 或者 null 时，数据返回结果是 null。
同期值	`@samePeriod(#metric, yyyy)` 其中，yyyy 可以不填，不填默认计算去年同期值。	同期值函数用于获取指标在去年或在指定年份的同期值。当 `metric` 为单值派生指标时：可调用该函数直接计算并获取去年的指标值。当 `metric` 为多值派生指标时：需先指定开始时间和结束时间，才能通过该函数获取同期值，例如：需先在接口中传入从 2022 年 03 月到 2022 年 06 月的每月发电量指标值，才可以得到去年 3 月、4 月、5 月和 6 月的发电量指标值。当分母的指标值为 0 或者 null 时，数据返回结果是 null。
环比增减额	`@compare(#metric)`	环比增减额即环比增幅。该函数用于获取指标本期与上期的差值，例如：可以通过该函数获取本周发电量与上周发电量的差值。当 `metric` 为单值派生指标时：可调用该函数直接计算并获取指标值的环比差额。当 `metric` 为多值派生指标时：需先指定开始时间和结束时间，才能通过该函数获取差额，例如：需先在接口中传入从 2022 年 03 月到 2022 年 06 月的每月发电量指标，才可以分别获取去年 3 月、4 月、5 月和 6 月的发电量指标值与上个月指标值的差额。
环比增长率	`@compareRate(#metric)`	环比增长率即环比增幅=((本期衍生指标值-上期衍生指标值)/上期衍生指标值)x100%，例如，某一发电量指标本周与上周的环比增长率 = ((本周发电量指标值-上周发电量指标值)/上周发电量指标值)x100%。当 `metric` 为单值派生指标时：可调用该函数直接计算并获取指标值的环比增长率。当 `metric` 为多值派生指标时：需先指定开始时间和结束时间，才能通过该函数获取增长率，例如，需先在接口中传入从 2022 年 03 月到 2022 年 06 月的每月发电量指标值值，才可以分别获取去年 3 月、4 月、5 月和 6 月的发电量指标值与上个月指标值相比的增长率。当公式中分母的值为 0 或者 null 时，数据返回结果是 null。
环期值	`@prevPeriod(#metric)`	环期值函数用于获取指标上一统计周期的值。当 `metric` 为单值派生指标时：可调用该函数直接计算并获取指标的环期值。当 `metric` 为多值派生指标时：需先指定开始时间和结束时间，才能通过该函数获取环期值，例如，需先在接口中传入从 2022 年 03 月到 2022 年 06 月的每月发电量指标值，才可以在去年 3 月、4 月、5 月和 6 月分别获得当月与上月的发电量指标值。