Essa variável de ambiente define o formato de data usado como padrão no aplicativo e por data, retornando funções como date() e date#(). O formato é usado para interpretar e formatar datas. Se a variável não estiver definida, o formato de data definido pelas suas configurações regionais será obtido quando o script for executado.
Sintaxe:
DateFormat
| Exemplo | Resultado |
|---|---|
| Set DateFormat='M/D/YY'; //(US format) | Esse uso da função DateFormat define a data como o formato dos EUA: mês/dia/ano. |
| Set DateFormat='DD/MM/YY'; //(UK date format) | Esse uso da função DateFormat define a data como o formato do Reino Unido: dia/mês/ano. |
| Set DateFormat='YYYY/MM/DD'; //(ISO date format) | Esse uso da função DateFormat define a data como o formato ISO: ano/mês/dia. |
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: Padrão de variáveis de sistema
Exemplo 2: Alterar variável do sistema
Exemplo 3: Interpretação de datas
Exemplo 4: Formatação de datas estrangeiras
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 de datas.
-
A variável DateFormat, que usa o formato "DD/MM/AAAA", mas com barras de comentário excluídas.
Script de carregamento
// SET DateFormat='DD/MM/YYYY';
Transactions:
Load
date,
month(date) as month,
id,
amount
Inline
[
date,id,amount
22-05-2022,1,1000
23-05-2022,2,2123
24-05-2022,3,4124
25-05-2022,4,2431
]; Resultados
Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:
-
date
-
month
Crie esta medida:
=sum(amount)
| date | mês | =sum(amount) |
|---|---|---|
| 22-05-2022 | - | 1000 |
| 23-05-2022 | - | 2123 |
| 24-05-2022 | - | 4124 |
| 25-05-2022 | - | 2431 |
No script de carregamento inicial, o DateFormat que está sendo usado é o padrão ‘MM/DD/AAAA’. Como o campo date no conjunto de dados de transações não está nesse formato, ele não é interpretado como uma data. Isso é mostrado na tabela de resultados em que os valores do campo month são nulos.
Você pode verificar os tipos de dados interpretados no Visualizador do modelo de dados inspecionando as propriedades "Tags" do campo date:
Visualização da tabela Transactions. Observe as "Tags" para o campo date indicando que os dados de entrada textual não foram implicitamente convertidos em um carimbo de data/hora.
Isso pode ser resolvido ativando a variável de sistema DateFormat:
// SET DateFormat='DD/MM/YYYY';
Remova as barras duplas e recarregue os dados.
Visualização da tabela Transactions. Observe as "Tags" para o campo date indicando que os dados de entrada textual foram implicitamente convertidos em um carimbo de data/hora.
