Funções de data e hora

As funções de data e hora do Qlik Sense são usadas para transformar e converter valores de data e hora. Todas as funções podem ser usadas no script de carga de dados e em expressões do gráfico.

As funções de data e hora têm como base um número de série de data e hora que é igual ao número de dias desde 30 de dezembro de 1899. O valor inteiro representa o dia e o valor fracionado representa a hora do dia.

O Qlik Sense usa o valor numérico do parâmetro, portanto, um número também é válido como parâmetro quando não está formatado como uma data ou hora. Se o parâmetro não corresponder ao valor numérico, por exemplo, se ele for uma string, então o Qlik Sensetenta interpretar a string de acordo com as variáveis de ambiente de data e hora.

Se o formato de hora usado no parâmetro não corresponder ao definido nas variáveis de ambiente, o Qlik Sense não poderá fazer uma interpretação correta. Para solucionar isso, altere a configuração ou use uma função de interpretação.

Nos exemplos para cada função, são considerados os formatos de data e hora padrão hh:mm:ss e YYYY-MM-DD (ISO 8601).

Ao processar um carimbo de data/hora com uma função de data ou hora, o Qlik Sense ignora os parâmetros de horário de verão, a menos que a função de data ou hora inclua uma posição geográfica.

Por exemplo, ConvertToLocalTime( filetime('Time.qvd'), 'Paris') usa parâmetros de horário de verão enquanto ConvertToLocalTime(filetime('Time.qvd'), 'GMT-01:00') não usa esses parâmetros.

Use a caixa suspensa em cada função para ver uma breve descrição e a sintaxe de cada função. Clique no nome da função na descrição da sintaxe para obter detalhes.

Expressões com inteiro de hora

Esta função retorna um número inteiro que representa o segundo em que a fração da expression é interpretada como uma hora, de acordo com a interpretação numérica padrão.

second(expression)

Esta função retorna um número inteiro que representa o minuto em que a fração da expression é interpretada como uma hora, de acordo com a interpretação numérica padrão.

minute(expression)

Esta função retorna um número inteiro que representa a hora em que a fração da expression é interpretada como uma hora, de acordo com a interpretação numérica padrão.

hour(expression)

Esta função retorna um número inteiro que representa o dia em que a fração da expression é interpretada como uma data, de acordo com a interpretação numérica padrão.

day(expression)

Esta função retorna um número inteiro que representa o número da semana de acordo com a ISO 8601. O número da semana é calculado a partir da data de interpretação da expressão, de acordo com a interpretação de números padrão.

week(expression)

Esta função retorna um valor dual: um nome do mês, conforme definido na variável de ambiente MonthNames e um inteiro entre 1 e 12. O mês é calculado a partir da data de interpretação da expressão, de acordo com a interpretação do número padrão.

month(expression)

Esta função retorna um número inteiro que representa o ano em que a expression é interpretada como uma data, de acordo com a interpretação de número padrão.

year(expression)

Esta função retorna o ano ao qual o número da semana pertence, de acordo com a ISO 8601. O número da semana varia entre 1 e cerca de 52.

weekyear(expression)

Esta função retorna um valor dual com: Um nome do dia conforme definido na variável de ambiente DayNames. Um inteiro entre 0 e 6 correspondendo ao dia nominal da semana (0-6).

weekday(date)

Funções de data/hora

Esta função retorna um carimbo de hora atual do relógio do sistema. O valor padrão é 1.

now([ timer_mode])

Esta função retorna a data atual do relógio do sistema.

today([timer_mode])

Esta função retorna um carimbo de hora da hora atual do relógio do sistema para um determinado fuso horário.

localtime([timezone [, ignoreDST ]])

Fazer funções

Esta função retorna uma data calculada a partir do ano YYYY, do mês MM e do dia DD.

makedate(YYYY [ , MM [ , DD ] ])

Esta função retorna uma data calculada a partir do ano YYYY, da semana WW e do dia da semana D.

