Essa função retorna a data atual. A função retorna valores no formato da variável do sistema DateFormat.
Sintaxe:
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 padrão de timer_mode é 1.
Argumentos
Argumento
Descrição
timer_mode
Pode ter os seguintes valores:
0 (dia do último carregamento de dados finalizado) 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 de dados, 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 no 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. 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.
Exemplo 1: geração de objetos usando script de carregamento
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:
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.
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 um script de carregamento
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:
Usando o objeto de gráfico Texto e imagem, crie uma caixa de texto.
Adicione a seguinte medida.
=today(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:
=today(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:
=today(2)
Em Aparência, selecione Mostrar títulos e adicione o título “Início da sessão do usuário” ao objeto.
A imagem acima mostra exemplos de valores para cada um dos objetos criados. Por exemplo, os valores podem ser os seguintes:
Carregamento de dados mais recente: 23/06/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 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 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.
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 desse 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.
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!