本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 期間至今運算
<a name="period-to-date-function"></a>

指定期間到目前為止，日期運算期間評估的值。例如，您可以建立一個運算，以瞭解您年初迄今獲得的銷售。

若要使用此函數，您在**時間**欄位集至少需要有一個維度。

## Parameters
<a name="period-to-date-function-parameters"></a>

*name*   
您指派或變更的唯一描述名稱。如果您未建立自己的名稱，則會指派一個名稱。您稍後可以編輯此名稱。

*日期*   
您想要排名的日期維度。

*Value*   
以此為基礎來運算的彙總度量。

*時間精細程度*   
您想要用於運算的日其精細程度，例如年初至今。

## 運算輸出
<a name="period-to-date-computation-outputs"></a>

每個函數會產生一組輸出參數。您可以將這些輸出新增到自動敘述以自訂其顯示內容。您也可以新增自己的自訂文字。

若要尋找輸出參數，請開啟右側的**運算**標籤，並找出您想要使用的運算。運算的名稱是來自您建立洞見時所提供的名稱。選擇輸出參數 (僅按一下即可)。如果您按了兩下，您將新增兩次相同的輸出。以**粗體**顯示的項目為敘述中可用的項目。
+ `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`：由指標欄位格式化的差異絕對值。

## 範例
<a name="period-to-date-computation-example"></a>

**建立期間至今運算**

1. 在要變更的分析中，選擇**新增洞見**。

1. 對於**運算類型**，選擇**期間至今**，然後選擇**選取**。

1. 在您建立的新洞見中，新增要比較的時間維度和價值維度欄位。在下面的螢幕擷取畫面中，`Order Date` 和 `Sales (Sum)` 已新增到洞見中。選取這兩個欄位後，Quick Sight 會顯示上個月的年初至今銷售額，以及與上個月相比的百分比差異。  
![\[alt text not found\]](http://docs.aws.amazon.com/zh_tw/quick/latest/userguide/images/periodOverPeriod1.png)

1. (選用) 若要進一步自訂洞見，請開啟視覺化效果選單並選擇**自訂敘述**。在出現的**編輯敘述**視窗中，從**運算**清單中拖曳所需的欄位，然後選擇**儲存**。