As funções de data e hora do QlikView são usadas para transformar e converter valores de data e hora. Todas as funções podem ser usadas no script de carregamento e nas expressões de 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 QlikView 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 QlikViewtenta 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 QlikView 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 timestamp com uma função de data e hora, o QlikView ignora qualquer parâmetro 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') usaria parâmetros de horário de verão, enquanto ConvertToLocalTime(filetime('Time.qvd'), 'GMT-01:00') não usaria 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(timestamp [, first_week_day [, broken_weeks [, reference_day]]])
Esta função retorna um valor dual com 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)
Essa 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 aproximadamente 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
Essa função retorna a data que ocorre n meses depois de startdate ou, se n for negativo, a data que ocorre n meses antes de startdate.
addmonths(startdate, n , [ , mode])
Essa função retorna a data que ocorre n anos depois de startdate ou, se n for negativo, a data que ocorre n anos antes de startdate.
addyears(startdate, n)
Esta função descobre se a data 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(timestamp [ , yearoffset [ , firstmonth [ , todaydate] ] ])
Funções de fuso horário
Esta função retorna o nome do fuso horário atual, conforme definido no Windows, não levando em conta os ajustes do horário de verão.
timezone( )
Esta função retorna a data e o Greenwich Mean Time atual, derivado do relógio do sistema e das configurações de hora do Windows.
GMT( )
Esta função retorna a data e o Coordinated Universal Time atual.
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 no mundo.
converttolocaltime(timestamp [, place [, ignore_dst=false]])
Definir funções de hora
Essa função pega um timestamp e um year como entrada e atualiza o timestamp com o year especificado na entrada.
setdateyear (timestamp, year)
Essa função pega 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 base_date.
inyear(date, basedate , shift [, first_month_of_year = 1])
Essa função retornará True se timestamp estiver na 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])
Essa função retornará True se timestamp estiver na parte do trimestre que contém a base_date até e inclusive o último milissegundo da base_date.
inquartertodate (date, basedate , shift [, first_month_of_year = 1])
Essa função retornará True se timestamp estiver dentro do mês que contém base_date.
inmonth(date, basedate , shift)
Retornará True se timestamp estiver na parte do mês que contém a base_date até e inclusive o último milissegundo da base_date.
inmonthtodate (date, basedate , shift)
Essa função verifica se um carimbo de data/hora está no mesmo mês, bimestre, trimestre, período de quatro meses ou meio ano da 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])
Esta função descobre se um carimbo de data/hora se enquadra na parte de um período do mês, bimestre, trimestre, período de quatro meses 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])
Esta função retornará verdadeiro se timestamp estiver dentro da semana lunar que contém base_date. As semanas lunares no QlikView são definidas ao considerar 1 de janeiro como o primeiro dia da semana.
inlunarweek (date, basedate , shift [, weekstart])
Esta função retornará verdadeiro se o timestamp estiver dentro da parte da semana lunar até e inclusive o último milissegundo da base_date. As semanas lunares no QlikView são definidas ao considerar 1 de janeiro como o primeiro dia da semana.
inlunarweektodate (date, basedate , shift [, weekstart])
Esta função retornará True se timestamp estiver dentro do dia que contém base_timestamp.
inday(timestamp, basetimestamp , shift [, daystart])
Esta função retornará True se timestamp estiver na parte da semana 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]])
Essa 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 ao carimbo de 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 um carimbo de 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 base de dados.
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]])
Essa função retorna um valor correspondente a um carimbo de data/hora do último milissegundo do último dia (domingo) 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]])
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 QlikView 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 QlikView 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 QlikView 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 a 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])
