alfresco-ng2-components/docs/content-services/components/search-datetime-range.component.md
Eugenio Romano 12ef9656aa
4.6.0 bump and doc update (#7253)
* update doc 4.6.0

* 4.6.0 bump

* fix

* fix lock
2021-09-15 16:08:17 +01:00

3.0 KiB

Title, Added, Status, Last reviewed
Title Added Status Last reviewed
Search datetime range component v4.2.0 Active 2020-11-02

Search datetime range component

Implements a search widget for the Search Filter component.

Date Range Widget

Basic usage

{
    "search": {
        "categories": [
            {
                "id": "createdDatetimeRange",
                "name": "Created Datetime (range)",
                "enabled": true,
                "component": {
                    "selector": "datetime-range",
                    "settings": {
                        "field": "cm:created"
                    }
                }
            }
        ]
    }
}

Settings

Name Type Description
field string Field to apply the query to. Required value
datetimeFormat string Datetime format. Datetime formats used by the datetime picker are Moment.js instances, so you can use any datetime format supported by Moment. Default is 'DD/MM/YYYY HH:mm'.
maxDatetime string A fixed datetime that will set the maximum searchable datetime. Default is no maximum.
hideDefaultAction boolean Show/hide the widget actions. By default is false.

Details

This component lets the user select a range between two dates and times based on the particular field. See the Search filter component for full details of how to use widgets in a search query.

Custom datetime format

You can set the datetime range picker to work with any datetime format your app requires. You can use any datetime format supported by Moment.js in the datetimeFormat and in the maxDatetime setting:

{
    "search": {
        "categories": [
            {
                "id": "createdDateTimeRange",
                "name": "Created Datetime (range)",
                "enabled": true,
                "component": {
                    "selector": "datetime-range",
                    "settings": {
                        "field": "cm:created",
                        "datetimeFormat": "DD-MMM-YY HH:mm:ss",
                        "maxDatetime": "10-Mar-20 20:00"
                    }
                }
            }
        ]
    }
}

See also