# 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)
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/year.htm)
#### Script de carregamento e resultados
Visão geral
Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.
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
| data | 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
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/year.htm)
#### Script de carregamento e resultados
Visão geral
Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.
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
| data | 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
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/year.htm)
#### Script de carregamento e resultados
Visão geral
Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.
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
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/year.htm)
#### Script de carregamento e expressão de gráfico
Visão geral
Abra o editor de carregamento 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á.
Script de carregamento
```
Sales:
Load
id,
sales_date,
amount
Inline
[
id,sales_date,amount
1,12/28/2020,231.24,
2,12/29/2020,567.28,
3,12/30/2020,364.28,
4,12/31/2020,575.76,
5,01/01/2021,638.68,
6,01/02/2021,785.38,
7,01/03/2021,967.46,
8,01/04/2021,287.67
9,01/05/2021,764.45,
10,01/06/2021,875.43,
11,01/07/2021,957.35
];
```
Resultados
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.