# today - Función de script y de gráfico
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 vuelva a cargar 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.
La configuración regional predeterminada en las aps se basa en la configuración del sistema regional de la computadora o servidor donde esté instalado Qlik Sense. Si el servidor de Qlik Sense al que está accediendo está configurado en Suecia, el editor de carga de datos utilizará la configuración regional sueca para las fechas, la hora y la moneda. Estos ajustes de formato regional no están relacionados con el idioma mostrado en la interfaz de usuario de Qlik Sense. Qlik Sense se mostrará en el mismo idioma que esté utilizando en su navegador.
## Ejemplo 1: generación de objetos utilizando script de carga
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/today.htm)
#### Script de carga y resultados
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:
1. Cree un cuadro de texto con el objeto de gráfico Texto e imagen.
2. Agregue al objeto la medida siguiente:
`=vPreviousDataLoad`
3. 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:
1. Cree un cuadro de texto con el objeto de gráfico Texto e imagen.
2. Agregue al objeto la medida siguiente:
`=vCurrentDataLoad`
3. 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:
1. Cree un cuadro de texto con el objeto de gráfico Texto e imagen.
2. Agregue al objeto la medida siguiente:
`=vApplicationOpened`
3. En Aspecto, seleccione Show titles y añada al objeto el título "Inicio de la sesión del usuario".
Diagrama de variables creadas utilizando la función `today()` en el script de carga
Diagrama de variables creadas utilizando la función `today()` en el script de carga
Diagrama de variables creadas utilizando la función `today()`today() en el script de carga
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
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/today.htm)
#### Script de carga y expresión de gráfico
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:
1. Cree un cuadro de texto con el objeto de gráfico Texto e imagen.
2. Agregue la siguiente medida.
`=today(0)`
3. 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:
1. Cree un cuadro de texto con el objeto de gráfico Texto e imagen.
2. Agregue la siguiente medida:
`=today(1)`
3. 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:
1. Cree un cuadro de texto con el objeto de gráfico Texto e imagen.
2. Agregue la siguiente medida:
`=today(2)`
3. En Aspecto, seleccione Mostrar títulos y añada al objeto el título "Comienzo de la sesión de usuario".
Diagrama de los objetos creados utilizando la función `today()` sin script de carga
Diagrama de los objetos creados utilizando la función `today()` sin script de carga
Diagrama de los objetos creados utilizando la función `today()`today() sin script de carga
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
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/today.htm)
#### Script de carga y expresión de gráfico
Vista general
Abra el Editor de carga de datos y añada el script de carga inferior en una nueva sección.
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.
Script de carga
```
Loans:
Load
*
Inline
[
loan_id,start_balance,rate
8188,$10000.00,0.024
8189,$15000.00,0.057
8190,$17500.00,0.024
8191,$21000.00,0.034
8192,$90000.00,0.084
];
```
Resultados
Haga lo siguiente:
1. Cargue los datos y abra una hoja.Cree una nueva tabla.
2. Agregue los siguientes campos como dimensiones.
* `loan_id`
* `start_balance`
3. Ahora cree una medida para calcular el interés acumulado:
`=start_balance*(rate*(today(1)-monthstart(today(1)))/365)`
4. Establezca el Formato numérico de la medida en Moneda.
Tabla de resultados
| loan\_id | start\_balance | =start\_balance\*(rate\*(today(1)-monthstart(today(1)))/365) |
| --- | --- | --- |
| 8188 | $10000.00 | $16.44 |
| 8189 | $15000.00 | $58.56 |
| 8190 | $17500.00 | $28.77 |
| 8191 | $21000.00 | $48.90 |
| 8192 | $90000.00 | $517.81 |
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.