inyear — функция скриптa и диаграммы
Эта функция возвращает значение True, если поле timestamp находится в пределах года, включающего значение, указанное в поле base_date.
Синтаксис:
InYear (timestamp, base_date, period_no [, first_month_of_year])
Возвращаемые типы данных: Булево значение
В Qlik Sense логическое значение «истина» представлено как -1, а «ложь» — как 0.
Функция inyear() возвращает булев результат сравнения выбранных значений дат с годом, заданным в аргументе base_date.
Когда это следует использовать
Функция inyear() возвращает результат в виде булева значения. Обычно этот тип функции используется в качестве условия в if expression. Она возвращает агрегацию или вычисление в зависимости от того, относится ли проверяемая дата к рассматриваемому году. Например, с помощью функции inyear() можно идентифицировать все продажи, совершенные в определенному году.
Аргумент | Описание |
---|---|
timestamp | Дата, которую необходимо сравнить со значением, указанным в поле base_date. |
base_date | Дата, использующаяся для оценки года. |
period_no | Год можно сместить, задав значение в поле period_no. period_no — целое число, где 0 обозначает год, включающий значение, указанное в поле base_date. Отрицательные значения, заданные в поле period_no, означают предшествующие годы, положительные — последующие. |
first_month_of_year | Если необходимо работать с годами (финансовыми), которые начинаются не в январе, задайте значение от 2 до 12 в поле first_month_of_year. |
Можно использовать следующие значения, чтобы задать первый месяц года в аргументе first_month_of_year:
Месяц | Значение |
---|---|
Февраль | 2 |
Март | 3 |
Апрель | 4 |
May | 5 |
Июнь | 6 |
Июль | 7 |
Август | 8 |
Сентябрь | 9 |
Октябрь | 10 |
Ноябрь | 11 |
Декабрь |
12 |
Региональные настройки
Если не указано иное, в примерах, приведенных в данном разделе, используется следующий формат даты: ММ/ДД/ГГГГ. Формат даты указан в операторе SET DateFormat скрипта загрузки данных. В вашей системе может быть установлен другой формат даты по умолчанию в зависимости от региональных настроек и других факторов. Можно изменить формат в примерах в соответствии с потребностями. Или можно изменить форматы в скрипте загрузки в соответствии с этими примерами.
Региональные настройки по умолчанию в приложениях основаны на системных региональных настройках компьютера или сервера, где установлено ПО Qlik Sense. Если на сервере Qlik Sense, к которому обращается пользователь, выбран шведский язык, то редактор загрузки данных будет использовать шведские региональные настройки для даты, времени и валюты. Эти параметры регионального формата не связаны с языком, отображаемым в интерфейсе пользователя Qlik Sense. Qlik Sense будет отображаться на языке, который используется в браузере.
Пример | Результат |
---|---|
inyear ('01/25/2013', '01/01/2013', 0 ) | Возвращает TRUE |
inyear ('01/25/2012', '01/01/2013', 0) | Возвращает FALSE |
inyear ('01/25/2013', '01/01/2013', -1) | Возвращает FALSE |
inyear ('01/25/2012', '01/01/2013', -1 ) | Возвращает TRUE |
inyear ('01/25/2013', '01/01/2013', 0, 3) |
Возвращает TRUE Значения base_date и first_month_of_year указывают, что метка времени должна попадать в период с 01/03/2012 по 02/28/2013 |
inyear ('03/25/2013', '07/01/2013', 0, 3 ) | Возвращает TRUE |