inyeartodate - función de script y de gráfico

Esta función devuelve True si timestamp se encuentra dentro de la parte del año que contiene a base_date hasta e incluido el último milisegundo de base_date.

Sintaxis:

InYearToDate (timestamp, base_date, period_no[, first_month_of_year])

Tipo de datos que devuelve: Booleano

En Qlik Sense, el valor booleano verdadero viene representado por -1 y el valor falso está representado por 0.

Diagrama de ejemplo del rango de fechas dentro del cual la función inyeartodate devolverá un valor de TRUE. — Diagrama de la función inyeartodate

La función inyeartodate() segmentará una porción particular del año con la base_date, identificando la fecha máxima permitida para ese segmento de año. La función evalúa a continuación si un campo de fecha o valor cae dentro de este segmento y devuelve un resultado booleano.

Argumentos
Argumento	Descripción
timestamp	La fecha que desea comparar con base_date.
base_date	La fecha que se utiliza para evaluar el año.
period_no	El año puede desplazarse mediante period_no. period_no es un entero, en el que el valor 0 indica el año que contiene a base_date. Los valores negativos en period_no indican años precedentes y los valores positivos indican años subsiguientes.
first_month_of_year	Si desea trabajar con años (fiscales) que no comiencen en enero, indique un valor entre 2 y 12 en first_month_of_year.

Cuándo se utiliza

La función inyeartodate() devuelve un resultado booleano. Normalmente, este tipo de función se utilizará como condición en una expresión if. Esto devolvería una agregación o cálculo dependiendo de si una fecha evaluada ocurrió en el año hasta e incluida la fecha en cuestión.

Por ejemplo, la función inyeartodate() se puede utilizar para identificar todos los equipos fabricados en un año hasta una fecha específica.

Estos ejemplos utilizan el formato de fecha MM/DD/AAAA. El formato de fecha se especifica en la sentencia SET DateFormat en la parte superior de su script de carga de datos. Cambie el formato en los ejemplos según se ajuste a sus necesidades.

Ejemplos de funciones
Ejemplo	Resultado
inyeartodate ('01/25/2013', '02/01/2013', 0)	Devuelve TRUE.
inyeartodate ('01/25/2012', '01/01/2013', 0)	Devuelve FALSE.
inyeartodate ('01/25/2012', '02/01/2013', -1)	Devuelve TRUE.
inyeartodate ('11/25/2012', '01/31/2013', 0, 4)	Devuelve TRUE. El valor de timestamp cae dentro del año fiscal que comienza en el cuarto mes y antes del valor de base_date.
inyeartodate ('3/31/2013', '01/31/2013', 0, 4 )	Devuelve FALSE. Comparado con el ejemplo anterior, el valor de timestamp todavía está dentro del año fiscal, pero es posterior al valor de base_date, por lo que cae fuera de la parte del año.

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. Para más información, vea Modificar la configuración regional de la app.

La configuración regional por defecto de las apps se basa en una combinación de la configuración del proveedor de identidad, la configuración del sistema o la configuración del navegador. Estos ajustes de formato regional no están relacionados con el idioma mostrado en la interfaz de usuario de Qlik Cloud. Qlik Cloud se mostrará en el mismo idioma que esté utilizando su navegador.

Si es un creador de aplicaciones, puede establecer la región por defecto para las apps que cree. Para más información, vea Establecer sus configuraciones regionales preferidas para crear apps.

Ejemplo 1: sin argumentos adicionales

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 que contiene un conjunto de transacciones entre 2020 y 2022, que se carga en una tabla llamada Transactions.
El campo de fecha proporcionado en el formato de variable del sistema DateFormat (MM/DD/AAAA).
La creación de un campo, in_year_to_date, que determina qué transacciones se realizaron en el año hasta el 26 de julio de 2021.

Script de carga

SET DateFormat='MM/DD/YYYY';

Transactions:
    Load
        *,
        inyeartodate(date,'07/26/2021', 0) as in_year_to_date
        ;
