Ir para conteúdo principal Pular para conteúdo complementar

lunarweekstart – função de script e gráfico

Essa função retorna um valor correspondente a um carimbo de data/hora do primeiro milissegundo do primeiro dia da semana lunar que contém date. As semanas lunares no Qlik Sense são definidas contando 1º de janeiro como o primeiro dia da semana e, além da última semana do ano, conterão exatamente sete dias.

Sintaxe:  

LunarweekStart(date[, period_no[, first_week_day]])

Tipo de dados de retorno: dual

A função lunarweekstart() determina em qual semana lunar a date cai. Em seguida, ela retorna um carimbo de data/hora, em formato de data, para o primeiro milissegundo daquela semana.

Exemplo de diagrama da função lunarweekstart()

Diagrama de exemplo mostrando como a função lunarweekstart converte uma data de entrada em um carimbo de data/hora para o primeiro milissegundo da semana lunar em que a data de entrada ocorre.
Argumentos
Argumento Descrição
date A data ou o carimbo de data/hora a ser avaliado.
period_no period_no é um inteiro ou uma expressão que resolve um inteiro em que o valor 0 indica a semana lunar que contém date. Valores negativos em period_no indicam semanas lunares precedentes e valores positivos indicam semanas lunares sucessivas.
first_week_day Um deslocamento que pode ser maior ou menor que zero. Isso muda o início do ano por um número determinado de dias e/ou frações de um dia.

Quando usar

A função lunarweekstart() é comumente usada como parte de uma expressão quando o usuário deseja que o cálculo use a fração da semana decorrida até o momento. Diferentemente da função weekstart(), no início de cada novo ano civil, a semana começa em 1º de janeiro e cada semana subsequente começa sete dias depois. A função lunarweekstart() não é afetada pela variável de sistema FirstWeekDay.

Por exemplo, lunarweekstart() pode ser usado para calcular os juros acumulados em uma semana até o momento.

Exemplos de funções
Exemplo Resultado
lunarweekstart('01/12/2013') Retorna 01/08/2013.
lunarweekstart('01/12/2013', -1) Retorna 01/01/2013.
lunarweekstart('01/12/2013', 0, 1 ) Retorna 01/09/2013, porque definir first_week_day como 1 significa que o início do ano foi alterado para 01/02/2013.

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 configurações regionais para aplicativos e scripts.

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 Definir suas configurações regionais preferidas para criar aplicativos e scripts no Qlik Cloud Analytics.

Exemplo 1: sem argumentos adicionais

Exemplo 2: period_no

Exemplo 3: first_week_day

Exemplo 4: Exemplo de objeto de gráfico

Exemplo 5: Cenário

Esta página ajudou?

Se você encontrar algum problema com esta página ou seu conteúdo - um erro de digitação, uma etapa ausente ou um erro técnico - informe-nos como podemos melhorar!