# quarter Функция скрипта и диаграммы

Функция quarter возвращает целое число, представляющее квартал указанной даты. Возвращаемое значение находится в диапазоне от 1 до 4. Функцию можно использовать как в скриптах загрузки, так и в выражениях диаграмм.

quarter(date [, first\_month\_of\_year])

**Тип возвращаемых данных:** целое число

quarterquarter аргументы функции

| Аргумент | Описание |
| --- | --- |
| date | Дата для вычисления. |
| first\_month\_of\_year | Если необходимо работать с годами (финансовыми), которые начинаются не в январе, задайте значение от 2 до 12 в first\_month\_of\_year.<br><br>Если не указано, значение по умолчанию — 1. |

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

Функция quarter полезна, когда требуется сравнить агрегации по кварталам, Например, ее можно использовать, если требуется увидеть общий объем продаж продуктов по кварталам. Его можно использовать для создания новых полей в Скрипте загрузки, а также в вычисляемых измерениях и выражениях множеств.

Примеры функции

| Пример | Результат |
| --- | --- |
| `quarter('10/29/2026')` | Возвращает 4. |
| `quarter('10/29/2026', 3)` | Возвращает 3. |

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

Если не указано иное, в примерах, приведенных в данном разделе, используется следующий формат даты: MM/DD/YYYY. Формат даты указан в операторе `SET DateFormat` скрипта загрузки данных. В вашей системе может быть установлен другой формат даты по умолчанию в зависимости от региональных настроек и других факторов. Можно изменить формат в примерах в соответствии с потребностями. Или можно изменить форматы в скрипте загрузки в соответствии с этими примерами. Для получения дополнительной информации см. раздел [Изменение региональных настроек для приложений и скриптов](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Apps/regional-settings-in-apps.htm).

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

Если вы — разработчик приложений, то можете задать регион по умолчанию для создаваемых приложений. Для получения дополнительной информации см. раздел [Установка предпочтительных региональных настроек для создания приложений и скриптов в Аналитика Qlik Cloud](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/UserInterface/Languages.htm#Setting).

## Пример – Скрипт загрузки

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/quarter.htm)

#### Скрипт загрузки и результаты

Обзор

Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки в новый раздел.

Скрипт загрузки содержит следующее:

* Набор данных, содержащий набор транзакций за 2025 год, который загружается в таблицу под именем `Transactions`.

* Поле даты, представленное в формате системной переменной `DateFormat` (M/D/YYYY).

* Создание двух полей:

  * `transaction_quarter` возвращает квартал, в котором совершены транзакции.

  * `transaction_quarter_march_yearstart` возвращает квартал транзакций, скорректированный таким образом, чтобы 1 марта было началом финансового года.

Скрипт загрузки

```
SET DateFormat='MM/DD/YYYY';

Transactions:
Load
*,
quarter(date) as transaction_quarter,
quarter(date,3) as transaction_quarter_march_yearstart
;
Load
*
Inline
[
id,date,amount
8188,1/7/2025,17.17
8189,1/19/2025,37.23
8190,2/28/2025,88.27
8191,2/5/2025,57.42
8192,3/16/2025,53.80
8193,4/1/2025,82.06
8194,5/7/2025,40.39
8195,5/16/2025,87.21
8196,6/15/2025,95.93
8197,6/26/2025,45.89
8198,7/9/2025,36.23
8199,7/22/2025,25.66
8200,7/23/2025,82.77
8201,7/27/2025,69.98
8202,8/2/2025,76.11
8203,8/8/2025,25.12
8204,8/19/2025,46.23
8205,9/26/2025,84.21
8206,10/14/2025,96.24
8207,10/29/2025,67.67
];
```

Результаты

Загрузите данные и откройте лист. Создайте новую таблицу и добавьте эти поля как измерения:

* `date`

* `transaction_quarter`

* `transaction_quarter_march_yearstart`

Результирующая таблица

