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

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

Esta função retorna um número inteiro que representa o ano em que a expression é interpretada como uma data, de acordo com a interpretação de número padrão.

Sintaxe:  

year(expression)

Tipo de dados de retorno: inteiro

A função year() está disponível como função de script e gráfico. A função retorna o ano de uma data específica. Ela é geralmente usada para criar um campo de ano como uma dimensão em um Calendário mestre.

Quando usar

A função year() é útil quando você deseja comparar agregações por ano. Por exemplo, a função pode ser usada se você deseja ver o total de vendas de produtos por ano.

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. Como alternativa, ela pode ser usada diretamente em um gráfico como uma dimensão calculada.

Exemplos de funções
Exemplo Resultado
year( '2012-10-12' ) retorna 2012
year( '35648' ) retorna 1997, por que 35648 = 1997-08-06

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.

As configurações regionais padrão nos aplicativos são baseadas nas configurações regionais do sistema do computador ou servidor em que o Qlik Sense está instalado. Se o servidor Qlik Sense que você está acessando estiver definido como Suécia, o Editor de carregamento de dados usará as configurações regionais suecas para datas, horas e moedas. Essas configurações de formato regional não estão relacionadas ao idioma exibido na interface do usuário do Qlik Sense. O Qlik Sense será exibido no mesmo idioma do navegador que você está usando.

Exemplo 1 – conjunto de dados DateFormat (script)

Exemplo 2: Datas ANSI

Exemplo 3: Datas não formatadas

Exemplo 4: Exemplo de objeto de gráfico

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!