Las funciones de fecha y hora de Qlik Sense se usan para transformar y convertir valores de fecha y hora. Todas las funciones pueden utilizarse tanto en el script de carga de datos 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.
Qlik Sense 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 Qlik Sense 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, Qlik Sense 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 para cada función, se asumen los formatos de fecha y hora hh:mm:ss y YYYY-MM-DD (ISO 8601) predeterminados.
Al procesar una marca de fecha-hora con una función de fecha u hora, Qlik Sense ignora todo parámetro 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') utilizaría los parámetros del horario de verano, mientras que ConvertToLocalTime(filetime('Time.qvd'), 'GMT-01:00') no utilizaría los parámetros del horario de verano.
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 expression se interpreta como una hora de acuerdo con la interpretación numérica estándar.
second(expression)
Esta función devuelve un entero que representa el minuto en que la fracción de la expression se interpreta como una hora de acuerdo con 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 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 expression se interpreta como una fecha de acuerdo con 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(expression)
Esta función devuelve un valor dual: un nombre de mes tal como se define 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 expression se interpreta como una fecha de acuerdo con 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:
- Un nombre de día tal como se define 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 marca de tiempo con la hora actual. La función devuelve valores en el formato de la variable del sistema TimeStamp. El valor predeterminado es 1 timer_mode.
now([ timer_mode])
Esta función devuelve la fecha actual. La función devuelve valores en el formato de la variable del sistema DateFormat.
today([timer_mode])
Esta función devuelve una marca de tiempo con la hora actual para una zona horaria especificada.
localtime([timezone [, ignoreDST ]])
Funciones make
Esta función devuelve una fecha calculada a partir del año YYYY, el mes MM y el día 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 de la hora hh, el minuto mm y el segundo ss.
maketime(hh [ , mm [ , ss [ .fff ] ] ])
Otras funciones de tiempo
Esta función devuelve la fecha que figura n meses después de startdate o, si n es negativa, la fecha que figura n meses antes de startdate.
addmonths(startdate, n , [ , mode])
Esta función devuelve la fecha que aparece n años después de startdate o, si n es negativa, la fecha que aparece n años antes de startdate.
addyears(startdate, n)
Esta función encuentra si la marca de tiempo (una fecha-hora) de entrada se encuentra dentro del año de la fecha en que se cargó el script por última vez, y devuelve True si lo hace o False si no lo hace.
yeartodate(date [ , yearoffset [ , firstmonth [ , todaydate] ] ])
Funciones de zona horaria
Esta función devuelve la zona horaria, tal como se define en el equipo informático donde está funcionando el motor de Qlik.
timezone( )
Esta función devuelve la Greenwich Mean Time actual, tal como se deriva de la configuración regional.
GMT( )
Devuelve la hora Coordinated Universal Time actual.
UTC( )
Devuelve el ajuste actual para el horario de verano, tal como se define en Windows.
Convierte una fecha-hora UTC o GMT en la fecha y hora local como un valor dual. El lugar puede ser cualquier ciudad, población o zona horaria del mundo.
converttolocaltime(timestamp [, place [, ignore_dst=false]])
Funciones de establecimiento de hora
Esta función toma como datos de entrada una marca de tiempo timestamp y un año year y actualiza la marca de tiempo timestamp con el año year especificado en los datos de entrada.
setdateyear (timestamp, year)
Esta función toma como datos de entrada una marca de tiempo timestamp, un mes month y un año year y actualiza la marca de tiempo timestamp con el año year y el mes month especificados en los datos de entrada.
setdateyearmonth (timestamp, year, month)
Funciones in...
Esta función devuelve True si timestamp se encuentra dentro del año que contiene a 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 a 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 a 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 a 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 a base_date.
inmonth(date, basedate , shift)
Devuelve True si date se encuentra dentro de la parte del mes que contiene a basedate hasta e incluido el último milisegundo de basedate.
inmonthtodate (date, basedate , shift)
Esta función determina si una fecha-hora se encuentra dentro del mismo periodo mensual, bimensual, trimestral, cuatrimestre o semestral que fecha base. También es posible hallar si la fecha-hora cae dentro de un periodo anterior o posterior.
inmonths(n, date, basedate , shift [, first_month_of_year = 1])
Esta función determina si una fecha-hora se encuentra dentro de la parte de un período mensual, bimensual, trimestral, cuatrimestral o semestral hasta e incluyendo el último milisegundo de base_date. También es posible hallar si la fecha-hora cae dentro de un periodo anterior o posterior.
inmonthstodate (n, date, basedate , shift [, first_month_of_year = 1])
La función devuelve True si timestamp se encuentra dentro de la semana que contiene a base_date.
inweek(date, basedate , shift [, weekstart])
Esta función devuelve True si timestamp se encuentra dentro de la parte de la semana que contiene a base_date hasta e incluido el último milisegundo de base_date.
inweektodate (date, basedate , shift [, weekstart])
Esta función determina si timestamp se encuentra dentro de la semana lunar que contiene a base_date. Las semanas lunares en Qlik Sense se definen contando el 1 de enero como el primer día de la semana. Aparte de la última semana del año, cada semana contendrá exactamente siete días.
inlunarweek (date, basedate , shift [, weekstart])
Esta función halla 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 Qlik Sense se definen contando el 1 de enero como el primer día de la semana y, aparte de la última semana del año, contendrán exactamente siete días.
inlunarweektodate (date, basedate , shift [, weekstart])
Esta función devuelve True si timestamp se encuentra dentro del día que contiene a 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 a base_timestamp hasta e incluido el milisegundo exacto de base_timestamp.
indaytotime(timestamp, basetimestamp , shift [, daystart])
Funciones start ... end
Esta función devuelve una marca de tiempo correspondiente al inicio del primer día del año que contiene a date. El formato de salida predefinido 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 marca de tiempo del último milisegundo del último día del año que contiene a date. El formato de salida predeterminado 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 como valor de visualización con un valor numérico subyacente correspondiente a una marca de tiempo (fecha-hora) del primer milisegundo del primer día del año que contiene date.
yearname(date [, shift = 0 [, first_month_of_year = 1]] )
Esta función devuelve un valor correspondiente a una marca de tiempo con el primer milisegundo del trimestre que contiene a date. El formato de salida predeterminado será el DateFormat establecido en el script.
quarterstart(date [, shift = 0 [, first_month_of_year = 1]])
Esta función devuelve un valor correspondiente a una marca de tiempo del último milisegundo del trimestre que contiene a date. El formato de salida predeterminado será el DateFormat establecido en el script.
quarterend(date [, shift = 0 [, first_month_of_year = 1]])
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.
quartername(date [, shift = 0 [, first_month_of_year = 1]])
Esta función devuelve un valor correspondiente a una marca de tiempo (fecha-hora) del primer milisegundo del primer día del mes que contiene a date. El formato de salida predeterminado será el DateFormat establecido en el script.
monthstart(date [, shift = 0])
Esta función devuelve un valor correspondiente a una marca de tiempo (fecha-hora) del último milisegundo del último día del mes que contiene a date. El formato de salida predeterminado será el DateFormat establecido en el script.
monthend(date [, shift = 0])
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.
monthname(date [, shift = 0])
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.
monthsstart(n, date [, shift = 0 [, first_month_of_year = 1]])
Esta función devuelve un valor correspondiente a una marca de tiempo del último 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.
monthsend(n, date [, shift = 0 [, first_month_of_year = 1]])
Esta función devuelve un valor de visualización que representa el rango de los meses del período (con formato de acuerdo con la variable de script MonthNames), así como el año. El valor numérico subyacente corresponde a una marca de tiempo del primer milisegundo del periodo mensual, bimensual, trimestral, cuatrimestral o semestral que contiene una fecha base.
monthsname(n, date [, shift = 0 [, first_month_of_year = 1]])
Esta función devuelve un valor correspondiente a una marca de tiempo del primer milisegundo del primer día de la semana natural que contiene a date. El formato de salida predefinido es el DateFormat definido en el script.
weekstart(date [, shift = 0 [,weekoffset = 0]])
Esta función devuelve un valor correspondiente a una marca de tiempo del último milisegundo del último día (domingo) de la semana del calendario que contiene date. El formato de salida predefinido será el DateFormat definido en el script.
weekend(date [, shift = 0 [,weekoffset = 0]])
Esta función devuelve un valor que muestra el número de año y de semana con un valor numérico subyacente correspondiente a una marca de tiempo del 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 marca de tiempo del primer milisegundo del primer día de la semana lunar que contiene a date. Las semanas lunares en Qlik Sense se definen contando el 1 de enero como el primer día de la semana y, aparte de la última semana del año, contendrán exactamente siete días.
lunarweekstart(date [, shift = 0 [,weekoffset = 0]])
Esta función devuelve un valor correspondiente a una marca de tiempo del último milisegundo del último día de la semana lunar que contiene a date. Las semanas lunares en Qlik Sense se definen contando el 1 de enero como el primer día de la semana y, aparte de la última semana del año, contendrán exactamente siete días.
lunarweekend(date [, shift = 0 [,weekoffset = 0]])
Esta función devuelve un valor de visualización que muestra el año y el número de la semana lunar correspondiente a una marca de tiempo (fecha-hora) del primer milisegundo del primer día de la semana lunar que contiene a date. Las semanas lunares en Qlik Sense se definen contando el 1 de enero como el primer día de la semana y, aparte de la última semana del año, contendrán exactamente siete días.
lunarweekname(date [, shift = 0 [,weekoffset = 0]])
Esta función devuelve un valor correspondiente a una marca de tiempo (fecha-hora) con el primer milisegundo del día contenido en el argumento time. El formato de salida predeterminado será el TimestampFormat establecido en el script.
daystart(timestamp [, shift = 0 [, dayoffset = 0]])
Esta función devuelve un valor correspondiente a una marca de tiempo (una fecha-hora) del milisegundo final del día contenido en time. El formato de salida predeterminado será el TimestampFormat establecido en el script.
dayend(timestamp [, shift = 0 [, dayoffset = 0]])
Esta función devuelve un valor que muestra la fecha con un valor numérico subyacente correspondiente a una marca de tiempo (fecha-hora) del 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 timestamp (en años completos) de una persona nacida el día date_of_birth.
age(timestamp, date_of_birth)
La función networkdays devuelve el número de días laborables (de lunes a viernes) entre e incluidos los días start_date y end_date teniendo en cuenta cualquier listado opcional de vacaciones: 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 deben ser fechas y horas válidas.
firstworkdate(end_date, no_of_workdays {, holiday} )
La función lastworkdate devuelve la fecha más temprana de finalización para obtener el no_of_workdays (lunes-viernes) si comienza en start_date y teniendo en cuenta cualquier periodo vacacional opcionalmente indicado holiday. start_date y holiday deben ser fechas o 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. Esta función se utiliza al crear un calendario maestro.
daynumberofquarter(date[,firstmonth])