Esta función devuelve la fecha actual. La función devuelve valores en el formato de la variable del sistema DateFormat.
Sintaxis:
today([
timer_mode])
Tipo de datos que devuelve: dual
La función today() se puede utilizar en el script de carga o en los objetos del gráfico.
El valor predeterminado es 1 timer_mode.
Argumentos
Argumento
Descripción
timer_mode
Puede tener los siguientes valores:
0 (día de la última carga de datos finalizada) 1 (día de la llamada a la función) 2 (día en que se abrió la app)
Nota informativaSi utiliza la función en un script de carga, timer_mode=0 dará como resultado el día de la última carga de datos finalizada, mientras que timer_mode=1 nos dará el día de la carga de datos actual.
Ejemplos de funciones
valor de timer_mode
Resultado si se usa en el script de carga
Resultado si se usa en el objeto gráfico
0
Devuelve una fecha, en el formato de la variable del sistema DateFormat, de la última recarga de datos correcta anterior a la última recarga de datos.
Devuelve una fecha, en el formato de la variable del sistema DateFormat, de la última recarga de datos.
1
Devuelve una fecha, en el formato de la variable del sistema DateFormat, de la última recarga de datos.
Devuelve una fecha, en el formato de la variable del sistema DateFormat, de la llamada a la función.
2
Devuelve una fecha, en el formato de la variable del sistema DateFormat, de cuándo comenzó la sesión del usuario en la aplicación. Esto no se actualizará a menos que el usuario recargue el script.
Devuelve la fecha, en el formato de la variable del sistema DateFormat, de cuándo comenzó la sesión del usuario en la aplicación. Esto se actualizará una vez que comience una nueva sesión o se vuelvan a cargar los datos en la aplicación.
Cuándo se utiliza
La función today() se utiliza habitualmente como un componente dentro de una expresión. Por ejemplo, se puede utilizar para calcular el interés que se ha acumulado en un mes hasta la fecha actual.
La tabla siguiente ofrece una explicación del resultado que devuelve la función today(), dados diferentes valores para el argumento de timer_mode:
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.
Ejemplo 1: generación de objetos utilizando script de carga
Vista general
El ejemplo siguiente crea tres variables usando la función today(). Cada variable utiliza una de las opciones timer_mode para demostrar su efecto.
Para que las variables cumplan su finalidad, recargue el script y después de 24 horas, vuelva a cargar el script por segunda vez. Esto dará como resultado que las variables de today(0) y today(1) muestren valores diferentes, cumpliendo así correctamente su propósito.
Script de carga
LET vPreviousDataLoad = today(0);
LET vCurrentDataLoad = today(1);
LET vApplicationOpened = today(2);
Resultados
Una vez cargados los datos por segunda vez, siga las instrucciones que se indican a continuación para crear tres cuadros de texto.
En primer lugar, cree un cuadro de texto para los datos que se cargaron anteriormente.
Haga lo siguiente:
Cree un cuadro de texto con el objeto de gráfico Texto e imagen.
Agregue al objeto la medida siguiente:
=vPreviousDataLoad
En Aspecto, seleccione Show titles y agregue al objeto el título "Hora de recarga anterior".
A continuación, cree un cuadro de texto para los datos que se están cargando actualmente.
Haga lo siguiente:
Cree un cuadro de texto con el objeto de gráfico Texto e imagen.
Agregue al objeto la medida siguiente:
=vCurrentDataLoad
En Aspecto, seleccione Show titles y agregue al objeto el título "Hora de recarga actual".
Cree un cuadro de texto final para mostrar cuándo se inició la sesión del usuario en la aplicación.
Haga lo siguiente:
Cree un cuadro de texto con el objeto de gráfico Texto e imagen.
Agregue al objeto la medida siguiente:
=vApplicationOpened
En Aspecto, seleccione Show titles y añada al objeto el título "Inicio de la sesión del usuario".
La imagen superior muestra valores a modo de ejemplo de cada una de las variables creadas. Por ejemplo, los valores podrían ser los siguientes:
Fecha de recarga anterior: 22/06/2022
Fecha de recarga actual: 23/06/2022
Comienzo de la sesión de usuario: 23/06/2022
Ejemplo 2: generación de objetos sin script de carga
Vista general
El ejemplo siguiente crea objetos gráficos usando la función today(). Cada objeto gráfico utiliza una de las opciones de timer_mode para demostrar su efecto.
No hay script de carga para este ejemplo.
Resultados
Una vez que los datos se hayan cargado por segunda vez, cree tres cuadros de texto.
Primero, cree un cuadro de texto para la última recarga de datos.
Haga lo siguiente:
Cree un cuadro de texto con el objeto gráfico Texto e imagen.
Agregue la siguiente medida.
=today(0)
En Aspecto, seleccione Mostrar títulos y agregue al objeto el título "Última recarga de datos".
A continuación, cree un cuadro de texto para mostrar la hora actual.
Haga lo siguiente:
Cree un cuadro de texto con el objeto gráfico Texto e imagen.
Agregue la siguiente medida:
=today(1)
En Aspecto, seleccione Mostrar títulos y agregue al objeto el título "Hora actual".
Cree un cuadro de texto final para mostrar cuándo se inició la sesión del usuario en la aplicación.
Haga lo siguiente:
Cree un cuadro de texto con el objeto gráfico Texto e imagen.
Agregue la siguiente medida:
=today(2)
En Aspecto, seleccione Mostrar títulos y añada al objeto el título "Comienzo de la sesión de usuario".
La imagen superior muestra valores de ejemplo para cada uno de los objetos creados. Por ejemplo, los valores podrían ser los siguientes:
Última recarga de datos: 23/06/2022
Fecha actual: 23/06/2022
Comienzo de la sesión de usuario: 23/06/2022
El objeto gráfico "Última recarga de datos" utiliza un valor timer_mode de 0. Esto devuelve la marca de tiempo de la última vez que los datos se recargaron correctamente.
El objeto gráfico "Hora actual" utiliza un valor timer_mode de 1. Esto devuelve la hora actual según el reloj del sistema. Si se actualiza la hoja o el objeto, se actualizará este valor.
El objeto gráfico "Comienzo de la sesión de usuario" utiliza un valor timer_mode de 2. Esto devuelve la fecha y hora de cuándo se abrió la aplicación y comenzó la sesión del usuario.
Ejemplo 3: escenario
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 saldos de préstamos, que se carga en una tabla llamada Loans.
Datos de tabla con los campos de ID de préstamo, saldo al inicio del mes y la tasa de interés simple cobrada en cada préstamo por año.
Al usuario final le gustaría tener un objeto gráfico que muestre, por ID de préstamo, el interés actual que se ha acumulado en cada préstamo en el mes hasta la fecha. Aunque la aplicación solo se recarga una vez por semana, al usuario le gustaría que los resultados se actualicen cada vez que se actualice el objeto o la aplicación.
La función monthstart(), utilizando la función today() para devolver la fecha de hoy como su único argumento, devuelve la fecha de inicio del mes actual. Restando ese resultado de la fecha actual, de nuevo utilizando la función today(), la expresión devuelve el número de días que han transcurrido en lo que llevamos de mes.
Luego, este valor se multiplica por la tasa de interés y se divide por 365 para obtener la tasa de interés efectiva en que se ha incurrido durante este período. Luego, el resultado se multiplica por el saldo inicial del préstamo para devolver los intereses que se han acumulado en lo que va del mes.
Debido a que el valor de 1 se usa como argumento de timer_mode en las funciones today() dentro de la expresión, cada vez que se actualiza el objeto gráfico (al abrir la aplicación, actualizar la página, moverse entre hojas, etc.), la fecha que devuelve será conforme a la fecha actual, y los resultados se actualizarán de manera acorde.
¿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.