# DatePeriod

Returns documents for a specified time period. This option has an effect only if you set FieldName to an `autn_date` metadata field. For example, this option allows you to use a single query to determine the number of documents that match a query in each day. The time period is aligned with local system time.

You can use the following values:

- century

- year

- month

- week

- day

- hour

- minute

- second

You can also add a second time period, to return this second time period in groups according to the first period. The second time period must be larger than the first.

For example:

    action=GetQueryTagValues&Text=*&FieldName=autn_date&DatePeriod=hour+day

This action returns all dates grouped into (at most) 24 segments, which represent the hours of the day.

Actions: | GetQueryTagValues
Type: | String
Default: |
Example: | `DatePeriod=year`
See Also: | FieldName

_FT_HTML5_bannerTitle.htm