Перейти к содержанию

Главная > Документация пользователя > Полезные материалы > Справочник функций

Функции даты и времени

Функции даты и времени - позволяют преобразовать данные, связанные с датами и временем.

Синтаксис формул похож на SQL.

DATEADD

#даты и времени

Позволяет изменить дату или время на предстоящие или прошедшие.

Возвращает дату, которая получена из значения value, измененного на count(1). В параметре unit указывается часть данных даты/времени для изменения: "year", "month", "day", "hour", "minute", "second".

  1. ℹ целое положительное или отрицательное число
DATEADD (
            value,
            unit,
            count
        )

Тип данных value: Дата

Тип данных unit: Строка

Тип данных count: Число (целое)

Исходные данные: Доступны данные по датам и времени заказов.

Цель: Показать дату и время заказа с учетом разницы часовых поясов 3 часа.

Формула: 

DATEADD (
            [data],
            "hour", 
            3
        )

Результат:

DATEADD

Подробнее

1.В виджете на вкладке Данные поле Data (дата) определено как Группы.

DATEADD_step1

2.В Расчетные агрегаты добавлен новый агрегат Date_time (дата и время заказа), в Промежуточное значение указана формула DATEADD ([data], "hour", 3).

DATEADD_step2

3.Расчетный агрегат Date_time (дата и время заказа) определен как Столбцы.

DATEPART

#даты и времени

Позволяет получить часть даты или времени.

Возвращает часть даты или времени, полученных из value в виде числа. В параметре unit указывается часть данных даты/времени для получения: "year", "quarter", "month", "week"(3), "dayofweek"(1) или "dow", "day", "hour", "minute", "second". Параметр firstday(2) позволяет указать первый день недели (по умолчанию понедельник - Monday) для unit - "dayofweek".

  1. ℹ день недели с учетом параметра firstday
  2. ℹ "Monday", "Mon" — понедельник;
    "Tuesday", "Tue" — вторник;
    "Wednesday", "Wed" — среда;
    "Thursday", "Thu" — четверг;
    "Friday", "Fri" — пятница;
    "Saturday", "Sat" — суббота;
    "Sunday", "Sun" — воскресенье.
  3. ℹ номер недели в соответствии с ISO 8601. Первой считается неделя, которая содержит первый четверг года и 4.01
DATEPART    (
                value,
                unit,
                firstday
            )

Тип данных value: Дата

Тип данных unit: Строка

Тип данных firstday: Число (целое)

Похожие: DAY | DAYOFWEEK | HOUR | MINUTE | MONTH | QUARTER | SECOND | WEEK | YEAR

Исходные данные: Доступны данные по датам и времени заказа.

Цель: Показать по отдельности год, квартал, месяц, номер недели, день недели (первый день недели - среда) и день.

Формула: 

DATEPART    (
                [data], 
                "year"
            )
DATEPART ([data], "quarter") DATEPART ([data], "month") DATEPART ([data], "week") DATEPART ([data], "dayofweek", "Wednesday") DATEPART ([data], "day")

Результат:

DATEPART

Подробнее

1.В виджете на вкладке Данные поле Data (дата) определено как Группы.

DATEPART_step1

2.В Расчетные агрегаты добавлены новые агрегаты

  • Year (год), в Промежуточное значение указана формула DATEPART ([data], "year");

  • Quarter (квартал), в Промежуточное значение указана формула DATEPART ([data], "quarter");

  • Month (месяц), в Промежуточное значение указана формула DATEPART ([data], "month");

  • Week (номер недели), в Промежуточное значение указана формула DATEPART ([data], "week");

  • Dayofweek (день недели), в Промежуточное значение указана формула DATEPART ([data], "dayofweek", "Wednesday");

  • Day (день), в Промежуточное значение указана формула DATEPART ([data], "day").

DATEPART_step2

3.Расчетные агрегаты Year (год), Quarter (квартал), Month (месяц), Week (номер недели), Dayofweek (день недели), Day (день) определены как Столбцы.

DATETRUNC

#даты и времени

Позволяет округлить дату или время.

Возвращает дату, которая получена из значения value, округленную до unit части данных даты/времени: "year", "quarter", "month", "week", "day"(1), "hour", "minute", "second". Параметр count позволяет задать количество единиц (по умолчанию - 1)

  1. ℹ номер дня в году, если указан count

При указании count округление считается от даты 1900-01-01.

DATETRUNC   (
                value,
                unit,
                count
            )

Тип данных value: Дата

Тип данных unit: Строка

Тип данных count: Число (целое)

Исходные данные: Доступны данные по датам и времени заказов.

Цель: Показать дату и время заказа "отбросив" минуты и секунды.

Формула: 

