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

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

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

Синтаксис:  

InYearToDate (timestamp, base_date, period_no[, first_month_of_year])

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

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

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

Диаграмма функции inyeartodate

Пример диаграммы диапазона дат, в пределах которого функция inyeartodate будет возвращать значение TRUE.

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

Аргументы
Аргумент Описание
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.

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

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

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

В этих примерах используется формат даты MM/DD/YYYY. Формат даты указан в операторе SET DateFormat в верхней части скрипта загрузки данных. Измените формат в примерах согласно своим пожеланиям.

Примеры функции
Пример Результат
inyeartodate ('01/25/2013', '02/01/2013', 0) Возвращает TRUE.
inyeartodate ('01/25/2012', '01/01/2013', 0) Возвращает FALSE.
inyeartodate ('01/25/2012', '02/01/2013', -1) Возвращает TRUE.
inyeartodate ('11/25/2012', '01/31/2013', 0, 4) Возвращает TRUE.
Значение timestamp выпадает на финансовый год, начинающийся в четвертом месяце, и до значения base_date.
inyeartodate ('3/31/2013', '01/31/2013', 0, 4 ) Возвращает FALSE.
По сравнению с предыдущим примером, значение timestamp все еще находится в финансовом году, но после значения base_date, таким образом, оно находится за пределами части года.

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

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

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

Пример 1. Без дополнительных аргументов

Пример 2. Скрипт period_no

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

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

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

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

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