Возвращает значение True, если значение date находится в пределах части месяца, включающей значение, заданное в поле basedate до последней миллисекунды, указанной в поле basedate, включительно.
Синтаксис:
InMonthToDate (timestamp, base_date, period_no)
Возвращаемые типы данных: Булево значение
Схема функции inmonthtodate.
Функция inmonthtodate() идентифицирует выбранный месяц как сегмент. Начальной границей является начало месяца. В качестве конечной границы можно указать более позднюю дату месяца. Затем функция определяет, попадает набор дат в этот сегмент или нет, и возвращает булево значение TRUE или FALSE.
| Аргумент | Описание |
|---|---|
| timestamp | Дата, которую необходимо сравнить со значением, указанным в поле base_date. |
| base_date | Дата, использующаяся для оценки месяца. |
| period_no |
Месяц можно сместить, задав значение в поле period_no. period_no — целое число, где 0 обозначает месяц, включающий значение, указанное в поле base_date. Отрицательные значения, заданные в поле period_no, означают предшествующие месяцы, положительные — последующие. |
Когда это следует использовать
Функция inmonthtodate() возвращает результат в виде булева значения. Обычно этот тип функции используется в качестве условия в if expression. Функция inmonthtodate() возвращает агрегирование или вычисление в зависимости от того, выпадает ли дата на указанный месяц, включая рассматриваемую дату.
Например, функцию inmonthtodate() можно использовать для идентификации всего оборудования, изготовленного в указанном месяце до определенной даты.
Региональные настройки
Если не указано иное, в примерах, приведенных в данном разделе, используется следующий формат даты: ММ/ДД/ГГГГ. Формат даты указан в операторе SET DateFormat скрипта загрузки данных. В вашей системе может быть установлен другой формат даты по умолчанию в зависимости от региональных настроек и других факторов. Можно изменить формат в примерах в соответствии с потребностями. Или можно изменить форматы в скрипте загрузки в соответствии с этими примерами. Для получения дополнительной информации см. Изменение региональных настроек для создания приложений и скриптов.
Региональные настройки по умолчанию в приложениях основаны на профиле пользователя. Эти параметры регионального формата не связаны с языком, отображаемым в интерфейсе пользователя Qlik Cloud. Qlik Cloud будет отображаться на языке, который используется в браузере.
Если вы — разработчик приложений, то можете задать регион по умолчанию для создаваемых приложений. Для получения дополнительной информации см. Установка предпочтительных региональных настроек для создания приложений и скриптов в Аналитика Qlik Cloud.
| Пример | Результат |
|---|---|
| inmonthtodate ('01/25/2013', '25/01/2013', 0) | Возвращает True |
| inmonthtodate ('01/25/2013', '24/01/2013', 0) | Возвращает False |
| inmonthtodate ('01/25/2013', '28/02/2013', -1) | Возвращает True |
Пример 1. Без дополнительных аргументов
Обзор
Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки на новую вкладку.
Скрипт загрузки содержит следующее:
-
Набор данных, содержащий набор транзакций за 2022 год, загруженный в таблицу под именем Transactions.
-
Поле даты, предоставленное в формате системной переменной DateFormat (MM/DD/YYYY).
-
Предшествующий оператор load, который содержит следующее:
-
Функция inmonthtodate(), заданная как поле in_month_to_date. Она определяет, какие транзакции совершены с 1 по 26 июля 2022 года.
-
Скрипт загрузки
SET DateFormat='MM/DD/YYYY';
Transactions:
Load
*,
inmonthtodate(date,'07/26/2022', 0) as in_month_to_date
;
Load
*
Inline
[
id,date,amount
8188,'1/19/2022',37.23
8189,'1/7/2022',17.17
8190,'2/28/2022',88.27
8191,'2/5/2022',57.42
8192,'3/16/2022',53.80
8193,'4/1/2022',82.06
8194,'5/7/2022',40.39
8195,'5/16/2022',87.21
8196,'6/15/2022',95.93
8197,'6/26/2022',45.89
8198,'7/9/2022',36.23
8199,'7/22/2022',25.66
8200,'7/23/2022',82.77
8201,'7/27/2022',69.98
8202,'8/2/2022',76.11
8203,'8/8/2022',25.12
8204,'8/19/2022',46.23
8205,'9/26/2022',84.21
8206,'10/14/2022',96.24
8207,'10/29/2022',67.67
]; Результаты
Загрузите данные и откройте лист. Создайте новую таблицу и добавьте эти поля как измерения:
-
date
-
in_month_to_date
| date | in_month_to_date |
|---|---|
| 1/7/2022 | 0 |
| 1/19/2022 | 0 |
| 2/5/2022 | 0 |
| 2/28/2022 | 0 |
| 3/16/2022 | 0 |
| 4/1/2022 | 0 |
| 5/7/2022 | 0 |
| 5/16/2022 | 0 |
| 6/15/2022 | 0 |
| 6/26/2022 | 0 |
| 7/9/2022 | -1 |
| 7/22/2022 | -1 |
| 7/23/2022 | -1 |
| 7/27/2022 | 0 |
| 8/2/2022 | 0 |
| 8/8/2022 | 0 |
| 8/19/2022 | 0 |
| 9/26/2022 | 0 |
| 10/14/2022 | 0 |
| 10/29/2022 | 0 |
Поле in_month_to_date создано в предыдущем операторе load с помощью функции inmonthtodate().
Первый аргумент определяет, какое поле оценивается. Второй аргумент — это жестко закодированная дата, 26 июля, которая выступает в роли base_date. Этот аргумент base_date определяет сегментированный месяц, а также конечную границу оцениваемого сегмента.
period_no = 0 — это последний аргумент, означающий, что функция не сравнивает месяцы, которые следуют до или после сегментированного месяца.
Диаграмма функции inmonthtodate без дополнительных аргументов
В результате все транзакции, совершенные в период с 1 по 26 июля, возвращают булево значение TRUE. Все транзакции, совершенные в июле после 26 числа, возвращают булево значение FALSE, как и транзакции, совершенные в другие месяцы года.
Пример 2. Скрипт period_no
Обзор
Используется тот же набор данных и сценарий, что в первом примере.
В этом примере стоит задача создать поле six_months_prior, которое определяет, какие транзакции совершены за шесть полных месяцев до периода с 1 по 26 июля.
Скрипт загрузки
SET DateFormat='MM/DD/YYYY';
Transactions:
Load
*,
inmonthtodate(date,'07/26/2022', -6) as six_months_prior
;
Load
*
Inline
[
id,date,amount
8188,'1/19/2022',37.23
8189,'1/7/2022',17.17
8190,'2/28/2022',88.27
8191,'2/5/2022',57.42
8192,'3/16/2022',53.80
8193,'4/1/2022',82.06
8194,'5/7/2022',40.39
8195,'5/16/2022',87.21
8196,'6/15/2022',95.93
8197,'6/26/2022',45.89
8198,'7/9/2022',36.23
8199,'7/22/2022',25.66
8200,'7/23/2022',82.77
8201,'7/27/2022',69.98
8202,'8/2/2022',76.11
8203,'8/8/2022',25.12
8204,'8/19/2022',46.23
8205,'9/26/2022',84.21
8206,'10/14/2022',96.24
8207,'10/29/2022',67.67
]; Результаты
Загрузите данные и откройте лист. Создайте новую таблицу и добавьте эти поля как измерения:
-
date
-
six_months_prior
| date | six_months_prior |
|---|---|
| 1/7/2022 | -1 |
| 1/19/2022 | -1 |
| 2/5/2022 | 0 |
| 2/28/2022 | 0 |
| 3/16/2022 | 0 |
| 4/1/2022 | 0 |
| 5/7/2022 | 0 |
| 5/16/2022 | 0 |
| 6/15/2022 | 0 |
| 6/26/2022 | 0 |
| 7/9/2022 | 0 |
| 7/22/2022 | 0 |
| 7/23/2022 | 0 |
| 7/27/2022 | 0 |
| 8/2/2022 | 0 |
| 8/8/2022 | 0 |
| 8/19/2022 | 0 |
| 9/26/2022 | 0 |
| 10/14/2022 | 0 |
| 10/29/2022 | 0 |
Используя -6 в качестве аргумента period_no, функция inmonthtodate() сдвигает границы сравниваемого сегмента месяца на шесть месяцев. Сначала сегмент месяца начинается 1 июля и заканчивается 26 июля. Затем period_no сдвигает этот сегмент назад на шесть месяцев, в результате чего новыми границами сегмента становятся 1 января и 26 января.
Диаграмма функции inmonthtodate с аргументом period_no = -6.
В результате все транзакции, совершенные в период с 1 по 26 января, возвращают булево значение TRUE.
Пример 3. Пример диаграммы
Обзор
Используется тот же набор данных и сценарий, что в первом примере.
В этом примере в приложение загружается неизмененный набор данных. Расчет, который определяет, произошли ли транзакции с 1 по 26 июля, создается как мера в объекте диаграммы в приложении.
Скрипт загрузки
SET DateFormat='MM/DD/YYYY';
Transactions:
Load
*
Inline
[
id,date,amount
8188,'1/19/2022',37.23
8189,'1/7/2022',17.17
8190,'2/28/2022',88.27
8191,'2/5/2022',57.42
8192,'3/16/2022',53.80
8193,'4/1/2022',82.06
8194,'5/7/2022',40.39
8195,'5/16/2022',87.21
8196,'6/15/2022',95.93
8197,'6/26/2022',45.89
8198,'7/9/2022',36.23
8199,'7/22/2022',25.66
8200,'7/23/2022',82.77
8201,'7/27/2022',69.98
8202,'8/2/2022',76.11
8203,'8/8/2022',25.12
8204,'8/19/2022',46.23
8205,'9/26/2022',84.21
8206,'10/14/2022',96.24
8207,'10/29/2022',67.67
]; Результаты
Загрузите данные и откройте лист. Создайте новую таблицу и добавьте это поле как измерение:
date
Чтобы рассчитать, совершены ли транзакции с 1 по 26 июля, создайте следующую меру:
=inmonthtodate(date,'07/26/2022', 0)
| date | =inmonthtodate(date,'07/26/2022', 0) |
|---|---|
| 1/7/2022 | 0 |
| 1/19/2022 | 0 |
| 2/5/2022 | 0 |
| 2/28/2022 | 0 |
| 3/16/2022 | 0 |
| 4/1/2022 | 0 |
| 5/7/2022 | 0 |
| 5/16/2022 | 0 |
| 6/15/2022 | 0 |
| 6/26/2022 | 0 |
| 7/9/2022 | -1 |
| 7/22/2022 | -1 |
| 7/23/2022 | -1 |
| 7/27/2022 | 0 |
| 8/2/2022 | 0 |
| 8/8/2022 | 0 |
| 8/19/2022 | 0 |
| 9/26/2022 | 0 |
| 10/14/2022 | 0 |
| 10/29/2022 | 0 |
Мера для поля in_month_to_date создается в диаграмме с помощью функции inmonthtodate().
Первый аргумент определяет, какое поле оценивается. Второй аргумент — это жестко закодированная дата, 26 июля, которая выступает в роли base_date. Этот аргумент base_date определяет сегментированный месяц, а также конечную границу оцениваемого сегмента. Заключительный аргумент — period_no = 0. Это значит, что функция не сравнивает месяцы, которые следуют до или после сегментированного месяца.
Диаграмма функции inmonthtodate без дополнительных аргументов
В результате все транзакции, совершенные в период с 1 по 26 июля, возвращают булево значение TRUE. Все транзакции, совершенные в июле после 26 числа, возвращают булево значение FALSE, как и транзакции, совершенные в другие месяцы года.