Funciones de fecha y hora

Las funciones de fecha y hora de QlikView se usan para transformar y convertir valores de fecha y hora. Todas las funciones pueden utilizarse tanto en el script de carga como en las expresiones de gráficos.

Las funciones están basadas en un número de serie de fecha-hora que es igual al número de días transcurridos desde el 30 de diciembre de 1899. El valor entero representa el día, y el valor fraccional representa la hora del día.

QlikView utiliza el valor numérico del parámetro, por tanto, un número también es válido como parámetro cuando no tiene formato de fecha u hora. Si el parámetro no se corresponde con el valor numérico, p. ej. si fuera una cadena, entonces QlikView trata de interpretar la cadena conforme a las variables de fecha y hora del sistema operativo.

Si el formato de hora utilizado en el parámetro no se corresponde con el establecido en el sistema operativo, QlikView no podrá realizar una interpretación correcta. Para resolver este problema, modifique la configuración o bien utilice una función de interpretación.

En los ejemplos de cada función, se asumen los formatos de fecha y hora predefinidos hh:mm:ss yYYYY-MM-DD (ISO 8601).

Cuando se procesa una fecha-hora con una función de fecha u hora, QlikView ignora cualquier ajuste de cambio horario a menos que la función de fecha u hora incluya una posición geográfica.

Por ejemplo, ConvertToLocalTime( filetime('Time.qvd'), 'Paris') tendría en cuenta ajustes de cambio horario mientras que ConvertToLocalTime(filetime('Time.qvd'), 'GMT-01:00') no lo haría.

Utilice el desplegable de cada función para ver una breve descripción y la sintaxis de cada función. Haga clic en el nombre de la función en la descripción de la sintaxis si desea más detalles.

Expresiones de tiempo con enteros

Esta función devuelve un entero que representa el segundo en que la fracción de la expression se interpreta como una hora conforme a la interpretación numérica estándar.

second(expression)

Esta función devuelve un entero que representa el minuto en el que la fracción de la expression se interpreta como una hora conforme a la interpretación numérica estándar.

minute(expression)

Esta función devuelve un entero que representa la hora en que la fracción de la expression se interpreta como una hora de acuerdo con la interpretación numérica estándar.

hour(expression)

Esta función devuelve un entero que representa el día en que la fracción de la expression se interpreta como una fecha conforme a la interpretación numérica estándar.

day(expression)

Esta función devuelve un entero que representa el número de semana conforme a la ISO 8601. El número de semana se calcula a partir de la interpretación de la fecha de la expresión, conforme a la interpretación numérica estándar.

week(timestamp [, first_week_day [, broken_weeks [, reference_day]]])

Esta función devuelve un valor dual con un nombre de mes tal y como venga definido en la variable de entorno MonthNames y un entero entre 1-12. El mes se calcula a partir de la interpretación de la fecha de la expresión, conforme a la interpretación numérica estándar.

month(expression)

Esta función devuelve un entero que representa el año en que la expression se interpreta como una fecha conforme a la interpretación numérica estándar.

year(expression)

Esta función devuelve el año al que pertenece el número de semana conforme a la ISO 8601. El número de semana varía entre 1 y 52 aproximadamente.

weekyear(expression)

Esta función devuelve un valor dual con lo siguiente: El nombre del día del modo definido en la variable de entorno DayNames. Un número entero entre 0 y 6 correspondiente al día nominal de la semana (0-6).

weekday(date)

Funciones de indicación de tiempo

Esta función devuelve una fecha-hora con la hora actual según el reloj del sistema. El valor por defecto es 1.

now([ timer_mode])

Esta función devuelve la fecha actual según el reloj del sistema.

today([timer_mode])

Esta función devuelve una fecha y hora con la hora actual según el reloj del sistema y una determinada zona horaria.

localtime([timezone [, ignoreDST ]])

Funciones make

Esta función devuelve una fecha calculada desde el año YYYY, el mes MM y el dia DD.

makedate(YYYY [ , MM [ , DD ] ])

Esta función devuelve una fecha calculada a partir del año YYYY, la semana WW y el día de la semana D.

