# now - Função de script e de gráfico
Essa função retorna um carimbo de data/hora da hora atual. A função retorna valores no formato de variável do sistema TimeStamp. O valor padrão de timer\_mode é 1.
Sintaxe:
now([ timer\_mode])
Tipo de dados de retorno: dual
A função `now()` pode ser usada no script de carregamento ou em objetos de gráfico.
Argumentos
| Argumento | Descrição |
| --- | --- |
| timer\_mode | Pode ter os seguintes valores:
0 (hora no último carregamento de dados finalizado)
1 (hora na chamada de função)
2 (hora em que o aplicativo foi aberto)
Nota informativaSe você usar a função em um script de carga de dados, timer\_mode=0 resultará na hora da última carga de dados acabada, enquanto que timer\_mode=1 dará a hora da chamada de função do carregamento de dados atual. |
Nota de dicaA função `now()` tem um impacto de alto desempenho, o que pode resultar em problemas de rolagem se a função for usada nas expressões das tabelas. Sempre que seu uso não for estritamente necessário, recomendamos o uso da função `today()`. Caso seja necessário o uso de `now()` em um layout, recomendamos utilizar as configurações não padrão `now(0)` ou `now(2)` quando possível, pois não requerem recálculos constantes
## Quando usar
A função `now()` é normalmente usada como um componente dentro de uma expressão. Por exemplo, ela pode ser usada para calcular o tempo restante no ciclo de vida de um produto. A função `now()` seria usada em vez da função `today()` quando a expressão requer o uso de uma fração de um dia.
A tabela a seguir fornece uma explicação do resultado retornado pela função `now()`, considerando valores diferentes para o argumento `timer_mode`:
Exemplos de funções
| timer\_mode value | Resultado se usado no script de carregamento | Resultado se usado no objeto de gráfico |
| --- | --- | --- |
| 0 | Retorna um carimbo de data/hora, no formato da `variável` de sistema TimeStamp, da última recarga de dados bem-sucedida antes do último carregamento de dados. | Retorna um carimbo de data/hora, no formato da variável de sistema `TimeStamp`, para o último carregamento de dados. |
| 1 | Retorna um carimbo de data/hora, no formato da variável de sistema `TimeStamp`, para o último carregamento de dados. | Retorna um carimbo de data/hora, no formato da variável de sistema `TimeStamp`, da chamada da função. |
| 2 | Retorna um carimbo de data/hora, no formato de variável de sistema `TimeStamp`, 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 o carimbo de data/hora, no formato de variável de sistema `TimeStamp`, 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. |
## 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 em que 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 interface do usuário do Qlik Sense. O 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/now.htm)
#### Script de carregamento e resultados
Visão geral
Abra o editor de carregamento de dados e adicione o script de carregamento abaixo em uma nova guia.
Este exemplo cria três variáveis usando a função `now()`. Cada variável usa uma das opções `timer_mode` para demonstrar seu efeito.
Para que as variáveis demonstrem sua finalidade, carregue o script e, depois de um curto período, carregue o script pela segunda vez. Isso fará com que as variáveis `now(0)` e `now(1)` mostrem valores diferentes, demonstrando corretamente sua finalidade.
Script de carregamento
```
LET vPreviousDataLoad = now(0);
LET vCurrentDataLoad = now(1);
LET vApplicationOpened = now(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.
Variáveis de script de carregamento `now()`
Variáveis de script de carregamento `now()`
Variáveis de script de carregamento `now()`now()
A imagem acima mostra exemplos de valores para cada uma das variáveis criadas. Por exemplo, os valores podem ser os seguintes:
* Tempo de carregamento anterior: 6/22/2022 8:54:03 AM
* Tempo de carregamento atual: 6/22/2022 9:02:08 AM
* Início da sessão do usuário: 6/22/2022 8:40:40 AM
## Exemplo 2: geração de objetos sem script de carregamento
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/now.htm)
#### Script de carregamento e expressão de gráfico
Visão geral
Neste exemplo, você criará três objetos gráficos usando a função `now()`, sem carregar nenhuma variável ou dado no aplicativo. 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.
Faça o seguinte:
1. Abra o editor de carregamento de dados.
2. Sem alterar o script de carregamento existente, clique em Carregar dados.
3. Depois de um curto período, carregue o script pela segunda vez.
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 objeto de gráfico Texto e imagem, crie uma caixa de texto.
2. Adicione a seguinte medida.
`=now(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 objeto de gráfico Texto e imagem, crie uma caixa de texto.
2. Adicione a seguinte medida:
`=now(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 objeto de gráfico Texto e imagem, crie uma caixa de texto.
2. Adicione a seguinte medida:
`=now(2)`
3. Em Aparência, selecione Mostrar títulos e adicione o título “Início da sessão do usuário” ao objeto.
Exemplos de objetos de gráfico de `now()`
Exemplos de objetos de gráfico de `now()`
Exemplos de objetos de gráfico de `now()`now()
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: 6/22/2022 9:02:08 AM
* Hora atual: 6/22/2022 9:25:16 AM
* Início da sessão do usuário: 6/22/2022 8:40:40 AM
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 vez em que os dados foram carregados com êxito.
O objeto de gráfico “Hora atual” usa um valor `timer_mode` de 1. Isso 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 valor `timer_mode` de 2. Isso retorna o carimbo de data/hora de quando o aplicativo foi aberto e a sessão do usuário foi iniciada.
## Exemplo 3: Cenário
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/now.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 que consiste no inventário de uma operação de mineração de criptomoedas, que é carregado em uma tabela denominada `Inventory`.
* Dados com os seguintes campos: `id`, `purchase_date` e `wph` (watts por hora).
O usuário deseja uma tabela que mostre, por `id`, o custo total que cada plataforma de mineração acumulou no mês até o momento, em termos de consumo de energia.
Esse valor deve ser atualizado sempre que o objeto de gráfico for atualizado. O custo atual da eletricidade é de $0,0678 por kWh.
Script de carregamento
```
SET DateFormat='MM/DD/YYYY';
Inventory:
Load
*
Inline
[
id,purchase_date,wph
8188,1/7/2022,1123
8189,1/19/2022,1432
8190,2/28/2022,1227
8191,2/5/2022,1322
8192,3/16/2022,1273
8193,4/1/2022,1123
8194,5/7/2022,1342
8195,5/16/2022,2342
8196,6/15/2022,1231
8197,6/26/2022,1231
8198,7/9/2022,1123
8199,7/22/2022,1212
8200,7/23/2022,1223
8201,7/27/2022,1232
8202,8/2/2022,1232
8203,8/8/2022,1211
8204,8/19/2022,1243
8205,9/26/2022,1322
8206,10/14/2022,1133
8207,10/29/2022,1231
];
```
Resultados
Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão: `id`.
Crie a seguinte medida:
`=(now(1)-monthstart(now(1)))*24*wph/1000*0.0678`
Se o objeto de gráfico fosse atualizado em 6/22/2022 10:39:05 AM, ele retornaria os seguintes resultados:
Tabela de resultados
| id | =(now(1)-monthstart(now(1)))\*24\*wph/1000\*0.0678 |
| --- | --- |
| 8188 | $39.18 |
| 8189 | $49.97 |
| 8190 | $42.81 |
| 8191 | $46.13 |
| 8192 | $44.42 |
| 8193 | $39.18 |
| 8194 | $46.83 |
| 8195 | $81.72 |
| 8196 | $42.95 |
| 8197 | $42.95 |
| 8198 | $39.18 |
| 8199 | $42.29 |
| 8200 | $42.67 |
| 8201 | $42.99 |
| 8202 | $42.99 |
| 8203 | $42.25 |
| 8204 | $43.37 |
| 8205 | $46.13 |
| 8206 | $39.53 |
O usuário gostaria que os resultados do objeto fossem atualizados sempre que esse objeto fosse atualizado. Portanto, o argumento `timer_mode` fornecido para instâncias da função `now()` na expressão. O carimbo de data/hora para o início do mês, identificado usando a função `now()` como o argumento timestamp na função `monthstart()`, é subtraído da hora atual que é identificada pela função `now()`. Isso fornece a quantidade total de tempo decorrido até o momento neste mês, em dias.
Esse valor é multiplicado por 24 (o número de horas em um dia) e depois pelo valor no `campo` wph.
Para converter de watts por hora em quilowatts por hora, o resultado é dividido por 1000 antes de finalmente ser multiplicado pela taxa de kWh fornecida.