# monthname - función de script y de gráfico

Esta función devuelve un valor de visualización que muestra el mes (con formato de acuerdo con la variable de script MonthNames) y el año con un valor numérico subyacente correspondiente a una marca de tiempo (fecha-hora) del primer milisegundo del primer día del mes.

Sintaxis:

MonthName(date[, period\_no])

Tipo de datos que devuelve: dual

Diagrama de la función monthname

Diagrama de la función monthname

Diagrama de la función monthname ![Diagrama de ejemplo de la función monthname, que muestra cómo la función devuelve el resultado combinado de un mes y un año cuando se le suministra una fecha de entrada específica.](https://help.qlik.com/es-ES/sense/November2024/Subsystems/Hub/Content/Resources/Images/scripting-functions-monthname-general.png)

Argumentos

| Argumento | Descripción |
| --- | --- |
| date | La fecha o marca de tiempo para evaluar. |
| period\_no | period\_no es un número entero que, si es 0 o se omite, indica el mes que contiene date. Los valores negativos en period\_no indican meses precedentes y los valores positivos indican meses subsiguientes. |

Ejemplos de funciones

| Ejemplo | Resultado |
| --- | --- |
| `monthname('10/19/2013')` | Devuelve Oct 2013 |
| `monthname('10/19/2013', -1)` | Devuelve Sep 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 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: ejemplo básico

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/monthname.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 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_month`, que devuelve el mes en el que se realizaron 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
        *,
        monthname(date) as transaction_month
        ;
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_month`

Tabla de resultados

| date | transaction\_month |
| --- | --- |
| 1/7/2022 | Ene 2022 |
| 1/19/2022 | Ene 2022 |
| 2/5/2022 | Feb 2022 |
| 2/28/2022 | Feb 2022 |
| 3/16/2022 | Mar 2022 |
| 4/1/2022 | Abr 2022 |
| 5/7/2022 | May 2022 |
| 5/16/2022 | May 2022 |
| 6/15/2022 | Jun 2022 |
| 6/26/2022 | Jun 2022 |
| 7/9/2022 | Jul 2022 |
| 7/22/2022 | Jul 2022 |
| 7/23/2022 | Jul 2022 |
| 7/27/2022 | Jul 2022 |
| 8/2/2022 | Ago 2022 |
| 8/8/2022 | Ago 2022 |
| 8/19/2022 | Ago 2022 |
| 9/26/2022 | Sep 2022 |
| 10/14/2022 | Oct 2022 |
| 10/29/2022 | Oct 2022 |

El campo `transaction_month` se crea en la instrucción load anterior utilizando la función `monthname()` e introduciendo el campo `date` como argumento de la función.

Diagrama de la función monthname, ejemplo básico

Diagrama de la función monthname, ejemplo básico

Diagrama de la función monthname, ejemplo básico![Diagrama que muestra los resultados de usar la función monthname para determinar el mes en el que se realizó una transacción.](https://help.qlik.com/es-ES/sense/November2024/Subsystems/Hub/Content/Resources/Images/scripting-functions-monthname-basic-example.png)

La función `monthname()` identifica que la transacción 8192 tuvo lugar en marzo de 2022 y devuelve este valor mediante la variable de sistema `MonthNames`.

## Ejemplo 2: period\_no

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

* Se utilizan el mismo conjunto de datos inline y el mismo escenario que en el primer ejemplo.

* La creación de un campo, `transaction_previous_month`, que devuelve la marca de tiempo del final del mes anterior a la transacción.

Script de carga

```
SET DateFormat='MM/DD/YYYY';
SET MonthNames='Jan;Feb;Mar;Apr;May;Jun;Jul;Aug;Sep;Oct;Nov;Dec';

Transactions:
    Load
        *,
        monthname(date,-1) as transaction_previous_month
        ;
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_previous_month`

Tabla de resultados

| date | transaction\_previous\_month |
| --- | --- |
| 1/7/2022 | Dic 2021 |
| 1/19/2022 | Dic 2021 |
| 2/5/2022 | Ene 2022 |
| 2/28/2022 | Ene 2022 |
| 3/16/2022 | Feb 2022 |
| 4/1/2022 | Mar 2022 |
| 5/7/2022 | Abr 2022 |
| 5/16/2022 | Abr 2022 |
| 6/15/2022 | May 2022 |
| 6/26/2022 | May 2022 |
| 7/9/2022 | Jun 2022 |
| 7/22/2022 | Jun 2022 |
| 7/23/2022 | Jun 2022 |
| 7/27/2022 | Jun 2022 |
| 8/2/2022 | Jul 2022 |
| 8/8/2022 | Jul 2022 |
| 8/19/2022 | Jul 2022 |
| 9/26/2022 | Ago 2022 |
| 10/14/2022 | Sep 2022 |
| 10/29/2022 | Sep 2022 |

En este caso, debido a que se usó un `period_no` de -1 como argumento de desplazamiento en la función `monthname()`, la función primero identifica el mes en el que se realizan las transacciones. Luego cambia a un mes anterior y devuelve el nombre del mes y el año.

Diagrama de la función monthname, ejemplo de period\_no

Diagrama de la función monthname, ejemplo de period\_no

Diagrama de la función monthname, ejemplo de period\_no![Diagrama que muestra los resultados de usar la función monthname para determinar el mes en el que se realizó una transacción.](https://help.qlik.com/es-ES/sense/November2024/Subsystems/Hub/Content/Resources/Images/scripting-functions-monthname-period-no.png)

La transacción 8192 tuvo lugar el 16 de marzo. La función `monthname()` identifica que el mes anterior a la transacción fue febrero y devuelve el mes, en el formato de variable del sistema `MonthNames`, junto con el año 2022.

## Ejemplo 3: ejemplo de objeto gráfico

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

El script de carga contiene el mismo conjunto de datos inline 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 mes en que se realizaron las transacciones se crea como una medida en un objeto gráfico de la aplicación.

Script de carga

```
SET DateFormat='MM/DD/YYYY';
SET MonthNames='Jan;Feb;Mar;Apr;May;Jun;Jul;Aug;Sep;Oct;Nov;Dec';

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

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

Cree la siguiente medida:

`=monthname(date)`

Tabla de resultados

| date | =monthname(date) |
| --- | --- |
| 1/7/2022 | Ene 2022 |
| 1/19/2022 | Ene 2022 |
| 2/5/2022 | Feb 2022 |
| 2/28/2022 | Feb 2022 |
| 3/16/2022 | Mar 2022 |
| 4/1/2022 | Abr 2022 |
| 5/7/2022 | May 2022 |
| 5/16/2022 | May 2022 |
| 6/15/2022 | Jun 2022 |
| 6/26/2022 | Jun 2022 |
| 7/9/2022 | Jul 2022 |
| 7/22/2022 | Jul 2022 |
| 7/23/2022 | Jul 2022 |
| 7/27/2022 | Jul 2022 |
| 8/2/2022 | Ago 2022 |
| 8/8/2022 | Ago 2022 |
| 8/19/2022 | Ago 2022 |
| 9/26/2022 | Sep 2022 |
| 10/14/2022 | Oct 2022 |
| 10/29/2022 | Oct 2022 |

La medida `month_name` se crea en el objeto gráfico utilizando la función `monthname()` e introduciendo el campo `date` como argumento de la función.

Diagrama de la función monthname, ejemplo de objeto gráfico

Diagrama de la función monthname, ejemplo de objeto gráfico

Diagrama de la función monthname, ejemplo de objeto gráfico![Diagrama que muestra los resultados de usar la función monthname para determinar el mes en el que se realizó una transacción.](https://help.qlik.com/es-ES/sense/November2024/Subsystems/Hub/Content/Resources/Images/scripting-functions-monthname-chart-object.png)

La función `monthname()` identifica que la transacción 8192 tuvo lugar en marzo de 2022 y devuelve este valor mediante la variable de sistema `MonthNames`.