本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 期初至今计算


期初至今计算评估指定的期初至今的值。例如，您可以创建一个计算来找出您的 year-to-date销售收入。

要使用该函数，您需要在 **Time (时间)** 字段井中具有至少一个维度。

## 参数


*name*   
您分配或更改的唯一描述性名称。如果您未创建自己的名称，则会分配一个名称。您可以稍后编辑它。

*日期*   
您要排名的日期维度。

*值*   
计算所基于的聚合度量。

*Time granularity (时间粒度)*   
要用于计算的日期粒度，例如“本年迄今”。

## 计算输出


每个函数都会生成一组输出参数。您可以将这些输出添加到自动叙述以自定义它显示的内容。您也可以添加自己的自定义文本。

要找到输出参数，请打开右侧的 **Computations (计算)** 选项卡并找到您要使用的计算。计算的名称来自您创建见解时提供的名称。请通过只单击一次来选择输出参数。如果您单击两次，您将两次添加相同的输出。以**粗体**显示的项目可用于叙述中。
+ `timeField` – 来自**时间**字段井。
  + `name` – 字段的格式化的显示名称。
  + `timeGranularity` – 时间字段粒度（**DAY**、**YEAR** 等等）。
+ `metricField` – 来自**值**字段井。
  + `name` – 字段的格式化的显示名称。
  + `aggregationFunction` – 用于指标的聚合（**SUM**、**AVG** 等等）。
+ `previousMetricValue` – 指标维度中的先前值。
  + `value` – 原始值。
  + `formattedValue` – 指标字段格式化的值。
  + `formattedAbsoluteValue` – 指标字段格式化的绝对值。
+ `previousTimeValue` – 日期时间维度中的先前值。
  + `value` – 原始值。
  + `formattedValue` – 日期时间字段格式化的值。
+ `currentMetricValue` – 指标维度中的当前值。
  + `value` – 原始值。
  + `formattedValue` – 指标字段格式化的值。
  + `formattedAbsoluteValue` – 指标字段格式化的绝对值。
+ `currentTimeValue` – 日期时间维度中的当前值。
  + `value` – 原始值。
  + `formattedValue` – 日期时间字段格式化的值。
+ `periodGranularity` – 此计算的期间粒度（**MONTH**、**YEAR** 等等）。
+ `percentDifference` – 指标字段的当前值与先前值之间的百分比差异。
  + `value` – 百分比差异计算的原始值。
  + `formattedValue` – 百分比差异的格式化值（例如，-42%）。
  + `formattedAbsoluteValue` – 百分比差异的格式化绝对值（例如，42%）。
+ `absoluteDifference` – 指标字段的当前值与先前值之间的绝对差异。
  + `value` – 绝对差异计算的原始值。
  + `formattedValue` – 由指标字段的格式首选项中的设置格式化的绝对差异。
  + `formattedAbsoluteValue` – 指标字段格式化的差异的绝对值。

## 示例


**创建期初至今计算**

1. 在要更改的分析中，选择**添加洞察**。

1. 对于**计算类型**，选择**起初至今**，然后选择**选择**。

1. 在您创建的新洞察中，添加要比较的时间维度和值维度字段。在下面的屏幕截图中，`Order Date` 和 `Sales (Sum)` 已添加到洞察中。选中这两个字段后，Quick Sight会显示最近一个月的年初至今销售额以及与上个月相比的百分比差异。  
![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/periodOverPeriod1.png)

1. （可选）要进一步自定义洞察，请打开视觉对象菜单并选择**自定义叙述**。在出现的**编辑叙述**窗口中，从**计算**列表中拖放所需的字段，然后选择**保存**。