Essa função retorna um carimbo de data/hora da hora atual. A função retorna valores no formato da 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.
| Argumento | Descrição |
|---|---|
| timer_mode |
Pode ter os seguintes valores: 0 (hora no último carregamento de dados finalizado) 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.
|
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:
| 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
Visão geral
Abra o editor da carga 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:
-
Usando o objeto de gráfico Texto e imagem, crie uma caixa de texto.
-
Adicione a seguinte medida ao objeto:
=vPreviousDataLoad
-
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:
-
Usando o objeto de gráfico Texto e imagem, crie uma caixa de texto.
-
Adicione a seguinte medida ao objeto:
=vCurrentDataLoad
-
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:
-
Usando o objeto de gráfico Texto e imagem, crie uma caixa de texto.
-
Adicione a seguinte medida ao objeto:
=vApplicationOpened
-
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()
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
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:
-
Abra o editor de carregamento de dados.
-
Sem alterar o script de carregamento existente, clique em Carregar dados.
-
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:
-
Usando o objeto de gráfico Texto e imagem, crie uma caixa de texto.
-
Adicione a seguinte medida:
=now(0)
-
Em Aparência, selecione Show titles 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:
-
Usando o objeto de gráfico Texto e imagem, crie uma caixa de texto.
-
Adicione a seguinte medida:
=now(1)
-
Em Aparência, selecione Show titles 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:
-
Usando o objeto de gráfico Texto e imagem, crie uma caixa de texto.
-
Adicione a seguinte medida:
=now(2)
-
Em Aparência, selecione Show titles e adicione o título “Início da sessão do usuário” ao objeto.
Exemplos de objetos de gráfico de 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.