> For the complete documentation index, see [llms.txt](https://developer.collibra.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.collibra.com/workflows/designing-workflows/forms/form-components/date.md).

# Date

The **Date** component adds an input field where users can enter a date manually or by selecting it from a calendar.

The value of the component is stored as a Unix timestamp in milliseconds, in UTC at midnight, for example `1749513600000` for *June 10, 2025*. The class of the stored value is Long.

{% hint style="info" %}
Using a variable of a date component on the same form to show the selected date results in the raw `toString()` representation Java Date object.
{% endhint %}

## General properties

| Property      | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ID            | The identifier of the component, primarily used for client-side interactions and identification in the HTML structure of the form. When you add a component, an ID is automatically generated to ensure it is unique in the form.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Label         | Text that appears above the form component in Collibra, briefly describing its purpose. This is the main title or question for the field.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Label tooltip | <p>Additional help or information about the field. If defined, a question mark icon appears after the label, showing the tooltip when users hover their pointer over the icon.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>The tooltip supports plain text only.</p></div>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Documentation | A text field for internal design notes or future reference about this specific component. This information is not visible in Collibra.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| Value         | <p>The name of the variable that stores the data entered into this field in Collibra. Use a variable name enclosed in double curly braces, for example <code>{{variableName}}</code>. Since this is a process variable, you can then use it throughout your workflow processes, such as in scripts, other forms, or service tasks.</p><p>You can also specify where the variable is saved:</p><ul><li><code>{{variableName}}</code> or <code>{{self.variableName}}</code>: Stores the value as a process variable in the current workflow.</li><li><code>{{parent.variableName}}</code>: Stores the value in a variable that belongs to the immediate parent process of the current workflow.</li><li><code>{{root.variableName}}</code>: Stores the value in a variable that belongs to the root process, which is the top-level workflow that started the current one.</li></ul> |
| Default value | The pre-filled value for the component when the form first appears. A filed shows the default value if the **Value** property does not set a value explicitly.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Tab Index     | <p>The tabbing order of this component in a user task form. When navigating through the form by pressing the <kbd>Tab</kbd> key, the cursor moves from one component to another based on their assigned tab index numbers. The component with the lowest tab index number receives focus first. The focus then moves sequentially to the component with the next highest number. For example, a component with a tab index of <em>1</em> receives focus before a component with a tab index of <em>2</em>.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>The tab index is ignored if the component is inside a subform.</p></div>                                                                                                                                                                                                       |

## Validation properties

| Attribute          | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Required           | Whether the component must have a value for the form to be submitted.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Minimum date       | The earliest valid date for this component. You can choose between a relative date in relation to the current date or an expression.                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Maximum date       | The latest valid date for this component. You can choose between a relative date in relation to the current date or an expression.                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Custom validations | <p>A list of additional validations for the component. Each custom validation consists of two parts:</p><ul><li><strong>Expression</strong>: A rule that must evaluate to <code>true</code> for the form to be submitted.</li><li><strong>Error message</strong>: The message that shows if the expression evaluates to <code>false</code>.</li></ul><p>For example, you can create a validation with the expression <code>{{experience>2}}</code>. This expression evaluates to <code>true</code> only if the value of the <code>experience</code> variable is greater than 2.</p> |

### Validation messages

| Attribute    | Description                                                                                   |
| ------------ | --------------------------------------------------------------------------------------------- |
| Minimum date | The error message that shows if the selected date is earlier than the specified minimum date. |
| Maximum date | The error message that shows if the selected date is later than the specified maximum date.   |

## Rendering properties

| Property         | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Ignored          | Whether the component is be hidden in the form and any value it might hold is not included in the submission data.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Visible          | Whether the component is shown or hidden on the form. You can controlled this unconditionally or through an expression. For example, you can set an expression that hides or shows the component based on a user selection in another component. This property is enabled by default.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Enabled          | Whether the component is interactive or read-only on the form. When disabled, users cannot change the component value. This property is enabled by default.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Description      | Additional information shown in Collibra below the form field, providing detailed instructions, examples, or essential guidance.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Format           | Currently not in use.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Format (unicode) | <p>The format of the date shown in Collibra, for example <code>MMMM d, y</code> for <em>September 02, 2025</em>:</p><ul><li><p>Days:</p><ul><li><code>E</code> for the short name of the weekday, fore example <em>Tue</em>.</li><li><code>EEEE</code> for the long name of the weekday, for example <em>Tuesday</em>.</li><li><code>e</code> or <code>ee</code> for the number of the weekday, for example <em>3</em> or <em>03</em> for Tuesday when the first day of the week is Sunday.</li><li><code>d</code> or <code>dd</code> for the number of the day in a month, for example <em>02</em> for the second of a month.</li></ul></li><li><p>Months:</p><ul><li><code>M</code> or <code>MM</code> for the number of the month, for example <em>09</em> for September.</li><li><code>MMM</code> for the short name of the month, for example <em>Sep</em> for September.</li><li><code>MMMM</code> for the short name of the month, for example <em>September</em>.</li></ul></li><li><p>Years:</p><ul><li><code>y</code> or <code>yyyy</code> for the year with four digits, for example <em>2025</em>.</li><li><code>yy</code> for the year with two digits, for example <em>25</em> for 2025.</li></ul></li></ul> |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.collibra.com/workflows/designing-workflows/forms/form-components/date.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.