| date | transaction\_quarter | transaction\_quarter\_march\_yearstart |
| --- | --- | --- |
| 1/7/2025 | 1 | 4 |
| 1/19/2025 | 1 | 4 |
| 2/28/2025 | 1 | 4 |
| 2/5/2025 | 1 | 4 |
| 3/16/2025 | 1 | 1 |
| 4/1/2025 | 2 | 1 |
| 5/7/2025 | 2 | 1 |
| 5/16/2025 | 2 | 1 |
| 6/15/2025 | 2 | 2 |
| 6/26/2025 | 2 | 2 |
| 7/9/2025 | 3 | 2 |
| 7/22/2025 | 3 | 2 |
| 7/23/2025 | 3 | 2 |
| 7/27/2025 | 3 | 2 |
| 8/2/2025 | 3 | 2 |
| 8/8/2025 | 3 | 2 |
| 8/19/2025 | 3 | 2 |
| 9/26/2025 | 3 | 3 |
| 10/14/2025 | 4 | 3 |
| 10/29/2025 | 4 | 3 |

## Пример 2 – выражения диаграммы

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/quarter.htm)

#### Выражения диаграммы

Обзор

Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки на новую вкладку.

Скрипт загрузки содержит тот же набор данных и сценарий, что в первом примере.

Однако в этом примере в приложение загружается неизмененный набор данных. Расчеты кварталов транзакций создаются как меры в объекте диаграммы приложения.

Скрипт загрузки

```
SET DateFormat='MM/DD/YYYY';

Transactions:
Load
*
Inline
[
id,date,amount
8188,1/7/2025,17.17
8189,1/19/2025,37.23
8190,2/28/2025,88.27
8191,2/5/2025,57.42
8192,3/16/2025,53.80
8193,4/1/2025,82.06
8194,5/7/2025,40.39
8195,5/16/2025,87.21
8196,6/15/2025,95.93
8197,6/26/2025,45.89
8198,7/9/2025,36.23
8199,7/22/2025,25.66
8200,7/23/2025,82.77
8201,7/27/2025,69.98
8202,8/2/2025,76.11
8203,8/8/2025,25.12
8204,8/19/2025,46.23
8205,9/26/2025,84.21
8206,10/14/2025,96.24
8207,10/29/2025,67.67
];
```

Результаты

Загрузите данные и откройте лист. Создайте новую таблицу и добавьте это поле как измерение:

* `date`

Создайте следующие меры:

* ```
  =quarter(date)
  ```

  Эта мера возвращает квартал, в котором были совершены транзакции.

* ```
  =quarter(date,3)
  ```

  Эта мера возвращает квартал транзакций, скорректированный таким образом, чтобы 1 марта было началом финансового года.

Меры создаются в объекте диаграммы с использованием функции `quarter()`, где в качестве аргументов передается поле `date`.

Результирующая таблица

| date | =quarter(date) | =quarter(date,3) |
| --- | --- | --- |
| 1/7/2025 | 1 | 4 |
| 1/19/2025 | 1 | 4 |
| 2/28/2025 | 1 | 4 |
| 2/5/2025 | 1 | 4 |
| 3/16/2025 | 1 | 1 |
| 4/1/2025 | 2 | 1 |
| 5/7/2025 | 2 | 1 |
| 5/16/2025 | 2 | 1 |
| 6/15/2025 | 2 | 2 |
| 6/26/2025 | 2 | 2 |
| 7/9/2025 | 3 | 2 |
| 7/22/2025 | 3 | 2 |
| 7/23/2025 | 3 | 2 |
| 7/27/2025 | 3 | 2 |
| 8/2/2025 | 3 | 2 |
| 8/8/2025 | 3 | 2 |
| 8/19/2025 | 3 | 2 |
| 9/26/2025 | 3 | 3 |
| 10/14/2025 | 4 | 3 |
| 10/29/2025 | 4 | 3 |