Перейти к основному содержимому Перейти к дополнительному содержимому

yeartodate — функция скриптa и диаграммы

Эта функция определяет, находится ли введенная метка времени в том году, в котором находится дата последней загрузки скрипта, и возвращает значение True, если это так, и False если это не так.

Синтаксис:  

YearToDate(timestamp[ , yearoffset [ , firstmonth [ , todaydate] ] ])

Возвращаемые типы данных: Булево значение

Примечание к информации

В Qlik Sense логическое значение «истина» представлено как -1, а «ложь» — как 0.

Диаграмма с примером функции yeartodate()

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

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

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

Однако функция также может заменять начальную дату года с помощью аргумента firstmonth и, кроме того, выполнять сравнения с предшествующими или последующими годами с помощью аргумента yearoffset.

В заключение при использовании исторических наборов данных, функция yeartodate() передает параметр для настройки todaydate, в результате чего выполняется сравнение метки времени с календарным годом до даты, предоставленной в аргументе todaydate, включительно.

Аргументы
Аргумент Описание
timestamp

Метка времени для проверки, например 10/12/2012.

yearoffset

При указании элемента yearoffset, элемент yeartodate возвращает значение True для того же периода в другом году. Отрицательное значение смещения yearoffset указывает предыдущий год, положительное значение смещения — будущий год. Наиболее поздняя дата с начала года до последнего момента достигается путем указания yearoffset = -1. Если значение не указано, принимается 0.

firstmonth

Если в поле firstmonth задать значение от 1 до 12 (1, если значение не указано), то начало года может быть передвинуто вперед на первый день любого месяца. Если, например, необходимо работать в рамках финансового года, начинающегося 1 мая, задайте firstmonth = 5. Значение 1 будет указывать начало финансового года с 1 января, а значение 12 — с 1 декабря.

todaydate Задав значение todaydate (метка времени последнего выполнения скрипта, если не указано), можно сместить день, используемый в качестве верхней границы периода.

Когда это следует использовать

Функция yeartodate() возвращает результат в виде логического значения. Обычно этот тип функции используется в качестве условия в выражении IF. Это возвращает агрегирование или расчет в зависимости от того, попадает ли проверяемая дата в год до рассматриваемой даты перезагрузки приложения включительно.

Например, функцию YearToDate() можно использовать для идентификации всего оборудования, изготовленного в текущем году до текущей даты.

В следующих примерах предполагается время последней перезагрузки = 11/18/2011.

Примеры функции
Пример Результат
yeartodate( '11/18/2010') возвращает False
yeartodate( '02/01/2011') возвращает True
yeartodate( '11/18/2011') возвращает True
yeartodate( '11/19/2011') возвращает False
yeartodate( '11/19/2011', 0, 1, '12/31/2011') возвращает True
yeartodate( '11/18/2010', -1) возвращает True
yeartodate( '11/18/2011', -1) возвращает False
yeartodate( '04/30/2011', 0, 5) возвращает False
yeartodate( '05/01/2011', 0, 5) возвращает True

Региональные настройки

Если не указано иное, в примерах, приведенных в данном разделе, используется следующий формат даты: ММ/ДД/ГГГГ. Формат даты указан в операторе SET DateFormat скрипта загрузки данных. В вашей системе может быть установлен другой формат даты по умолчанию в зависимости от региональных настроек и других факторов. Можно изменить формат в примерах в соответствии с потребностями. Или можно изменить форматы в скрипте загрузки в соответствии с этими примерами. Для получения дополнительной информации см. Изменение региональных настроек для создания приложений и скриптов.

Региональные настройки по умолчанию в приложениях основаны на профиле пользователя. Эти параметры регионального формата не связаны с языком, отображаемым в интерфейсе пользователя Qlik Cloud. Qlik Cloud будет отображаться на языке, который используется в браузере.

Если вы — разработчик приложений, то можете задать регион по умолчанию для создаваемых приложений. Для получения дополнительной информации см. Установка предпочтительных региональных настроек для создания приложений и скриптов в Аналитика Qlik Cloud.

Пример 1. Базовый пример

Пример 2. Аргумент yearoffset

Пример 3. Аргумент firstmonth

Пример 4. Аргумент todaydate

Пример 5. Пример объекта диаграммы

Пример 6. Сценарий

Помогла ли вам эта страница?

Если вы обнаружили какую-либо проблему на этой странице и с ее содержанием — будь то опечатка, пропущенный шаг или техническая ошибка, сообщите нам об этом, чтобы мы смогли ее исправить!