# today Função de script e de gráfico
Essa função retorna a data atual. A função retorna valores no formato da variável do sistema `DateFormat`.
today([ timer\_mode])
Tipo de dados de retorno: Dual
A função `today()` pode ser usada no script de carregamento ou em objetos de gráfico.
O valor `timer_mode` padrão é 1.
Argumentos
| Argumento | Descrição |
| --- | --- |
| timer\_mode | Pode ter os seguintes valores:
0 (dia da última carga de dados acabada)
1 (dia da chamada de função)
2 (dia em que o aplicativo foi aberto)
Nota informativaSe você usar a função em um script de carregamento, timer\_mode=0 resultará no dia do último carregamento de dados finalizado, enquanto timer\_mode=1 indicará o dia do carregamento de dados atual. |
Exemplos de funções
| timer\_mode value | Resultado se usado em script de carregamento | Resultado se usado no objeto de gráfico |
| --- | --- | --- |
| 0 | Retorna uma data, no formato da variável de sistema `DateFormat`, da última recarga de dados bem-sucedida antes do último carregamento de dados. | Retorna uma data, no formato da variável de sistema `DateFormat`, para o último carregamento de dados. |
| 1 | Retorna uma data, no formato da variável de sistema `DateFormat`, para o último carregamento de dados. | Retorna uma data, no formato da variável de sistema `DateFormat`, da chamada da função. |
| 2 | Retorna uma data, no formato de variável de sistema `DateFormat`, de quando a sessão do usuário no aplicativo começou. Isso não será atualizado a menos que o usuário recarregue o script. | Retorna a data, no formato de variável de sistema `DateFormat`, de quando a sessão do usuário no aplicativo começou. Isso será atualizado quando uma nova sessão for iniciada ou quando os dados do aplicativo forem recarregados. |
## Quando usar
A função `today()` é normalmente usada como um componente dentro de uma expressão. Por exemplo, ela pode ser usada para calcular os juros acumulados em um mês até a data atual.
A tabela a seguir fornece uma explicação do resultado retornado pela função `today()`, considerando valores diferentes para o argumento `timer_mode`:
## Configurações regionais
A menos que especificado de outra forma, os exemplos neste tópico usam o seguinte formato de data: MM/DD/AAAA. O formato de data é especificado na instrução `SET DateFormat` no seu script de carregamento de dados. A formatação de data padrão pode ser diferente no seu sistema devido às suas configurações regionais e outros fatores. Você pode alterar os formatos nos exemplos abaixo para atender às suas necessidades. Ou pode alterar os formatos no seu script de carregamento para corresponder a esses exemplos.
As configurações regionais padrão nos aplicativos são baseadas nas configurações regionais do sistema do computador ou servidor onde o Qlik Sense está instalado. Se o servidor Qlik Sense que você está acessando estiver definido como Suécia, o Editor de carregamento de dados usará as configurações regionais suecas para datas, horas e moedas. Essas configurações de formato regional não estão relacionadas ao idioma exibido na Qlik Sense interface do usuário. Qlik Sense será exibido no mesmo idioma do navegador que você está usando.
## Exemplo 1: geração de objetos usando script de carregamento
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/today.htm)
#### Script de carregamento e resultados
Visão geral
O exemplo a seguir cria três variáveis usando a função `today()`. Cada variável usa uma das opções `timer_mode` para demonstrar seu efeito.
Para que as variáveis demonstrem sua finalidade, recarregue o script e, depois de 24 horas, recarregue o script uma segunda vez. Isso fará com que as variáveis `today(0)` e `today(1)` mostrem valores diferentes, demonstrando corretamente sua finalidade.
Script de carregamento
```
LET vPreviousDataLoad = today(0);
LET vCurrentDataLoad = today(1);
LET vApplicationOpened = today(2);
```
Resultados
Depois que os dados tiverem sido carregados pela segunda vez, crie três caixas de texto usando as instruções abaixo.
Primeiro, crie uma caixa de texto para os dados que foram carregados anteriormente.
Faça o seguinte:
1. Usando o objeto de gráfico Texto e imagem, crie uma caixa de texto.
2. Adicione a seguinte medida ao objeto:
`=vPreviousDataLoad`
3. Em Aparência, selecione Show titles e adicione o título "Tempo de carregamento anterior" ao objeto.
Em seguida, crie uma caixa de texto para os dados que estão sendo carregados.
Faça o seguinte:
1. Usando o objeto de gráfico Texto e imagem, crie uma caixa de texto.
2. Adicione a seguinte medida ao objeto:
`=vCurrentDataLoad`
3. Em Aparência, selecione Show titles e adicione o título "Tempo de carregamento atual" ao objeto.
Crie uma caixa de texto final para mostrar quando a sessão do usuário no aplicativo foi iniciada.
Faça o seguinte:
1. Usando o objeto de gráfico Texto e imagem, crie uma caixa de texto.
2. Adicione a seguinte medida ao objeto:
`=vApplicationOpened`
3. Em Aparência, selecione Show titles e adicione o título "Sessão do usuário iniciada" ao objeto.
Diagrama de variáveis criadas usando a função `today()` no script de carregamento
Diagrama de variáveis criadas usando a função `today()` no script de carregamento
Diagrama de variáveis criadas usando a função `today()`today() no script de carregamento 
A imagem acima mostra exemplos de valores para cada uma das variáveis criadas. Por exemplo, os valores podem ser os seguintes:
* Hora de carregamento anterior: 22/06/2022
* Hora de carregamento atual: 23/06/2022
* Início da sessão do usuário: 23/06/2022
## Exemplo 2: geração de objetos sem script de carregamento
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/today.htm)
#### Script de carregamento e expressão de gráfico
Visão geral
O exemplo a seguir cria três objetos de gráfico usando a função `today()`. Cada objeto de gráfico usa uma das opções `timer_mode` para demonstrar seu efeito.
Não há script de carregamento para esse exemplo.
Resultados
Depois que os dados tiverem sido carregados pela segunda vez, crie três caixas de texto.
Primeiro, crie uma caixa de texto para o último carregamento de dados.
Faça o seguinte:
1. Usando o Texto e imagem objeto de gráfico, crie uma caixa de texto.
2. Adicione a seguinte medida.
`=today(0)`
3. Em Aparência, selecione Mostrar títulos e adicione o título "Carregamento de dados mais recente" ao objeto.
Em seguida, crie uma caixa de texto para mostrar a hora atual.
Faça o seguinte:
1. Usando o Texto e imagem objeto de gráfico, crie uma caixa de texto.
2. Adicione a seguinte medida:
`=today(1)`
3. Em Aparência, selecione Mostrar títulos e adicione o título "Hora atual" ao objeto.
Crie uma caixa de texto final para mostrar quando a sessão do usuário no aplicativo foi iniciada.
Faça o seguinte:
1. Usando o Texto e imagem objeto de gráfico, crie uma caixa de texto.
2. Adicione a seguinte medida:
`=today(2)`
3. Em Aparência, selecione Mostrar títulos e adicione o título “Início da sessão do usuário” ao objeto.
Diagrama de objetos criados usando a função `today()` sem script de carregamento
Diagrama de objetos criados usando a função `today()` sem script de carregamento
Diagrama de objetos criados usando a função `today()`today() sem script de carregamento 
A imagem acima mostra exemplos de valores para cada um dos objetos criados. Por exemplo, os valores podem ser os seguintes:
* Último carregamento de dados: 06/23/2022
* Hora atual: 23/06/2022
* Início da sessão do usuário: 23/06/2022
O objeto de gráfico 'Carregamento de dados mais recente' usa um valor `timer_mode` de 0. Isso retorna o carimbo de data/hora da última recarga bem-sucedida dos dados.
O objeto de gráfico 'Hora atual' usa um valor `timer_mode` de 1. Isto retorna a hora atual de acordo com o relógio do sistema. Se a pasta ou o objeto forem atualizados, esse valor será atualizado.
O objeto de gráfico “Início da sessão do usuário” usa um `timer_mode` valor de 2. Isso retorna o carimbo de data/hora de quando o aplicativo foi aberto e a sessão do usuário começou.
## Exemplo 3: Cenário
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/today.htm)
#### Script de carregamento e expressão de gráfico
Visão geral
Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.
O script de carregamento contém:
* Um conjunto de dados contendo um conjunto de saldos de empréstimos, que é carregado em uma tabela denominada `Loans`.
* Tabela de dados com campos para ID de empréstimo, saldo no início do mês e taxa de juros simples cobrada em cada empréstimo por ano.
O usuário final deseja um objeto de gráfico que mostre, por ID de empréstimo, os juros atuais que foram acumulados em cada empréstimo no mês até o momento. Embora o aplicativo seja recarregado apenas uma vez por semana, o usuário gostaria que os resultados fossem atualizados sempre que o objeto ou aplicativo fosse atualizado.
Script de carregamento
```
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
Faça o seguinte:
1. Carregue os dados e abra uma pasta. Crie uma nova tabela.
2. Adicione os seguintes campos como dimensões.
* `loan_id`
* `start_balance`
3. Em seguida, crie uma medida para calcular os juros acumulados:
`=start_balance*(rate*(today(1)-monthstart(today(1)))/365)`
4. Defina o Formato numérico da medida como Dinheiro.
Tabela 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 |
A função `monthstart()`, usando a função `today()` para retornar a data de hoje como seu único argumento, retorna a data de início do mês atual. Ao subtrair esse resultado da data atual, novamente usando a função `today()`, a expressão retorna o número de dias decorridos até o momento neste mês.
Esse valor é então multiplicado pela taxa de juros e dividido por 365 para retornar a taxa de juros efetiva acumulada do período. O resultado é então multiplicado pelo saldo inicial do empréstimo para retornar os juros acumulados até o momento neste mês.
Como o valor de 1 é usado como o argumento `timer_mode` nas funções `today()` dentro da expressão, todas as vezes que o objeto de gráfico é atualizado (abrindo o aplicativo, atualizando a página, movendo-se entre pastas etc.), a data retornada será referente à data atual, e os resultados serão atualizados de acordo.