Todos os produtos
Search
Central de documentação

Quick BI:Filtros de campo de data

Última atualização: Jun 27, 2026

Configure uma barra de filtros para consultar dados do painel por campos de data, como ano, mês, semana ou dia.

Pré-requisitos

  • Você criou um painel com gráficos que contêm campos de data.

  • Uma barra de filtros vazia foi adicionada ao painel. Criar uma barra de filtros.

Procedimento

Configure a barra de filtros de data conforme mostrado abaixo.

image

Configuração básica

Tipo de exibição

Permite a seleção de datas.

Granularidade de tempo

Campos de data como Ano, Trimestre, Mês, Semana, Dia e Ano-Mês-Dia-Hora-Minuto-Segundo permitem alternar a granularidade de tempo e combinar múltiplas granularidades. Os campos Hora, Hora-Minuto e Hora-Minuto-Segundo não suportam alternância de granularidade.

Campo de data

Granularidade de tempo

Ano (year)

O padrão é ano. É possível alternar para ano-trimestre, ano-mês, ano-semana ou ano-mês-dia.

Trimestre (quarter)

O padrão é ano-trimestre. É possível alternar para ano, ano-mês, ano-semana ou ano-mês-dia.

Mês (month)

O padrão é ano-mês. É possível alternar para ano, ano-trimestre, ano-semana ou ano-mês-dia.

Semana (week)

O padrão é ano-semana. É possível alternar para ano, ano-mês, ano-trimestre ou ano-mês-dia.

Dia (day)

O padrão é ano-mês-dia. É possível alternar para ano, ano-trimestre, ano-mês ou ano-semana.

Ano-Mês-Dia-Hora-Minuto-Segundo (ymdhms)

O padrão é ano-mês-dia-hora-minuto-segundo. É possível alternar para ano, ano-trimestre, ano-mês, ano-semana ou ano-mês-dia.

Hora (hour)

O padrão é hora. Não é possível alternar a granularidade de tempo.

Hora-Minuto (minute)

O padrão é hora-minuto. Não é possível alternar a granularidade de tempo.

Hora-Minuto-Segundo (second)

O padrão é hora-minuto-segundo. Não é possível alternar a granularidade de tempo.

Nota

A seleção de múltiplas granularidades de tempo não é suportada em cenários de ano fiscal.

Fonte de dados

A source de dados da barra de filtros pode ser um Seletor de data padrão, que suporta cascata de datas, ou um campo de conjunto de dados, que suporta mesma source, fontes cruzadas e cascata de datas.

  • Seletor de data padrão

    Não requer source de dados externa. Suporta apenas cascata de datas, sem cascata com outros controles.

    image

  • Campo de conjunto de dados

    Utiliza um conjunto de dados como source de dados. Suporta cascata de datas e cascata com controles suspensos e de árvore.

    image

Time filter range

Defina um intervalo de tempo para restringir as datas selecionáveis no filtro.

image

    • O Tipo de intervalo padrão é Nenhum. Outras opções incluem Começa em, Termina em e Intervalo de tempo.

      image

    • O exemplo a seguir mostra como definir um intervalo de tempo relativo quando o Tipo de intervalo é Começa em. Configure o tempo relativo conforme mostrado na figura.

      image

      Nota

      A granularidade de T pode ser selecionada em uma lista suspensa que inclui todas as granularidades da granularidade de tempo atual. Por exemplo, se a granularidade de tempo atual for ano-mês-dia, selecione ano, mês ou dia. Se a granularidade de tempo atual for ano-mês-dia-hora-minuto-segundo, selecione ano, mês, dia, hora, minuto ou segundo como granularidade para T.

      Por exemplo, quando a granularidade de tempo é ano-mês-dia-hora-minuto-segundo, calcular o tempo relativo em segundos pode ser difícil. Nesse caso, alterne para uma granularidade de dias para visualizar rapidamente os dados de diferentes datas.

    • O exemplo a seguir mostra como definir um intervalo de tempo absoluto quando o Tipo de intervalo é Começa em.

      image

    • Ao selecionar Dynamic query time window e definir a Maximum single query duration, limite a duração máxima permitida para uma única consulta dentro do intervalo de filtro especificado.

      image