makeweekdate(YYYY [ , WW [ , D ] ])

Esta función devuelve una hora calculada a partir del año hh, el minuto mm y los segundos ss.

maketime(hh [ , mm [ , ss [ .fff ] ] ])

Otras funciones de tiempo

Esta función devuelve la fecha que ocurre n meses después de startdate o, si n es negativa, la fecha que ocurre n meses antes de startdate.

addmonths(startdate, n , [ , mode])

Esta función devuelve la fecha que ocurre n años después de startdate o, si n es negativa, la fecha que ocurre n años antes de startdate.

addyears(startdate, n)

Esta función encuentra si la fecha de entrada cae en el año de la fecha en la que se cargó el script, y devuelve True en caso afirmativo, y False en caso negativo.

yeartodate(timestamp [ , yearoffset [ , firstmonth [ , todaydate] ] ])

Funciones de zona horaria

Esta función devuelve el nombre de la actual zona horaria, según lo definido en Windows, sin tener en cuenta el ajuste del horario de verano.

timezone( )

Esta función devuelve la fecha y hora actual según Greenwich Mean Time, tal y como lo extrae del reloj del sistema y las configuraciones horarias de Windows.

GMT( )

Devuelve la fecha y la hora actual según Coordinated Universal Time.

UTC( )

Devuelve el ajuste actual de cambio de hora automático, según el horario de verano, tal y como se define en Windows.

daylightsaving( )

Convierte una fecha-hora UTC o GMT a una hora local, con la forma de un valor dual. El lugar puede ser cualquier ciudad o zona horaria del mundo.

converttolocaltime(timestamp [, place [, ignore_dst=false]])

Funciones de establecimiento de hora

Esta función toma como entrada una fecha-hora timestamp y un año year y actualiza la fecha-hora timestamp con el año year especificado.

setdateyear (timestamp, year)

Esta función toma como entrada una fecha-hora timestamp, un mes month y un año year y actualiza la fecha-hora timestamp con el año year y el mes month especificados.

setdateyearmonth (timestamp, year, month)

Funciones in...

Esta función devuelve True si timestamp se encuentra dentro del año que contiene base_date.

inyear(date, basedate , shift [, first_month_of_year = 1])

Esta función devuelve True si timestamp se encuentra dentro de la parte del año que contiene base_date hasta e incluido el último milisegundo de base_date.

inyeartodate (date, basedate , shift [, first_month_of_year = 1])

Esta función devuelve True si timestamp se encuentra dentro del trimestre que contiene base_date.

inquarter (date, basedate , shift [, first_month_of_year = 1])

Esta función devuelve True si timestamp se encuentra dentro de la parte del trimestre que contiene base_date hasta e incluido el último milisegundo de base_date.

inquartertodate (date, basedate , shift [, first_month_of_year = 1])

Esta función devuelve True si timestamp se encuentra dentro del mes que contiene base_date.

inmonth(date, basedate , shift)

Esta función de script devuelve True si timestamp cae dentro de la parte del mes que contiene base_date hasta e incluido el último milisegundo de base_date.

inmonthtodate (date, basedate , shift)

Esta función determina si una fecha-hora se encuentra dentro del mismo mes, período bimensual, trimestral, cuatrimestral o semestral que fecha base. También es posible hallar si la fecha-hora cae dentro de un período anterior o posterior.

inmonths(n, date, basedate , shift [, first_month_of_year = 1])

Esta función halla si una fecha-hora se encuentra dentro de parte de un período mensual, bimensual, trimestral, cuatrimestral o semestral hasta e incluido el último milisegundo de base_date. También es posible hallar si la fecha-hora cae dentro de un período anterior o posterior.

inmonthstodate (n, date, basedate , shift [, first_month_of_year = 1])

Esta función devuelve True si timestamp se encuentra dentro de la semana que contiene base_date.

inweek(date, basedate , shift [, weekstart])

Esta función devuelve True si timestamp cae dentro de la parte de la semana que contiene base_date hasta e incluido el último milisegundo de base_date.