DATETRUNC   (
                DATETIME ([data]),
                "hour"
            )

Результат:

DATETRUNC

Подробнее

1.В виджете на вкладке Данные поле Data (дата) определено как Группы.

DATETRUNC_step1

2.В Расчетные агрегаты добавлен новый агрегат Date_hour (дата и час заказа), в Промежуточное значение указана формула DATETRUNC (DATETIME ([data])(1), "hour").

  1. ℹ DATETIME преобразует дату, число или строку в дату и время

DATETRUNC_step2

3.Расчетный агрегат Date_hour (дата и час заказа) определен как Столбцы.

DAY

#даты и времени

Позволяет получить день из даты.

Возвращает номер дня месяца из value.

DAY (
        value
    )

Тип данных value: Дата

Похожие: DATEPART | DAYOFWEEK | HOUR | MINUTE | MONTH | QUARTER | SECOND | WEEK | YEAR

Исходные данные: Доступны данные по датам и времени заказов.

Цель: Показать число заказа.

Формула: 

DAY (
        [data]
    )

Результат:

DAY

Подробнее

1.В виджете на вкладке Данные поле Data (дата) определено как Группы.

DAY_step1

2.В Расчетные агрегаты добавлен новый агрегат Date_day (день заказа), в Промежуточное значение указана формула DAY ([data]).

DAY_step2

3.Расчетный агрегат Date_day (день заказа) определен как Столбцы.

DAYOFWEEK

#даты и времени

Позволяет получить номер(1) дня недели, с учетом заданного первого дня недели.

  1. в соответствии с ISO 8601 первой считается неделя, которая содержит первый четверг года и 4.01

Возвращает номер дня недели из value. Параметр firstday(1) позволяет указать первый день недели (по умолчанию понедельник - 1).

  1. ℹ 1 — понедельник;
    2 — вторник;
    3 — среда;
    4 — четверг;
    5 — пятница;
    6 — суббота;
    7 — воскресенье.
DAYOFWEEK   (
                value,
                firstday
            )

Тип данных value: Дата

Тип данных firstday: Число (целое)

Похожие: DATEPART | DAY | HOUR | MINUTE | MONTH | QUARTER | SECOND | WEEK | YEAR

Исходные данные: Доступны данные по датам и времени заказов.

Цель: Показать номер дня недели заказа с учетом начала рабочей недели в среду.

Формула: 

DAYOFWEEK   (
                [data],
                3
            )

Результат:

DAYOFWEEK

Подробнее

1.В виджете на вкладке Данные поле Data (дата) определено как Группы.

DAYOFWEEK_step1

2.В Расчетные агрегаты добавлен новый агрегат Date_dayofweek (день недели), в Промежуточное значение указана формула DAYOFWEEK ([data], 3).

DAYOFWEEK_step2

3.Расчетный агрегат Date_dayofweek (день недели) определен как Столбцы.

HOUR

#даты и времени

Позволяет получить час из времени.

Возвращает номер часа из value.

HOUR    (
            value
        )

Тип данных value: Дата

Похожие: DATEPART | DAY | DAYOFWEEK | MINUTE | MONTH | QUARTER | SECOND | WEEK | YEAR

Исходные данные: Доступны данные по датам и времени заказов.

Цель: Показать час заказа.

Формула: 

HOUR    (
            [data]
        )

Результат:

HOUR

Подробнее

1.В виджете на вкладке Данные поле Data (дата) определено как Группы.

HOUR_step1

2.В Расчетные агрегаты добавлен новый агрегат Date_hour (час), в Промежуточное значение указана формула HOUR ([data]).

HOUR_step2

3.Расчетный агрегат Date_hour (час) определен как Столбцы.

MINUTE

#даты и времени

Позволяет получить минуты из времени.

Возвращает номер минуты из value.

MINUTE  (
            value
        )

Тип данных value: Дата

Похожие: DATEPART | DAY | DAYOFWEEK | HOUR | MONTH | QUARTER | SECOND | WEEK | YEAR

Исходные данные: Доступны данные по датам и времени заказов.

Цель: Показать минуты заказа.

Формула: 

MINUTE  (
            [data]
        )

Результат:

MINUTE

Подробнее

1.В виджете на вкладке Данные поле Data (дата) определено как Группы.

MINUTE_step1

2.В Расчетные агрегаты добавлен новый агрегат Date_minute (минуты), в Промежуточное значение указана формула MINUTE ([data]).

MINUTE_step2

3.Расчетный агрегат Date_minute (минуты) определен как Столбцы.

MONTH

#даты и времени

Позволяет получить месяц из даты.

Возвращает номер месяца из value.

MONTH   (
            value
        )

Тип данных value: Дата

