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

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

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

Синтаксис:  

week(timestamp [, first_week_day [, broken_weeks [, reference_day]]])

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

Аргументы
Аргумент Описание
timestamp Дата или метка времени для вычисления.
first_week_day

Указывает день начала недели. Если не указано, используется значение переменной FirstWeekDay.

Возможные значения first_week_day: 0 — понедельник, 1 — вторник, 2 — среда, 3 — четверг, 4 — пятница, 5 — суббота и 6 — воскресенье.

Для получения дополнительной информации о системной переменной см. FirstWeekDay.

broken_weeks

Если параметр broken_weeks не указан, значение переменной BrokenWeeks будет использовано для определения, какими должны быть недели: целыми или разбитыми.

Для получения дополнительной информации о системной переменной см. BrokenWeeks

reference_day

Если параметр reference_day не указан, значение переменной ReferenceDay будет использовано для определения, какой день в январе должен быть задан в качестве дня ссылки, чтобы определить неделю 1. По умолчанию в функциях Qlik Sense используется 4 как день ссылки. Это значит, что неделя 1 должна содержать значение «январь 4» , или, другими словами, в неделе 1 всегда должно быть не меньше 4 дней в январе.

Для получения дополнительной информации о системной переменной см. ReferenceDay

Функция week() определяет, на какую неделю приходится дата, и возвращает номер этой недели.

 В Qlik Sense региональные настройки извлекаются при создании приложения и соответствующие параметры хранятся в скрипте как переменные среды. Они используются для определения номера недели.

Это означает, что большинство европейских разработчиков приложений получают следующие переменные среды в соответствии с определением ISO 8601:

Set FirstWeekDay =0; // Monday as first week day Set BrokenWeeks =0; // Use unbroken weeks Set ReferenceDay =4; // Jan 4th is always in week 1

Североамериканские разработчики приложений часто получают следующие переменные среды:

Set FirstWeekDay =6; // Sunday as first week day Set BrokenWeeks =1; // Use broken weeks Set ReferenceDay =1; // Jan 1st is always in week 1

Первый день недели определяется системной переменной FirstWeekDay. Также можно изменить первый день недели, используя аргумент first_week_day в функции week().

Если приложение использует неполные недели, отсчет номера недели начинается с 1 января и заканчивается за день до системной переменной FirstWeekDay независимо от того, сколько дней прошло.

Если в приложении используются непрерывные недели, неделя 1 может начинаться в предыдущем году или в первые несколько дней января. Это зависит от того, как используются переменные среды FirstWeekDay и ReferenceDay.

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

Функция The week() полезна, когда требуется сравнить агрегирования по неделям. Например, ее можно использовать, если требуется увидеть общий объем продаж продуктов по неделям. Функции week() отдается предпочтение перед weekname(), когда пользователю требуется, чтобы в вычислении не всегда использовались системные переменные приложения: BrokenWeeks, FirstWeekDay или ReferenceDay.

Например, если требуется увидеть общий объем продаж продуктов по неделям.

Если приложение использует полные недели, неделя 1 может содержать даты декабря предыдущего года или исключать даты января текущего года. Если приложение использует неполные недели, неделя 1 может содержать менее семи дней.

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

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

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

В приведенных ниже примерах используется

Set DateFormat= 'MM/DD/YYYY'; Set FirstWeekDay=0; Set BrokenWeeks=0; Set ReferenceDay=4;
Примеры функции
ПримерРезультат

week('12/28/2021')

Возвращает 52.

week(44614)Возвращает 8, так как это порядковый номер для 02/22/2022.
week('01/03/2021')Возвращает 53.
week('01/03/2021',6)Возвращает 1.

Пример 1. Системные переменные по умолчанию

Пример 2. Аргумент first_week_day

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

Пример 4. Аргумент reference_day

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

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

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

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