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

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

Эта функция возвращает значение, которое соответствует метке времени, равной первой миллисекунде первого дня календарной недели, и содержит date. По умолчанию для вывода используется формат DateFormat, заданный в скрипте.

Синтаксис:  

WeekStart(timestamp [, period_no [, first_week_day ]])

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

Функция weekstart() определяет, на какой день недели приходится дата. Затем она возвращает метку времени в формате даты для первой миллисекунды этой недели. Первый день недели определяется переменной среды FirstWeekDay. Однако ее можно переопределить с помощью аргумента first_week_day в функции weekstart().

Аргументы
Аргумент Описание
timestamp Дата или метка времени для вычисления.
period_no shift — целое число, где 0 обозначает неделю, включающую значение, указанное в поле date. Отрицательные значения, заданные в поле shift, означают предшествующие недели, положительные — последующие.
first_week_day

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

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

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

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

Функция weekstart() широко используется в составе выражения, когда пользователю требуется учитывать в расчетах часть недели, которая уже прошла. Например, с ее помощью можно вычислить совокупную заработную плату, заработанную сотрудниками за эту неделю по состоянию на текущий момент.

В следующих примерах используется:

SET FirstWeekDay=0;
Примеры функции
Пример Результат
weekstart('01/12/2013') Возвращает 01/07/2013.
weekstart('01/12/2013', -1 ) Возвращает 11/31/2012.
weekstart('01/12/2013', 0, 1) Возвращает 01/08/2013.

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

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

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

Если вы — разработчик приложений, то можете задать регион по умолчанию для создаваемых приложений. Для получения дополнительной информации см. Установка предпочтительных региональных настроек для создания приложений и скриптов в Аналитика Qlik Cloud.

Примеры:  

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

Set DateFormat ='YYYY-MM-DD'; Set FirstWeekDay =0; // Monday as first week day Set BrokenWeeks =0; //(use unbroken weeks) Set ReferenceDay =4; // Jan 4th is always in week 1

Если требуется использовать параметры US, убедитесь, что в скрипте содержится следующее:

Set DateFormat ='M/D/YYYY'; Set FirstWeekDay =6; // Sunday as first week day Set BrokenWeeks =1; //(use broken weeks) Set ReferenceDay =1; // Jan 1st is always in week 1

Приведенные выше примеры дают следующие результаты функции weekstart():

Пример функции Weekstart
Date Начало недели ISO Начало недели US
Sat 2020 Dec 26 2020-12-21 12/20/2020
Sun 2020 Dec 27 2020-12-21 12/27/2020
Mon 2020 Dec 28 2020-12-28 12/27/2020
Tue 2020 Dec 29 2020-12-28 12/27/2020
Wed 2020 Dec 30 2020-12-28 12/27/2020
Thu 2020 Dec 31 2020-12-28 12/27/2020
Fri 2021 Jan 1 2020-12-28 12/27/2020
Sat 2021 Jan 2 2020-12-28 12/27/2020
Sun 2021 Jan 3 2020-12-28 1/3/2021
Mon 2021 Jan 4 2021-01-04 1/3/2021
Tue 2021 Jan 5 2021-01-04 1/3/2021
Примечание к информацииНачало недели выпадает на понедельник в столбце ISO и на воскресенье в столбце US.

Пример 1. Без дополнительных аргументов

Пример 2. Скрипт period_no

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

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

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

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

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