quarterend – função de script e gráfico
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.
Sintaxe:
QuarterEnd(date[, period_no[, first_month_of_year]])
Tipo de dados de retorno: dual
A função quarterend() determina em qual trimestre a data cai. Em seguida, ele retorna um carimbo de data/hora, no formato de data, para o último milissegundo do último mês desse trimestre. O primeiro mês do ano é, por padrão, janeiro. No entanto, você pode alterar o mês definido como o primeiro usando o argumento first_month_of_year na função quarterend().
Quando usar
A função quarterend() é normalmente usada como parte de uma expressão quando você deseja que o cálculo use a fração do trimestre que ainda não ocorreu. Por exemplo, se você quiser calcular o total de juros ainda não acumulados durante o trimestre.
Argumento | Descrição |
---|---|
date | A data ou o carimbo de data/hora a ser avaliado. |
period_no | period_no é um inteiro, em que o valor 0 indica o trimestre que contém date. Valores negativos em period_no indicam trimestres precedentes e valores positivos indicam trimestres sucessivos. |
first_month_of_year | Se desejar trabalhar com anos (fiscais) que não comecem em janeiro, indique um valor entre 2 e 12 em first_month_of_year. |
Você pode usar os seguintes valores para definir o primeiro mês do ano no argumento first_month_of_year:
Month | Valor |
---|---|
Fevereiro | 2 |
Março | 3 |
Abril | 4 |
Maio | 5 |
Junho | 6 |
Julho | 7 |
Agosto | 8 |
Setembro | 9 |
Outubro | 10 |
Novembro | 11 |
Dezembro |
12 |
Configurações regionais
A menos que especificado de outra forma, os exemplos neste tópico usam o seguinte formato de data: MM/DD/AAAA. O formato de data é especificado na instrução SET DateFormat no seu script de carregamento de dados. A formatação de data padrão pode ser diferente no seu sistema devido às suas configurações regionais e outros fatores. Você pode alterar os formatos nos exemplos abaixo para atender às suas necessidades. Ou pode alterar os formatos no seu script de carregamento para corresponder a esses exemplos.
As configurações regionais padrão nos aplicativos são baseadas nas configurações regionais do sistema do computador ou servidor em que o Qlik Sense está instalado. Se o servidor Qlik Sense que você está acessando estiver definido como Suécia, o Editor de carregamento de dados usará as configurações regionais suecas para datas, horas e moedas. Essas configurações de formato regional não estão relacionadas ao idioma exibido na interface do usuário do Qlik Sense. O Qlik Sense será exibido no mesmo idioma do navegador que você está usando.
Exemplo | Resultado |
---|---|
quarterend('10/29/2005') | Retorna 12/31/2005 23:59:59. |
quarterend('10/29/2005', -1) | Retorna 09/30/2005 23:59:59. |
quarterend('10/29/2005', 0, 3) | Retorna 11/30/2005 23:59:59. |