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

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

`periodOverPeriodDifference` 函數會計算由週期粒度和偏移量指定的兩個不同期間內的量值差異。與差異計算不同，此函數使用基於日期的偏移量而不是固定大小的偏移量。這樣可確保只比較正確的日期，即使資料集中缺少資料點也是如此。

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

```
periodOverPeriodDifference(
	measure, 
	date, 
	period, 
	offset)
```

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

 *measure*   
您想要對其執行 periodOverPeriod 計算的彙總量值。

 *dateTime*   
我們用於執行各期間 (Period-Over-Period) 計算的日期維度。

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

 *offset*   
(選用) 偏移量可以是正整數或負整數，代表您要比較的先前期間 (由期間指定)。例如，偏移量為 1 的季度期間表示與上一季度進行比較。  
預設值為 1.

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

下列範例使用計算欄位 `PeriodOverPeriod` 來顯示昨天的銷售金額差異

```
periodOverPeriodDifference(sum(Sales), {Order Date})
```

![\[這是範例計算傳回的影像。\]](http://docs.aws.amazon.com/zh_tw/quick/latest/userguide/images/MonthOverMonthDifference.png)


下列範例使用計算欄位 `PeriodOverPeriod` 來顯示前兩個月的銷售金額差異。以下範例是 `Mar2020` 與 `Jan2020` 的銷售額比較。

```
periodOverPeriodDifference(sum(Sales),{Order Date}, MONTH, 1)
```

![\[這是範例計算傳回的影像。\]](http://docs.aws.amazon.com/zh_tw/quick/latest/userguide/images/MonthOverMonthDifference2.png)