inweektodate (date, basedate , shift [, weekstart])

Esta función devuelve verdadero si timestamp se encuentra dentro de la semana lunar que contiene a base_date. Las semanas lunares en QlikView se definen contando 1 de enero como el primer día de la semana.

inlunarweek (date, basedate , shift [, weekstart])

Esta función devuelve verdadero si timestamp se encuentra dentro de la parte de la semana lunar hasta e incluido el último milisegundo de base_date. Las semanas lunares en QlikView se definen contando 1 de enero como el primer día de la semana.

inlunarweektodate (date, basedate , shift [, weekstart])

Esta función devuelve True si timestamp se encuentra dentro del día que contiene base_timestamp.

inday(timestamp, basetimestamp , shift [, daystart])

Esta función devuelve True si timestamp se encuentra dentro de la parte del día que contiene base_timestamp hasta e incluido el milisegundo exacto de base_timestamp.

indaytotime(timestamp, basetimestamp , shift [, daystart])

Funciones start ... end

Esta función devuelve una indicación de fecha y hora correspondiente al inicio del primer día del año que contiene a la fecha date. El formato de salida por defecto será el DateFormat definido en el script.

yearstart( date [, shift = 0 [, first_month_of_year = 1]])

Esta función devuelve un valor correspondiente a una fecha-hora con el último milisegundo del último día del año que contiene la fecha date. El formato de salida por defecto será el DateFormat definido en el script.

yearend( date [, shift = 0 [, first_month_of_year = 1]])

Esta función devuelve un año de cuatro dígitos con un valor numérico correspondiente a una fecha-hora con el primer milisegundo del primer día del año en el que se incluye date.

yearname(date [, shift = 0 [, first_month_of_year = 1]] )

Esta función devuelve un valor correspondiente a una indicación de fecha y hora con el primer milisegundo del trimestre que contiene a date. El formato de salida por defecto será el DateFormat definido en el script.

quarterstart(date [, shift = 0 [, first_month_of_year = 1]])

Esta función devuelve un valor correspondiente a una indicación de fecha y hora con el último milisegundo del trimestre que contiene la date. El formato de salida por defecto será el DateFormat definido en el script.

quarterend(date [, shift = 0 [, first_month_of_year = 1]])

Esta función devuelve un valor que muestra los meses del trimestre (formateado conforme a la variable de script MonthNames) y el año, con un valor numérico subyacente correspondiente a una fecha y hora con el primer milisegundo del primer día del trimestre.

quartername(date [, shift = 0 [, first_month_of_year = 1]])

Esta función devuelve un valor correspondiente a una indicación de fecha y hora con el primer milisegundo del primer día del mes que contiene la fecha date. El formato de salida por defecto será el DateFormat definido en el script.

monthstart(date [, shift = 0])

Esta función devuelve un valor correspondiente a una fecha y hora con el último milisegundo del último día del mes que contiene la fecha date. El formato de salida por defecto será el DateFormat definido en el script.

monthend(date [, shift = 0])

Esta función devuelve un valor que muestra el mes (formateado según la variable de script MonthNames) y el año, con un valor numérico subyacente correspondiente a una fecha y hora con el primer milisegundo del primer día del mes.

monthname(date [, shift = 0])

Esta función devuelve un valor correspondiente a la fecha y hora del primer milisegundo del mes, bimestre, trimestre, cuatrimestre o semestre que contiene una fecha base. También es posible hallar la fecha-hora de un período anterior o posterior.

monthsstart(n, date [, shift = 0 [, first_month_of_year = 1]])

Esta función devuelve el último milisegundo del mes, bimestre, trimestre, cuatrimestre o semestre que contiene una fecha base. También es posible hallar la fecha-hora de un período anterior o posterior.

monthsend(n, date [, shift = 0 [, first_month_of_year = 1]])

Esta función devuelve un valor de visualización que representa el rango de meses del período (con el mismo formato que la variable de script MonthNames), así como el año. El valor numérico corresponde a una fecha y hora del primer milisegundo del mes, bimestre, trimestre, cuatrimestre o semestre que contiene una fecha base.