makeweekdate(YYYY [ , WW [ , D ] ])

Esta função retorna um momento calculado a partir da hora hh, do minuto mm e do segundo ss.

maketime(hh [ , mm [ , ss [ .fff ] ] ])

Outras funções de data

Esta função retorna a data que ocorre n meses após a startdate ou, se n for negativo, a data que ocorre n meses antes da startdate.

addmonths(startdate, n , [ , mode])

Essa função retorna a data ocorrendo n anos após startdate ou, se n for negativo, a data ocorrendo n anos antes de startdate.

addyears(startdate, n)

Esta função descobre se o carimbo de data e hora de entrada cai dentro de um ano da data em que o script foi carregado pela última vez, e retorna True se cair, False se não cair.

yeartodate(date [ , yearoffset [ , firstmonth [ , todaydate] ] ])

Funções de fuso horário

Esta função retorna o nome do fuso horário atual, conforme definido no Windows.

timezone( )

Esta função retorna o atual Greenwich Mean Time, derivado do relógio do sistema e das configurações de hora do Windows.

GMT( )

Retorna o atual Coordinated Universal Time.

UTC( )

Retorna os ajustes atuais do horário de verão conforme definido no Windows.

daylightsaving( )

Converte um carimbo de data/hora de UTC ou GMT para a hora local, na forma de um valor duplo. O lugar pode ser qualquer quantidade de cidades, lugares e fusos horários do mundo.

converttolocaltime(timestamp [, place [, ignore_dst=false]])

Definir funções de hora

Esta função admite como entrada um timestamp e year e atualiza o timestamp com o year especificado na entrada.

setdateyear (timestamp, year)

Esta função admite como entrada um timestamp, um month e um year , e atualiza o timestamp com o year e o month especificado na entrada.

setdateyearmonth (timestamp, year, month)

Funções In...

Essa função retornará True se timestamp estiver dentro do ano que contém a base_date.

inyear(date, basedate , shift [, first_month_of_year = 1])

Esta função retornará True se timestamp estiver na parte da parte do ano que contém base_date até e inclusive o último milissegundo de base_date.

inyeartodate (date, basedate , shift [, first_month_of_year = 1])

Esta função retornará True se timestamp estiver dentro do trimestre que contém base_date.

inquarter (date, basedate , shift [, first_month_of_year = 1])

Esta função retornará True se timestamp estiver na parte do trimestre que contém a base_date até e inclusive o último milissegundo de base_date.

inquartertodate (date, basedate , shift [, first_month_of_year = 1])

Esta função retornará True se timestamp estiver dentro do mês que contém base_date.

inmonth(date, basedate , shift)

Retornará True se date estiver na parte do mês que contém a basedate até e inclusive o último milissegundo da basedate.

inmonthtodate (date, basedate , shift)

Esta função descobre se um timestamp cai dentro do mesmo mês, bi-mês, trimestre, terço ou metade do ano como uma data base. Também é possível descobrir se o timestamp cai dentro de um período de tempo anterior ou seguinte.

inmonths(n, date, basedate , shift [, first_month_of_year = 1])

Esta função confere se uma data/hora está dentro de parte de um período do mês, bimestre, trimestre ou meio ano, incluindo o último milissegundo de base_date. Também é possível descobrir se uma data/hora está dentro de um período de tempo anterior ou seguinte.

inmonthstodate (n, date, basedate , shift [, first_month_of_year = 1])

Essa função retornará True se timestamp estiver dentro da semana que contém base_date.

inweek(date, basedate , shift [, weekstart])

Essa função retornará True se timestamp estiver na parte da semana que contém a base_date até e inclusive o último milissegundo da base_date.

inweektodate (date, basedate , shift [, weekstart])

Esta função encontra se timestamp estiver dentro da semana lunar que contém base_date. As semanas lunares no Qlik Sense são definidas ao considerar 1 de janeiro como o primeiro dia da semana.

