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

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

Эта функция возвращает год, к которому относится номер недели в соответствии с переменными среды. Номер недели в году может быть установлен в пределах от 1 до 52.

Синтаксис:  

weekyear(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

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

Если BrokenWeeks задано значение 0 (false), weekyear() будет возвращать то же, что year().

Диаграмма диапазона функции weekyear()

Диаграмма, демонстрирующая диапазон времени, оцениваемый функцией weekyear().

Однако если системная переменная BrokenWeeks задает использование полных недель, неделя 1 должна содержать не меньше определенного количества дней января на основе значения, заданного системной переменной ReferenceDay.

Например, если используется ReferenceDay = 4, неделя 1 должна включать не меньше четырех дней января. Неделя 1 может включать дни декабря предыдущего года, а последняя неделя года может включать дни января следующего года. В подобных ситуациях функция weekyear() возвращает значение, не совпадающее с результатом функции year().

Диаграмма диапазона функции weekyear() при использовании полных недель

Диаграмма, демонстрирующая, как функция weekyear() работает с полными неделями.

Функция weekyear() полезна, когда требуется сравнить агрегирования по годам, например, если требуется увидеть общий объем продаж продуктов по годам. Функции weekyear() отдается предпочтение перед year(), когда пользователю требуется обеспечить согласованность с переменной BrokenWeeks в приложении.

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

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

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

Примеры функции
Пример Результат
weekyear('12/30/1996',0,0,4) Возвращает 1997, поскольку неделя 1 1997 года начинается 12/30/1996
weekyear('01/02/1997',0,0,4) Возвращает 1997
weekyear('12/28/1997',0,0,4) Возвращает 1997
weekyear('12/30/1997',0,0,4) Возвращает 1998, поскольку неделя 1 1998 года начинается 12/29/1997
weekyear('01/02/1999',0,0,4) Возвращает 1998, поскольку неделя 53 1998 года оканчивается 01/03/1999
Связанные темы
Тема Взаимодействие
week — функция скриптa и диаграммы Возвращает номер недели в виде целого числа согласно стандарту ISO 8601
year — функция скриптa и диаграммы Возвращает год в виде целого числа, а выражение интерпретируется как дата согласно стандартной интерпретации чисел.

Пример 1. Неполные недели

Пример 2. Полные недели

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

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

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

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