Deprecated
This field is being deprecated, for the new version check DateTime Field
The Date Field is meant for displaying dates with an specific format (in case you don't want to use timestamps). The transform_data method of this field, turns the data into a more readable format specified by the user through the format parameter.
Schema Details
| Property | Type | Description | Required | Default | Enum |
|---|---|---|---|---|---|
| type | string | The type of field. | No | date | date |
| label | string/null | Label to show for this field. | No | null | |
| css_style | object/null | Style to apply in the HTML of the UI. | No | null | |
| css_class | string/null | CSS class to apply in the HTML component. | No | null | |
| translate | string/null | Translation key for the field. | No | null | |
| translate_label | string/null | Translation key for the label. | No | null | |
| analytics | object/null | Analytics configuration. | No | null | |
| if_not_exist | string/null | Show only if the specified field doesn't exist. | No | null | |
| if_exist | string/null | Show only if the specified field does exist. | No | null | |
| only_on_highlight | boolean | Show only when the value is highlighted. | No | false | |
| display | any | Value from the field. | No | null | |
| field | string | Path to field from which to retrieve the value (in JMESPath format). | Yes | ||
| field_highlight | string/null | Path to highlight field from which to retrieve the value, in case it is not the same as the field parameter (in JMESPath format). | No | null | |
| default | any | Default value to use in case no value was found for the field. | No | null | |
| transform | array/string/null | List of transformations to apply to the displayed values. | No | null | |
| suffix | string/null | Suffix to append to the value or values. | No | null | |
| prefix | string/null | Prefix to append to the value or values. | No | null | |
| suffix_label | string/null | Suffix to append to the label of the field. | No | null | |
| prefix_label | string/null | Prefix to append to the label of the field. | No | null | |
| sort | string/boolean | Sort order for values in an array. | No | false | asc, desc |
| unique | boolean | If the values are in an array, remove the duplicates. | No | false | |
| show_blank | boolean | If there is no value, or value is null, and show_blank is true, keep the field. | No | false | |
| replacement | string/null | Replacement string for matches in the transformations Transformation.REPLACE_FIRST, Transformation.REPLACE_LAST, and Transformation.REPLACE_ALL. | No | null | |
| pattern | string/null | Pattern used to look for matches in the transformations Transformation.REPLACE_FIRST, Transformation.REPLACE_LAST, and Transformation.REPLACE_ALL. | No | null | |
| format | string | Format of the date value. | No | %Y-%m-%d | |
| timezone | string/null | Timezone for the date value. | No | null |
Example JSON Representation
{
"type": "date",
"label": "Date of Birth",
"css_style": null,
"css_class": null,
"translate": null,
"translate_label": null,
"analytics": null,
"if_not_exist": null,
"if_exist": null,
"only_on_highlight": false,
"display": null,
"field": "birthdate",
"field_highlight": null,
"default": null,
"transform": null,
"suffix": null,
"prefix": null,
"suffix_label": null,
"prefix_label": null,
"sort": false,
"unique": false,
"show_blank": false,
"replacement": null,
"pattern": null,
"format": "%Y-%m-%d",
"timezone": "UTC"
}
Code Example of Usage
date_field_example = DateField(
field="birthdate",
format="%Y-%m-%d",
timezone="UTC"
)
Overview
Content Tools