Похожие: DATEPART | DAY | DAYOFWEEK | HOUR | MINUTE | QUARTER | SECOND | WEEK | YEAR

Исходные данные: Доступны данные по датам и времени заказов.

Цель: Показать месяц заказа.

Формула: 

MONTH   (
            [data]
        )

Результат:

MONTH

Подробнее

1.В виджете на вкладке Данные поле Data (дата) определено как Группы.

MONTH_step1

2.В Расчетные агрегаты добавлен новый агрегат Date_month (месяц), в Промежуточное значение указана формула MONTH ([data]).

MONTH_step2

3.Расчетный агрегат Date_month (месяц) определен как Столбцы.

MONTHEND

#даты и времени

Позволяет получить первый день месяца из даты.

Возвращает первый день месяца из value.

MONTHEND  (
                value
            )

Тип данных value: Дата

Похожие: DATEPART | DAY | DAYOFWEEK | HOUR | MINUTE | MONTHSTART | QUARTER | SECOND | WEEK | YEAR

Исходные данные: Доступны данные по датам и времени заказов.

Цель: Показать последний день месяца заказа.

Формула: 

MONTHEND  (
                [data]
            )

Результат:

MONTHEND

Подробнее

1.В виджете на вкладке Данные поле Data (дата) определено как Группы.

MONTHEND_step1

2.В Расчетные агрегаты добавлен новый агрегат End_month (последний день месяца), в Промежуточное значение указана формула MONTHEND ([data]).

MONTHEND_step2

3.Расчетный агрегат End_month (последний день месяца) определен как Столбцы.

MONTHSTART

#даты и времени

Позволяет получить первый день месяца из даты.

Возвращает первый день месяца из value.

MONTHSTART  (
                value
            )

Тип данных value: Дата

Похожие: DATEPART | DAY | DAYOFWEEK | HOUR | MINUTE | MONTHEND | QUARTER | SECOND | WEEK | YEAR

Исходные данные: Доступны данные по датам и времени заказов.

Цель: Показать первый день месяца заказа.

Формула: 

MONTHSTART  (
                [data]
            )

Результат:

MONTHSTART

Подробнее

1.В виджете на вкладке Данные поле Data (дата) определено как Группы.

MONTHSTART_step1

2.В Расчетные агрегаты добавлен новый агрегат Start_month (первый день месяца), в Промежуточное значение указана формула MONTHSTART ([data]).

MONTHSTART_step2

3.Расчетный агрегат Start_month (первый день месяца) определен как Столбцы.

NETWORKDAYS

#даты и времени

Позволяет получить количество рабочих дней между датами.

Возвращает количество дней между start_date и end_date включительно с учетом выходных weekend(1) и нерабочих дней exclude_dates(2). Параметр weekend позволяет указать какие дни недели считаются выходными (по умолчанию - 1: суббота и воскресенье). В параметре exclude_dates указывается массив строк с датами через запятую, которые являются нерабочими днями.

  1. ℹ 1 — суббота и восресенье;
    2 — воскресенье и понедельник;
    3 — понедельник и вторник;
    4 — вторник и среда;
    5 — среда и четверг;
    6 — четверг и пятница;
    7 — пятница и суббота;
    11 — воскресенье;
    12 — понедельник;
    13 — вторник;
    14 — среда;
    15 — четверг;
    16 — пятница;
    17 — суббота
  2. ℹ массив строк через запятую в квадратных скобках в формате ГГГГ.ММ.ДД ['2025.09.26', '2025.09.27']
NETWORKDAYS (
                start_date,
                end_date,
                weekend,
                exclude_dates
            )

Тип данных start_date, end_date: Строка, Дата

Тип данных weekend: Число (целое)

Тип данных exclude_dates: Строка

Исходные данные: Доступны данные по датам продажи.

Цель: Показать количество рабочих дней между датами с учетом рабочей недели понедельник-пятница.

Формула: 

NETWORKDAYS (
                MAX (
                        [date_begin]
                    ), 
                MAX (
                        [date_begin_end]
                    )
            )

Результат:

NETWORKDAYS

Подробнее

1.В виджете на вкладке Вид выбрана таблица агрегатов.

2.На вкладке Данные поля Date_begin (дата начало), date_begin_end (дата конец) определены как Группы.

NETWORKDAYS_step1

3.В Расчетные агрегаты добавлен новый агрегат Work_day (рабочие дни), в Промежуточное значение указана формула NETWORKDAYS (MAX([date_begin]), MAX([date_begin_end])).

NETWORKDAYS_step2

3.Расчетный агрегат Work_day (рабочие дни) определен как Столбцы.

NOW

#даты и времени

Позволяет получить текущую дату и время.

