# quartername Función de script y de gráfico

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()`

Diagrama de la función `quartername()`

Diagrama de la función `quartername()`quartername() ![Diagrama a modo de ejemplo que muestra cómo la función quartername convierte una fecha de entrada en un rango de meses contenidos en el trimestre en el que ocurre la fecha.](https://help.qlik.com/es-ES/sense/May2026/Subsystems/Hub/Content/Resources/Images/scripting-functions-quartername-general.png)

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.

Argumentos

| 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.

Ejemplos de funciones

| 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.

La configuración regional predeterminada en las aplicaciones 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 Qlik Sense interfaz de usuario. Qlik Sense se mostrará en el mismo idioma que el navegador que esté utilizando.

## Ejemplo 1: la fecha sin argumentos adicionales

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/quartername.htm)

#### Script de carga y resultados

Vista general

Abra el Editor de carga de datos y añada el script de carga inferior en una nueva sección.

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`

Tabla de resultados

| 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 precedente 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

Diagrama de la función `quartername()`, ejemplo sin argumentos adicionales

Diagrama de la función `quartername()`quartername(), ejemplo sin argumentos adicionales ![Diagrama que muestra cómo la función quartername determina el rango de meses del trimestre en el que tiene lugar una transacción.](https://help.qlik.com/es-ES/sense/May2026/Subsystems/Hub/Content/Resources/Images/scripting-functions-quartername-examples-no-add-arg.png)

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 argumento period\_no

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/quartername.htm)

#### Script de carga y resultados

Vista general

Abra el Editor de carga de datos y añada el script de carga inferior en una nueva sección.

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`

Tabla de resultados

| 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

Diagrama de la función `quartername()`, ejemplo de period\_no

Diagrama de la función `quartername()`quartername(), ejemplo de period\_no ![Diagrama que muestra cómo la función quartername determina el rango de meses del trimestre en el que tiene lugar una transacción.](https://help.qlik.com/es-ES/sense/May2026/Subsystems/Hub/Content/Resources/Images/scripting-functions-quartername-examples-period-no.png)

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

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/quartername.htm)

#### Script de carga y resultados

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`

Tabla de resultados

| 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

Diagrama de la función `quartername()`, ejemplo de first\_week\_day

Diagrama de la función `quartername()`quartername(), ejemplo de first\_week\_day ![Diagrama que muestra cómo la función quartername determina el rango de meses del trimestre en el que tiene lugar una transacción.](https://help.qlik.com/es-ES/sense/May2026/Subsystems/Hub/Content/Resources/Images/scripting-functions-quartername-examples-first-week-day.png)

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

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/quartername.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 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 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)

Tabla de resultados

| 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

Diagrama de la función quartername(), ejemplo de objeto gráfico

Diagrama de la función quartername()quartername(), ejemplo de objeto gráfico ![Diagrama que muestra cómo la función quartername determina el rango de meses del trimestre en el que tiene lugar una transacción.](https://help.qlik.com/es-ES/sense/May2026/Subsystems/Hub/Content/Resources/Images/scripting-functions-quartername-examples-chart-object.png)

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 5: Escenario

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/quartername.htm)

#### Script de carga y expresión de gráfico

Vista general

Abra el Editor de carga de datos y añada el script de carga inferior en una nueva sección.

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).

Al usuario final le gustaría tener un objeto gráfico que presente el total de ventas por trimestre de las transacciones. Esto podría lograrse incluso cuando esta dimensión no esté disponible en el modelo de datos, utilizando la función quartername() como una dimensión calculada en el gráfico.

Script de carga

```
SET DateFormat='MM/DD/YYYY';

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/2022',84.21
8206,'10/14/2022',96.24
8207,'10/29/2022',67.67
];
```

Resultados

Haga lo siguiente:

1. Cargue los datos y abra una hoja.Cree una nueva tabla.

2. Cree una dimensión calculada usando la siguiente expresión:

   =quartername(date)

3. A continuación calcule el total de ventas con la siguiente medida de agregación:

   =sum(amount)

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

Tabla de resultados

| =quartername(date) | =sum(amount) |
| --- | --- |
| Jul-Sep 2022 | $446.31 |
| Abr-Jun 2022 | $351.48 |
| Ene-Mar 2022 | $253.89 |
| Oct-Dic 2022 | $163.91 |