Yandex Cloud
  • Сервисы
  • Решения
  • Почему Yandex Cloud
  • Сообщество
  • Тарифы
  • Документация
  • Связаться с нами
Подключиться
Language / Region
Проект Яндекса
© 2023 ООО «Яндекс.Облако»
Yandex DataLens
  • Начало работы
  • Практические руководства
  • Концепции
  • Пошаговые инструкции
  • Управление доступом
  • Правила тарификации
  • Справочник визуализаций
  • Справочник функций
    • Все функции
    • Агрегатные функции
    • Логические функции
    • Математические функции
    • Оконные функции
    • Операторы
    • Строковые функции
    • Функции даты и времени
    • Функции для работы с временными рядами
      • Обзор
      • AGO
      • AT_DATE
    • Функции для работы с массивами
    • Функции преобразования типов
    • Функции разметки
    • Поддержка функций
  • Туториалы по функциям
  • Образовательные проекты
  • Решение проблем
    • Вопросы и ответы
    • Ошибки DataLens
  1. Справочник функций
  2. Функции для работы с временными рядами
  3. Обзор

Функции для работы с временными рядами

Статья создана
Yandex Cloud
  • Синтаксис
    • BEFORE FILTER BY
    • IGNORE DIMENSIONS
  • AGO
  • AT_DATE

Эти функции позволяют получать значения показателя, отнесенного к конкретным дате и времени. Дата и время задаются либо точными значениями, либо в виде смещения вдоль заданной временной оси.

В некоторой степени эти функции схожи с оконной LAG.

Основное отличие — LAG не учитывает значения измерений и использует смещение, заданное в виде количества строк.

Функции временных рядов работают с конкретными значениями или смещениями, заданными во временных единицах (дни, часы или секунды). За счет этого они становятся чувствительными к пропущенным значениям в данных. В результате, формула AGO(SUM([Sales]), [Date], "year") вернет NULL, если отсутствуют данные на ту же дату за предыдущий год.

Синтаксис

Функции временных рядов поддерживают расширенный синтаксис:

<FUNCTION_NAME>(
    arg1, arg2, ...

    [ BEFORE FILTER BY filtered_field_1, ... ]
    [ IGNORE DIMENSIONS dimension_1, ... ]
)

BEFORE FILTER BY

Если какие-то поля перечислены в BEFORE FILTER BY, то функция вычисляется до применения фильтрации по этим полям.
Например, если c помощью функции AGO раcсчитать [Sales] за период (год назад) от текущей даты:

AGO([Sales], [Date], "year", 1)

и при этом в чарте используется фильтр, ограничивающий даты одним годом (2018 < [Year] <= 2019, где Year равно YEAR([Date])), то все строки, относящиеся к 2018 году, будут исключены из запроса. В результате в функция вернет NULL.

Если в формулу c AGO добавить BEFORE FILTER BY:

AGO([Sales], [Date], "year", 1 BEFORE FILTER BY [Year])

то функция вернет значение [Sales].

Временное измерение, заданное вторым аргументом функций временных рядов, автоматически добавляется в BEFORE FILTER BY. Таким образом, следующие две формулы эквивалентны:

AGO([Sales], [Date], "week")
AGO([Sales], [Date], "week" BEFORE FILTER BY [Date])

IGNORE DIMENSIONS

IGNORE DIMENSIONS позволяет исключить измерения из критериев поиска. Для вычисления значения показателя для какой-то даты, поиск нужной строки производится с помощью построчного соспосталения значений всех измерений со значениями этих же измерений в текущей строке. Если какие-либо измерения косвенно или напрямую зависят от даты, то запрос может вернуть пустые значения (NULL).

Например, если делается запрос с полями [Date], [Month] (месяц от даты) и AGO([Sales], [Date], "month"), то будет невозможно найти строку, в которой значение [Date] на месяц меньше текущего, а значение [Month] совпадает со значением в текущей строке. Из-за этого результатом AGO будет NULL во всех строках.

Чтобы функция вернула правильное значение [Sales], с помощью IGNORE DIMENSIONS исключите измерение [Month]:

AGO([Sales], [Date], "month" IGNORE DIMENSIONS [Month])

AGO

Синтаксис:
AGO( measure, date_dimension [ , unit [ , number ] ] )
или
AGO( measure, date_dimension [ , unit [ , number ] ] [ BEFORE FILTER BY ... ] [ IGNORE DIMENSIONS ... ] )

Вычисляет measure для даты/времени с указанным смещением.
Аргумент date_dimension задает измерение, вдоль которого делается смещение.
Аргумент number задается целым числом. Может принимать отрицательные значения.
Аргумент unit принимает следующие значения:

  • "year" — год;
  • "month" — месяц;
  • "day" — день;
  • "hour" — час;
  • "minute" — минута;
  • "second" — секунда.

Возможен вариант использования AGO( measure, date_dimension, number ). В этом случае аргумент unit — количество дней.

См. также AT_DATE, LAG.

AT_DATE

Синтаксис:
AT_DATE( measure, date_dimension, date_expr )
или
AT_DATE( measure, date_dimension, date_expr [ BEFORE FILTER BY ... ] [ IGNORE DIMENSIONS ... ] )

Вычисляет measure для даты/времени, заданных выражением date_expr.
Аргумент date_dimension задает измерение, вдоль которого делается смещение.

См. также AGO, LAG.

Была ли статья полезна?

Language / Region
Проект Яндекса
© 2023 ООО «Яндекс.Облако»
В этой статье:
  • Синтаксис
  • BEFORE FILTER BY
  • IGNORE DIMENSIONS
  • AGO
  • AT_DATE