Load
*
Inline
[
id,date,amount
8188,'01/13/2020',37.23
8189,'02/26/2020',17.17
8190,'03/27/2020',88.27
8191,'04/16/2020',57.42
8192,'05/21/2020',53.80
8193,'06/14/2020',82.06
8194,'08/07/2020',40.39
8195,'09/05/2020',87.21
8196,'01/22/2021',95.93
8197,'02/03/2021',45.89
8198,'03/17/2021',36.23
8199,'04/23/2021',25.66
8200,'05/04/2021',82.77
8201,'06/30/2021',69.98
8202,'07/26/2021',76.11
8203,'07/27/2021',25.12
8204,'06/06/2022',46.23
8205,'07/18/2022',84.21
8206,'11/14/2022',96.24
8207,'12/12/2022',67.67
];

Resultados

Cargue los datos y abra una hoja. Cree una nueva tabla y agregue estos campos como dimensiones:

date
in_year_to_date

Tabla de resultados
date	in_year_to_date
01/13/2020	0
02/26/2020	0
03/27/2020	0
04/16/2020	0
05/21/2020	0
06/14/2020	0
08/07/2020	0
09/05/2020	0
01/22/2021	-1
02/03/2021	-1
03/17/2021	-1
04/23/2021	-1
05/04/2021	-1
06/30/2021	-1
07/26/2021	-1
07/27/2021	0
06/06/2022	0
07/18/2022	0
11/14/2022	0
12/12/2022	0

El campo in_year_to_date se crea en la instrucción de carga anterior mediante el uso de la función inyeartodate(). El primer argumento proporcionado identifica qué campo se está evaluando.

El segundo argumento es una fecha codificada para el 26 de julio de 2021, que es la base_date que identifica el límite final del segmento del año. Un period_no de 0 es el argumento final, lo que significa que la función no compara los años que preceden o siguen al año segmentado.

Diagrama que muestra el rango de fechas para las que la función inyeartodate devolverá un valor de TRUE. — Diagrama de la función inyeartodate, sin argumentos adicionales

Cualquier transacción que ocurra entre el 1 de enero y el 26 de julio devuelve un resultado booleano de TRUE. Las fechas de transacciones anteriores a 2021 y posteriores al 26 de julio de 2021 devuelven FALSE.

Ejemplo 2: period_no

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:

Se utilizan el mismo conjunto de datos y escenario que en el primer ejemplo.
La creación de un campo, previous_year_to_date, que determina qué transacciones se realizaron en un año completo antes del segmento de año que finaliza el 26 de julio de 2021.

Script de carga

SET DateFormat='MM/DD/YYYY';

Transactions:
    Load
        *,
        inyeartodate(date,'07/26/2021', -1) as previous_year_to_date
        ;
Load
*
Inline
[
id,date,amount
8188,'01/13/2020',37.23
8189,'02/26/2020',17.17
8190,'03/27/2020',88.27
8191,'04/16/2020',57.42
8192,'05/21/2020',53.80
8193,'06/14/2020',82.06
8194,'08/07/2020',40.39
8195,'09/05/2020',87.21
8196,'01/22/2021',95.93
8197,'02/03/2021',45.89
8198,'03/17/2021',36.23
8199,'04/23/2021',25.66
8200,'05/04/2021',82.77
8201,'06/30/2021',69.98
8202,'07/26/2021',76.11
8203,'07/27/2021',25.12
8204,'06/06/2022',46.23
8205,'07/18/2022',84.21
8206,'11/14/2022',96.24
8207,'12/12/2022',67.67
];

Resultados

Cargue los datos y abra una hoja. Cree una nueva tabla y agregue estos campos como dimensiones:

date
previous_year_to_date

Tabla de resultados
date	previous_year_to_date
01/13/2020	-1
02/26/2020	-1
03/27/2020	-1
04/16/2020	-1
05/21/2020	-1
06/14/2020	-1
08/07/2020	0
09/05/2020	0
01/22/2021	0
02/03/2021	0
03/17/2021	0
04/23/2021	0
05/04/2021	0
06/30/2021	0
07/26/2021	0
07/27/2021	0
06/06/2022	0
07/18/2022	0
11/14/2022	0
12/12/2022	0