monthsname(n, date [, shift = 0 [, first_month_of_year = 1]])

Esta función devuelve un valor correspondiente a una indicación de fecha y hora con el primer milisegundo del primer día (Lunes) de la semana natural que contiene la fecha date. El formato de salida predeterminado es el DateFormat definido en el script.

weekstart(date [, shift = 0 [,weekoffset = 0]])

Esta función devuelve un valor correspondiente a una indicación de fecha y hora con el último milisegundo del último día (Domingo) de la semana natural que contiene la fecha date. El formato de salida por defecto será el DateFormat definido en el script.

weekend(date [, shift = 0 [,weekoffset = 0]])

Esta función devuelve un valor que muestra el año y el número de semana, con un valor numérico subyacente correspondiente a una indicación de fecha y hora con el primer milisegundo del primer día de la semana que contiene a date.

weekname(date [, shift = 0 [,weekoffset = 0]])

Esta función devuelve un valor correspondiente a una fecha y hora con el primer milisegundo de la semana lunar en la que se incluye date. Las semanas lunares en QlikView se definen contando 1 de enero como el primer día de la semana.

lunarweekstart(date [, shift = 0 [,weekoffset = 0]])

Esta función devuelve un valor correspondiente a una indicación de fecha y hora con el último milisegundo de la semana lunar que contiene la date. Las semanas lunares en QlikView se definen contando 1 de enero como el primer día de la semana.

lunarweekend(date [, shift = 0 [,weekoffset = 0]])

Esta función devuelve un valor que muestra el año y el número de semana lunar correspondiente a una indicación de fecha y hora con el primer milisegundo del primer día de la semana que contiene a date. Las semanas lunares en QlikView se definen contando 1 de enero como el primer día de la semana.

lunarweekname(date [, shift = 0 [,weekoffset = 0]])

Esta función devuelve un valor correspondiente a una indicación de fecha y hora con el último milisegundo del día contenido en el argumento de time. El formato de salida por defecto será el TimestampFormat definido en el script.

daystart(timestamp [, shift = 0 [, dayoffset = 0]])

Esta función devuelve un valor correspondiente a una indicación de fecha y hora con el último milisegundo del día contenido en time. El formato de salida por defecto será el TimestampFormat definido en el script.

dayend(timestamp [, shift = 0 [, dayoffset = 0]])

Esta función devuelve un valor de fecha, con un valor numérico subyacente correspondiente a una fecha-hora con el primer milisegundo del día que contiene a time.

dayname(timestamp [, shift = 0 [, dayoffset = 0]])

Funciones de número de día

La función age devuelve la edad en el momento indicado en timestamp (en años completos) de alguien nacido en date_of_birth.

age(timestamp, date_of_birth)

La función networkdays devuelve el número de días laborables (Lunes-Viernes) situados entre start_date y end_date (ambos inclusive) teniendo en cuenta la lista opcional de holiday.

networkdays (start:date, end_date {, holiday})

La función firstworkdate devuelve la última fecha de inicio para obtener un no_of_workdays (de lunes a viernes) sin sobrepasar end_date teniendo en cuenta la lista opcional de vacaciones. end_date y holiday deberían ser fechas o fecha-hora válidas.

firstworkdate(end_date, no_of_workdays {, holiday} )

La función lastworkdate devuelve la primera fecha de finalización para obtener el no_of_workdays (Lunes-Viernes) si comienza en start_date y teniendo en cuenta cualquier vacaciones holiday opcionalmente indicadas. start_date y holiday deben ser fechas o indicaciones de fecha-hora válidas.

lastworkdate(start_date, no_of_workdays {, holiday})

Esta función calcula el número de día del año en el que cae una fecha-hora. El cálculo se hace a partir del primer milisegundo del primer día del año, pero el primer mes puede desplazarse.

daynumberofyear(date[,firstmonth])

Esta función calcula el número de día del trimestre en el que cae una fecha-hora.

daynumberofquarter(date[,firstmonth])

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

Deje aquí sus comentarios