DOCSUP-2807: Documented the date_trunc function (#15429)

* Docs updated for date_trunc() and now().

* Minor fix.

* Minor fix in en. Translation to Russian.

* Minor link fixes.

* Apply suggestions from code review
Co-authored-by: NBayoNet <da-daos@yandex.ru>

* Updates

* Minor fix

* Minor updates for now() (en, ru).
Co-authored-by: NOlga Revyakina <revolg@yandex-team.ru>
Co-authored-by: NBayoNet <da-daos@yandex.ru>

docs/en/sql-reference/functions/date-time-functions.md

@@ -337,26 +337,124 @@ SELECT toDate('2016-12-27') AS date, toYearWeek(date) AS yearWeek0, toYearWeek(d
 └────────────┴───────────┴───────────┴───────────┘
 ```
 
-## date_trunc(datepart, time_or_data\[, time_zone\]), dateTrunc(datepart, time_or_data\[, time_zone\]) {#date_trunc}
-
-Truncates a date or date with time based on the specified datepart, such as
-- `second`
-- `minute`
-- `hour`
-- `day`
-- `week`
-- `month`
-- `quarter`
-- `year`
+## date_trunc {#date_trunc}
+
+Truncates date and time data to the specified part of date.
+
+**Syntax** 
+
+``` sql
+date_trunc(unit, value[, timezone])
+```
+
+Alias: `dateTrunc`. 
+
+**Parameters**
+
+-   `unit` — Part of date. [String](../syntax.md#syntax-string-literal).
+    Possible values:
+
+    - `second`
+    - `minute`
+    - `hour`
+    - `day`
+    - `week`
+    - `month`
+    - `quarter`
+    - `year`
+
+-   `value` — Date and time. [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) for the returned value (optional). If not specified, the function uses the timezone of the `value` parameter. [String](../../sql-reference/data-types/string.md).
+
+**Returned value**
+
+-   Value, truncated to the specified part of date.
+
+Type: [Datetime](../../sql-reference/data-types/datetime.md).
+
+**Example**
+
+Query without timezone:
+
+``` sql
+SELECT now(), date_trunc('hour', now());
+```
+
+Result:
+
+``` text
+┌───────────────now()─┬─date_trunc('hour', now())─┐
+│ 2020-09-28 10:40:45 │       2020-09-28 10:00:00 │
+└─────────────────────┴───────────────────────────┘
+```
+
+Query with the specified timezone:
 
 ```sql
-SELECT date_trunc('hour', now())
+SELECT now(), date_trunc('hour', now(), 'Europe/Moscow');
+```
+
+Result:
+
+```text
+┌───────────────now()─┬─date_trunc('hour', now(), 'Europe/Moscow')─┐
+│ 2020-09-28 10:46:26 │                        2020-09-28 13:00:00 │
+└─────────────────────┴────────────────────────────────────────────┘
 ```
 
-## now {#now}
+**See also**
+
+-   [toStartOfInterval](#tostartofintervaltime-or-data-interval-x-unit-time-zone)
 
-Accepts zero or one arguments(timezone) and returns the current time at one of the moments of request execution, or current time of specific timezone at one of the moments of request execution if `timezone` argument provided.
-This function returns a constant, even if the request took a long time to complete.
+# now {#now}
+
+Returns the current date and time. 
+
+**Syntax** 
+
+``` sql
+now([timezone])
+```
+
+**Parameters**
+
+-   `timezone` — [Timezone name](../../operations/server-configuration-parameters/settings.md#server_configuration_parameters-timezone) for the returned value (optional). [String](../../sql-reference/data-types/string.md).
+
+**Returned value**
+
+-   Current date and time.
+
+Type: [Datetime](../../sql-reference/data-types/datetime.md).
+
+**Example**
+
+Query without timezone:
+
+``` sql
+SELECT now();
+```
+
+Result:
+
+``` text
+┌───────────────now()─┐
+│ 2020-10-17 07:42:09 │
+└─────────────────────┘
+```
+
+Query with the specified timezone:
+
+``` sql
+SELECT now('Europe/Moscow');
+```
+
+Result:
+
+``` text
+┌─now('Europe/Moscow')─┐
+│  2020-10-17 10:42:23 │
+└──────────────────────┘
+```
 
 ## today {#today}
 

docs/ru/sql-reference/functions/date-time-functions.md

@@ -234,10 +234,124 @@ WITH toDateTime64('2020-01-01 10:20:30.999', 3) AS dt64 SELECT toStartOfSecond(d
 
 Переводит дату-с-временем в номер секунды, начиная с некоторого фиксированного момента в прошлом.
 
+## date_trunc {#date_trunc}
+
+Отсекает от даты и времени части, меньшие чем указанная часть.
+
+**Синтаксис** 
+
+``` sql
+date_trunc(unit, value[, timezone])
+```
+
+Синоним: `dateTrunc`. 
+
+**Параметры**
+
+-   `unit` — Название части даты или времени. [String](../syntax.md#syntax-string-literal).
+    Возможные значения:
+
+    - `second`
+    - `minute`
+    - `hour`
+    - `day`
+    - `week`
+    - `month`
+    - `quarter`
+    - `year`
+
+-   `value` — Дата и время. [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) для возвращаемого значения (необязательно). Если параметр не задан, используется часовой пояс параметра `value`. [String](../../sql-reference/data-types/string.md)
+
+**Возвращаемое значение**
+
+-   Дата и время, отсеченные до указанной части.
+
+Тип: [Datetime](../../sql-reference/data-types/datetime.md).
+
+**Примеры**
+
+Запрос без указания часового пояса:
+
+``` sql
+SELECT now(), date_trunc('hour', now());
+```
+
+Результат:
+
+``` text
+┌───────────────now()─┬─date_trunc('hour', now())─┐
+│ 2020-09-28 10:40:45 │       2020-09-28 10:00:00 │
+└─────────────────────┴───────────────────────────┘
+```
+
+Запрос с указанием часового пояса:
+
+```sql
+SELECT now(), date_trunc('hour', now(), 'Europe/Moscow');
+```
+
+Результат:
+
+```text
+┌───────────────now()─┬─date_trunc('hour', now(), 'Europe/Moscow')─┐
+│ 2020-09-28 10:46:26 │                        2020-09-28 13:00:00 │
+└─────────────────────┴────────────────────────────────────────────┘
+```
+
+**См. также**
+
+-   [toStartOfInterval](#tostartofintervaltime-or-data-interval-x-unit-time-zone)
+
 ## now {#now}
 
-Принимает ноль аргументов и возвращает текущее время на один из моментов выполнения запроса.
-Функция возвращает константу, даже если запрос выполнялся долго.
+Возвращает текущую дату и время. 
+
+**Синтаксис** 
+
+``` sql
+now([timezone])
+```
+
+**Параметры**
+
+-   `timezone` — [часовой пояс](../../operations/server-configuration-parameters/settings.md#server_configuration_parameters-timezone) для возвращаемого значения (необязательно). [String](../../sql-reference/data-types/string.md)
+
+**Возвращаемое значение**
+
+-   Текущие дата и время.
+
+Тип: [Datetime](../../sql-reference/data-types/datetime.md).
+
+**Пример**
+
+Запрос без указания часового пояса:
+
+``` sql
+SELECT now();
+```
+
+Результат:
+
+``` text
+┌───────────────now()─┐
+│ 2020-10-17 07:42:09 │
+└─────────────────────┘
+```
+
+Запрос с указанием часового пояса:
+
+``` sql
+SELECT now('Europe/Moscow');
+```
+
+Результат:
+
+``` text
+┌─now('Europe/Moscow')─┐
+│  2020-10-17 10:42:23 │
+└──────────────────────┘
+```
 
 ## today {#today}