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

> The TIMESTAMP function converts a date object to a timestamp and supports use in various YiDA scenarios, such as forms and workflow design. This function simplifies conversion between dates and timestamps, and suits applications that require precise time handling.

The **TIMESTAMP** function converts a date object to a timestamp. You can assign the timestamp to a date component.

## Supported Product Scenarios

The TIMESTAMP function can be used in the following YiDA scenarios:

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

## Syntax

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

## Attribute Description

| **Attribute** | **Required** | **Description**  |
| ------------- | ------------ | ---------------- |
| date          | Yes          | The date object. |

## Return Value

| **Return value type** | **Description**                                                                                                                                                                                                                                                                                                                                                   |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Timestamp             | The converted numerical value.<br />**Note**: A date object can be interpreted as 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 represents 00:00:00 Beijing time on August 1, 2015. Date objects support various operations, such as date addition and subtraction. |

## Example

As shown in the following figure, you can use the TIMESTAMP() function to assign the timestamp of the current time to a date component.

## Overview

Converts a date object to a timestamp. This function is mainly used to convert a date object calculated by a date formula into a timestamp and assign it to a date component.