# year - función de script y de gráfico
Esta función devuelve un entero que representa el año en que expression se interpreta como una fecha de acuerdo con la interpretación numérica estándar.
Sintaxis:
year(expression)
Tipo de datos que devuelve: Entero
La función `year()` está disponible como función de script y de gráfico. La función devuelve el año de una fecha en particular. Normalmente se utiliza para crear un campo de año como dimensión en un calendario maestro.
## Cuándo se utiliza
La función `year()` es útil cuando se desea comparar agregaciones por año. Por ejemplo, si desea ver el total de ventas de productos por año.
Estas dimensiones se pueden crear o bien en el script de carga, utilizando la función para crear un campo en una tabla de calendario maestro. Alternativamente, podría usarse directamente en un gráfico como una dimensión calculada.
Ejemplos de funciones
| Ejemplo | Resultado |
| --- | --- |
| `year(
'2012-10-12' )` | devuelve 2012 |
| `year(
'35648' )` | devuelve 1997, porque 35648 = 1997-08-06 |
## Configuraciones regionales
A menos que se especifique algo distinto, los ejemplos de este tema utilizan el siguiente formato de fecha: MM/DD/YYYY. El formato de fecha se especifica en la sentencia `SET DateFormat` de su script de carga de datos. El formato de fecha predeterminado puede ser diferente en su sistema, debido a su configuración regional y otros factores. Puede cambiar el formato en los ejemplos a continuación para ajustarlo a sus necesidades. O puede cambiar los formatos en su script de carga para que coincidan con estos ejemplos.
La configuración regional predeterminada en las aps se basa en la configuración del sistema regional de la computadora o servidor donde esté instalado Qlik Sense. Si el servidor de Qlik Sense al que está accediendo está configurado en Suecia, el editor de carga de datos utilizará la configuración regional sueca para las fechas, la hora y la moneda. Estos ajustes de formato regional no están relacionados con el idioma mostrado en la interfaz de usuario de Qlik Sense. Qlik Sense se mostrará en el mismo idioma que esté utilizando en su navegador.
## Ejemplo 1: conjunto de datos DateFormat (script)
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/year.htm)
#### Script de carga y resultados
Vista general
Abra el editor de carga de datos y agregue el script de carga a continuación a una nueva pestaña.
El script de carga contiene:
* Un conjunto de datos de fechas que se carga en una tabla denominada `Master Calendar`.
* Se utiliza la variable predefinida del sistema `DateFormat` (DD/MM/AAAA).
* Un load precedente, que se utiliza para crear un campo adicional, "`year`", usando la función `year()`.
Script de carga
```
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
Cargue los datos y abra una hoja. Cree una nueva tabla y agregue estos campos como dimensiones:
* `date`
* `year`
Tabla de resultados
| date | año |
| --- | --- |
| 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 |
## Ejemplo 2: fechas ANSI
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/year.htm)
#### Script de carga y resultados
Vista general
Abra el editor de carga de datos y agregue el script de carga a continuación a una nueva pestaña.
El script de carga contiene:
* Un conjunto de fechas que se carga en una tabla denominada `Master Calendar`.
* Se utiliza la variable predefinida del sistema `DateFormat`: DD/MM/AAAA. Sin embargo, las fechas incluidas en el conjunto de datos están en el formato de fecha estándar ANSI.
* Un load precedente, que se utiliza para crear un campo adicional, llamado `year`, usando la función `year()`.
Script de carga
```
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
Cargue los datos y abra una hoja. Cree una nueva tabla y agregue estos campos como dimensiones:
* `date`
* `year`
Tabla de resultados
| date | año |
| --- | --- |
| 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 |
## Ejemplo 3: fechas sin formato
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/year.htm)
#### Script de carga y resultados
Vista general
Abra el editor de carga de datos y agregue el script de carga a continuación a una nueva pestaña.
El script de carga contiene:
* Un conjunto de fechas, en formato numérico, que se carga en una tabla denominada `Master Calendar`.
* Se utiliza la variable predefinida del sistema `DateFormat`: DD/MM/AAAA.
* Un load precedente, que se utiliza para crear un campo adicional, "`year`", usando la función `year()`.
Se carga la fecha original sin formato, llamada `unformatted_date` y, para proporcionar claridad, se usa un campo adicional, llamado `long_date`, para convertir la fecha numérica en un campo de fecha con formato usando la función `date()`.
Script de carga
```
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
Cargue los datos y abra una hoja. Cree una nueva tabla y agregue estos campos como dimensiones:
* `unformatted_date`
* `long_date`
* `year`
Tabla de resultados
| unformatted\_date | long\_date | año |
| --- | --- | --- |
| 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 |
## Ejemplo 4: ejemplo de objeto gráfico
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/year.htm)
#### Script de carga y expresión de gráfico
Vista general
Abra el editor de carga de datos y agregue el script de carga a continuación en una nueva pestaña.
En este ejemplo, se carga un conjunto de datos de pedidos en una tabla denominada "Sales". La tabla contiene tres campos:
* id
* sales\_date
* amount
Las garantías por la venta de productos duran dos años a partir de la fecha de venta. La tarea es crear una medida en un gráfico para determinar el año en que expirará cada garantía.
Script de carga
```
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
Cargue los datos y abra una hoja. Cree una nueva tabla y agregue este campo como dimensión: sales\_date.
Cree la siguiente medida:
=year(sales\_date+365\*2)
Tabla 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 |
Los resultados de esta medida se pueden ver en la tabla anterior. Para sumar dos años a una fecha, multiplique 365 por 2 y sume el resultado a la fecha de venta. Por lo tanto, las ventas que tuvieron lugar en 2020 tienen como año de vencimiento 2022.