> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# DATE

> The DATE function converts a timestamp into a date object. It is available across multiple YiDA scenarios such as forms, workflow design, and integration & automation. Use the format DATE(timestamp) to return a date object suitable for operations such as date arithmetic.

The **DATE** function converts a timestamp into a date object.

## Supported Product Scenarios

The DATE function is available in the following YiDA scenarios:

* Form (main table fields)
* Form (business association rules)
* Form (validation)
* Workflow design (validation rules)
* Workflow design (associated actions)
* Integration & automation
* Workflow node
* Connector

## Format

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
DATE(timestamp)
```

## Attribute Description

| **Attribute** | **Required** | **Description**                                                                                                                                                                                                                                                          |
| ------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| timestamp     | Yes          | Millisecond-level timestamp.<br />**Note**: A timestamp is a format that computers use to record time. It is typically a character sequence that uniquely identifies a specific moment. In YiDA forms, the Date component stores its values using this type of sequence. |

## Return Value

| **Return type** | **Description**                                                                                                                                                                                                                                                                                                                                |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Date object     | The converted value.<br />**Note**: A date object represents year, month, day, hour, minute, and second. The format of a date object is `Sat Aug 01 2015 00:00:00 GMT+0800 (China Standard Time)`, which corresponds to August 1, 2015, 00:00:00 Beijing time. Date objects support various operations, such as date addition and subtraction. |

## Example

As shown below, use the DATE() function to convert the timestamp of a Date component into a date object.

## Try It Out

Convert a timestamp into a date object. Use this function to convert the timestamp of a Date component into a date object for use in date formula calculations.