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

# TIMESTAMP

> TIMESTAMP函数用于将日期对象转换为时间戳，支持在宜搭的多种场景中使用，如表单、流程设计等。通过该函数可以方便地进行日期与时间戳之间的转换，适用于需要精确时间处理的应用场景。

**TIMESTAMP**函数用于将日期对象转换为时间戳，你可以将该时间戳赋值给日期组件。

## 支持产品场景

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

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

## 格式

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
TIMESTAMP(date)
```

## 属性说明

| **属性** | **是否必填** | **说明** |
| ------ | -------- | ------ |
| date   | 是        | 日期对象。  |

## 返回值

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

## 使用示例

如下图所示，你可以使用TIMESTAMP()函数将当前时间的时间戳赋值到日期组件。

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1703059876598-01bf249b-52c5-481f-9b6d-a06e190f571b.png)
</Frame>

## 体验

将日期对象转换成时间戳，主要用来将日期公式计算出的日期对象转为时间戳，给日期组件赋值。