Método de filtro

Suporta filtragem por dia único ou por intervalo de datas. Detalhes de configuração e exemplos estão disponíveis nas seções Consulta de data única e Consulta por intervalo de datas abaixo.

Default value

Defina um valor padrão usando entrada manual ou uma função dinâmica.

  • Defina manualmente um valor padrão usando tempo relativo ou tempo absoluto.

    image

  • Quando os dados do dia atual ou anterior não estiverem disponíveis, use uma função dinâmica para recuperar a data mais recente com dados disponíveis.

    image

    • Quando o método de filtro for Dia Único, defina o tempo padrão como Valor máximo do campo de consulta, Valor mínimo do campo de consulta ou Primeiro item do campo de consulta.

      image

    • Quando o método de filtro for intervalo (como diário ou mensal) e o tipo de intervalo for Começa em, Termina em ou Intervalo de tempo, defina um tempo padrão. Esse tempo padrão pode começar ou terminar no valor mínimo do campo de consulta ou no valor máximo do campo de consulta.

      Nota

      É possível definir um valor apenas para Começa em ou apenas para Termina em. Se tanto um horário de início quanto um de término forem definidos, o horário de início não poderá ser posterior ao horário de término.

      image

Enable quick date navigation

Adiciona setas de navegação ao filtro de data na página do relatório para alternância rápida de datas.

Nota

Este parâmetro é suportado quando a granularidade de tempo para uma data é ano, trimestre, mês, semana ou dia, e o método de filtro é de granularidade única.

Defina o filter method como Single day e ative Enable quick date navigation. Setas de navegação aparecerão no controle de data no painel. Clique em nas setas para alternar entre as datas.

date navigation arrows

    Nota

    As setas de navegação funcionam apenas quando uma data específica está selecionada.

    Se um intervalo de filtro de tempo estiver definido, as setas de navegação não poderão alternar para datas fora desse intervalo.

Consulta de data única

Visualize dados de vendas de um dia específico usando o campo order_date (dia).

  1. Na página de gerenciamento de painéis, selecione um painel que contenha o gráfico e a barra de filtros necessários.

    image

  2. Na barra de filtros, clique em advanced configuration.

  3. No painel query condition setting, configure as condições de filtro conforme mostrado na figura a seguir.

    image

  4. Após concluir a configuração, selecione uma data na barra de filtros e clique em Query para visualizar os dados de vendas daquele dia.

    1经验

Consulta por intervalo de datas