Un valor period_no de -1 indica que la función inyeartodate () compara el segmento del trimestre introducido con el año anterior. Con una fecha de entrada del 26 de julio de 2021, el segmento del 1 de enero de 2021 al 26 de julio de 2021 se identificó inicialmente como el año hasta la fecha. El period_no luego desplaza este segmento a un año completo antes, lo que hace que los límites de fecha sean del 1 de enero al 26 de juli0 de 2020.

Por lo tanto, cualquier transacción que ocurra entre el 1 de enero y el 26 de julio de 2020, devolverá un resultado booleano de TRUE.

Ejemplo 3: first_month_of_year

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:

Se utilizan el mismo conjunto de datos y escenario que en el primer ejemplo.
La creación de un campo, in_year_to_date, que determina qué transacciones se realizaron en el mismo año hasta el 26 de julio de 2021.

En este ejemplo, establecemos marzo como el primer mes del año fiscal.

Script de carga

SET DateFormat='MM/DD/YYYY';

Transactions:
    Load
        *,
        inyeartodate(date,'07/26/2021', 0,3) as in_year_to_date
        ;
Load
*
Inline
[
id,date,amount
8188,'01/13/2020',37.23
8189,'02/26/2020',17.17
8190,'03/27/2020',88.27
8191,'04/16/2020',57.42
8192,'05/21/2020',53.80
8193,'06/14/2020',82.06
8194,'08/07/2020',40.39
8195,'09/05/2020',87.21
8196,'01/22/2021',95.93
8197,'02/03/2021',45.89
8198,'03/17/2021',36.23
8199,'04/23/2021',25.66
8200,'05/04/2021',82.77
8201,'06/30/2021',69.98
8202,'07/26/2021',76.11
8203,'07/27/2021',25.12
8204,'06/06/2022',46.23
8205,'07/18/2022',84.21
8206,'11/14/2022',96.24
8207,'12/12/2022',67.67
];

Resultados

Cargue los datos y abra una hoja. Cree una nueva tabla y agregue estos campos como dimensiones:

date
in_year_to_date

Tabla de resultados
date	in_year_to_date
01/13/2020	0
02/26/2020	0
03/27/2020	0
04/16/2020	0
05/21/2020	0
06/14/2020	0
08/07/2020	0
09/05/2020	0
01/22/2021	0
02/03/2021	0
03/17/2021	-1
04/23/2021	-1
05/04/2021	-1
06/30/2021	-1
07/26/2021	-1
07/27/2021	0
06/06/2022	0
07/18/2022	0
11/14/2022	0
12/12/2022	0

Usando 3 como el argumento de first_month_of_year en la función inyeartodate(), la función comienza el año el 1 de marzo. La base_date del 26 de julio de 2021 luego establece la fecha de finalización de ese segmento de año.

En consecuencia, cualquier transacción que ocurra entre el 1 de marzo y el 26 de julio arrojará un resultado booleano de TRUE, mientras que las transacciones con fechas fuera de estos límites devolverán un valor de FALSE.

Ejemplo 4: ejemplo de objeto gráfico

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 el mismo conjunto de datos y escenario que el primer ejemplo. Sin embargo, en este ejemplo, el conjunto de datos sin modificar se carga en la aplicación. El cálculo que determina qué transacciones tuvieron lugar en el mismo año hasta el 26 de julio de 2021 se crea como una medida en un objeto de gráfico en la aplicación.

Script de carga

SET DateFormat='MM/DD/YYYY';

Transactions: 
Load 
* 
Inline  
[ 
id,date,amount 
8188,'01/13/2020',37.23 
8189,'02/26/2020',17.17 
8190,'03/27/2020',88.27 
8191,'04/16/2020',57.42 
8192,'05/21/2020',53.80 
8193,'06/14/2020',82.06 
8194,'08/07/2020',40.39 
8195,'09/05/2020',87.21 
8196,'01/22/2021',95.93 
8197,'02/03/2021',45.89 
8198,'03/17/2021',36.23 
8199,'04/23/2021',25.66 
8200,'05/04/2021',82.77 
8201,'06/30/2021',69.98 
8202,'07/26/2021',76.11 
8203,'07/27/2021',25.12 
8204,'06/06/2022',46.23 
8205,'07/18/2022',84.21 
8206,'11/14/2022',96.24 
8207,'12/12/2022',67.67
];

Resultados

