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

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

`periodToDatePercentile` 函數會根據指定時間粒度 (例如一個季度) 到相對於該期間的某個時間點的實際量值數字，計算百分位數。它使用在欄位集中應用的分組和排序方法。

若要傳回資料集中最接近的百分位數值，請使用 `periodToDatePercentile`。若要傳回資料集中可能不存在的確切百分位數值，請改用 `periodToDatePercentileCont`。

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

```
periodToDatePercentile(
	measure, 
	percentile, 
	dateTime, 
	period, 
	endDate (optional))
```

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

 *measure*   
引數必須是欄位。結果會省略空值。常值無作用。

 *percentile*   
百分位數值可以是 0-100 之間的任何數字常數。百分位數為 50 計算量值的中位數。

 *dateTime*   
您運算 PeriodToDate 彙總時的「日期」維度。

 *period*   
您的運算所適用的期間。`YEAR` 的粒度表示 `YearToDate` 運算，`Quarter` 表示 `QuarterToDate`，以此類推。有效粒度包括 `YEAR`、`QUARTER`、`MONTH`、`WEEK`、`DAY`、`HOUR`、`MINUTE` 和 `SECONDS`。

 *endDate*   
(選用) 您要結束運算 periodToDate 彙總的日期維度。若省略，則預設為 `now()`。

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

下列範例計算 21 年 6 月 30 日當週每個付款類型的票價金額當週迄今的第 90 個百分位數。為簡單起見，我們僅過濾掉一筆付款。21 年 6 月 30 日是週三。快速從星期天開始。在我們的範例中是 21 年 6 月 27 日。

```
periodToDatePercentile(fare_amount, 90, pickupDatetime, WEEK, parseDate("06-30-2021", "MM-dd-yyyy"))
```

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