Saltar al contenido principal Saltar al contenido complementario

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

Esta función devuelve un valor correspondiente a la marca de tiempo del primer milisegundo del periodo mensual, bimensual, trimestral, cuatrimestral o semestral que contiene una fecha base. También es posible hallar la marca de tiempo de un periodo anterior o posterior.El formato de salida predefinido es el DateFormat definido en el script.

Sintaxis:  

MonthsStart(n_months, date[, period_no [, first_month_of_year]])

Tipo de datos que devuelve: dual

Diagrama de la función monthsstart()

Diagrama a modo de ejemplo que muestra cómo cada uno de los elementos de la función trabajan de manera conjunta para devolver el resultado de la marca de tiempo.

La función monthsstart() divide el año en segmentos basándose en el argumento n_months proporcionado. Luego evalúa en qué segmento cae cada fecha proporcionada y devuelve el primer milisegundo de ese segmento, en formato de fecha. La función también brinda la capacidad de devolver la marca de tiempo de inicio de los segmentos anteriores o posteriores, así como redefinir cuál habrá de ser el primer mes del año.

Los siguientes segmentos del año están disponibles en la función n_month como argumentos:

Posibles argumentos de n_month
Períodos Número de meses
mes 1
bimestre 2
trimestre 3
cuatrimestre

4

semestre 6
Argumentos
Argumento Descripción
n_months El número de meses que define el periodo. Un entero o expresión que devuelve un entero que debe ser uno de los siguientes: 1 (equivalente a la función inmonth() ), 2 (bimestral), 3 (equivalente a la función inquarter()), 4 (cuatrimestral) o 6 (medio año).
date La fecha o marca de tiempo para evaluar.
period_no El período se puede desplazar mediante period_no, un entero o una expresión que devuelve un entero, donde el valor 0 indica el período que contiene a base_date. Los valores negativos en period_no indican períodos precedentes y los valores positivos indican períodos 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 monthsstart() se suele utilizar como parte de una expresión cuando el usuario desea que el cálculo utilice la fracción de un período que aún no ha transcurrido. Esto podría usarse, por ejemplo, para tener una variable de entrada que permita al usuario calcular el interés total que se ha acumulado hasta el momento en el mes, trimestre o semestre.

Ejemplos de funciones
Ejemplo Resultado
monthsstart(4, '10/19/2013') Devuelve 09/01/2013.
monthsstart(4, '10/19/2013, -1) Devuelve 05/01/2013.
monthsstart(4, '10/19/2013', 0, 2 ) Devuelve 10/01/2013, porque el inicio del año se convierte en el mes 2.

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: sin argumentos adicionales

Ejemplo 2: period_no

Ejemplo 3: first_month_of_year

Ejemplo 4: ejemplo de objeto gráfico

Ejemplo 5: escenario

¿Esta página le ha sido útil?

No dude en indicarnos en qué podemos mejorar si encuentra algún problema en esta página o su contenido, como, por ejemplo, errores tipográficos, pasos que falta o errores técnicos.