As funções de data processam datas e horas em análises de dados. Use-as para formatar datas, calcular diferenças entre datas, retornar o timestamp atual e adicionar ou subtrair unidades de tempo.
BI_DATEADD
A função BI_DATEADD retorna uma data após adicionar um intervalo de tempo especificado.
|
Sintaxe |
BI_DATEADD(date, interval, date_part) |
|
Parâmetros |
|
|
Definição |
Retorna uma nova data calculada ao adicionar um <interval> especificado ao <date_part> de uma data. |
|
Saída |
Data |
|
Exemplo |
BI_DATEADD('2020-09-29', 100, 'day') = 2021-01-07 |
|
Limites |
Não compatível com fontes de dados Lindorm (LindormTSDB). Compatível apenas com fontes de dados Lindorm (LindormTable, SQL multimodelo) versão 2,8 ou posterior. |
BI_DATEDIFF
A função BI_DATEDIFF retorna a diferença entre duas datas.
|
Sintaxe |
BI_DATEDIFF(date1, date2, date_part) |
|
Parâmetros |
|
|
Definição |
Retorna a diferença entre <date1> e <date2>, expressa em unidades completas de <date_part>. |
|
Saída |
Inteiro |
|
Exemplo |
BI_DATEDIFF('2024-05-22', '2020-09-29', 'year') = 3 Isso indica três anos completos entre 29 de setembro de 2020 e 22 de maio de 2024. |
|
Limites |
Não compatível com fontes de dados Lindorm (LindormTSDB). Compatível apenas com fontes de dados Lindorm (LindormTable, SQL multimodelo) versão 2,8 ou posterior. |
BI_DATETRUNC
A função BI_DATETRUNC trunca uma data para uma precisão especificada, como dia, mês, trimestre ou ano, e retorna o início desse período.
|
Sintaxe |
BI_DATETRUNC(date, date_part) |
|
Parâmetros |
|
|
Definição |
Trunca <date> para a precisão de <date_part>. Por exemplo, truncar para mês retorna o primeiro dia daquele mês. |
|
Saída |
Data |
|
Exemplo |
BI_DATETRUNC('2020-09-29', 'day') = 2020-09-29 BI_DATETRUNC('2020-09-29', 'quarter') = 2020-07-01 |
|
Limites |
Não compatível com fontes de dados Lindorm. |
BI_DAY
A função BI_DAY retorna o dia do mês de uma data.
|
Sintaxe |
BI_DAY(date) |
|
Descrição do parâmetro |
date: a data de entrada. |
|
Definição |
Retorna o dia do mês de <date> como um inteiro. |
|
Saída |
Inteiro |
|
Exemplo |
BI_DAY('2020-09-29') = 29 |
BI_DAYOFWEEK
|
Sintaxe |
BI_DAYOFWEEK(date, <start>) |
|
Parâmetros |
|
|
Definição |
Retorna o número do dia de <date> dentro da semana. A semana começa em <start>. <start> é opcional e tem "Mon" como padrão. |
|
Saída |
Número |
|
Exemplo |
BI_DAYOFWEEK("2024-05-22", "Mon") = 3 BI_DAYOFWEEK("2024-09-29", "Mon") = 7 |
BI_MAKEDATE
A função BI_MAKEDATE constrói uma data a partir de valores de ano, mês e dia.
|
Sintaxe |
BI_MAKEDATE(year, month, day) |
|
Parâmetros |
|
|
Definição |
Retorna uma data construída a partir de <year>, <month> e <day>. |
|
Saída |
Data |
|
Exemplo |
BI_MAKEDATE(2020, 9, 29) = 2020-09-29 |
|
Limites |
Compatível apenas com fontes de dados Lindorm (LindormTable, SQL multimodelo) versão 2,8 ou posterior. |
BI_MONTH
A função BI_MONTH retorna o mês de uma data.
|
Sintaxe |
BI_MONTH(date) |
|
Descrição do parâmetro |
date: a data de entrada. |
|
Definição |
Retorna o mês de <date> como um inteiro. |
|
Saída |
Inteiro |
|
Exemplo |
BI_MONTH('2020-09-29') = 9 |
BI_NOW
A função BI_NOW retorna a data e a hora atuais.
|
Sintaxe |
BI_NOW() |
|
Definição |
Retorna a data e a hora atuais. |
|
Saída |
Data |
|
Exemplo |
BI_NOW() = 2024-05-22 09:29:29 |
BI_QUARTER
A função BI_QUARTER retorna o trimestre de uma data.
|
Sintaxe |
BI_QUARTER(date) |
|
Descrição do parâmetro |
date: a data de entrada. |
|
Definição |
Retorna o trimestre de <date> como um inteiro. |
|
Saída |
Inteiro |
|
Exemplo |
BI_QUARTER('2020-09-29') = 3 |
BI_TODAY
A função BI_TODAY retorna a data atual.
|
Sintaxe |
BI_TODAY() |
|
Definição |
Retorna a data atual. |
|
Saída |
Data |
|
Exemplo |
BI_TODAY() = 2024-05-22 |
BI_WEEK
A função BI_WEEK retorna o número da semana de uma data.
|
Sintaxe |
BI_WEEK(date) |
|
Descrição do parâmetro |
date: a data de entrada. |
|
Definição |
Retorna o número da semana de <date> como um inteiro. |
|
Saída |
Inteiro |
|
Exemplo |
BI_WEEK('2010-01-01') = 52 BI_WEEK('2010-01-06') = 1 |
BI_YEAR
A função BI_YEAR retorna o ano de uma data.
|
Sintaxe |
BI_YEAR(date) |
|
Parâmetro |
date: a data de entrada. |
|
Definição |
Retorna o ano de <date> como um inteiro. |
|
Saída |
Inteiro |
|
Exemplo |
BI_YEAR('2020-09-29') = 2020 |