Visualize o lucro de uma loja dentro de um período específico usando o campo order_date (dia).

  1. Na página de gerenciamento de painéis, selecione um painel que contenha o gráfico e a barra de filtros necessários.

    Os gráficos no painel devem conter um campo de data.

    image

  2. Na barra de filtros, clique em advanced configuration.

  3. No painel query condition setting, configure as condições de filtro conforme mostrado na figura a seguir.

    image

  4. Após concluir a configuração, selecione um intervalo de datas na barra de filtros e clique em Query para visualizar o lucro da loja naquele período.

    image

    Quando o método de filtro estiver definido como intervalo, utilize os seguintes recursos para aprimorar a visualização dos dados:

    • Interval type: Suporta quatro tipos: Começa em, Termina em, Intervalo de tempo e intervalo rápido.

      Começa em

      image

      Termina em

      image

      Intervalo de tempo

      image Intervalo rápido

      image

    • Customize quick range: Permite definir intervalos rápidos personalizados para vários cenários. Selecione em uma lista suspensa ou adicione um intervalo rápido personalizado.

      image

      Nota

      Esta opção está disponível apenas quando o Interval type está definido como quick range.

      • Selecione rapidamente um intervalo rápido na lista suspensa. Os intervalos rápidos disponíveis variam conforme a granularidade de tempo. Exibição de Configuração do Tipo de Consulta.

        image

      • Caso os intervalos rápidos integrados não atendam às suas necessidades, clique em Add custom quick range para criar um.

        Nota

        Um intervalo rápido personalizado aplica-se apenas à condição de consulta atual.

        image

        O painel de intervalo rápido personalizado inclui estas opções:

        image

        Parâmetro

        Descrição

        Nome do intervalo

        Nome do intervalo rápido personalizado.

        Data de referência

        O tempo base pode ser Hoje, Ontem ou Personalizado.

        image

        Nota

        T representa hoje; exemplo: T +1 representa amanhã, T-1 representa ontem.

        O tempo base é o ponto de partida para o intervalo de datas. Os intervalos subsequentes são calculados para frente ou para trás a partir deste ponto.

        Exemplo: Se hoje for 17 de outubro de 2025, o tempo base for ontem (16 de outubro) e o intervalo for os últimos 3 dias, a consulta abrangerá de 14 a 16 de outubro de 2025.

        image

        Intervalo

        Nota

        O intervalo precisa ser configurado após a definição do tempo de referência.

        • Últimos xx ciclos: Gera um intervalo dinâmico dos últimos N ciclos a partir do tempo de referência. As opções de ciclo disponíveis dependem da granularidade de tempo. Por exemplo, com granularidade de dia, defina os últimos N dias, meses ou anos.

          image

        • Intervalo personalizado: Se a opção de últimos N ciclos não atender às suas necessidades, defina tempos de início e fim relativos ou absolutos independentemente.

          image

        Visualização

        A visualização é atualizada em tempo real com base no tempo base e no intervalo selecionados. Verifique se o intervalo configurado atende às expectativas.

        image

    • Associate charts with start and end time only: Em um painel, use associate charts with start and end time only para aplicar o mesmo intervalo de datas a diferentes gráficos.

      Três tipos de filtro de intervalo de tempo são suportados:

      • Especificar hora de início

        image

      • Especificar hora de término

        image

      • Especificar intervalo de tempo

        image

      Nota

      Esta opção é suportada apenas quando Range type está definido como Time range.

Alternância de granularidade de data

Quando o campo associado à barra de filtros for do tipo data (ano, trimestre, mês, semana, dia ou ymdhms), alterne a granularidade de data para visualizar dados em diferentes níveis de tempo em um único gráfico.image

A barra de filtros de data suporta dois modos:

Método de configuração

Descrição

Exemplo

A alternância de granularidade controla apenas a barra de filtros

Alternar a granularidade de data altera apenas as opções de filtro, não a granularidade de exibição do gráfico.

Use este modo quando precisar alterar apenas as opções de filtro sem afetar a dimensão de tempo do gráfico. Para detalhes de configuração, consulte A alternância de granularidade de data controla apenas a barra de filtros.

O gráfico exibe dados com granularidade anual. Definir a barra de filtros para mensal de janeiro a setembro de 2023 e clicar em Consulta mantém o gráfico na granularidade anual, mostrando apenas os dados agregados para esse período.111

A alternância de granularidade sincroniza com o gráfico

Se um grupo de dimensões de data estiver configurado no painel Campos do gráfico, a granularidade de exibição do gráfico seguirá automaticamente a granularidade de data selecionada na barra de filtros.

Use este modo quando precisar que a barra de filtros altere dinamicamente a dimensão de tempo do gráfico. Para detalhes de configuração, consulte A alternância de granularidade de data sincroniza com o gráfico.

O gráfico exibe granularidade anual. Alterar a barra de filtros para mensal e selecionar de janeiro a novembro de 2023 atualiza o gráfico para mostrar detalhes mensais.111

