now – função de script e gráfico

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.

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 carregamento 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.

A 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. Para obter mais informações, consulte Modificando configurações regionais para aplicativos e scripts.

As configurações regionais padrão nos aplicativos são baseadas no perfil do usuário. Essas configurações de formato regional não estão relacionadas ao idioma exibido na interface do usuário do Qlik Cloud. O Qlik Cloud será exibido no mesmo idioma do navegador que você está usando.

Se você for um criador de aplicativos, poderá definir a região padrão para os aplicativos que criar. Para obter mais informações, consulte Definir suas configurações regionais preferidas para criar aplicativos e scripts no Qlik Cloud Analytics.

Exemplo 1: geração de objetos usando script de carregamento

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:

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.

Diagrama mostrando a aparência de cada uma das três caixas de texto geradas após o uso da função now() para carregar as variáveis por meio do script de carregamento. — 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 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:

Usando o objeto de gráfico Texto e imagem, crie uma caixa de texto.
Adicione a seguinte medida:

=now(1)
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:

Usando o objeto de gráfico Texto e imagem, crie uma caixa de texto.
Adicione a seguinte medida:

=now(2)
Em Aparência, selecione Mostrar títulos e adicione o título “Início da sessão do usuário” ao objeto.

Diagrama mostrando a aparência de cada uma das três caixas de texto geradas após o uso da função now() para criar somente objetos gráficos, sem dados carregados no aplicativo. — 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.

Exemplo 3: Cenário

Visão geral

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova guia.

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)))24wph/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.

Esta página ajudou?

Se você encontrar algum problema com esta página ou seu conteúdo - um erro de digitação, uma etapa ausente ou um erro técnico - informe-nos como podemos melhorar!

Deixe seu feedback aqui