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

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

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

Синтаксис:  

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

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

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

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

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

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

Функция inquartertodate() делит год на четыре равных квартала между 1 января и 31 декабря (или определяемым пользователем началом года и соответствующей ему датой окончания). Используя base_date, функция затем сегментирует конкретный квартал, а 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.

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

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

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

Примеры функции
Пример Результат
inquartertodate('01/25/2013', '03/25/2013', 0) Возвращает TRUE, так как значениеtimestamp, 01/25/2013, попадает в трехмесячный период с 01/01/2013 по  03/25/2013, в который попадает значение base_date, 03/25/2013.
inquartertodate('04/26/2013', '03/25/2013', 0) Возвращает FALSE, так как 04/26/2013 находится за пределами периода, указанного в предыдущем примере.
inquartertodate('02/25/2013', '06/09/2013', -1) Возвращает TRUE, так как значение period_no, -1, сдвигает период поиска назад на один трехмесячный период (один квартал года). Таким образом, период поиска длится с  01/01/2013  по 03/09/2013.
inquartertodate('03/25/2006', '04/15/2006', 0, 2) Возвращает TRUE, так как значение first_month_of_yearравно 2, в результате чего период поиска длится с  02/01/2006  по 04/15/2006, а не с  04/01/2006  по  04/15/2006.

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

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

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

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

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

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

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

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

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

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

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