A alternância de granularidade de data controla apenas a barra de filtros

O valor de granularidade de data na barra de filtros afeta apenas as opções de filtro. Configure conforme descrito a seguir.

  1. Na página query condition setting, defina as condições de consulta conforme mostrado na figura a seguir.

    Neste exemplo, o campo de data está definido como order date (ymdhms).image

    Na seção Basic Settings, os parâmetros são descritos da seguinte forma:

    • Time granularity: Após selecionar um campo de granularidade de tempo, um valor padrão é preenchido automaticamente na lista Time granularity. O valor padrão varia de acordo com o campo selecionado. Para mais informações, consulte Granularidade de tempo.

      Adicione ou remova granularidades de tempo da lista suspensa conforme necessário.

    • Granularity Grouping: Configure o agrupamento de granularidade para visualizar rapidamente dados de diferentes perspectivas de tempo em uma página do painel.

      Nota

      O agrupamento de granularidade só pode ser configurado quando dois ou mais valores forem selecionados para Time granularity.

      image

    • Set default filter value: Defina um valor padrão para a barra de filtros.

      Após configurar o Granularity Grouping, defina um valor padrão diferente para cada granularidade de tempo. Isso permite consultar dados rapidamente ao alternar entre granularidades de tempo.

      2.gif

  2. Alterne a granularidade na barra de filtros, selecione uma data e clique em Query.

    image

    Alterne a granularidade para consultar rapidamente dados em diferentes níveis de tempo.

    3.gif

Nota

Se um ano fiscal estiver configurado para o conjunto de dados, a configuração Fiscal year starts on seguirá a configuração de campo do conjunto de dados e não poderá ser alterada. Criar um conjunto de dados.

A alternância de granularidade de data sincroniza com o gráfico

Se um grupo de dimensões de data estiver configurado no painel Fields do gráfico, defina a barra de filtros para sincronizar a dimensão de tempo do gráfico ao alternar a granularidade.

  1. Configure um grupo de dimensões de data para o gráfico que precisa de sincronização de granularidade.

    1. No painel Data do gráfico, clique em no ícone image e selecione New Dimension Group na lista suspensa.image

    2. Na caixa de diálogo New Dimension Group Field, configure os campos de data conforme necessário e clique em OK.image

    3. Arraste o campo do grupo de dimensões de data criado para o painel Fields do gráfico e clique em Update.image

  2. Adicione uma barra de filtros e configure as condições de consulta.

    image

    Conteúdo da configuração

    Descrição

    Área ①

    Nome da barra de filtros

    Insira um nome personalizado para a barra de filtros, como Date Filter.

    Área ②

    Gráfico e campos associados

    Selecione o gráfico a ser sincronizado e o campo de data a ser associado.

    Nota
    • Gráficos não selecionados não são afetados pela alternância de granularidade na barra de filtros.

    • Gráficos selecionados sem um grupo de dimensões não são afetados pela alternância de granularidade.

    Área ③

    Configurações Básicas

    Selecione Synchronize chart dimension with time granularity switching para sincronizar a granularidade da barra de filtros com o gráfico associado. Outras configurações são as mesmas descritas em A alternância de granularidade de data controla apenas a barra de filtros.

    Nota
    • Certifique-se de que o campo correspondente do grupo de dimensões de data esteja configurado para o gráfico que precisa ser sincronizado.

    • As granularidades de tempo no controle devem corresponder individualmente às granularidades de tempo no grupo de dimensões do gráfico.

  3. Selecione uma granularidade de tempo e um intervalo de datas na barra de filtros e clique em Query. O gráfico associado atualiza sua granularidade de acordo.111

    Nota

    Se um ano fiscal estiver configurado para o conjunto de dados, a configuração Fiscal year starts on seguirá a configuração de campo do conjunto de dados e não poderá ser alterada. Criar um conjunto de dados.