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)
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 de datas, que é carregado em uma tabela denominada Master Calendar.
A variável de sistema DateFormat padrão (MM/DD/AAAA) é usada.
Um carregamento anterior, que é usado para criar um campo adicional, year, usando a função year().
Script de carregamento
SET DateFormat='MM/DD/YYYY';
Master_Calendar:
Load
date,
year(date) as year
;
Load
date
Inline
[
date
12/28/2020
12/29/2020
12/30/2020
12/31/2020
01/01/2021
01/02/2021
01/03/2021
01/04/2021
01/05/2021
01/06/2021
01/07/2021
];
Resultados
Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:
date
year
Tabela de resultados
date
ano
12/28/2020
2020
12/29/2020
2020
12/30/2020
2020
12/31/2020
2020
01/01/2021
2021
01/02/2021
2021
01/03/2021
2021
01/04/2021
2021
01/05/2021
2021
01/06/2021
2021
01/07/2021
2021
Exemplo 2: Datas ANSI
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 de datas, que é carregado em uma tabela denominada Master Calendar.
A variável de sistema DateFormat padrão (MM/DD/AAAA) é usada. No entanto, as datas incluídas no conjunto de dados estão no formato de data padrão ANSI.
Um carregamento anterior, que é usado para criar um campo adicional, denominado year, usando a função year().
Script de carregamento
SET DateFormat='MM/DD/YYYY';
Master_Calendar:
Load
date,
year(date) as year
;
Load
date
Inline
[
date
2020-12-28
2020-12-29
2020-12-30
2020-12-31
2021-01-01
2021-01-02
2021-01-03
2021-01-04
2021-01-05
2021-01-06
2021-01-07
];
Resultados
Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:
date
year
Tabela de resultados
date
ano
2020-12-28
2020
2020-12-29
2020
2020-12-30
2020
2020-12-31
2020
2021-01-01
2021
2021-01-02
2021
2021-01-03
2021
2021-01-04
2021
2021-01-05
2021
2021-01-06
2021
2021-01-07
2021
Exemplo 3: Datas não formatadas
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 de datas em formato numérico, que é carregado em uma tabela denominada Master Calendar.
A variável de sistema DateFormat padrão (MM/DD/AAAA) é usada.
Um carregamento anterior, que é usado para criar um campo adicional, year, usando a função year().
A data original não formatada é carregada, denominada unformatted_date, e, para fornecer clareza, um outro campo adicional, denominado long_date, é usado para converter a data numérica em um campo de data formatado usando a função date().
Script de carregamento
SET DateFormat='MM/DD/YYYY';
Master_Calendar:
Load
unformatted_date,
date(unformatted_date) as long_date,
year(unformatted_date) as year
;
Load
unformatted_date
Inline
[
unformatted_date
44868
44898
44928
44958
44988
45018
45048
45078
45008
45038
45068
];
Resultados
Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:
unformatted_date
long_date
year
Tabela de resultados
unformatted_date
long_date
ano
44868
11/03/2022
2022
44898
12/03/2022
2022
44928
01/02/2023
2023
44958
02/01/2023
2023
44988
03/03/2023
2023
45008
03/23/2023
2023
45018
04/02/2023
2023
45038
04/22/2023
2023
45048
05/02/2023
2023
45068
05/22/2023
2023
45078
06/01/2023
2023
Exemplo 4: 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.
Neste exemplo, um conjunto de dados de pedidos feitos é carregado em uma tabela denominada Sales. A tabela contém três campos:
id
sales_date
amount
As garantias na venda de produtos duram dois anos a partir da data de venda. A tarefa é criar uma medida em um gráfico para determinar o ano em que cada garantia expirará.
Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão: sales_date.
Crie a seguinte medida:
=year(sales_date+365*2)
Tabela de resultados
sales_date
=year(sales_date+365*2)
12/28/2020
2022
12/29/2020
2022
12/30/2020
2022
12/31/2020
2022
01/01/2021
2023
01/02/2021
2023
01/03/2021
2023
01/04/2021
2023
01/05/2021
2023
01/06/2021
2023
01/07/2021
2023
Os resultados dessa medida podem ser vistos na tabela acima. Para adicionar dois anos a uma data, multiplique 365 por 2 e adicione o resultado à data da venda. Portanto, as vendas que ocorreram em 2020 têm um ano de expiração de 2022.
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!