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

# periodToDateSumOverTime
<a name="periodToDateSumOverTime-function"></a>

`periodToDateSumOverTime` 函數計算指定時間粒度 (例如一個季度) 到某個時間點的量值總和。

## 語法
<a name="periodToDateSumOverTime-function-syntax"></a>

```
periodToDateSumOverTime(
	measure, 
	dateTime, 
	period)
```

## 引數
<a name="periodToDateSumOverTime-function-arguments"></a>

 *measure*   
您想要執行計算的彙總量值

 *dateTime*   
您計算 PeriodOverTime 計算的日期維度。

 *period*   
(選用) 您的運算所針對的期間。`YEAR` 的粒度表示 `YearToDate` 運算，`Quarter` 表示 `QuarterToDate`，以此類推。有效粒度包括 `YEAR`、`QUARTER`、`MONTH`、`WEEK`、`DAY`、`HOUR`、`MINUTE` 和 `SECONDS`。  
預設值是視覺效果的日期維度粒度。

## 範例
<a name="periodToDateSumOverTime-function-example"></a>

下列函數返回每月的票價金額總計。

```
periodToDateSumOverTime(sum({fare_amount}), pickupDatetime, MONTH)
```

![\[這是範例計算結果的影像 (含插圖)。\]](http://docs.aws.amazon.com/zh_tw/quick/latest/userguide/images/PTDSumOverTime-example-results.png)