> ## 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

> DATE函数用于将时间戳转换为时间对象，支持在宜搭的多种场景中使用，如表单、流程设计和集成自动化等。通过DATE(timestamp)格式使用，返回值为日期对象，适用于日期加减等运算。

**DATE**函数用于将时间戳转换为时间对象。

## 支持产品场景

DATE函数支持在宜搭的以下场景中使用。

* 表单（主表字段）
* 表单（业务关联规则）
* 表单（校验）
* 流程设计（校验规则）
* 流程设计（关联操作）
* 集成自动化
* 流程-节点
* 连接器

## 格式

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

## 属性说明

| **属性**    | **是否必填** | **说明**                                                                                |
| --------- | -------- | ------------------------------------------------------------------------------------- |
| timestamp | 是        | 毫秒级时间戳。<br />**说明**：时间戳是计算机记录时间的一种格式。通常是一个字符序列，唯一地标识某一刻的时间。在宜搭表单中，「日期」组件便是由这样的序列来存储的。 |

## 返回值

| **返回值类型** | **说明**                                                                                                                                        |
| --------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| 日期对象      | 转换后的数值。<br />**说明**：日期对象可以理解为年月日时分秒。日期对象的格式为 `Sat Aug 01 2015 00:00:00 GMT+0800（中国标准时间）`，即北京时间 2015 年 8 月 1 日 00:00:00。日期对象可以进行各种运算，比如日期加减法等。 |

## 使用示例

如下图所示，你可以使用DATE()函数将日期组件的时间戳转为日期对象。

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1703053693892-4f186c14-e4b2-4e87-82fe-07f20955bf7e.png)
</Frame>

## 体验

将时间戳转换为日期对象。 用来将日期组件的时间戳转为日期对象进行日期公式运算。