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

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

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

Синтаксис:  

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

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

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

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

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

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

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

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

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

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

SET FirstWeekDay=0;

 

Пример Результат
weekend('01/10/2013') Возвращает 01/12/2013 23:59:59.
weekend('01/10/2013', -1) Возвращает 01/05/2013 23:59:59..
weekend('01/10/2013', 0, 1) Возвращает 01/14/2013 23:59:59.

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

Если не указано иное, в примерах, приведенных в данном разделе, используется следующий формат даты: ММ/ДД/ГГГГ. Формат даты указан в операторе 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

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

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

Пример 1. Базовый пример

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

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

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

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

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

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