Возвращает текущую дату и время сервера на момент запроса с точностью до секунды.

NOW ()

Похожие: TODAY

Исходные данные: Доступны данные для анализа.

Цель: Показать текущую дату и время анализа данных.

Формула: 

NOW ()

Результат:

NOW

Подробнее

1.В виджете на вкладке Данные поле Data (дата) определено как Группы.

NOW_step1

2.В Расчетные агрегаты добавлен новый агрегат Date_analysis (дата и время анализа), в Промежуточное значение указана формула NOW ().

NOW_step2

3.Расчетный агрегат Date_analysis (дата и время анализа) определен как Столбцы.

QUARTER

#даты и времени

Позволяет получить квартал из даты.

Возвращает номер квартала (1-4) из value.

QUARTER (
            value
        )

Тип данных value: Дата

Похожие: DATEPART | DAY | DAYOFWEEK | HOUR | MINUTE | MONTH | SECOND | WEEK | YEAR

Исходные данные: Доступны данные по датам и времени заказов.

Цель: Показать квартал заказа.

Формула: 

QUARTER (
            [data]
        )

Результат:

QUARTER

Подробнее

1.В виджете на вкладке Данные поле Data (дата) определено как Группы.

QUARTER_step1

2.В Расчетные агрегаты добавлен новый агрегат Date_quarter (квартал), в Промежуточное значение указана формула QUARTER ([data]).

QUARTER_step2

3.Расчетный агрегат Date_quarter (квартал) определен как Столбцы.

SECOND

#даты и времени

Позволяет получить секунды из времени.

Возвращает номер секунды из value.

SECOND  (
            value
        )

Тип данных value: Дата

Похожие: DATEPART | DAY | DAYOFWEEK | HOUR | MINUTE | MONTH | QUARTER | WEEK | YEAR

Исходные данные: Доступны данные по датам и времени заказов.

Цель: Показать секунды заказа.

Формула: 

SECOND  (
            [data]
        )

Результат:

SECOND

Подробнее

1.В виджете на вкладке Данные поле Data (дата) определено как Группы.

SECOND_step1

2.В Расчетные агрегаты добавлен новый агрегат Date_second (секунды), в Промежуточное значение указана формула SECOND ([data]).

SECOND_step2

3.Расчетный агрегат Date_second (секунды) определен как Столбцы.

TODAY

#даты и времени

Позволяет получить текущую дату.

Возвращает текущую дату сервера на момент запроса.

TODAY ()

Похожие: NOW

Исходные данные: Доступны данные для анализа.

Цель: Показать текущую дату анализа данных.

Формула: 

TODAY ()

Результат:

TODAY

Подробнее

1.В виджете на вкладке Данные поле Data (дата) определено как Группы.

TODAY_step1

2.В Расчетные агрегаты добавлен новый агрегат Date_analysis (дата анализа), в Промежуточное значение указана формула TODAY ().

TODAY_step2

3.Расчетный агрегат Date_month (месяц) определен как Столбцы.

WEEK

#даты и времени

Позволяет получить номер недели из даты.

Возвращает номер(1) недели из value.

  1. ℹ в соответствии с ISO 8601 первой считается неделя, которая содержит первый четверг года и 4.01
WEEK    (
            value
        )

Тип данных value: Дата

Похожие: DATEPART | DAY | DAYOFWEEK | HOUR | MINUTE | MONTH | QUARTER | SECOND | YEAR

Исходные данные: Доступны данные по датам и времени заказов.

Цель: Показать неделю заказа.

Формула: 

WEEK    (
            [data]
        )

Результат:

WEEK

Подробнее

1.В виджете на вкладке Данные поле Data (дата) определено как Группы.

WEEK_step1

2.В Расчетные агрегаты добавлен новый агрегат Date_week (неделя), в Промежуточное значение указана формула WEEK ([data]).

WEEK_step2

3.Расчетный агрегат Date_week (неделя) определен как Столбцы.

YEAR

#даты и времени

Позволяет получить год из даты.

Возвращает номер года из value.

YEAR    (
            value
        )

Тип данных value: Дата

Похожие: DATEPART | DAY | DAYOFWEEK | HOUR | MINUTE | MONTH | QUARTER | SECOND | WEEK

Исходные данные: Доступны данные по датам и времени заказов.

Цель: Показать год заказа.

Формула: 

YEAR    (
            [data]
        )

Результат:

YEAR

Подробнее

1.В виджете на вкладке Данные поле Data (дата) определено как Группы.

YEAR_step1

2.В Расчетные агрегаты добавлен новый агрегат Date_year (год), в Промежуточное значение указана формула YEAR ([data]).

YEAR_step2

3.Расчетный агрегат Date_year (год) определен как Столбцы.