Эта функция возвращает значение, соответствующее метке времени, включающей первую миллисекунду квартала, содержащего значение, указанное в поле date. По умолчанию для вывода используется формат DateFormat, установленный в скрипте.
Функция quarterstart() определяет, на какой квартал приходится date. Затем она возвращает метку времени в формате даты для первой миллисекунды первого месяца этого квартала.
Аргументы
Аргумент
Описание
date
Дата или метка времени для вычисления.
period_no
period_no — целое число, где 0 обозначает квартал, включающий значение, указанное в поле date. Отрицательные значения, заданные в поле period_no, означают предшествующие кварталы, положительные — последующие.
first_month_of_year
Если необходимо работать с годами (финансовыми), которые начинаются не в январе, задайте значение от 2 до 12 в поле first_month_of_year.
Когда это следует использовать
Функция quarterstart() широко используется в составе выражения, когда пользователю требуется учитывать в расчетах часть квартала, которая уже прошла. Например, можно ее использовать, если требуется рассчитать проценты, накопленные в течение квартала до текущей даты.
Примеры функции
Пример
Результат
quarterstart('10/29/2005')
Возвращает 10/01/2005.
quarterstart('10/29/2005', -1 )
Возвращает 07/01/2005.
quarterstart('10/29/2005', 0, 3)
Возвращает 09/01/2005.
Региональные настройки
Если не указано иное, в примерах, приведенных в данном разделе, используется следующий формат даты: ММ/ДД/ГГГГ. Формат даты указан в операторе SET DateFormat скрипта загрузки данных. В вашей системе может быть установлен другой формат даты по умолчанию в зависимости от региональных настроек и других факторов. Можно изменить формат в примерах в соответствии с потребностями. Или можно изменить форматы в скрипте загрузки в соответствии с этими примерами.
Региональные настройки по умолчанию в приложениях основаны на системных региональных настройках компьютера или сервера, где установлено ПО Qlik Sense. Если на сервере Qlik Sense, к которому обращается пользователь, выбран шведский язык, то редактор загрузки данных будет использовать шведские региональные настройки для даты, времени и валюты. Эти параметры регионального формата не связаны с языком, отображаемым в интерфейсе пользователя Qlik Sense. Qlik Sense будет отображаться на языке, который используется в браузере.
Пример 1. Без дополнительных аргументов
Обзор
Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки на новую вкладку.
Скрипт загрузки содержит следующее:
Набор данных, содержащий набор транзакций за 2022 год, который загружается в таблицу под именем Transactions.
Поле даты было предоставлено в формате системной переменной DateFormat (MM/DD/YYYY).
Создание поля start_of_quarter, возвращающего метку времени начала квартала, в течение которого совершены транзакции.
Загрузите данные и откройте лист. Создайте новую таблицу и добавьте эти поля как измерения:
date
start_of_quarter
start_of_quarter_timestamp
Результирующая таблица
date
start_of_quarter
start_of_quarter_timestamp
1/7/2022
01/01/2022
1/1/2022 12:00:00 AM
1/19/2022
01/01/2022
1/1/2022 12:00:00 AM
2/5/2022
01/01/2022
1/1/2022 12:00:00 AM
2/28/2022
01/01/2022
1/1/2022 12:00:00 AM
3/16/2022
01/01/2022
1/1/2022 12:00:00 AM
4/1/2022
04/01/2022
4/1/2021 12:00:00 AM
5/7/2022
04/01/2022
4/1/2021 12:00:00 AM
5/16/2022
04/01/2022
4/1/2021 12:00:00 AM
6/15/2022
04/01/2022
4/1/2021 12:00:00 AM
6/26/2022
04/01/2022
4/1/2021 12:00:00 AM
7/9/2022
07/01/2022
7/1/2021 12:00:00 AM
7/22/2022
07/01/2022
7/1/2021 12:00:00 AM
7/23/2022
07/01/2022
7/1/2021 12:00:00 AM
7/27/2022
07/01/2022
7/1/2021 12:00:00 AM
8/2/2022
07/01/2022
7/1/2021 12:00:00 AM
8/8/2022
07/01/2022
7/1/2021 12:00:00 AM
8/19/2022
07/01/2022
7/1/2021 12:00:00 AM
9/26/2022
07/01/2022
7/1/2021 12:00:00 AM
10/14/2022
10/01/2022
10/1/2022 12:00:00 AM
10/29/2022
10/01/2022
10/1/2022 12:00:00 AM
Поле start_of_quarter создано предшествующим оператором load с использованием функции quarterstart(), где в качестве аргумента функции передано поле даты. Функция uarterstart() сначала определяет квартал, к которому относится значение даты. Затем она возвращает метку времени для первой миллисекунды этого квартала.
Транзакция 8203 совершена 8 августа. Функция quarterstart() определяет, что транзакция совершена в третьем квартале, и возвращает первую миллисекунду этого квартала, то есть 00:00:00 (12:00:00 AM) 1 июля.
Пример 2. Скрипт period_no
Обзор
Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки на новую вкладку.
Скрипт загрузки содержит следующее:
Используется тот же набор данных и сценарий, что в первом примере.
Создание поля previous_quarter_start, возвращающего метку времени начала квартала, который предшествует совершению транзакции.
Загрузите данные и откройте лист. Создайте новую таблицу и добавьте эти поля как измерения:
date
previous_quarter_start
previous_quarter_start_timestamp
Результирующая таблица
date
previous_quarter_start
previous_quarter_start_timestamp
1/7/2022
10/01/2021
10/1/2021 12:00:00 AM
1/19/2022
10/01/2021
10/1/2021 12:00:00 AM
2/5/2022
10/01/2021
10/1/2021 12:00:00 AM
2/28/2022
10/01/2021
10/1/2021 12:00:00 AM
3/16/2022
10/01/2021
10/1/2021 12:00:00 AM
4/1/2022
01/01/2022
1/1/2022 12:00:00 AM
5/7/2022
01/01/2022
1/1/2022 12:00:00 AM
5/16/2022
01/01/2022
1/1/2022 12:00:00 AM
6/15/2022
01/01/2022
1/1/2022 12:00:00 AM
6/26/2022
01/01/2022
1/1/2022 12:00:00 AM
7/9/2022
04/01/2022
4/1/2021 12:00:00 AM
7/22/2022
04/01/2022
4/1/2021 12:00:00 AM
7/23/2022
04/01/2022
4/1/2021 12:00:00 AM
7/27/2022
04/01/2022
4/1/2021 12:00:00 AM
8/2/2022
04/01/2022
4/1/2021 12:00:00 AM
8/8/2022
04/01/2022
4/1/2021 12:00:00 AM
8/19/2022
04/01/2022
4/1/2021 12:00:00 AM
9/26/2022
04/01/2022
4/1/2021 12:00:00 AM
10/14/2022
07/01/2022
7/1/2022 12:00:00 AM
10/29/2022
07/01/2022
7/1/2022 12:00:00 AM
В этом случае, так как в качестве аргумента смещения использовалось period_no = -1, функция quarterstart() сначала определяет квартал, в котором совершаются транзакции. Затем она возвращается на квартал назад и определяет первую миллисекунду предыдущего квартала.
Транзакция 8203 совершена 8 августа. Функция quarterstart() определяет, что квартал, предшествующий совершению транзакции, начинается 1 апреля и заканчивается 30 июня. Затем она возвращает первую миллисекунду этого квартала, 00:00:00 (12:00:00 AM) 1 апреля.
Пример 3. Аргумент first_month_of_year
Обзор
Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки на новую вкладку.
Скрипт загрузки содержит тот же набор данных и сценарий, что в первом примере. Однако в этом примере нам также нужно задать 1 марта в качестве начала финансового года.
Загрузите данные и откройте лист. Создайте новую таблицу и добавьте эти поля как измерения:
date
start_of_quarter
start_of_quarter_timestamp
Результирующая таблица
date
start_of_quarter
start_of_quarter_timestamp
1/7/2022
12/01/2021
12/1/2021 12:00:00 AM
1/19/2022
12/01/2021
12/1/2021 12:00:00 AM
2/5/2022
12/01/2021
12/1/2021 12:00:00 AM
2/28/2022
12/01/2021
12/1/2021 12:00:00 AM
3/16/2022
03/01/2022
3/1/2022 12:00:00 AM
4/1/2022
03/01/2022
3/1/2022 12:00:00 AM
5/7/2022
03/01/2022
3/1/2022 12:00:00 AM
5/16/2022
03/01/2022
3/1/2022 12:00:00 AM
6/15/2022
06/01/2022
6/1/2022 12:00:00 AM
6/26/2022
06/01/2022
6/1/2022 12:00:00 AM
7/9/2022
06/01/2022
6/1/2022 12:00:00 AM
7/22/2022
06/01/2022
6/1/2022 12:00:00 AM
7/23/2022
06/01/2022
6/1/2022 12:00:00 AM
7/27/2022
06/01/2022
6/1/2022 12:00:00 AM
8/2/2022
06/01/2022
6/1/2022 12:00:00 AM
8/8/2022
06/01/2022
6/1/2022 12:00:00 AM
8/19/2022
06/01/2022
6/1/2022 12:00:00 AM
9/26/2022
09/01/2022
9/1/2022 12:00:00 AM
10/14/2022
09/01/2022
9/1/2022 12:00:00 AM
10/29/2022
09/01/2022
9/1/2022 12:00:00 AM
В этом примере, так как используется аргумент first_month_of_year= 3 в функции quarterstart(), начало года переносится с 1 января на 1 марта.
Транзакция 8203 совершена 8 августа. Так как год начинается 1 марта, он делится на кварталы март-май, июнь-август, сентябрь-ноябрь и декабрь-февраль. Функция quarterstart() определяет, что транзакция совершена в квартале с июня по август и возвращает первую миллисекунду этого квартала, то есть 00:00:00 (12:00:00 AM) 1 июня.
Пример 4. Пример объекта диаграммы
Обзор
Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки на новую вкладку.
Скрипт загрузки содержит тот же набор данных и сценарий, что в первом примере.
Однако в этом примере в приложение загружается неизмененный набор данных. Расчет, возвращающий метку времени окончания квартала, в котором совершены транзакции, создается как мера в объекте диаграммы в приложении.
Загрузите данные и откройте лист. Создайте новую таблицу и добавьте это поле как измерение: date.
Добавьте следующие меры:
=quarterstart(date)
=timestamp(quarterstart(date))
Результирующая таблица
date
=quarterstart(date)
=timestamp(quarterstart(date))
10/14/2022
10/01/2022
10/1/2022 12:00:00 AM
10/29/2022
10/01/2022
10/1/2022 12:00:00 AM
7/9/2022
07/01/2022
7/1/2022 12:00:00 AM
7/22/2022
07/01/2022
7/1/2022 12:00:00 AM
7/23/2022
07/01/2022
7/1/2022 12:00:00 AM
7/27/2022
07/01/2022
7/1/2022 12:00:00 AM
8/2/2022
07/01/2022
7/1/2022 12:00:00 AM
8/8/2022
07/01/2022
7/1/2022 12:00:00 AM
8/19/2022
07/01/2022
7/1/2022 12:00:00 AM
9/26/2022
07/01/2022
7/1/2022 12:00:00 AM
4/1/2022
04/01/2022
4/1/2022 12:00:00 AM
5/7/2022
04/01/2022
4/1/2022 12:00:00 AM
5/16/2022
04/01/2022
4/1/2022 12:00:00 AM
6/15/2022
04/01/2022
4/1/2022 12:00:00 AM
6/26/2022
04/01/2022
4/1/2022 12:00:00 AM
1/7/2022
01/01/2022
1/1/2022 12:00:00 AM
1/19/2022
01/01/2022
1/1/2022 12:00:00 AM
2/5/2022
01/01/2022
1/1/2022 12:00:00 AM
2/28/2022
01/01/2022
1/1/2022 12:00:00 AM
3/16/2022
01/01/2022
1/1/2022 12:00:00 AM
Мера start_of_quarter создана в объекте диаграммы с использованием функции quarterstart(), где в качестве аргумента функции передано поле date.
Функция quarterstart() определяет, к какому кварталу относится дата, и возвращает метку времени для первой миллисекунды этого квартала.
Транзакция 8203 совершена 8 августа. Функция quarterstart() определяет, что транзакция совершена в третьем квартале, и возвращает первую миллисекунду этого квартала, то есть 00:00:00 (12:00:00 AM) 1 июля.
Пример 5. Сценарий
Обзор
Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки на новую вкладку.
Скрипт загрузки содержит следующее:
Набор данных, содержащий набор остатков по кредитам, который загружается в таблицу под именем Loans.
Данные, включая идентификаторы кредитов, остаток на начало квартала и простую процентную ставку, взимаемую по каждому кредиту за год.
Конечному пользователю требуется объект диаграммы, который будет отображать по идентификатору кредита текущий процент, начисленный по каждому кредиту в течение квартала до текущей даты.
Используя сегодняшнюю дату в качестве единственного аргумента, функция quarterstart() возвращает дату начала текущего года. Вычитая этот результат из текущей даты, выражение возвращает количество дней, прошедших до сих пор в этом квартале.
Затем это значение умножается на процентную ставку и делится на 365, чтобы получить эффективную процентную ставку начисленную за этот период. После этого результат умножается на начальный остаток кредита, чтобы вернуть проценты, начисленные до сих пор в течение этого квартала.
Помогла ли вам эта страница?
Если вы обнаружили какую-либо проблему на этой странице и с ее содержанием — будь то опечатка, пропущенный шаг или техническая ошибка, сообщите нам об этом, чтобы мы смогли ее исправить!