Esta função retorna um valor dual com:
- Um nome do dia conforme definido na variável de ambiente DayNames.
- Um inteiro entre 0 e 6 correspondendo ao dia nominal da semana (0-6).
Sintaxe:
weekday(date [,first_week_day=0])
Tipo de dados de retorno: dual
A função weekday() determina em qual dia da semana uma data ocorre. Em seguida, ela retorna um valor de string representando esse dia.
Diagrama da função weekday() que retorna o nome do dia em que uma data cai
O resultado retorna o valor numérico correspondente a esse dia da semana (0-6), com base no dia de início da semana. Por exemplo, se o primeiro dia da semana for definido como domingo, uma quarta-feira retornará um valor numérico de 3. Esse dia de início é determinado pela variável de sistema FirstWeekDay ou pelo parâmetro da função first_week_day.
Você pode usar esse valor numérico como parte de uma expressão aritmética. Por exemplo, multiplique por 1 para retornar o valor em si.
Diagrama da função weekday() com o valor numérico do dia sendo mostrado no lugar do nome do dia
Quando usar
A função weekday() é útil quando você deseja comparar agregações por dia da semana. Por exemplo, se você quiser comparar a média de vendas de produtos por dia da semana.
Essas dimensões podem ser criadas no script de carregamento usando a função para criar um campo em uma tabela de Calendário mestre ou podem ser criadas diretamente em um gráfico como uma medida calculada.
| Tópicos | Interação |
|---|---|
| FirstWeekDay | Define o dia de início de cada semana. |
|
|
| Argumento | Descrição |
|---|---|
| date | A data ou o carimbo de data/hora a ser avaliado. |
| first_week_day |
Especifica o dia no qual inicia a semana. Se omitido, o valor da variável FirstWeekDay é usado. |
Você pode usar os seguintes valores para definir o dia em que a semana começa no argumento first_week_day:
| Dia | Valor |
|---|---|
| Segunda-feira | 0 |
| Terça-feira | 1 |
| Quarta-feira | 2 |
| Quinta-feira | 3 |
| Sexta-feira | 4 |
| Sábado | 5 |
| Domingo | 6 |
Configurações regionais
A menos que especificado de outra forma, os exemplos neste tópico usam o seguinte formato de data: MM/DD/AAAA. O formato de data é especificado na instrução SET DateFormat no seu script de carregamento de dados. A formatação de data padrão pode ser diferente no seu sistema devido às suas configurações regionais e outros fatores. Você pode alterar os formatos nos exemplos abaixo para atender às suas necessidades. Ou pode alterar os formatos no seu script de carregamento para corresponder a esses exemplos. Para obter mais informações, consulte Modificando as configurações regionais do aplicativo.
As configurações regionais padrão nos aplicativos são baseadas no perfil do usuário. Essas configurações de formato regional não estão relacionadas ao idioma exibido na interface do usuário do Qlik Cloud. O Qlik Cloud será exibido no mesmo idioma do navegador que você está usando.
Se você for um criador de aplicativos, poderá definir a região padrão para os aplicativos que criar. Para obter mais informações, consulte Definindo suas configurações regionais preferidas para criar aplicativos no Qlik Cloud Analytics.
| Exemplo | Resultado |
|---|---|
| weekday('10/12/1971') | Retorna “True” e 1. |
| weekday('10/12/1971' , 6) |
Retorna “True” e 2. Neste exemplo, domingo (6) é o primeiro dia da semana. |
|
SET FirstWeekDay=6; ... weekday('10/12/1971') |
Retorna “True” e 2. |
Exemplo 1: sequência de caracteres para dias da semana
Visão geral
Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova guia.
O script de carregamento contém:
-
Um conjunto de dados contendo um conjunto de transações para 2022, que é carregado em uma tabela denominada "Transactions".
-
A variável de sistema FirstWeekDay que é definida como 6 (domingo).
-
A variável DayNames que está configurada para usar os nomes de dias padrão.
-
Um carregamento anterior que contém a função weekday(), que é definida como o campo "week_day" e retorna o dia da semana em que as transações ocorreram.
Script de carregamento
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
]; Resultados
Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:
-
id
-
date
-
week_day
| id | date | week_day |
|---|---|---|
| 8188 | 01/01/2022 | Sáb |
| 8189 | 01/02/2022 | Dom |
| 8190 | 01/03/2022 | Seg |
| 8191 | 01/04/2022 | Ter |
| 8192 | 01/05/2022 | Qua |
| 8193 | 01/06/2022 | Qui |
| 8194 | 01/07/2022 | Sex |
O campo "week_day" é criado na instrução de carregamento anterior usando a função weekday() e transmitindo o campo de data como o argumento da função.
A função weekday() retorna o valor da cadeia de caracteres do dia da semana; ou seja, ela retorna o nome do dia da semana que é definido pela variável de sistema DayNames.
Diagrama da função weekday() que retorna quarta-feira como o dia da semana para a transação 8192
A transação 8192 ocorreu em 5 de janeiro. A variável de sistema FirstWeekDay define o primeiro dia da semana como domingo. A transação da função weekday() ocorreu em uma quarta-feira e retorna esse valor, na forma abreviada da variável de sistema DayNames, no campo week_day.
Os valores no campo "week_day" estão alinhados à direita na coluna porque há um resultado duplo de número e texto para o campo (quarta-feira, 3). Para converter o valor do campo em seu equivalente numérico, o campo pode ser encapsulado dentro da função num(). Por exemplo, na Transação 8192, o valor de quarta-feira seria convertido no número 3.
Exemplo 2: first_week_day
Visão geral
Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova guia.
O script de carregamento contém:
-
Um conjunto de dados contendo um conjunto de transações para 2022, que é carregado em uma tabela chamada Transactions.
-
A variável de sistema FirstWeekDay que é definida como 6 (domingo).
-
A variável DayNames que está configurada para usar os nomes de dias padrão.
-
Uma carga anterior que contém a função weekday(), que é definida como o campo "week_day" e retorna o dia da semana em que as transações ocorreram.
Script de carregamento
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
]; Resultados
Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:
-
id
-
date
-
week_day
| id | date | week_day |
|---|---|---|
| 8188 | 01/01/2022 | Sáb |
| 8189 | 01/02/2022 | Dom |
| 8190 | 01/03/2022 | Seg |
| 8191 | 01/04/2022 | Ter |
| 8192 | 01/05/2022 | Qua |
| 8193 | 01/06/2022 | Qui |
| 8194 | 01/07/2022 | Sex |
Diagrama da função weekday() que mostra que quarta-feira tem o valor de número duplo de 1
Como o argumento first_week_day está definido como 1 na função weekday(), o primeiro dia da semana é terça-feira. Portanto, todas as transações que ocorrerem em uma terça-feira terão um valor numérico duplo de 0.
A transação 8192 ocorreu em 5 de janeiro. A função weekday() identifica que esta é uma quarta-feira e, portanto, a expressão retornaria o valor de número duplo de 1.
Exemplo 3: Exemplo de objeto de gráfico
Visão geral
Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova guia.
O script de carregamento contém:
-
Um conjunto de dados contendo um conjunto de transações para 2022, que é carregado em uma tabela denominada "Transactions".
-
A variável de sistema FirstWeekDay que é definida como 6 (domingo).
-
A variável DayNames que está configurada para usar os nomes de dias padrão.
No entanto, neste exemplo, o conjunto de dados permanece inalterado e é carregado no aplicativo. O cálculo que identifica o valor do dia da semana é criado como uma medida em um gráfico no aplicativo.
Script de carregamento
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
]; Resultados
Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:
-
id
-
date
Para calcular o valor do dia da semana, crie a seguinte medida:
-
=weekday(date)
| id | date | =weekday(date) |
|---|---|---|
| 8188 | 01/01/2022 | Sáb |
| 8189 | 01/02/2022 | Dom |
| 8190 | 01/03/2022 | Seg |
| 8191 | 01/04/2022 | Ter |
| 8192 | 01/05/2022 | Qua |
| 8193 | 01/06/2022 | Qui |
| 8194 | 01/07/2022 | Sex |
O campo “=weekday(date)” é criado no gráfico usando a função weekday() e transmitindo o campo de data como o argumento da função.
A função weekday() retorna o valor da cadeia de caracteres do dia da semana; ou seja, ela retorna o nome do dia da semana que é definido pela variável de sistema DayNames.
Diagrama da função weekday() que retorna quarta-feira como o dia da semana para a transação 8192
A transação 8192 ocorreu em 5 de janeiro. A variável de sistema FirstWeekDay define o primeiro dia da semana como domingo. A transação da função weekday() ocorreu em uma quarta-feira e retorna esse valor, na forma abreviada da variável de sistema DayNames, no campo =weekday(date).