38 lines
728 B
Markdown
38 lines
728 B
Markdown
|
## `TO_TIMEDURATION` [esql-to_timeduration]
|
||
|
|
|
||
|
|
**Syntax**
|
||
|
|
|
||
|
|
:::{image} ../../../../../images/to_timeduration.svg
|
||
|
|
:alt: Embedded
|
||
|
|
:class: text-center
|
||
|
|
:::
|
||
|
|
|
||
|
|
**Parameters**
|
||
|
|
|
||
|
|
`field`
|
||
|
|
: Input value. The input is a valid constant time duration expression.
|
||
|
|
|
||
|
|
**Description**
|
||
|
|
|
||
|
|
Converts an input value into a `time_duration` value.
|
||
|
|
|
||
|
|
**Supported types**
|
||
|
|
|
||
|
|
| field | result |
|
||
|
|
| --- | --- |
|
||
|
|
| keyword | time_duration |
|
||
|
|
| text | time_duration |
|
||
|
|
| time_duration | time_duration |
|
||
|
|
|
||
|
|
**Example**
|
||
|
|
|
||
|
|
```esql
|
||
|
|
row x = "2024-01-01"::datetime | eval y = x + "3 hours"::time_duration, z = x - to_timeduration("3 hours");
|
||
|
|
```
|
||
|
|
|
||
|
|
| x:datetime | y:datetime | z:datetime |
|
||
|
|
| --- | --- | --- |
|
||
|
|
| 2024-01-01 | 2024-01-01T03:00:00.000Z | 2023-12-31T21:00:00.000Z |
|
||
|
|
|
||
|
|
|