This is the new *Amazon CloudFormation Template Reference Guide*. Please update your bookmarks and links. For help getting started with CloudFormation, see the [Amazon CloudFormation User Guide](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/Welcome.html).

# AWS::QuickSight::Dashboard PeriodToDateComputation
<a name="aws-properties-quicksight-dashboard-periodtodatecomputation"></a>

The period to date computation configuration.

## Syntax
<a name="aws-properties-quicksight-dashboard-periodtodatecomputation-syntax"></a>

To declare this entity in your Amazon CloudFormation template, use the following syntax:

### JSON
<a name="aws-properties-quicksight-dashboard-periodtodatecomputation-syntax.json"></a>

```
{
  "[ComputationId](#cfn-quicksight-dashboard-periodtodatecomputation-computationid)" : String,
  "[Name](#cfn-quicksight-dashboard-periodtodatecomputation-name)" : String,
  "[PeriodTimeGranularity](#cfn-quicksight-dashboard-periodtodatecomputation-periodtimegranularity)" : String,
  "[Time](#cfn-quicksight-dashboard-periodtodatecomputation-time)" : DimensionField,
  "[Value](#cfn-quicksight-dashboard-periodtodatecomputation-value)" : MeasureField
}
```

### YAML
<a name="aws-properties-quicksight-dashboard-periodtodatecomputation-syntax.yaml"></a>

```
  [ComputationId](#cfn-quicksight-dashboard-periodtodatecomputation-computationid): String
  [Name](#cfn-quicksight-dashboard-periodtodatecomputation-name): String
  [PeriodTimeGranularity](#cfn-quicksight-dashboard-periodtodatecomputation-periodtimegranularity): String
  [Time](#cfn-quicksight-dashboard-periodtodatecomputation-time): 
    DimensionField
  [Value](#cfn-quicksight-dashboard-periodtodatecomputation-value): 
    MeasureField
```

## Properties
<a name="aws-properties-quicksight-dashboard-periodtodatecomputation-properties"></a>

`ComputationId`  <a name="cfn-quicksight-dashboard-periodtodatecomputation-computationid"></a>
The ID for a computation.  
*Required*: Yes  
*Type*: String  
*Pattern*: `^[\w\-]+$`  
*Minimum*: `1`  
*Maximum*: `512`  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Name`  <a name="cfn-quicksight-dashboard-periodtodatecomputation-name"></a>
The name of a computation.  
*Required*: No  
*Type*: String  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`PeriodTimeGranularity`  <a name="cfn-quicksight-dashboard-periodtodatecomputation-periodtimegranularity"></a>
The time granularity setup of period to date computation. Choose from the following options:  
+ YEAR: Year to date.
+ MONTH: Month to date.
*Required*: No  
*Type*: String  
*Allowed values*: `YEAR | QUARTER | MONTH | WEEK | DAY | HOUR | MINUTE | SECOND | MILLISECOND`  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Time`  <a name="cfn-quicksight-dashboard-periodtodatecomputation-time"></a>
The time field that is used in a computation.  
*Required*: No  
*Type*: [DimensionField](aws-properties-quicksight-dashboard-dimensionfield.md)  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Value`  <a name="cfn-quicksight-dashboard-periodtodatecomputation-value"></a>
The value field that is used in a computation.  
*Required*: No  
*Type*: [MeasureField](aws-properties-quicksight-dashboard-measurefield.md)  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)