期间运算符
关于期间运算符
期间运算符可聚合一段时间内的值。
若向包含日期的可视化视图或报表对象分配期间聚合项，则该聚合项会为可视化视图或报表对象中的每个时间期间显示聚合值。
在不包含日期的可视化视图或报表对象中，聚合项显示的值以今天的日期作为参照。若用于运算符的日期数据项不包含含今天日期的时间间隔的数据，则该运算符返回缺失值。
使用时间间隔对期间运算符求值。时间间隔指定是否按月、按季度等时间间隔来应用聚合。您可以指定特定时间间隔，也可以指定推算时间间隔。对于推算的时间间隔，将基于聚合在可视化视图或报表对象中的上下文对聚合求值。例如，若可视化视图包含月度销售额的条形图，则推算的时间间隔为月。
注: 期间运算符在以下情况下返回缺失值：
-
指定时间期间的数据不存在。
-
用于期间计算的日期数据项与可视化视图或报表对象中的日期数据项不匹配。您必须使用相同的日期数据项或基于同一数据项复制的数据项。
-
用于运算符的时间间隔小于可视化视图或报表对象中的日期格式的时间间隔（例如，若时间间隔为每月，但日期格式为“年”）。
-
对于使用内部和外部时间间隔的运算符，内部时间间隔大于外部时间间隔。
-
推算的时间间隔为按年中周或按小于天的时间间隔。
-
对于具有 0 以外偏移量的任何运算符，推算的时间间隔为按天。对于探索器，ParallelPeriod 和 RelativePeriod 运算符始终在推算的时间间隔为按天时返回缺失值。
以下期间运算符可用：
|
返回一段时间内以及较大时间期间内的以往所有期间的聚合值（例如，年初至今月度值总和）。
|
|
|
返回与当前时间期间并行的时间期间的聚合值（例如，去年同月的值）。
|
|
|
返回某个时间期间的聚合值（例如，当月的值）。
|
|
|
返回特定的固定时间期间的聚合值（例如，包含 15OCT2013 的月份的值）。
|
|
|
返回与当前期间相关的时间期间的聚合值（例如，同一年的上个月的值）。
|
CumulativePeriod
CumulativePeriod 运算符返回一段时间内以及较大时间期间内的以往所有期间的聚合值（例如，年初至今月度值总和）。
注: CumulativePeriod 运算符在每个日历年开始时重置。CumulativePeriod 运算符的日期范围不能在两个日历年上重叠。
指定以下参数：
CumulativePeriod 运算符的参数
| 1 | 应用于测度的聚合。 |
| 2 | 用于随时间聚合的测度。 |
| 3 | 在处理聚合测度前，应该应用哪些时间过滤器。选择以下之一：
_ApplyAllFilters_
在处理聚合测度前应用全部过滤器
_IgnoreAllTimeFrameFilters_
忽略使用相同日期数据项作为期间运算符的全部过滤器。
_IgnoreInteractiveTimeFrameFilters_
忽略基于相同日期数据项作为期间运算符的全部交互式过滤器（来自提示和交互操作）。
注: 该参数在探索器中不可用
|
| 4 | 用于期间计算的日期数据项。只有格式中指定了年的数据项才可用。 |
| 5 | 对其值进行聚合的内部时间间隔（较小的时间期间）。例如，指定 _ByMonth_ 作为内部时间间隔，且指定 _ByYear_ 作为外部时间间隔，以聚合每月的年初至今值。
选择以下之一：
_Inferred_
指定从显示聚合项的可视化视图或报表对象自动确定时间间隔。
_ByMonth_
指定月度时间间隔。
_ByQuarter_
指定季度时间间隔。
_ByYear_
指定年度时间间隔。
|
| 6 | 为累积聚合提供上下文的外部时间间隔（较大时间期间）。例如，指定 _ByMonth_ 作为内部时间间隔，且指定 _ByYear_ 作为外部时间间隔，以聚合每月的年初至今值。
选择以下之一：
_Inferred_
指定从显示聚合项的可视化视图或报表对象自动确定时间间隔。
_ByMonth_
指定月度时间间隔。
_ByQuarter_
指定季度时间间隔。
_ByYear_
指定年度时间间隔。
|
| 7 | 自当前期间推移的外部时间间隔数。0 指定使用来自当前外部时间间隔的期间。负值指示之前的时间间隔。
例如，若内部时间间隔为按月，外部时间间隔为按年，则 -1 指定去年的年初至今月度值。
|
| 8 | 每个新外部期间的起始点。例如，若内部时间间隔为按月，外部时间间隔为按年，则 3 指定每年在第 3 个月份开始。
注: 该参数在探索器中不可用
注: 若外部时间间隔是推算的或按年，则值必须为介于 1 和 12 之间的时间间隔。若外部时间间隔是按季度，则值必须为介于 1 和 4 之间的时间间隔。
|
| 9 | 期间范围。该范围指定聚合每个期间的多长时间。
选择以下之一：
_Full_
聚合整个期间的值。
_ToDate_
仅聚合截至外部时间间隔特定日期的值。
_ToToday_
仅聚合截至当前时间间隔中相当于今天日期的值。例如，若今天是季度中的第 40 天，且外部时间间隔为按季度，则仅使用截至每季度第 40 天的值。
只要在可视化视图或报表对象查看该聚合项，即可动态计算今天的值。
|
| 10 | 若选择 _ToDate_ 作为范围，则选择用于对每个期间取子集的日期。
例如，若选择 09NOV2013，且外部时间间隔为按年，则仅在聚合中使用截至每年的 9 月 9 号的值。
|
例如，
CumulativePeriod(_Sum_, 'Expenses'n, _ApplyAllFilters_, 'Date'n, _ByMonth_, _ByYear_, 0, 1, _Full_)会使用 Date 数据项中的日期值聚合 Expenses 测度的年初至今月度值总和。
ParallelPeriod
ParallelPeriod 运算符返回与当前期间并行的时间期间的聚合值（例如，去年同月的值）。
指定以下参数：
ParallelPeriod 运算符的参数
| 1 | 应用于测度的聚合。 |
| 2 | 用于随时间聚合的测度。 |
| 3 | 在处理聚合测度前，应该应用哪些时间过滤器。选择以下之一：
_ApplyAllFilters_
在处理聚合测度前应用全部过滤器
_IgnoreAllTimeFrameFilters_
忽略使用相同日期数据项作为期间运算符的全部过滤器。
_IgnoreInteractiveTimeFrameFilters_
忽略基于相同日期数据项作为期间运算符的全部交互式过滤器（来自提示和交互操作）。
注: 该参数在探索器中不可用
|
| 4 | 用于期间计算的日期数据项。只有格式中指定了年的数据项才可用。 |
| 5 | 对其值进行聚合的内部时间间隔（较小的时间期间）。例如，指定 _ByMonth_ 作为内部时间间隔可聚合每月的值。
选择以下之一：
_Inferred_
指定从显示聚合项的可视化视图或报表对象自动确定时间间隔。
_ByMonth_
指定月度时间间隔。
_ByQuarter_
指定季度时间间隔。
_ByYear_
指定年度时间间隔。
|
| 6 | 为并行期间聚合提供上下文的外部时间间隔（较大时间期间）。例如，指定 _ByMonth_ 作为内部时间间隔，且指定 _ByYear_ 作为外部时间间隔，以聚合不同年度的月度值。
选择以下之一：
_Inferred_
指定从显示聚合项的可视化视图或报表对象自动确定时间间隔。
_ByMonth_
指定月度时间间隔。
_ByQuarter_
指定季度时间间隔。
_ByYear_
指定年度时间间隔。
|
| 7 | 自当前期间推移的外部时间间隔数。0 指定使用来自当前外部时间间隔的期间。负值指示之前的时间间隔。
例如，若内部时间间隔为按月，外部时间间隔为按年，则 -1 指定去年的月度值。
|
| 8 | 期间范围。该范围指定聚合每个期间的多长时间。
选择以下之一：
_Full_
聚合整个期间的值。
_ToDate_
仅聚合截至外部时间间隔特定日期的值。
_ToToday_
仅聚合截至当前时间间隔中相当于今天日期的值。例如，若今天是季度中的第 40 天，且外部时间间隔为按季度，则仅使用截至每季度第 40 天的值。
只要在可视化视图或报表对象查看该聚合项，即可动态计算今天的值。
|
| 9 | 若选择 _ToDate_ 作为范围，则选择用于对每个期间取子集的日期。
例如，若选择 09NOV2013，且外部时间间隔为按年，则仅在聚合中使用截至每年的 9 月 9 号的值。
|
例如，
ParallelPeriod(_Sum_, 'Expenses'n, _ApplyAllFilters_, 'Date'n, _ByMonth_, _ByYear_, -1, _Full_)会使用 Date 数据项中的日期值聚合去年 Expenses 测度的月度值总和。
Period
Period 运算符返回某个时间期间的聚合值（例如，当月的值）。
指定以下参数：
期间运算符的参数
| 1 | 应用于测度的聚合。 |
| 2 | 用于随时间聚合的测度。 |
| 3 | 在处理聚合测度前，应该应用哪些时间过滤器。选择以下之一：
_ApplyAllFilters_
在处理聚合测度前应用全部过滤器
_IgnoreAllTimeFrameFilters_
忽略使用相同日期数据项作为期间运算符的全部过滤器。
_IgnoreInteractiveTimeFrameFilters_
忽略基于相同日期数据项作为期间运算符的全部交互式过滤器（来自提示和交互操作）。
注: 该参数在探索器中不可用
|
| 4 | 用于期间计算的日期数据项。只有格式中指定了年的数据项才可用。 |
| 5 | 对其值进行聚合的时间间隔。例如，指定 _ByMonth_ 作为时间间隔可聚合每月的值。
选择以下之一：
_Inferred_
指定从显示聚合项的可视化视图或报表对象自动确定时间间隔。
_ByMonth_
指定月度时间间隔。
_ByQuarter_
指定季度时间间隔。
_ByYear_
指定年度时间间隔。
|
例如，
Period(_Sum_, 'Expenses'n, _ApplyAllFilters_, 'Date'n, _ByMonth_)会使用 Date 数据项中的日期值聚合 Expenses 测度的月度值总和。
PeriodWithDate
PeriodWithDate 运算符返回特定的固定时间期间的聚合值（例如，包含 15OCT2013 的月份的值）。
指定以下参数：
PeriodWithDate 运算符的参数
| 1 | 应用于测度的聚合。 |
| 2 | 用于随时间聚合的测度。 |
| 3 | 在处理聚合测度前，应该应用哪些时间过滤器。选择以下之一：
_ApplyAllFilters_
在处理聚合测度前应用全部过滤器
_IgnoreAllTimeFrameFilters_
忽略使用相同日期数据项作为期间运算符的全部过滤器。
_IgnoreInteractiveTimeFrameFilters_
忽略基于相同日期数据项作为期间运算符的全部交互式过滤器（来自提示和交互操作）。
注: 该参数在探索器中不可用
|
| 4 | 用于期间计算的日期数据项。只有格式中指定了年的数据项才可用。 |
| 5 | 对其值进行聚合的时间间隔。例如，指定 _ByMonth_ 作为时间间隔可聚合每月的值。
选择以下之一：
_Inferred_
指定从显示聚合项的可视化视图或报表对象自动确定时间间隔。
_ByMonth_
指定月度时间间隔。
_ByQuarter_
指定季度时间间隔。
_ByYear_
指定年度时间间隔。
|
| 6 | 期间聚合的参照日期。 |
例如，
PeriodWithDate(_Sum_, 'Expenses'n, _ApplyAllFilters_, 'Date'n, _ByMonth_, '15OCT2013'd)会使用 Date 数据项中的日期值聚合 Expenses 测度的月度值总和。
RelativePeriod
RelativePeriod 运算符返回相对于当前期间（例如，同一年的上个月）的时间期间的聚合值。
指定以下参数：
RelativePeriod 运算符的参数
| 1 | 应用于测度的聚合。 |
| 2 | 用于随时间聚合的测度。 |
| 3 | 在处理聚合测度前，应该应用哪些时间过滤器。选择以下之一：
_ApplyAllFilters_
在处理聚合测度前应用全部过滤器
_IgnoreAllTimeFrameFilters_
忽略使用相同日期数据项作为期间运算符的全部过滤器。
_IgnoreInteractiveTimeFrameFilters_
忽略基于相同日期数据项作为期间运算符的全部交互式过滤器（来自提示和交互操作）。
注: 该参数在探索器中不可用
|
| 4 | 用于期间计算的日期数据项。只有格式中指定了年的数据项才可用。 |
| 5 | 对其值进行聚合的时间间隔。例如，指定 _ByMonth_ 作为间隔以聚合每月的年初至今值。
选择以下之一：
_Inferred_
指定从显示聚合项的可视化视图或报表对象自动确定时间间隔。
_ByMonth_
指定月度时间间隔。
_ByQuarter_
指定季度时间间隔。
_ByYear_
指定年度时间间隔。
|
| 6 | 自当前期间推移的时间间隔数。0 指定使用来自当前时间间隔的期间。负值指示之前的时间间隔。
例如，若时间间隔为按月，则 -1 指定上个月的月度值。
|
| 7 | 期间范围。该范围指定聚合每个期间的多长时间。
选择以下之一：
_Full_
聚合整个期间的值。
_ToDate_
仅聚合截至时间间隔特定日期的值。
_ToToday_
仅聚合截至当前时间间隔中相当于今天日期的值。例如，若今天是季度中的第 40 天，且外部时间间隔为按季度，则仅使用截至每季度第 40 天的值。
只要在可视化视图或报表对象查看该聚合项，即可动态计算今天的值。
|
| 8 | 若选择 _ToDate_ 作为范围，则选择用于对每个期间取子集的日期。
例如，若选择 09NOV2013，且外部时间间隔为按季度，则仅在聚合中使用截至每季度第 40 天的值。
|
例如，
RelativePeriod(_Sum_, 'Expenses'n, _ApplyAllFilters_, 'Date'n, _ByMonth_, -1, _Full_)会使用 Date 数据项中的日期值聚合上个月 Expenses 测度的月度值总和。