The DateAgeField
schema defines the structure for a field object used to display the age calculated from a date value within a UI. This schema allows for various customizations such as labeling, CSS styling, translation, transformations, and conditional display logic.
The Date Age Field refers to a format to display the difference between a previous year and the current year. For example if the value of the field selected was to be 12/September/1996 and the current date is 09/September/2023 then de value displayed after the data transformation would be 26 years old.
DateAgeField
Property | Type | Description | Required | Default | Enum |
---|
type | string | The type of field. | No | date_age | date_age |
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/null | Format of the date value. | No | null |
|
timezone | string/null | Timezone for the date value. | No | null |
|
Code Example of Usage
Code Block |
---|
|
date_age_field_example = DateAgeField(
field="birthdate",
suffix=" years",
format="yyyy-MM-dd",
timezone="UTC"
) |