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.
Sintaxis:
now([ timer_mode])
Tipo de datos que devuelve: dual
La función now() se puede utilizar en el script de carga o en los objetos del gráfico.
| Argumento | Descripción |
|---|---|
| timer_mode |
Puede tener los siguientes valores: 0 (hora de la última carga de datos terminada) Nota informativaSi utiliza la función en un script de carga de datos, timer_mode=0 dará como resultado la hora de la última carga de datos finalizada, mientras que timer_mode=1 dará la hora de la llamada a la función en la carga de datos actual.
|
Cuándo se utiliza
La función now() se utiliza habitualmente como un componente dentro de una expresión. Por ejemplo, se puede utilizar para calcular el tiempo restante en el ciclo de vida de un producto. Se utilizaría la función now() en lugar de la función today() cuando la expresión requiera el uso de una fracción de día.
La tabla siguiente ofrece una explicación del resultado que devuelve la función now(), dados diferentes valores para el argumento de timer_mode:
| 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 marca de tiempo, en el formato de la variable del sistema TimeStamp, de la última recarga de datos correcta anterior a la última recarga de datos. | Devuelve una marca de tiempo, en el formato de la variable del sistema TimeStamp, de la última recarga de datos. |
|
1 |
Devuelve una marca de tiempo, en el formato de la variable del sistema TimeStamp, de la última recarga de datos. | Devuelve una marca de tiempo, en el formato de la variable del sistema TimeStamp, de la llamada a la función. |
|
2 |
Devuelve una marca de tiempo, en el formato de la variable del sistema TimeStamp, de cuándo comenzó la sesión del usuario en la aplicación. Esto no se actualizará a menos que el usuario vuelva a cargar el script. | Devuelve la marca de tiempo, en el formato de la variable del sistema TimeStamp, 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. |
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: generación de objetos utilizando script de carga
Vista general
Abra el editor de carga de datos y agregue el script de carga a continuación en una nueva pestaña.
Este ejemplo crea tres variables usando la función now(). Cada variable utiliza una de las opciones timer_mode para demostrar su efecto.
Para que las variables cumplan su finalidad, vuelva a cargar la secuencia de script y luego, tras un breve período de tiempo, vuelva a cargar la secuencia de script por segunda vez. Esto dará como resultado que las variables de now(0) y now(1) muestren valores diferentes, cumpliendo así correctamente su propósito.
Script de carga
LET vPreviousDataLoad = now(0);
LET vCurrentDataLoad = now(1);
LET vApplicationOpened = now(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".
Variables del script de carga de now()
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:
-
Tiempo de recarga anterior: 22/6/2022 8:54:03 a. m.
-
Tiempo de recarga actual: 22/6/2022 9:02:08 a. m.
-
Comienzo de la sesión de usuario: 22/6/2022 8:40:40 a. m.
Ejemplo 2: generación de objetos sin script de carga
Vista general
En este ejemplo, creará tres objetos gráficos usando la función now(), sin cargar ninguna variable o dato en la aplicación. Cada objeto gráfico utiliza una de las opciones timer_mode para demostrar su efecto.
No hay script de carga para este ejemplo.
Haga lo siguiente:
-
Abra el Editor de carga de datos.
-
Sin cambiar el script de carga existente, haga clic en Cargar datos.
-
Tras un breve período de tiempo, cargue el script por segunda vez.
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.
=now(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:
=now(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:
=now(2)
-
En Aspecto, seleccione Mostrar títulos y añada al objeto el título "Comienzo de la sesión de usuario".
Ejemplos de objeto gráfico now()
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: 6/22/2022 9:02:08 AM
-
Hora actual: 6/22/2022 9:25:16 AM
-
Comienzo de la sesión de usuario: 22/6/2022 8:40:40 a. m.
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.