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. 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 – 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!