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

# TIME

> The TIME function converts a timestamp for a specified time into a decimal time value. It is supported in multiple YiDA scenarios, including forms, workflow design, and integration & automation. The function takes three parameters — hour, minute, and second — and returns a decimal number that represents the specified time.

The **TIME** function converts a timestamp for a specified time into a decimal time value.

## Supported Product Scenarios

The TIME function is supported in the following YiDA scenarios:

* Form (main table field)
* Form (business association rule)
* Form (validation)
* Workflow design (validation rule)
* Workflow design (associated action)
* Integration & automation
* Workflow node
* Connector

## Format

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
TIME(hour,minute,second)
```

## Attribute Description

| **Attribute** | **Required** | **Description**    |
| ------------- | ------------ | ------------------ |
| hour          | Yes          | Timestamp, hour.   |
| minute        | Yes          | Timestamp, minute. |
| second        | Yes          | Timestamp, second. |

## Return Value

| **Return type** | **Description**                                                                                                                           |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| Number          | Returns a decimal number that represents the specified time. The time value is part of a date value and is expressed as a decimal number. |

## Example

As shown below, use the TIME() function to convert the timestamp of the current time into a decimal number.

## Try It

Returns a decimal number that represents the specified time. The time value is part of a date value and is expressed as a decimal number.
