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

# HOUR

> The HOUR function returns the hour from a given time. It is supported across multiple YiDA scenarios, including Form, workflow design, and integration & automation. Pass a time object to get the corresponding hour.

The **HOUR** function returns the hour from a given time.

## Supported Scenarios

The HOUR function is supported in the following YiDA scenarios:

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

## Syntax

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

## Attributes

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

## Return Value

| **Return type** | **Description**             |
| --------------- | --------------------------- |
| Number          | The hour of the input time. |

## Example

As shown below, use the `HOUR()` function to extract the hour from a time selected by a user.

## Try It Out

Returns the hour of a given date.