Эта функция определяет, находится ли введенная метка времени в том году, в котором находится дата последней загрузки скрипта, и возвращает значение True, если это так, и False если это не так.
Синтаксис:
YearToDate(timestamp[ , yearoffset [ , firstmonth [ , todaydate] ] ])
Возвращаемые типы данных: Булево значение
В Qlik Sense логическое значение «истина» представлено как -1, а «ложь» — как 0.
Диаграмма с примером функции yeartodate()
Если дополнительные параметры не используются, то значение данной функции может быть любой датой в пределах одного календарного года с 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. Базовый пример
Обзор
Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки на новую вкладку.
Скрипт загрузки содержит следующее:
-
Набор данных, содержащий набор транзакций с 2020 по 2022 год, который загружается в таблицу под именем Transactions.
- Поле даты было предоставлено в формате системной переменной DateFormat (MM/DD/YYYY).
-
Создание поля year_to_date, которое определяет, какие транзакции совершены в течение календарного года до даты последней перезагрузки.
Текущая дата на момент создания — 26 апреля 2022 года.
Скрипт загрузки
SET DateFormat='MM/DD/YYYY';
Transactions:
Load
*,
yeartodate(date) as year_to_date
;
Load
*
Inline
[
id,date,amount
8188,01/10/2020,37.23
8189,02/28/2020,17.17
8190,04/09/2020,88.27
8191,04/16/2020,57.42
8192,05/21/2020,53.80
8193,08/14/2020,82.06
8194,10/07/2020,40.39
8195,12/05/2020,87.21
8196,01/22/2021,95.93
8197,02/03/2021,45.89
8198,03/17/2021,36.23
8199,04/23/2021,25.66
8200,05/04/2021,82.77
8201,06/30/2021,69.98
8202,07/26/2021,76.11
8203,12/27/2021,25.12
8204,02/02/2022,46.23
8205,02/26/2022,84.21
8206,03/07/2022,96.24
8207,03/11/2022,67.67
];Результаты
Загрузите данные и откройте лист. Создайте новую таблицу и добавьте эти поля как измерения:
-
date
-
year_to_date
| date | year_to_date |
|---|---|
| 01/10/2020 | 0 |
| 02/28/2020 | 0 |
| 04/09/2020 | 0 |
| 04/16/2020 | 0 |
| 05/21/2020 | 0 |
| 08/14/2020 | 0 |
| 10/07/2020 | 0 |
| 12/05/2020 | 0 |
| 01/22/2021 | 0 |
| 02/03/2021 | 0 |
| 03/17/2021 | 0 |
| 04/23/2021 | 0 |
| 05/04/2021 | 0 |
| 06/30/2021 | 0 |
| 07/26/2021 | 0 |
| 12/27/2021 | 0 |
| 02/02/2022 | -1 |
| 02/26/2022 | -1 |
| 03/07/2022 | -1 |
| 03/11/2022 | -1 |
Диаграмма функции yeartodate(), базовый пример
Поле year_to_date создано предшествующим оператором load с использованием функции yeartodate(), где в качестве аргумента передано поле date.
Так как функции yeartodate() не переданы дополнительные параметры, она сначала определяет дату перезагрузки и границы текущего календарного года (начало 1 января), которые будут возвращать булево значение TRUE.
Таким образом, любая транзакция, совершенная в период с 1 января по 26 апреля (дата перезагрузки), возвращает булев результат TRUE. Любая транзакция, совершенная до начала 2022 года, будет возвращать булев результат FALSE.
Пример 2. Аргумент yearoffset
Обзор
Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки на новую вкладку.
Скрипт загрузки содержит следующее:
-
Используется тот же набор данных и сценарий, что в первом примере.
-
Создание поля two_years_prior, определяющего, какие транзакции совершены на два полных года раньше сегмента текущего календарного года до рассматриваемой даты.
Скрипт загрузки
SET DateFormat='MM/DD/YYYY';
Transactions:
Load
*,
yeartodate(date,-2) as two_years_prior
;
Load
*
Inline
[
id,date,amount
8188,01/10/2020,37.23
8189,02/28/2020,17.17
8190,04/09/2020,88.27
8191,04/16/2020,57.42
8192,05/21/2020,53.80
8193,08/14/2020,82.06
8194,10/07/2020,40.39
8195,12/05/2020,87.21
8196,01/22/2021,95.93
8197,02/03/2021,45.89
8198,03/17/2021,36.23
8199,04/23/2021,25.66
8200,05/04/2021,82.77
8201,06/30/2021,69.98
8202,07/26/2021,76.11
8203,12/27/2021,25.12
8204,02/02/2022,46.23
8205,02/26/2022,84.21
8206,03/07/2022,96.24
8207,03/11/2022,67.67
];Результаты
Загрузите данные и откройте лист. Создайте новую таблицу и добавьте эти поля как измерения:
-
date
-
two_years_prior
| date | two_years_prior |
|---|---|
| 01/10/2020 | -1 |
| 02/28/2020 | -1 |
| 04/09/2020 | -1 |
| 04/16/2020 | -1 |
| 05/21/2020 | 0 |
| 08/14/2020 | 0 |
| 10/07/2020 | 0 |
| 12/05/2020 | 0 |
| 01/22/2021 | 0 |
| 02/03/2021 | 0 |
| 03/17/2021 | 0 |
| 04/23/2021 | 0 |
| 05/04/2021 | 0 |
| 06/30/2021 | 0 |
| 07/26/2021 | 0 |
| 12/27/2021 | 0 |
| 02/02/2022 | 0 |
| 02/26/2022 | 0 |
| 03/07/2022 | 0 |
| 03/11/2022 | 0 |
Используя аргумент yearoffset = -2, функция yeartodate() сдвигает границы сравниваемого сегмента календарного года на два полных года. Первоначально сегмент года начинался 1 января и заканчивался 26 апреля 2022 года. Затем аргумент yearoffset сдвигает этот сегмент на два года назад. Таким образом границы сегмента переносятся на 1 января и 26 апреля 2020 года.
Диаграмма функции yeartodate(), пример с аргументом yearoffset
Таким образом, любая транзакция, совершенная в период с 1 января по 26 апреля 2020 года, возвращает булев результат TRUE. Все транзакции, совершенные до или после этого сегмента, возвращают FALSE.
Пример 3. Аргумент firstmonth
Обзор
Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки на новую вкладку.
Скрипт загрузки содержит следующее:
- Используется тот же набор данных и сценарий, что в первом примере.
-
Создание поля year_to_date, которое определяет, какие транзакции совершены в течение календарного года до даты последней перезагрузки.
В данном примере в качестве начала финансового года задано 1 июля.
Скрипт загрузки
SET DateFormat='MM/DD/YYYY';
Transactions:
Load
*,
yeartodate(date,0,7) as year_to_date
;
Load
*
Inline
[
id,date,amount
8188,01/10/2020,37.23
8189,02/28/2020,17.17
8190,04/09/2020,88.27
8191,04/16/2020,57.42
8192,05/21/2020,53.80
8193,08/14/2020,82.06
8194,10/07/2020,40.39
8195,12/05/2020,87.21
8196,01/22/2021,95.93
8197,02/03/2021,45.89
8198,03/17/2021,36.23
8199,04/23/2021,25.66
8200,05/04/2021,82.77
8201,06/30/2021,69.98
8202,07/26/2021,76.11
8203,12/27/2021,25.12
8204,02/02/2022,46.23
8205,02/26/2022,84.21
8206,03/07/2022,96.24
8207,03/11/2022,67.67
];Результаты
Загрузите данные и откройте лист. Создайте новую таблицу и добавьте эти поля как измерения:
-
date
-
year_to_date
| date | year_to_date |
|---|---|
| 01/10/2020 | 0 |
| 02/28/2020 | 0 |
| 04/09/2020 | 0 |
| 04/16/2020 | 0 |
| 05/21/2020 | 0 |
| 08/14/2020 | 0 |
| 10/07/2020 | 0 |
| 12/05/2020 | 0 |
| 01/22/2021 | 0 |
| 02/03/2021 | 0 |
| 03/17/2021 | 0 |
| 04/23/2021 | 0 |
| 05/04/2021 | 0 |
| 06/30/2021 | 0 |
| 07/26/2021 | -1 |
| 12/27/2021 | -1 |
| 02/02/2022 | -1 |
| 02/26/2022 | -1 |
| 03/07/2022 | -1 |
| 03/11/2022 | -1 |
Поскольку в этом примере используется аргумент firstmonth = 7, функция yeartodate() задает в качестве первого дня года 1 июля, а в качестве последнего дня года — 30 июня.
Диаграмма функции yeartodate(), пример с аргументом firstmonth
Таким образом, любая транзакция, совершенная в период с 1 июля 2021 года по 26 апреля 2022 года (дата перезагрузки), возвращает булев результат TRUE. Любая транзакция, совершенная до 1 июля 2021 года, будет возвращать булев результат FALSE.
Пример 4. Аргумент todaydate
Обзор
Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки на новую вкладку.
Скрипт загрузки содержит следующее:
- Используется тот же набор данных и сценарий, что в первом примере.
-
Создание поля year_to_date, которое определяет, какие транзакции совершены в течение календарного года до даты последней перезагрузки.
Однако в этом примере требуется идентифицировать все транзакции, совершенные в течение календарного года до 1 марта 2022 года включительно.
Скрипт загрузки
SET DateFormat='MM/DD/YYYY';
Transactions:
Load
*,
yeartodate(date, 0, 1, '03/01/2022') as year_to_date
;
Load
*
Inline
[
id,date,amount
8188,01/10/2020,37.23
8189,02/28/2020,17.17
8190,04/09/2020,88.27
8191,04/16/2020,57.42
8192,05/21/2020,53.80
8193,08/14/2020,82.06
8194,10/07/2020,40.39
8195,12/05/2020,87.21
8196,01/22/2021,95.93
8197,02/03/2021,45.89
8198,03/17/2021,36.23
8199,04/23/2021,25.66
8200,05/04/2021,82.77
8201,06/30/2021,69.98
8202,07/26/2021,76.11
8203,12/27/2021,25.12
8204,02/02/2022,46.23
8205,02/26/2022,84.21
8206,03/07/2022,96.24
8207,03/11/2022,67.67
];Результаты
Загрузите данные и откройте лист. Создайте новую таблицу и добавьте эти поля как измерения:
-
date
-
year_to_date
| date | year_to_date |
|---|---|
| 01/10/2020 | 0 |
| 02/28/2020 | 0 |
| 04/09/2020 | 0 |
| 04/16/2020 | 0 |
| 05/21/2020 | 0 |
| 08/14/2020 | 0 |
| 10/07/2020 | 0 |
| 12/05/2020 | 0 |
| 01/22/2021 | 0 |
| 02/03/2021 | 0 |
| 03/17/2021 | 0 |
| 04/23/2021 | 0 |
| 05/04/2021 | 0 |
| 06/30/2021 | 0 |
| 07/26/2021 | 0 |
| 12/27/2021 | 0 |
| 02/02/2022 | -1 |
| 02/26/2022 | -1 |
| 03/07/2022 | 0 |
| 03/11/2022 | 0 |
В этом примере, так как используется аргумент todaydate = 03/01/2022, функция yeartodate() задает в качестве окончания сравниваемого сегмента календарного года 1 марта 2022 года. Критически важно предоставить параметр firstmonth (от 1 до 12); в противном случае функция вернет нулевые результаты (null).
Диаграмма функции yeartodate(), пример с аргументом todaydate
Таким образом, любая транзакция, совершенная в период с 1 января по 1 марта 2022 года (параметр todaydate), возвращает булев результат TRUE. Любая транзакция, совершенная до 1 января 2022 года или после 1 марта 2022 года, будет возвращать булев результат FALSE.
Пример 5. Пример объекта диаграммы
Обзор
Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки на новую вкладку.
Скрипт загрузки содержит тот же набор данных и сценарий, что в первом примере.
Однако в этом примере в приложение загружается неизмененный набор данных. Расчет, который определяет, какие транзакции совершены в календарном году до текущей даты, создается в качестве меры в объекте диаграммы в приложении.
Скрипт загрузки
Transactions:
Load
*
Inline
[
id,date,amount
8188,01/10/2020,37.23
8189,02/28/2020,17.17
8190,04/09/2020,88.27
8191,04/16/2020,57.42
8192,05/21/2020,53.80
8193,08/14/2020,82.06
8194,10/07/2020,40.39
8195,12/05/2020,87.21
8196,01/22/2021,95.93
8197,02/03/2021,45.89
8198,03/17/2021,36.23
8199,04/23/2021,25.66
8200,05/04/2021,82.77
8201,06/30/2021,69.98
8202,07/26/2021,76.11
8203,12/27/2021,25.12
8204,02/02/2022,46.23
8205,02/26/2022,84.21
8206,03/07/2022,96.24
8207,03/11/2022,67.67
];Результаты
Загрузите данные и откройте лист. Создайте новую таблицу и добавьте это поле как измерение: date.
Добавьте следующую меру:
=yeartodate(date)
| date | =yeartodate(date) |
|---|---|
| 01/10/2020 | 0 |
| 02/28/2020 | 0 |
| 04/09/2020 | 0 |
| 04/16/2020 | 0 |
| 05/21/2020 | 0 |
| 08/14/2020 | 0 |
| 10/07/2020 | 0 |
| 12/05/2020 | 0 |
| 01/22/2021 | 0 |
| 02/03/2021 | 0 |
| 03/17/2021 | 0 |
| 04/23/2021 | 0 |
| 05/04/2021 | 0 |
| 06/30/2021 | 0 |
| 07/26/2021 | 0 |
| 12/27/2021 | 0 |
| 02/02/2022 | -1 |
| 02/26/2022 | -1 |
| 03/07/2022 | -1 |
| 03/11/2022 | -1 |
Мера year_to_date создается в объекте диаграммы с использованием функции yeartodate(), где в качестве аргумента функции передано поле date.
Так как функции yeartodate() не переданы дополнительные параметры, она сначала определяет дату перезагрузки и границы текущего календарного года (начало 1 января), которые будут возвращать булево значение TRUE.
Диаграмма функции yeartodate(), пример с объектом диаграммы
Любая транзакция, совершенная в период с 1 января по 26 апреля (дата перезагрузки), возвращает булев результат TRUE. Любая транзакция, совершенная до начала 2022 года, будет возвращать булев результат FALSE.
Пример 6. Сценарий
Обзор
Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки на новую вкладку.
Скрипт загрузки содержит следующее:
-
Набор данных, содержащий набор транзакций с 2020 по 2022 год, который загружается в таблицу под именем Transactions.
- Поле даты было предоставлено в формате системной переменной DateFormat (MM/DD/YYYY).
Конечному пользователю требуется объект ключевого показателя эффективности (КПЭ), который представляет общие продажи за период 2021 года, эквивалентный периоду текущего года до текущей даты по состоянию на время последней перезагрузки.
Текущая дата на момент создания — 16 июня 2022 года.
Скрипт загрузки
SET DateFormat='MM/DD/YYYY';
Transactions:
Load
*
Inline
[
id,date,amount
8188,01/10/2020,37.23
8189,02/28/2020,17.17
8190,04/09/2020,88.27
8191,04/16/2020,57.42
8192,05/21/2020,53.80
8193,08/14/2020,82.06
8194,10/07/2020,40.39
8195,12/05/2020,87.21
8196,01/22/2021,95.93
8197,02/03/2021,45.89
8198,03/17/2021,36.23
8199,04/23/2021,25.66
8200,05/04/2021,82.77
8201,06/30/2021,69.98
8202,07/26/2021,76.11
8203,12/27/2021,25.12
8204,02/02/2022,46.23
8205,02/26/2022,84.21
8206,03/07/2022,96.24
8207,03/11/2022,67.67
];Результаты
Выполните следующие действия.
-
Создайте объект ключевого показателя эффективности.
-
Чтобы рассчитать общий объем продаж, создайте следующую меру агрегирования:
=sum(if(yeartodate(date,-1),amount,0))
-
Задайте параметру Формат чисел меры значение Денежный.
Диаграмма КПЭ yeartodate() за 2021 год
Функция yeartodate() возвращает булево значение при проверке дат для каждого идентификатора транзакции. Так как перезагрузка выполнена 16 июня 2022 года, функция yeartodate рассматривает сегмент года с 01/01/2022 по 06/16/2022. Однако так как в функции использовался аргумент period_no = -1, эти границы затем переносятся на год назад. Поэтому для любой транзакции, совершенной с 01/01/2021 по 06/16/2021, функция yeartodate() возвращает булево значение TRUE и суммирует количество.