As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

A função `periodToDateSum` adiciona a medida especificada para uma determinada granularidade de tempo (por exemplo, um quarto) até um ponto no tempo, em relação a esse período.

## Sintaxe
<a name="periodToDateSum-function-syntax"></a>

```
periodToDateSum(
	measure, 
	dateTime, 
	period, 
	endDate)
```

## Argumentos
<a name="periodToDateSum-function-arguments"></a>

 *medida*   
O argumento deve ser um campo. Valores nulos são omitidos nos resultados. Valores literais não funcionam.

 *dateTime*   
A dimensão Data na qual você está computando PeriodToDate agregações.

 *período*   
O período durante o qual você está computando a computação. A granularidade de `YEAR` significa computação de `YearToDate`, `Quarter` significa `QuarterToDate` e assim por diante. As granularidades válidas incluem `YEAR`, `QUARTER`, `MONTH`, `WEEK`, `DAY`, `HOUR`, `MINUTE` e `SECONDS`.

 *endDate*   
(Opcional) A dimensão da data em que você está encerrando periodToDate as agregações computacionais. Se omitida, assumirá `now()` como padrão.

## Exemplo
<a name="periodToDateSum-function-example"></a>

A função a seguir calcula a soma semanal acumulada do valor da tarifa por pagamento, para a semana de 30/6/21. Para simplificar o exemplo, filtramos um único pagamento. A data 30/6/21 é quarta-feira. O Quick começa a semana aos domingos. No nosso exemplo, essa data é 27/6/21.

```
periodToDateSum(fare_amount, pickUpDateTime, WEEK, parseDate("06-30-2021", "MM-dd-yyyy"))
```

![\[Esta é uma imagem dos resultados do exemplo, com ilustrações.\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/PTDSumResults.png)