Эта функция возвращает двойное значение со следующим:
- Имя дня, как определено переменной окружения DayNames.
- Целое от 0 до 6, соответствующее номинальному дню недели (0–6).
Синтаксис:
weekday(date [,first_week_day=0])
Возвращаемые типы данных: двойное значение
Функция weekday() определяет, на какой день недели выпадает дата. Затем она возвращает строковое значение, представляющее этот день.
Диаграмма функции weekday(), возвращающей название дня недели, на который выпадает дата
Результат возвращает значение, соответствующее дню недели (0-6), в зависимости от первого дня недели. Например, если в качестве первого дня недели задано воскресенье, то для среды будет возвращаться значение 3. Этот день начала недели определяется системной переменной FirstWeekDay или параметром функции first_week_day.
Это числовое значение можно использовать как часть арифметического выражения. Например, умножьте его на 1 для возвращения самого значения.
Диаграмма функции weekday() с числовым значением дня, которое отображается вместо названия дня
Когда это следует использовать
Функция weekday() полезна, когда требуется сравнить агрегирования по дням недели, например, если требуется сравнить средние продажи продуктов по дням недели.
Эти измерения можно создать в скрипте загрузки, используя функцию для создания поля в таблице основного календаря, или непосредственно в диаграмме в качестве вычисляемого измерения.
| Темы | Взаимодействие |
|---|---|
| FirstWeekDay | Определяет день начала каждой недели. |
|
|
| Аргумент | Описание |
|---|---|
| date | Дата или метка времени для вычисления. |
| first_week_day |
Указывает день начала недели. Если не указано, используется значение переменной FirstWeekDay. |
Можно использовать следующие значения, чтобы задать первый день недели в аргументе first_week_day:
| День | Значение |
|---|---|
| Понедельник | 0 |
| Вторник | 1 |
| Среда | 2 |
| Четверг | 3 |
| Пятница | 4 |
| Суббота | 5 |
| Воскресенье | 6 |
Региональные настройки
Если не указано иное, в примерах, приведенных в данном разделе, используется следующий формат даты: ММ/ДД/ГГГГ. Формат даты указан в операторе SET DateFormat скрипта загрузки данных. В вашей системе может быть установлен другой формат даты по умолчанию в зависимости от региональных настроек и других факторов. Можно изменить формат в примерах в соответствии с потребностями. Или можно изменить форматы в скрипте загрузки в соответствии с этими примерами. Для получения дополнительной информации см. Изменение региональных настроек для создания приложений и скриптов.
Региональные настройки по умолчанию в приложениях основаны на профиле пользователя. Эти параметры регионального формата не связаны с языком, отображаемым в интерфейсе пользователя Qlik Cloud. Qlik Cloud будет отображаться на языке, который используется в браузере.
Если вы — разработчик приложений, то можете задать регион по умолчанию для создаваемых приложений. Для получения дополнительной информации см. Установка предпочтительных региональных настроек для создания приложений и скриптов в Аналитика Qlik Cloud.
| Пример | Результат |
|---|---|
| weekday('10/12/1971') | Возвращает Tue (вторник) и 1. |
| weekday('10/12/1971' , 6) |
Возвращает Tue (вторник) и 2. В этом примере мы используем воскресенье (6) в качестве первого дня недели. |
|
SET FirstWeekDay=6; ... weekday('10/12/1971') |
Возвращает Tue (вторник) и 2. |
Пример 1. Строка с названием дня недели
Обзор
Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки на новую вкладку.
Скрипт загрузки содержит следующее:
-
Набор данных, содержащий набор транзакций за 2022 год, который загружается в таблицу под именем Transactions.
-
Системная переменная FirstWeekDay, для которой задано значение 6 (воскресенье).
-
Переменная DayNames, настроенная для использования названий дней недели по умолчанию.
-
Предшествующая загрузка, содержащая функцию weekday(), которая настроена как поле week_day и возвращает день недели, когда совершены транзакции.
Скрипт загрузки
SET DateFormat='MM/DD/YYYY';
SET DayNames='Mon;Tue;Wed;Thu;Fri;Sat;Sun';
SET FirstWeekDay=6;
Transactions:
Load
*,
WeekDay(date) as week_day
;
Load
*
Inline
[
id,date,amount
8188,01/01/2022,37.23
8189,01/02/2022,17.17
8190,01/03/2022,88.27
8191,01/04/2022,57.42
8192,01/05/2022,53.80
8193,01/06/2022,82.06
8194,01/07/2022,40.39
]; Результаты
Загрузите данные и откройте лист. Создайте новую таблицу и добавьте эти поля как измерения:
-
id
-
date
-
week_day
| id | date | week_day |
|---|---|---|
| 8188 | 01/01/2022 | Sat |
| 8189 | 01/02/2022 | Sun |
| 8190 | 01/03/2022 | Mon |
| 8191 | 01/04/2022 | Tue |
| 8192 | 01/05/2022 | Wed |
| 8193 | 01/06/2022 | Thu |
| 8194 | 01/07/2022 | Fri |
Поле week_day создано предшествующим оператором load с использованием функции weekday(), где в качестве аргумента функции передано поле даты.
Функция weekday() возвращает строковое значение дня недели; другими словами, она возвращает название дня недели, заданное системной переменной DayNames.
Диаграмма функции weekday(), которая возвращает среду в качестве дня недели для транзакции 8192
Транзакция 8192 совершена 5 января. Системная переменная FirstWeekDay задает в качестве первого дня недели воскресенье. Функция weekday() определяет, что транзакция совершена в среду, и возвращает это значение как сокращенную форму системной переменной DayNames в поле week_day.
Значения в поле week_day выравниваются по правому краю столбца, так как это двойной текстово-числовой результат для поля (Wednesday, 3). Чтобы преобразовать значение поля в числовой эквивалент, можно поместить поле в функцию num(). Например, в транзакции 8192 значение Wednesday (среда) можно преобразовать в число 3.
Пример 2. Аргумент first_week_day
Обзор
Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки на новую вкладку.
Скрипт загрузки содержит следующее:
-
Набор данных, содержащий набор транзакций за 2022 год, который загружается в таблицу под именем Transactions.
-
Системная переменная FirstWeekDay, для которой задано значение 6 (воскресенье).
-
Переменная DayNames, настроенная для использования названий дней недели по умолчанию.
-
Предшествующая загрузка, содержащая функцию weekday(), которая настроена как поле week_day и возвращает день недели, когда совершены транзакции.
Скрипт загрузки
SET DateFormat='MM/DD/YYYY';
SET DayNames='Mon;Tue;Wed;Thu;Fri;Sat;Sun';
SET FirstWeekDay=6;
Transactions:
Load
*,
WeekDay(date,1) as week_day
;
Load
*
Inline
[
id,date,amount
8188,01/01/2022,37.23
8189,01/02/2022,17.17
8190,01/03/2022,88.27
8191,01/04/2022,57.42
8192,01/05/2022,53.80
8193,01/06/2022,82.06
8194,01/07/2022,40.39
]; Результаты
Загрузите данные и откройте лист. Создайте новую таблицу и добавьте эти поля как измерения:
-
id
-
date
-
week_day
| id | date | week_day |
|---|---|---|
| 8188 | 01/01/2022 | Sat |
| 8189 | 01/02/2022 | Sun |
| 8190 | 01/03/2022 | Mon |
| 8191 | 01/04/2022 | Tue |
| 8192 | 01/05/2022 | Wed |
| 8193 | 01/06/2022 | Thu |
| 8194 | 01/07/2022 | Fri |
Диаграмма функции weekday(), которая показывает, что для среды предусмотрено двойное числовое значение 1
Поскольку используется аргумент first_week_day = 1 в функции weekday(), первым днем недели является вторник. Таким образом, все транзакции, совершенные во вторник, имеют двойное числовое значение 0.
Транзакция 8192 совершена 5 января. Функция weekday() определяет, что эта дата выпадает на среду, поэтому выражение возвращает двойное числовое значение 1.
Пример 3. Пример объекта диаграммы
Обзор
Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки на новую вкладку.
Скрипт загрузки содержит следующее:
-
Набор данных, содержащий набор транзакций за 2022 год, который загружается в таблицу под именем Transactions.
-
Системная переменная FirstWeekDay, для которой задано значение 6 (воскресенье).
-
Переменная DayNames, настроенная для использования названий дней недели по умолчанию.
Однако в этом примере в приложение загружается неизмененный набор данных. Расчет, который определяет день недели, создается как мера в диаграмме приложения.
Скрипт загрузки
SET DateFormat='MM/DD/YYYY';
SET DayNames='Mon;Tue;Wed;Thu;Fri;Sat;Sun';
SET FirstWeekDay=6;
Transactions:
Load
*
Inline
[
id,date,amount
8188,01/01/2022,37.23
8189,01/02/2022,17.17
8190,01/03/2022,88.27
8191,01/04/2022,57.42
8192,01/05/2022,53.80
8193,01/06/2022,82.06
8194,01/07/2022,40.39
]; Результаты
Загрузите данные и откройте лист. Создайте новую таблицу и добавьте эти поля как измерения:
-
id
-
date
Чтобы рассчитать значение дня недели, создайте следующую меру:
-
=weekday(date)
| id | date | =weekday(date) |
|---|---|---|
| 8188 | 01/01/2022 | Sat |
| 8189 | 01/02/2022 | Sun |
| 8190 | 01/03/2022 | Mon |
| 8191 | 01/04/2022 | Tue |
| 8192 | 01/05/2022 | Wed |
| 8193 | 01/06/2022 | Thu |
| 8194 | 01/07/2022 | Fri |
Поле =weekday(date) создано в диаграмме с использованием функции weekday(), где в качестве аргумента функции передано поле даты.
Функция weekday() возвращает строковое значение дня недели; другими словами, она возвращает название дня недели, заданное системной переменной DayNames.
Диаграмма функции weekday(), которая возвращает среду в качестве дня недели для транзакции 8192
Транзакция 8192 совершена 5 января. Системная переменная FirstWeekDay задает в качестве первого дня недели воскресенье. Функция weekday() определяет, что транзакция совершена в среду, и возвращает это значение как сокращенную форму системной переменной DayNames в поле =weekday(date).