Period to Date Computation
The period to date computation evaluates values for a specified period to date. For example, you can create a computation to find out how much you've earned in yeartodate sales.
To use this function, you need at least one dimension in the Time field well.
Parameters
 name

A unique descriptive name that you assign or change. A name is assigned if you don't create your own. You can edit this later.
 Date

The date dimension that you want to rank.
 Value

The aggregated measure that the computation is based on.
 Time granularity

The date granularity that you want to use for the computation, for example year to date.
Computation Outputs
Each function generates a set of output parameters. You can add these outputs to the autonarrative to customize what it displays. You can also add your own custom text.
To locate the output parameters, open the Computations tab on the right, and locate the computation that you want to use. The names of the computations come from the name you provide when you create the insight. Choose the output parameter by clicking on it only once. If you click twice, you add the same output twice. Items displayed in bold can be used in the narrative.

timeField
– From the Time field well.
name
– The formatted display name of the field. 
timeGranularity
– The time field granularity (DAY, YEAR, and so on).


metricField
– From the Values field well.
name
– The formatted display name of the field. 
aggregationFunction
– The aggregation used for the metric (SUM, AVG, and so on).


previousMetricValue
– The previous value in the metric dimension.
value
– The raw value. 
formattedValue
– The value formatted by the metric field. 
formattedAbsoluteValue
– The absolute value formatted by the metric field.


previousTimeValue
– The previous value in the datetime dimension.
value
– The raw value. 
formattedValue
– The value formatted by the datetime field.


currentMetricValue
– The current value in the metric dimension.
value
– The raw value. 
formattedValue
– The value formatted by the metric field. 
formattedAbsoluteValue
– The absolute value formatted by the metric field.


currentTimeValue
– The current value in the datetime dimension.
value
– The raw value. 
formattedValue
– The value formatted by the datetime field.


periodGranularity
– The period granularity for this computation (MONTH, YEAR, and so on). 
percentDifference
– The percent difference between the current and previous values of the metric field.
value
– The raw value of the calculation of the percent difference. 
formattedValue
– The formatted value of the percent difference (for example, 42%). 
formattedAbsoluteValue
– The formatted absolute value of the percent difference (for example, 42%).


absoluteDifference
– The absolute difference between the current and previous values of the metric field.
value
– The raw value of the calculation of the absolute difference. 
formattedValue
– The absolute difference formatted by the settings in the metric field's format preferences. 
formattedAbsoluteValue
– The absolute value of the difference formatted by the metric field.