inlunarweek (date, basedate , shift [, weekstart])

Esta função descobre se timestamp está dentro da parte da semana lunar até e inclusive o último milissegundo da base_date. As semanas lunares no Qlik Sense são definidas ao considerar 1 de janeiro como o primeiro dia da semana.

inlunarweektodate (date, basedate , shift [, weekstart])

Esta função retorna True se timestamp estiver dentro do dia que contém base_timestamp.

inday(timestamp, basetimestamp , shift [, daystart])

Esta função retorna True se timestamp estiver na parte do dia que contém a base_timestamp até e inclusive o exato milissegundo da base_timestamp.

indaytotime(timestamp, basetimestamp , shift [, daystart])

Funções Start ... end

Esta função retorna um carimbo de data/hora correspondente ao início do primeiro dia do ano que contém a date. O formato de saída padrão será o DateFormat definido no script.

yearstart( date [, shift = 0 [, first_month_of_year = 1]])

Esta função retorna um valor correspondente a um carimbo de data/hora com o último milissegundo do último dia do ano que contém date. O formato de saída padrão será o DateFormat definido no script.

yearend( date [, shift = 0 [, first_month_of_year = 1]])

Esta função retorna um ano com quatro dígitos como valor de exibição com um valor numérico subjacente que corresponde a um carimbo de data/hora com o primeiro milissegundo do primeiro dia do ano que contém date.

yearname(date [, shift = 0 [, first_month_of_year = 1]] )

Esta função retorna um valor correspondente a um carimbo de data/hora com o primeiro milissegundo do trimestre que contém date. O formato de saída padrão será o DateFormat definido no script.

quarterstart(date [, shift = 0 [, first_month_of_year = 1]])

Esta função retorna um valor correspondente a uma data/hora com o último milissegundo do trimestre que contém date. O formato de saída padrão será o DateFormat definido no script.

quarterend(date [, shift = 0 [, first_month_of_year = 1]])

Esta função retorna um valor de exibição que mostra os meses do trimestre (formatados de acordo com a variável de script MonthNames) e o ano com um valor numérico subjacente que corresponde a um carimbo de hora do primeiro milissegundo do primeiro dia do trimestre.

quartername(date [, shift = 0 [, first_month_of_year = 1]])

Esta função retorna um valor correspondente à data/hora com o primeiro milissegundo do primeiro dia do mês que contém date. O formato de saída padrão será o DateFormat definido no script.

monthstart(date [, shift = 0])

Esta função retorna um valor correspondente ao carimbo de data/hora do último milissegundo do último dia do mês que contém date. O formato de saída padrão será o DateFormat definido no script.

monthend(date [, shift = 0])

Esta função retorna um valor de exibição que mostra o mês (formatado de acordo com a variável de script MonthNames) e o ano com um valor numérico subjacente que corresponde a um carimbo de hora do primeiro milissegundo do primeiro dia do mês.

monthname(date [, shift = 0])

Esta função retorna um valor correspondente à data/hora do primeiro milissegundo do mês, bimestre, trimestre, quadrimestre ou semestre que contém uma base de dados. Também é possível descobrir a data/hora de um período de tempo anterior ou seguinte.

monthsstart(n, date [, shift = 0 [, first_month_of_year = 1]])

Esta função retorna um valor correspondente a uma data/hora do último milissegundo do mês, bimestre, trimestre, quadrimestre ou semestre que contém uma base de dados. Também é possível descobrir a data/hora de um período de tempo anterior ou seguinte.

monthsend(n, date [, shift = 0 [, first_month_of_year = 1]])

Esta função retorna um valor de exibição que representa o intervalo dos meses do período (formatados de acordo com a variável de script MonthNames) e o ano. O valor numérico subjacente correspondente a uma data/hora do primeiro milissegundo do mês, bimestre, trimestre, quadrimestre ou semestre que contém uma data de base.

