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)
Essa função retorna o ano ao qual o número da semana pertence, de acordo com as variáveis de ambiente. 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
Essa função retorna um carimbo de data/hora da hora atual. A função retorna valores no formato da variável do sistema TimeStamp. O valor padrão de timer_mode é 1.
now([ timer_mode])
Essa função retorna a data atual. A função retorna valores no formato da variável do sistema DateFormat.
today([timer_mode])
Essa função retorna um carimbo de data/hora da hora atual para um fuso horário especificado.
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 ] ])
Essa função retorna uma data calculada a partir do ano, do número da semana e do dia da semana.
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 fuso horário, conforme definido no computador onde o mecanismo do Qlik está executando.
timezone( )
Essa função retorna o Greenwich Mean Time atual, derivado das configurações regionais.
GMT( )
Retorna o atual Coordinated Universal Time.
UTC( )
Retorna os ajustes atuais do horário de verão conforme definido no Windows.
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)
Essa função descobre se um carimbo de data/hora está dentro do mesmo mês, bimestre, trimestre, quadrimestre ou semestre como data base. Também é possível descobrir se uma data/hora está dentro de um período de tempo anterior ou seguinte.
inmonths(n, date, basedate , shift [, first_month_of_year = 1])
Essa função descobre se um carimbo de data/hora está dentro da parte de um período do mês, bimestre, trimestre, quadrimestre ou semestre, até e 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])
Essa função determina se timestamp está dentro da semana lunar que contém base_date. As semanas lunares no Qlik Sense são definidas contando 1º de janeiro como o primeiro dia da semana. Além da última semana do ano, cada semana conterá exatamente sete dias.
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 contando 1º de janeiro como o primeiro dia da semana e, além da última semana do ano, conterão exatamente sete dias.
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])
Essa função retorna um valor correspondente ao carimbo de data/hora do primeiro milissegundo do mês, bimestre, trimestre, quadrimestre ou semestre contendo uma data base. Também é possível descobrir a data/hora de um período de tempo anterior ou seguinte.O formato de saída padrão é o DateFormat definido no script.
monthsstart(n, date [, shift = 0 [, first_month_of_year = 1]])
Essa função retorna um valor correspondente a um carimbo de data/hora do último milissegundo do mês, bimestre, trimestre, quadrimestre ou semestre contendo uma data base. 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 corresponde a um carimbo de data/hora do primeiro milissegundo do mês, bimestre, trimestre, quadrimestre ou semestre contendo uma data 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 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]])
Essa função retorna um valor correspondente a um carimbo de data/hora do último milissegundo do último dia da semana do calendário contendo 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]])
Essa função retorna um valor correspondente a um carimbo de data/hora do primeiro milissegundo do primeiro dia da semana lunar que contém date. As semanas lunares no Qlik Sense são definidas contando 1º de janeiro como o primeiro dia da semana e, além da última semana do ano, conterão exatamente sete dias.
lunarweekstart(date [, shift = 0 [,weekoffset = 0]])
Essa função retorna um valor correspondente a um carimbo de data/hora do último milissegundo do último dia da semana lunar que contém date. As semanas lunares no Qlik Sense são definidas contando 1º de janeiro como o primeiro dia da semana e, além da última semana do ano, conterão exatamente sete dias.
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 contando 1º de janeiro como o primeiro dia da semana e, além da última semana do ano, conterão exatamente sete dias.
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. Essa função é usada ao criar um Calendário Mestre.
daynumberofquarter(date[,firstmonth])