Cargue los datos y abra una hoja. Cree una nueva tabla y agregue este campo como dimensión:date.

Cree la siguiente medida:

=inyeartodate(date,'07/26/2021', 0)

Tabla de resultados
date	=inyeartodate(date,'07/26/2021', 0)
01/13/2020	0
02/26/2020	0
03/27/2020	0
04/16/2020	0
05/21/2020	0
06/14/2020	0
08/07/2020	0
09/05/2020	0
01/22/2021	-1
02/03/2021	-1
03/17/2021	-1
04/23/2021	-1
05/04/2021	-1
06/30/2021	-1
07/26/2021	-1
07/27/2021	0
06/06/2022	0
07/18/2022	0
11/14/2022	0
12/12/2022	0

La medida in_year_to_date se crea en el objeto gráfico usando la función inyeartodate(). El primer argumento proporcionado identifica qué campo se está evaluando. El segundo argumento es una fecha codificada para el 26 de julio de 2021, que es la base_date que identifica el límite final del segmento del año de comparación. Un period_no de 0 es el argumento final, lo que significa que la función no compara los años que preceden o siguen al año segmentado.

Cualquier transacción que ocurra entre el 1 de enero y el 26 de julio de 2021 devuelve un resultado booleano de TRUE. Las fechas de transacciones anteriores a 2021 y posteriores al 26 de julio de 2021 devuelven FALSE.

Ejemplo 5: Escenario

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 que se carga en una tabla denominada Products.
Información relativa a la identificación del producto, tipo de producto, fecha de fabricación y precio de coste.

Al usuario final le gustaría un objeto de gráfico que muestre, por tipo de producto, el coste de producción de los productos fabricados en 2021 hasta el 26 de julio.

Script de carga

Products:
Load
*
Inline
[
product_id,product_type,manufacture_date,cost_price
8188,product A,'01/13/2020',37.23
8189,product B,'02/26/2020',17.17
8190,product B,'03/27/2020',88.27
8191,product C,'04/16/2020',57.42
8192,product D,'05/21/2020',53.80
8193,product D,'08/14/2020',82.06
8194,product C,'10/07/2020',40.39
8195,product B,'12/05/2020',87.21
8196,product A,'01/22/2021',95.93
8197,product B,'02/03/2021',45.89
8198,product C,'03/17/2021',36.23
8199,product C,'04/23/2021',25.66
8200,product B,'05/04/2021',82.77
8201,product D,'06/30/2021',69.98
8202,product D,'07/26/2021',76.11
8203,product D,'12/27/2021',25.12
8204,product C,'06/06/2022',46.23
8205,product C,'07/18/2022',84.21
8206,product A,'11/14/2022',96.24
8207,product B,'12/12/2022',67.67
];

Resultados

Cargue los datos y abra una hoja. Cree una nueva tabla y agregue este campo como dimensión:product_type.

Cree una medida que calcule la suma de cada producto que se fabricó en 2021 antes del 27 de julio:

=sum(if(inyeartodate(manufacture_date,makedate(2021,07,26),0),cost_price,0))

Establezca el Formato numérico de la medida en Moneda.

Tabla de resultados
product_type	=sum(if(inyeartodate(manufacture_date,makedate(2021,07,26),0),cost_price,0))
producto A	$95.93
producto B	$128.66
producto C	$61.89
producto D	$146.09

La función inyeartodate() devuelve un valor booleano al evaluar las fechas de fabricación de cada uno de los productos. Para cualquier producto fabricado en 2021 antes del 27 de julio, la función inyeartodate() devuelve un valor booleano de TRUE y suma el cost_price.

El Producto D es el único producto que también se fabricó después del 26 de julio de 2021. La entrada con product_ID 8203 se fabricó el 27 de diciembre y costó 25,12 $. Por lo tanto, este costo no se incluyó en el total del Producto D en el objeto gráfico.

EN ESTA PÁGINA

inyeartodate - función de script y de gráfico

Cuándo se utiliza

Configuraciones regionales

Ejemplo 1: sin argumentos adicionales

Ejemplo 2: period_no

Ejemplo 3: first_month_of_year

Ejemplo 4: ejemplo de objeto gráfico

Ejemplo 5: Escenario