monthsname(n, date [, shift = 0 [, first_month_of_year = 1]])

Esta função retorna um valor correspondente ao carimbo de data/hora com o primeiro milissegundo do primeiro dia (segunda-feira) da semana do calendário que contém a date. O formato de saída padrão é o DateFormat definido no script.

weekstart(date [, shift = 0 [,weekoffset = 0]])

Esta função retorna um valor que corresponde a um carimbo de hora do último milissegundo do último dia (domingo) da semana do calendário que contém a date. O formato de saída padrão será o DateFormat definido no script.

weekend(date [, shift = 0 [,weekoffset = 0]])

Esta função retorna um valor que mostra o número do ano e da semana com um valor numérico subjacente que corresponde a um carimbo de hora do primeiro milissegundo do primeiro dia da semana que contém a date.

weekname(date [, shift = 0 [,weekoffset = 0]])

Esta função retorna um valor correspondente a um carimbo de data/hora com o primeiro milissegundo da semana lunar que contém date. As semanas lunares no Qlik Sense são definidas ao considerar 1 de janeiro como o primeiro dia da semana.

lunarweekstart(date [, shift = 0 [,weekoffset = 0]])

Esta função retorna um valor correspondente a uma data/hora com o último milissegundo da semana lunar que contém date. As semanas lunares no Qlik Sense são definidas ao considerar 1 de janeiro como o primeiro dia da semana.

lunarweekend(date [, shift = 0 [,weekoffset = 0]])

Esta função retorna um valor de exibição que mostra o número do ano e da semana lunar que corresponde a data/hora do primeiro milissegundo do primeiro dia da semana lunar que contém a date. As semanas lunares no Qlik Sense são definidas ao considerar 1 de janeiro como o primeiro dia da semana.

lunarweekname(date [, shift = 0 [,weekoffset = 0]])

Esta função retorna um valor correspondente a uma data/hora com o primeiro milissegundo do dia contido no argumento time. O formato de saída padrão será o TimestampFormat definido no script.

daystart(timestamp [, shift = 0 [, dayoffset = 0]])

Esta função retorna um valor correspondente a uma data/hora com o milissegundo final do dia contido em time. O formato de saída padrão será o TimestampFormat definido no script.

dayend(timestamp [, shift = 0 [, dayoffset = 0]])

Esta função retorna um valor que mostra a data com um valor numérico subjacente que corresponde a um carimbo de hora do primeiro milissegundo do dia que contém o time.

dayname(timestamp [, shift = 0 [, dayoffset = 0]])

Funções de numeração de dia

A função age retorna a idade no momento do timestamp (em anos completados) de alguém nascido em date_of_birth.

age(timestamp, date_of_birth)

A função networkdays retorna o número de dias úteis (segunda-sexta) entre e inclusive a start_date e end_date, levando em conta qualquer holiday opcionalmente listado.

networkdays (start:date, end_date {, holiday})

A função firstworkdate retorna a última data inicial para obter o no_of_workdays (segunda-sexta) com término não posterior à end_date levando em conta os feriados opcionalmente listados. end_date e holiday devem ser datas ou carimbos de data/hora válidos.

firstworkdate(end_date, no_of_workdays {, holiday} )

A função lastworkdate retorna a primeira data de término para obter no_of_workdays (de segunda a sexta-feira), se começar em start_date, levando em consideração qualquer holiday opcionalmente listado. start_date e holiday devem ser datas ou carimbos de data/hora válidos.

lastworkdate(start_date, no_of_workdays {, holiday})

Essa função calcula o número do dia do ano que estiver em um carimbo de data/hora. O cálculo é feito a partir do primeiro milissegundo do primeiro dia do ano, mas o primeiro mês pode ser deslocado.

daynumberofyear(date[,firstmonth])

Esta função calcula o número do dia do trimestre em que um timestamp cai.

daynumberofquarter(date[,firstmonth])

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!

Deixe seu feedback aqui