Uso
dimension: field_name {
convert_tz: sim | não
}
}
|
Hierarquia
convert_tz |
Tipos de campo possíveis
Dimensão, grupo de dimensões, medida, filtro, parâmetroAceita
Um booleano (sim ou não) |
Definição
O Looker tem várias configurações de fuso horário que convertem dados com base no horário entre diferentes fusos horários. Por padrão, o Looker faz a conversão de fuso horário. Se você não quiser que o Looker faça uma conversão de fuso horário para um determinado campo dimension, dimension_group (com type: time) ou filter, use o parâmetro convert_tz. Isso pode ser útil para campos que já foram convertidos para o fuso horário apropriado ou em algumas situações avançadas em que é necessário evitar a conversão dupla do fuso horário.
Em geral, os cálculos de tempo (diferenças, durações etc.) só funcionam corretamente quando você opera em valores de horário que são convertidos para o mesmo fuso horário. É importante considerar os fusos horários ao criar LookML.
Examples
Não realize conversões de fuso horário para o grupo de dimensões local_created:
dimension_group: local_created {
type: time
timeframes: [time, date, week, month]
sql: ${TABLE}.local_created_at ;;
convert_tz: no
}
Considerações
convert_tz: no se aplica somente a uma dimensão, não a um filtro que a use. Em outras palavras, os filtros sempre realizam a conversão de fuso horário. Quando você especifica convert_tz: no, os valores de dados baseados em tempo são exibidos no fuso horário do banco de dados, mas filtrados usando o fuso horário da consulta.
Como os filtros sempre fazem a conversão de fuso horário, uma diferença entre o fuso horário do banco de dados e o fuso horário da consulta pode fazer com que os dados sejam incluídos ou excluídos inesperadamente de um conjunto de dados. Para evitar isso, verifique se o fuso horário da consulta está definido com o mesmo valor do fuso horário do banco de dados.
Se a opção Fusos horários específicos do usuário estiver ativada, defina o menu suspenso de fuso horário (localizado ao lado do botão Executar em "Explorar", "Aparências" e "Painéis") com o mesmo valor do fuso horário do banco de dados. Se os Fusos horários específicos do usuário estiverem desativados, defina o Fuso horário da consulta com o mesmo valor do fuso horário do banco de dados.
Se você estiver usando filtros personalizados, mantenha a conversão de fuso horário ativada para garantir comparações de datas válidas. Se você desativar a conversão de fuso horário usando convert_tz: no e incluir o campo em um filtro personalizado, suas comparações de datas poderão ser inválidas.
Compatibilidade do dialeto do banco de dados para a conversão de fuso horário
Para que o Looker converta fusos horários no seu projeto do Looker, o dialeto do banco de dados precisa ser compatível com a conversão. A tabela a seguir mostra quais dialetos são compatíveis com a conversão de fuso horário na versão mais recente do Looker: