mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-09-20 08:40:50 +00:00
Add doc for age() function
This commit is contained in:
parent
4962df7efb
commit
31d84d5aed
@ -637,6 +637,79 @@ Result:
|
|||||||
└───────────────────────────────────────────────┘
|
└───────────────────────────────────────────────┘
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## age
|
||||||
|
|
||||||
|
Returns the difference between two dates or dates with time values expressed as number of full units.
|
||||||
|
E.g. the difference between `2022-01-01` and `2021-12-29` is 3 days for `day` unit, 0 months for `month` unit, 0 years for `year` unit.
|
||||||
|
|
||||||
|
**Syntax**
|
||||||
|
|
||||||
|
``` sql
|
||||||
|
age('unit', startdate, enddate, [timezone])
|
||||||
|
```
|
||||||
|
|
||||||
|
**Arguments**
|
||||||
|
|
||||||
|
- `unit` — The type of interval for result. [String](../../sql-reference/data-types/string.md).
|
||||||
|
Possible values:
|
||||||
|
|
||||||
|
- `second`
|
||||||
|
- `minute`
|
||||||
|
- `hour`
|
||||||
|
- `day`
|
||||||
|
- `week`
|
||||||
|
- `month`
|
||||||
|
- `quarter`
|
||||||
|
- `year`
|
||||||
|
|
||||||
|
- `startdate` — The first time value to subtract (the subtrahend). [Date](../../sql-reference/data-types/date.md), [Date32](../../sql-reference/data-types/date32.md), [DateTime](../../sql-reference/data-types/datetime.md) or [DateTime64](../../sql-reference/data-types/datetime64.md).
|
||||||
|
|
||||||
|
- `enddate` — The second time value to subtract from (the minuend). [Date](../../sql-reference/data-types/date.md), [Date32](../../sql-reference/data-types/date32.md), [DateTime](../../sql-reference/data-types/datetime.md) or [DateTime64](../../sql-reference/data-types/datetime64.md).
|
||||||
|
|
||||||
|
- `timezone` — [Timezone name](../../operations/server-configuration-parameters/settings.md#server_configuration_parameters-timezone) (optional). If specified, it is applied to both `startdate` and `enddate`. If not specified, timezones of `startdate` and `enddate` are used. If they are not the same, the result is unspecified. [String](../../sql-reference/data-types/string.md).
|
||||||
|
|
||||||
|
**Returned value**
|
||||||
|
|
||||||
|
Difference between `enddate` and `startdate` expressed in `unit`.
|
||||||
|
|
||||||
|
Type: [Int](../../sql-reference/data-types/int-uint.md).
|
||||||
|
|
||||||
|
**Example**
|
||||||
|
|
||||||
|
Query:
|
||||||
|
|
||||||
|
``` sql
|
||||||
|
SELECT age('hour', toDateTime('2018-01-01 22:30:00'), toDateTime('2018-01-02 23:00:00'));
|
||||||
|
```
|
||||||
|
|
||||||
|
Result:
|
||||||
|
|
||||||
|
``` text
|
||||||
|
┌─age('hour', toDateTime('2018-01-01 22:30:00'), toDateTime('2018-01-02 23:00:00'))─┐
|
||||||
|
│ 24 │
|
||||||
|
└───────────────────────────────────────────────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
Query:
|
||||||
|
|
||||||
|
``` sql
|
||||||
|
SELECT
|
||||||
|
toDate('2022-01-01') AS e,
|
||||||
|
toDate('2021-12-29') AS s,
|
||||||
|
age('day', s, e) AS day_age,
|
||||||
|
age('month', s, e) AS month__age,
|
||||||
|
age('year', s, e) AS year_age;
|
||||||
|
```
|
||||||
|
|
||||||
|
Result:
|
||||||
|
|
||||||
|
``` text
|
||||||
|
┌──────────e─┬──────────s─┬─day_age─┬─month__age─┬─year_age─┐
|
||||||
|
│ 2022-01-01 │ 2021-12-29 │ 3 │ 0 │ 0 │
|
||||||
|
└────────────┴────────────┴─────────┴────────────┴──────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
## date\_diff
|
## date\_diff
|
||||||
|
|
||||||
Returns the difference between two dates or dates with time values.
|
Returns the difference between two dates or dates with time values.
|
||||||
|
@ -689,6 +689,78 @@ SELECT date_add(YEAR, 3, toDate('2018-01-01'));
|
|||||||
└───────────────────────────────────────────────┘
|
└───────────────────────────────────────────────┘
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## age
|
||||||
|
|
||||||
|
Вычисляет разницу между двумя значениями дат или дат со временем выраженную как целое число единиц.
|
||||||
|
Например, разница между `2022-01-01` и `2021-12-29` 3 дня для единицы `day`, 0 месяцев для единицы `month`, 0 лет для единицы `year`.
|
||||||
|
|
||||||
|
**Синтаксис**
|
||||||
|
|
||||||
|
``` sql
|
||||||
|
age('unit', startdate, enddate, [timezone])
|
||||||
|
```
|
||||||
|
|
||||||
|
**Аргументы**
|
||||||
|
|
||||||
|
- `unit` — единица измерения времени, в которой будет выражено возвращаемое значение функции. [String](../../sql-reference/data-types/string.md).
|
||||||
|
Возможные значения:
|
||||||
|
|
||||||
|
- `second`
|
||||||
|
- `minute`
|
||||||
|
- `hour`
|
||||||
|
- `day`
|
||||||
|
- `week`
|
||||||
|
- `month`
|
||||||
|
- `quarter`
|
||||||
|
- `year`
|
||||||
|
|
||||||
|
- `startdate` — первая дата или дата со временем, которая вычитается из `enddate`. [Date](../../sql-reference/data-types/date.md), [Date32](../../sql-reference/data-types/date32.md), [DateTime](../../sql-reference/data-types/datetime.md) или [DateTime64](../../sql-reference/data-types/datetime64.md).
|
||||||
|
|
||||||
|
- `enddate` — вторая дата или дата со временем, из которой вычитается `startdate`. [Date](../../sql-reference/data-types/date.md), [Date32](../../sql-reference/data-types/date32.md), [DateTime](../../sql-reference/data-types/datetime.md) или [DateTime64](../../sql-reference/data-types/datetime64.md).
|
||||||
|
|
||||||
|
- `timezone` — [часовой пояс](../../operations/server-configuration-parameters/settings.md#server_configuration_parameters-timezone) (необязательно). Если этот аргумент указан, то он применяется как для `startdate`, так и для `enddate`. Если этот аргумент не указан, то используются часовые пояса аргументов `startdate` и `enddate`. Если часовые пояса аргументов `startdate` и `enddate` не совпадают, то результат не определен. [String](../../sql-reference/data-types/string.md).
|
||||||
|
|
||||||
|
**Возвращаемое значение**
|
||||||
|
|
||||||
|
Разница между `enddate` и `startdate`, выраженная в `unit`.
|
||||||
|
|
||||||
|
Тип: [Int](../../sql-reference/data-types/int-uint.md).
|
||||||
|
|
||||||
|
**Пример**
|
||||||
|
|
||||||
|
Запрос:
|
||||||
|
|
||||||
|
``` sql
|
||||||
|
SELECT age('hour', toDateTime('2018-01-01 22:30:00'), toDateTime('2018-01-02 23:00:00'));
|
||||||
|
```
|
||||||
|
|
||||||
|
Результат:
|
||||||
|
|
||||||
|
``` text
|
||||||
|
┌─age('hour', toDateTime('2018-01-01 22:30:00'), toDateTime('2018-01-02 23:00:00'))─┐
|
||||||
|
│ 24 │
|
||||||
|
└───────────────────────────────────────────────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
Запрос:
|
||||||
|
|
||||||
|
``` sql
|
||||||
|
SELECT
|
||||||
|
toDate('2022-01-01') AS e,
|
||||||
|
toDate('2021-12-29') AS s,
|
||||||
|
age('day', s, e) AS day_age,
|
||||||
|
age('month', s, e) AS month__age,
|
||||||
|
age('year', s, e) AS year_age;
|
||||||
|
```
|
||||||
|
|
||||||
|
Результат:
|
||||||
|
|
||||||
|
``` text
|
||||||
|
┌──────────e─┬──────────s─┬─day_age─┬─month__age─┬─year_age─┐
|
||||||
|
│ 2022-01-01 │ 2021-12-29 │ 3 │ 0 │ 0 │
|
||||||
|
└────────────┴────────────┴─────────┴────────────┴──────────┘
|
||||||
|
```
|
||||||
|
|
||||||
## date\_diff {#date_diff}
|
## date\_diff {#date_diff}
|
||||||
|
|
||||||
Вычисляет разницу между двумя значениями дат или дат со временем.
|
Вычисляет разницу между двумя значениями дат или дат со временем.
|
||||||
|
Loading…
Reference in New Issue
Block a user