Amazon QuickSight – periodToDateStDev

The periodToDateStDev() function in Amazon QuickSight is a statistical function that calculates the standard deviation of a measure for a specified time period. Standard deviation is a measure of how spread out the values in a dataset are relative to the mean value.

Syntax

#Start#
periodToDateStDev(
    measure, 
    dateTime, 
    period, 
    endDate (optional)
)
#End#

This function takes the following arguments:

measure: This parameter specifies the measure for which you want to calculate the standard deviation. The measure can be a field or an expression.

dateTime: This parameter specifies the date and time for which you want to calculate the standard deviation. The parameter should be in the timestamp format.

period: This parameter specifies the time period for which you want to calculate the standard deviation. The valid values for the period parameter are hour, day, week, month, quarter, and year.

endDate (optional): This parameter specifies the end date and time of the time period. If this parameter is not specified, the current date and time will be used as the end date.

Suppose you have a sales dataset with the following fields: Date, Product, Sales, and Region. You can use the periodToDateStDev() function to calculate the standard deviation of sales for the current week by region. Here’s an example formula:

Example

#Start#
periodToDateStDev(Sales, Date, 'week', now(), Region)
#End#

This formula calculates the standard deviation of the Sales field for the current week, grouped by Region. The now() function is used to specify the current date and time as the end date. This function can help you identify the level of variability of sales for the week in each region and compare it to the overall variability of the data.