time-range parameters

Author: Natalia Kazakova (DevExpress)

reporting-for-desktop/articles/report-designer/report-designer-for-winforms/use-report-parameters/date-range-report-parameters.md

@@ -5,30 +5,53 @@ author: Sergey Andreev
 
 # Date Range Report Parameters
 
-This topic describes how to create a date range parameter and filter a report's data by the specified dates.
+This topic describes how to create **date range** and **time range** parameters and filter a report’s data by the specified date or time values.
 
-![A date range parameter's editor in Preview](../../../../images/eurd-win-date-ranges-parameters-panel.png)
+![A date range parameter's editor in Preview](~/reporting-for-desktop/images/use-date-ranges-parameters-panel.png)
 
 ## Create a Date Range Parameter in the Report Designer
 
-Follow the steps below to add a date range parameter to a report in the [Report Designer](../../report-designer-for-winforms.md):
+Follow the steps below to add a range parameter to a report in the [Report Designer](../../report-designer-for-winforms.md):
 
-1. [Create a report parameter](create-a-report-parameter.md) and set the **Value Source** option to **Range Parameters**. The **Start Parameter** and **End Parameter** sections appear, and you can configure options in these sections to create a date range.
+1. [Create a report parameter](create-a-report-parameter.md).
+2. In the *Add New Parameter* dialog, specify parameter options:
+   
+    - **Parameter type**: *Date and Time*, *Date*, or *Time*
+    - **Value Source**: *Range Parameters*
+   
+    The **Start Parameter** and **End Parameter** sections that appear allow you to configure options to create a date or time range:
 
-    ![add-parameter-dialog](../../../../images/use-date-ranges-design-add-param-dialog.png)
+    ![The "Add new parameter" dialog for a range parameter](~/reporting-for-desktop/images/use-date-ranges-design-add-param-dialog.png)
 
-2. Set the name and initial value for the **Start Parameter** and **End Parameter**. To specify an [expression](../use-expressions.md) instead of a static value, click the **Value** option's ellipsis button and use the **Expression Editor** dialog.
+3. You can change the *Name* and initial static *Value* for the **Start Parameter** and **End Parameter**. To specify an [expression](../use-expressions.md) instead of a static value, the **Value** option's ellipsis button and use the **Expression Editor** dialog:
 
-    ![value-expression](../../../../images/use-date-ranges-design-value-expression.png)
+    ![The "Add new parameter" dialog for a range parameter - Expression](~/reporting-for-desktop/images/use-date-ranges-design-value-expression.png)
 
-After you create a date range parameter, you can reference the names of the **Start Parameter** and **End Parameter** in the report's filter string to [filter the report's data](../shape-report-data/filter-data/filter-data-at-the-report-level.md) by the created date range. Select the report, click the **FilterString**'s ellipsis button in the **Properties window**, and construct a filter condition in the invoked **FilterString Editor**.
+4. [Reference the created range parameter](reference-report-parameters.md). You can reference this parameter in the report’s filter string, in expressions, and in a control's **Text** property. You can also bind control and data source parameters to report parameters.
 
-![filterstring](../../../../images/use-date-ranges-filterstring.png)
+    We recommend that you use the following functions with range parameters in expressions and filter strings:
 
-When you switch to the report's **Print Preview** tab, the [Parameters panel](parameters-panel.md) displays the date range parameter. After you submit a start and end date, the report document shows filtered data.
+    - `InDateRange(Date, FromDate, ToDate)` - equivalent to the `FromDate <= Date && Value < Date` expression.
+    - `InTimeRange(Time, FromTime, ToTime)` - equivalent to the `FromTime <= Time && Time < ToTime` expression (including cases where the range spans midnight, such as 23:00-01:00).
+    - `OutOfTimeRange(Time, FromTime, ToTime)` - equivalent to the `FromTime > Time || Time => ToTime` expression (including cases where the range spans midnight, such as 23:00-01:00).
 
-![A date range parameter's editor in Preview](../../../../images/eurd-win-date-ranges-parameters-panel.png)
+    The image below filters the report's data by the following filter string:
 
-The start and end parameter values store the selected day's midnight time. For instance, if you choose _10/15/2019_, the *DateTime* value is _10/15/2019 12:00:00 AM_. If your date fields include non-midnight times, records for the end date _10/15/2019_ are excluded from the report. To include data for the 10/15/2019 date, use the **GetDate()** function in the **FilterString Editor**.  
+    `InDateRange([ShippedDate], ?paramDateRange_Start, ?paramDateRange_End) `
 
-![Filter String - GetDate](../../../../images/eurd-win-date-ranges-filterstring-getdate.png)
+    ![Reference the created range parameter in the filter string](~/reporting-for-desktop/images/use-date-ranges-filterstring.png)
+
+
+When you switch to the report's **Print Preview** tab, the [Parameters panel](parameters-panel.md) displays the newly created range parameter. Click the editor to set a range. The editor type depends on the parameter type:
+
+**An editor for "Date" and "Date and Time" range parameters:**
+
+![A date range parameter's editor on Print Preview.](~/reporting-for-desktop/images/use-date-ranges-parameters-panel.png)
+
+**An editor for "Time" range parameters:**
+
+![A time range parameter's editor on Print Preview.](~/reporting-for-desktop/images/use-time-ranges-parameters-panel.png)
+
+After you submit start and end values, the report document shows filtered data. The report below shows the **ShippedDate** field filtered by the date range parameter:
+
+![The report data is filtered by the date range](~/reporting-for-desktop/images/use-date-ranges-parameters-filtered.png)

reporting-for-desktop/images/eurd-win-date-ranges-filterstring-getdate.png

@@ -9,6 +9,9 @@ This topic describes how to create a date range parameter and filter a report's
 
 ![A date range parameter's editor in Preview](../../../images/eurd-web-date-ranges-parameters-panel.png)
 
+> [!Note]
+> Web Report controls do not support `Date` and `Time` range parameters. You can only create a range parameter of `Date and Time` type.
+
 ## Create a Date Range Parameter in the Report Designer
 
 Follow the steps below to add a date range parameter to a report in the [Report Designer](../first-look-at-the-report-designer.md):
@@ -31,4 +34,4 @@ When you switch to the report's **Print Preview** tab, the [Parameters panel](pa
 
 The start and end parameter values store the selected day's midnight time. For instance, if you choose _10/15/2019_, the *DateTime* value is _10/15/2019 12:00:00 AM_. If your date fields include non-midnight times, records for the end date _10/15/2019_ are excluded from the report. To include data for the 10/15/2019 date, use the **GetDate()** function in the **FilterString Editor**.  
 
-![Filter String - GetDate](../../../images/eurd-web-date-ranges-filterstring-getdate.png)
+![Filter String - GetDate](../../../images/eurd-web-date-ranges-filterstring-getdate.png)