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
| 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. |
| 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. 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: ejemplo básico
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
| 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
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
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
| 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
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
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)
| 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
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.