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

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

Esta função retorna um valor de exibição que mostra os meses do trimestre (formatados de acordo com a variável de script MonthNames) e o ano com um valor numérico subjacente que corresponde a um carimbo de hora do primeiro milissegundo do primeiro dia do trimestre.

Sintaxe:  

QuarterName(date[, period_no[, first_month_of_year]])

Tipo de dados de retorno: dual

Diagrama da função quartername()

Diagrama de exemplo mostrando como a função quartername converte uma data de entrada em um intervalo de meses contido no trimestre em que a data ocorre.

A função quartername() determina em qual trimestre a data cai. Em seguida, ela retorna um valor mostrando os meses de início e fim deste trimestre, bem como o ano. O valor numérico subjacente desse resultado é o primeiro milissegundo do trimestre.

Argumentos
Argumento Descrição
date A data ou o carimbo de data/hora a ser avaliado.
period_no period_no é um inteiro, em que o valor 0 indica o trimestre que contém date. Valores negativos em period_no indicam trimestres precedentes e valores positivos indicam trimestres sucessivos.
first_month_of_year Se desejar trabalhar com anos (fiscais) que não comecem em janeiro, indique um valor entre 2 e 12 em first_month_of_year.

Quando usar

A função quartername() é útil quando você deseja comparar agregações por trimestre. Por exemplo, se você quiser ver o total de vendas de produtos por trimestre.

Essa função pode ser usada no script de carregamento para criar um campo em uma tabela do calendário mestre. Como alternativa, ela pode ser usada diretamente em um gráfico como uma dimensão calculada.

Esses exemplos usam o formato de data MM/DD/AAAA. O formato de data é especificado no comando SET DateFormat na parte superior do seu script de carregamento de dados. Altere o formato nos exemplos para atender às suas necessidades.

Exemplos de funções
Exemplo Resultado
quartername('10/29/2013') Retorna Oct-Dec 2013.
quartername('10/29/2013', -1) Retorna Jul-Sep 2013.
quartername('10/29/2013', 0, 3) Retorna Sep-Nov 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: data sem argumentos adicionais

Exemplo 2: data com o argumento period_no

Exemplo 3: data com o argumento 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!