Esta función devuelve un valor de visualización que muestra los meses del trimestre (con formato conforme a la variable de script MonthNames) y el año con un valor numérico subyacente correspondiente a una marca de tiempo (una fecha-hora) del primer milisegundo del primer día del trimestre.
Sintaxis:
QuarterName(date[, period_no[, first_month_of_year]])
Tipo de datos que devuelve: dual
Diagrama de la función quartername()
La función quartername() determina en qué trimestre cae la fecha. A continuación, devuelve un valor que muestra los meses de inicio y fin de este trimestre, así como el año. El valor numérico subyacente de este resultado es el primer milisegundo del trimestre.
| Argumento | Descripción |
|---|---|
| date | La fecha o marca de tiempo para evaluar. |
| period_no | period_no es un entero, donde el valor 0 indica el trimestre que contiene a date. Los valores negativos en period_no indican trimestres precedentes y los valores positivos indican trimestres 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 quartername() es útil cuando se desea comparar agregaciones por trimestre. Por ejemplo, si desea ver el total de ventas de productos por trimestre.
Esta función podría usarse en el script de carga para crear un campo en una tabla de calendario maestro. Alternativamente, podría usarse directamente en un gráfico como una dimensión calculada.
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.
| Ejemplo | Resultado |
|---|---|
| quartername('10/29/2013') | Devuelve Oct-Dec 2013. |
| quartername('10/29/2013', -1) | Devuelve Jul-Sep 2013. |
| quartername('10/29/2013', 0, 3) | Devuelve Sep-Nov 2013. |
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 para aplicaciones y scripts.
La configuración regional predeterminada en las aplicaciones se basa en el perfil de usuario. 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 y scripts en Analítica de Qlik Cloud.
Ejemplo 1: la fecha 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 de 2022, que se carga en una tabla llamada "Transactions".
-
El campo de fecha proporcionado en el formato de la variable del sistema DateFormat: (MM/DD/AAAA).
-
La creación de un campo, transaction_quarter, que devuelve el trimestre en el que se realizaron las transacciones.
Agregue su otro texto aquí, según sea necesario, con listas, etc.
Script de carga
SET DateFormat='MM/DD/YYYY';
SET MonthNames='Jan;Feb;Mar;Apr;May;Jun;Jul;Aug;Sep;Oct;Nov;Dec';
Transactions:
Load
*,
quartername(date) as transaction_quarter
;
Load
*
Inline
[
id,date,amount
8188,1/7/2022,17.17
8189,1/19/2022,37.23
8190,2/28/2022,88.27
8191,2/5/2022,57.42
8192,3/16/2022,53.80
8193,4/1/2022,82.06
8194,5/7/2022,40.39
8195,5/16/2022,87.21
8196,6/15/2022,95.93
8197,6/26/2022,45.89
8198,7/9/2022,36.23
8199,7/22/2022,25.66
8200,7/23/2022,82.77
8201,7/27/2022,69.98
8202,8/2/2022,76.11
8203,8/8/2022,25.12
8204,8/19/2022,46.23
8205,9/26/2022,84.21
8206,10/14/2022,96.24
8207,10/29/2022,67.67
];Resultados
Cargue los datos y abra una hoja. Cree una nueva tabla y agregue estos campos como dimensiones:
-
date
-
transaction_quarter
| date | transaction_quarter |
|---|---|
| 1/7/2022 | Ene-Mar 2022 |
| 1/19/2022 | Ene-Mar 2022 |
| 2/5/2022 | Ene-Mar 2022 |
| 2/28/2022 | Ene-Mar 2022 |
| 3/16/2022 | Ene-Mar 2022 |
| 4/1/2022 | Abr-Jun 2022 |
| 5/7/2022 | Abr-Jun 2022 |
| 5/16/2022 | Abr-Jun 2022 |
| 6/15/2022 | Abr-Jun 2022 |
| 6/26/2022 | Abr-Jun 2022 |
| 7/9/2022 | Jul-Sep 2022 |
| 7/22/2022 | Jul-Sep 2022 |
| 7/23/2022 | Jul-Sep 2022 |
| 7/27/2022 | Jul-Sep 2022 |
| 8/2/2022 | Jul-Sep 2022 |
| 8/8/2022 | Jul-Sep 2022 |
| 8/19/2022 | Jul-Sep 2022 |
| 9/26/2022 | Jul-Sep 2022 |
| 10/14/2022 | Oct-Dic 2022 |
| 10/29/2022 | Oct-Dic 2022 |
El campo transaction_quarter se crea en la instrucción load anterior utilizando la función quartername() e introduciendo el campo de fecha como argumento de la función.
La función quartername() identifica inicialmente el trimestre en el que cae el valor de la fecha. Después devuelve un valor que muestra los meses de inicio y finalización de este trimestre, así como el año.
Diagrama de la función quartername(), ejemplo sin argumentos adicionales
La transacción 8203 tuvo lugar el 8 de agosto de 2022. La función quartername() identifica que la transacción tuvo lugar en el tercer trimestre y, por lo tanto, devuelve julio-septiembre de 2022. Los meses se muestran en el mismo formato que la variable del sistema MonthNames.
Ejemplo 2: fecha con el argumento de 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_quarter, que devuelve el trimestre anterior a que se realizaran las transacciones.
Script de carga
SET DateFormat='MM/DD/YYYY';
SET MonthNames='Jan;Feb;Mar;Apr;May;Jun;Jul;Aug;Sep;Oct;Nov;Dec';
Transactions:
Load
*,
quartername(date,-1) as previous_quarter
;
Load
*
Inline
[
id,date,amount
8188,1/7/2022,17.17
8189,1/19/2022,37.23
8190,2/28/2022,88.27
8191,2/5/2022,57.42
8192,3/16/2022,53.80
8193,4/1/2022,82.06
8194,5/7/2022,40.39
8195,5/16/2022,87.21
8196,6/15/2022,95.93
8197,6/26/2022,45.89
8198,7/9/2022,36.23
8199,7/22/2022,25.66
8200,7/23/2022,82.77
8201,7/27/2022,69.98
8202,8/2/2022,76.11
8203,8/8/2022,25.12
8204,8/19/2022,46.23
8205,9/26/2022,84.21
8206,10/14/2022,96.24
8207,10/29/2022,67.67
];Resultados
Cargue los datos y abra una hoja. Cree una nueva tabla y agregue estos campos como dimensiones:
-
date
-
previous_quarter
| date | previous_quarter |
|---|---|
| 1/7/2022 | Oct-Dic 2021 |
| 1/19/2022 | Oct-Dic 2021 |
| 2/5/2022 | Oct-Dic 2021 |
| 2/28/2022 | Oct-Dic 2021 |
| 3/16/2022 | Oct-Dic 2021 |
| 4/1/2022 | Ene-Mar 2022 |
| 5/7/2022 | Ene-Mar 2022 |
| 5/16/2022 | Ene-Mar 2022 |
| 6/15/2022 | Ene-Mar 2022 |
| 6/26/2022 | Ene-Mar 2022 |
| 7/9/2022 | Abr-Jun 2022 |
| 7/22/2022 | Abr-Jun 2022 |
| 7/23/2022 | Abr-Jun 2022 |
| 7/27/2022 | Abr-Jun 2022 |
| 8/2/2022 | Abr-Jun 2022 |
| 8/8/2022 | Abr-Jun 2022 |
| 8/19/2022 | Abr-Jun 2022 |
| 9/26/2022 | Abr-Jun 2022 |
| 10/14/2022 | Jul-Sep 2022 |
| 10/29/2022 | Jul-Sep 2022 |
En este caso, debido a que se usó un period_no de -1 como argumento del desplazamiento en la función quartername(), la función primero identifica que las transacciones se realizaron en el tercer trimestre. Luego se desplaza un trimestre anterior y devuelve un valor que muestra los meses de inicio y finalización de este trimestre, así como el año.
Diagrama de la función quartername(), ejemplo de period_no
La transacción 8203 tuvo lugar el 8 de agosto. La función quartername() identifica que el trimestre anterior a la transacción fue entre el 1 de abril y el 30 de junio. Por lo tanto, devuelve de abril a junio de 2022.
Ejemplo 3: fecha con el argumento de first_week_day
Vista general
Abra el editor de carga de datos y agregue el script de carga a continuación en 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, necesitamos establecer el 1 de marzo como el comienzo del año fiscal.
Script de carga
SET DateFormat='MM/DD/YYYY';
SET MonthNames='Jan;Feb;Mar;Apr;May;Jun;Jul;Aug;Sep;Oct;Nov;Dec';
Transactions:
Load
*,
quartername(date,0,3) as transaction_quarter
;
Load
*
Inline
[
id,date,amount
8188,1/7/2022,17.17
8189,1/19/2022,37.23
8190,2/28/2022,88.27
8191,2/5/2022,57.42
8192,3/16/2022,53.80
8193,4/1/2022,82.06
8194,5/7/2022,40.39
8195,5/16/2022,87.21
8196,6/15/2022,95.93
8197,6/26/2022,45.89
8198,7/9/2022,36.23
8199,7/22/2022,25.66
8200,7/23/2022,82.77
8201,7/27/2022,69.98
8202,8/2/2022,76.11
8203,8/8/2022,25.12
8204,8/19/2022,46.23
8205,9/26/2022,84.21
8206,10/14/2022,96.24
8207,10/29/2022,67.67
];Resultados
Cargue los datos y abra una hoja. Cree una nueva tabla y agregue estos campos como dimensiones:
-
date
-
transaction_quarter
| date | transaction_quarter |
|---|---|
| 1/7/2022 | Dic-Feb 2021 |
| 1/19/2022 | Dic-Feb 2021 |
| 2/5/2022 | Dic-Feb 2021 |
| 2/28/2022 | Dic-Feb 2021 |
| 3/16/2022 | Mar-May 2022 |
| 4/1/2022 | Mar-May 2022 |
| 5/7/2022 | Mar-May 2022 |
| 5/16/2022 | Mar-May 2022 |
| 6/15/2022 | Jun-Ago 2022 |
| 6/26/2022 | Jun-Ago 2022 |
| 7/9/2022 | Jun-Ago 2022 |
| 7/22/2022 | Jun-Ago 2022 |
| 7/23/2022 | Jun-Ago 2022 |
| 7/27/2022 | Jun-Ago 2022 |
| 8/2/2022 | Jun-Ago 2022 |
| 8/8/2022 | Jun-Ago 2022 |
| 8/19/2022 | Jun-Ago 2022 |
| 9/26/2022 | Sep-Nov 2022 |
| 10/14/2022 | Sep-Nov 2022 |
| 10/29/2022 | Sep-Nov 2022 |
En este caso, como se usa el argumento first_month_of_year de 3 en la función quartername(), el comienzo del año se mueve del 1 de enero al 1 de marzo. Por lo tanto, los trimestres del año se separan en marzo-mayo, junio-agosto, septiembre-noviembre y diciembre-febrero.
Diagrama de la función quartername(), ejemplo de first_week_day
La transacción 8203 tuvo lugar el 8 de agosto. La función quartername() identifica que la transacción se realizó en el segundo trimestre, entre principios de junio y finales de agosto. Por lo tanto, devuelve de junio a agosto de 2022.
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 en 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 devuelve una marca de tiempo del final del trimestre en que se realizaron las transacciones se crea como una medida en un objeto gráfico de la aplicación.
Script de carga
Transactions:
Load
*
Inline
[
id,date,amount
8188,1/7/2022,17.17
8189,1/19/2022,37.23
8190,2/28/2022,88.27
8191,2/5/2022,57.42
8192,3/16/2022,53.80
8193,4/1/2022,82.06
8194,5/7/2022,40.39
8195,5/16/2022,87.21
8196,6/15/2022,95.93
8197,6/26/2022,45.89
8198,7/9/2022,36.23
8199,7/22/2022,25.66
8200,7/23/2022,82.77
8201,7/27/2022,69.98
8202,8/2/2022,76.11
8203,8/8/2022,25.12
8204,8/19/2022,46.23
8205,9/26/022,84.21
8206,10/14/2022,96.24
8207,10/29/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:
=quartername(date)
| date | =quartername(date) |
|---|---|
| 1/7/2022 | Ene-Mar 2022 |
| 1/19/2022 | Ene-Mar 2022 |
| 2/5/2022 | Ene-Mar 2022 |
| 2/28/2022 | Ene-Mar 2022 |
| 3/16/2022 | Ene-Mar 2022 |
| 4/1/2022 | Abr-Jun 2022 |
| 5/7/2022 | Abr-Jun 2022 |
| 5/16/2022 | Abr-Jun 2022 |
| 6/15/2022 | Abr-Jun 2022 |
| 6/26/2022 | Abr-Jun 2022 |
| 7/9/2022 | Jul-Sep 2022 |
| 7/22/2022 | Jul-Sep 2022 |
| 7/23/2022 | Jul-Sep 2022 |
| 7/27/2022 | Jul-Sep 2022 |
| 8/2/2022 | Jul-Sep 2022 |
| 8/8/2022 | Jul-Sep 2022 |
| 8/19/2022 | Jul-Sep 2022 |
| 9/26/2022 | Jul-Sep 2022 |
| 10/14/2022 | Oct-Dic 2022 |
| 10/29/2022 | Oct-Dic 2022 |
La medida transaction_quarter se crea en el objeto gráfico utilizando la función quartername() e introduciendo el campo date como argumento de la función.
La función quartername() identifica inicialmente el trimestre en el que cae el valor de la fecha. Después devuelve un valor que muestra los meses de inicio y finalización de este trimestre, así como el año.
Diagrama de la función quartername(), ejemplo de objeto gráfico
La transacción 8203 tuvo lugar el 8 de agosto de 2022. La función quartername() identifica que la transacción tuvo lugar en el tercer trimestre y, por lo tanto, devuelve julio-septiembre de 2022. Los meses se muestran en el mismo formato que la variable del sistema MonthNames.