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

Diagrama que mostra como a função quarterend() identifica o trimestre em que uma data cai e que retorna o último dia desse trimestre. — Diagrama da função quarterend()

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().

A função quarterend() não considera a variável de sistema FirstMonthOfYear. O ano começa em 1º de janeiro, a menos que o argumento first_month_of_year seja usado para alterá-lo.

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.

Argumentos
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:

Valores 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.

Exemplos de funções
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.

Exemplo 1: Exemplo básico

Visão geral

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova guia.

O script de carregamento contém:

Um conjunto de dados contendo um conjunto de transações em 2022 que é carregado em uma tabela denominada "Transactions".
Um carregamento anterior que contém o seguinte:
- A função quarterend() que é definida como o campo “end_of_quarter” e retorna um carimbo de data/hora para o final do trimestre em que as transações ocorreram.
- A função timestamp() que é definida como o campo “end_of_quarter_timestamp” e retorna o carimbo de data/hora exato do final do trimestre selecionado.

Script de carregamento

SET DateFormat='MM/DD/YYYY'; 

Transactions: 
    Load 
       *, 
       quarterend(date) as end_of_quarter, 
       timestamp(quarterend(date)) as end_of_quarter_timestamp 
       ; 
Load 
* 
Inline  
[ 
id,date,amount 
8188,1/7/2022,17.17 
8189,1/19/2022,37.23 
8190,2/28/2022,88.27 
8191,2/5/2022,57.42 
8192,3/16/2022,53.80 
8193,4/1/2022,82.06 
8194,5/7/2022,40.39 
8195,5/16/2022,87.21 
8196,6/15/2022,95.93 
8197,6/26/2022,45.89 
8198,7/9/2022,36.23 
8199,7/22/2022,25.66 
8200,7/23/2022,82.77 
8201,7/27/2022,69.98 
8202,8/2/2022,76.11 
8203,8/8/2022,25.12 
8204,8/19/2022,46.23 
8205,9/26/2022,84.21 
8206,10/14/2022,96.24 
8207,10/29/2022,67.67 
];

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:

id
date
end_of_quarter
end_of_quarter_timestamp

Tabela de resultados
id	date	end_of_quarter	end_of_quarter_timestamp
8188	1/7/2022	03/31/2022	3/31/2022 11:59:59 PM
8189	1/19/2022	03/31/2022	3/31/2022 11:59:59 PM
8190	2/5/2022	03/31/2022	3/31/2022 11:59:59 PM
8191	2/28/2022	03/31/2022	3/31/2022 11:59:59 PM
8192	3/16/2022	03/31/2022	3/31/2022 11:59:59 PM
8193	4/1/2022	06/30/2022	6/30/2022 11:59:59 PM
8194	5/7/2022	06/30/2022	6/30/2022 11:59:59 PM
8195	5/16/2022	06/30/2022	6/30/2022 11:59:59 PM
8196	6/15/2022	06/30/2022	6/30/2022 11:59:59 PM
8197	6/26/2022	06/30/2022	6/30/2022 11:59:59 PM
8198	7/9/2022	09/30/2022	9/30/2022 11:59:59 PM
8199	7/22/2022	09/30/2022	9/30/2022 11:59:59 PM
8200	7/23/2022	09/30/2022	9/30/2022 11:59:59 PM
8201	7/27/2022	09/30/2022	9/30/2022 11:59:59 PM
8202	8/2/2022	09/30/2022	9/30/2022 11:59:59 PM
8203	8/8/2022	09/30/2022	9/30/2022 11:59:59 PM
8204	8/19/2022	09/30/2022	9/30/2022 11:59:59 PM
8205	9/26/2022	09/30/2022	9/30/2022 11:59:59 PM
8206	10/14/2022	12/31/2022	12/31/2022 11:59:59 PM
8207	10/29/2022	12/31/2022	12/31/2022 11:59:59 PM

O campo "end_of_quarter" é criado na instrução de carregamento anterior usando a função quarterend() e transmitindo o campo de data como o argumento da função.

A função quarterend() identifica inicialmente em qual trimestre o valor da data cai e, em seguida, retorna um carimbo de data/hora para o último milissegundo desse trimestre.

Diagrama mostrando o final do trimestre que a função quarterend() identifica pela data da transação 8203. — Diagrama da função quarterend() com o final do trimestre da transação 8203 identificado

A transação 8203 ocorreu em 8 de agosto. A função quarterend() identifica que a transação ocorreu no terceiro trimestre e retorna o último milissegundo desse trimestre, que é 30 de setembro às 11:59:59 PM.

Exemplo 2: period_no

Visão geral

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova guia.

O script de carregamento contém:

Um conjunto de dados contendo um conjunto de transações em 2022 que é carregado em uma tabela denominada "Transactions".
Um carregamento anterior que contém o seguinte:
- A função quarterend() que é definida como o campo “previous_quarter_end” e retorna um carimbo de data/hora para o final do trimestre antes da transação.
- A função timestamp() que é definida como o campo “previous_end_of_quarter_timestamp” e retorna o carimbo de data/hora exato do final do trimestre antes da transação.

Script de carregamento

SET DateFormat='MM/DD/YYYY'; 

Transactions: 
    Load 
       *, 
       quarterend(date, -1) as previous_quarter_end, 
       timestamp(quarterend(date, -1)) as previous_quarter_end_timestamp 
       ; 
Load 
* 
Inline  
[ 
id,date,amount 
8188,1/7/2022,17.17 
8189,1/19/2022,37.23 
8190,2/28/2022,88.27 
8191,2/5/2022,57.42 
8192,3/16/2022,53.80 
8193,4/1/2022,82.06 
8194,5/7/2022,40.39 
8195,5/16/2022,87.21 
8196,6/15/2022,95.93 
8197,6/26/2022,45.89 
8198,7/9/2022,36.23 
8199,7/22/2022,25.66 
8200,7/23/2022,82.77 
8201,7/27/2022,69.98 
8202,8/2/2022,76.11 
8203,8/8/2022,25.12 
8204,8/19/2022,46.23 
8205,9/26/2022,84.21 
8206,10/14/2022,96.24 
8207,10/29/2022,67.67 
];

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:

id
date
previous_quarter_end
previous_quarter_end_timestamp

Tabela de resultados
id	date	previous_quarter_end	previous_quarter_end_timestamp
8188	1/7/2022	12/31/2021	12/31/2021 11:59:59 PM
8189	1/19/2022	12/31/2021	12/31/2021 11:59:59 PM
8190	2/5/2022	12/31/2021	12/31/2021 11:59:59 PM
8191	2/28/2022	12/31/2021	12/31/2021 11:59:59 PM
8192	3/16/2022	12/31/2021	12/31/2021 11:59:59 PM
8193	4/1/2022	03/31/2022	3/31/2022 11:59:59 PM
8194	5/7/2022	03/31/2022	3/31/2022 11:59:59 PM
8195	5/16/2022	03/31/2022	3/31/2022 11:59:59 PM
8196	6/15/2022	03/31/2022	3/31/2022 11:59:59 PM
8197	6/26/2022	03/31/2022	3/31/2022 11:59:59 PM
8198	7/9/2022	06/30/2022	6/30/2022 11:59:59 PM
8199	7/22/2022	06/30/2022	6/30/2022 11:59:59 PM
8200	7/23/2022	06/30/2022	6/30/2022 11:59:59 PM
8201	7/27/2022	06/30/2022	6/30/2022 11:59:59 PM
8202	8/2/2022	06/30/2022	6/30/2022 11:59:59 PM
8203	8/8/2022	06/30/2022	6/30/2022 11:59:59 PM
8204	8/19/2022	06/30/2022	6/30/2022 11:59:59 PM
8205	9/26/2022	06/30/2022	6/30/2022 11:59:59 PM
8206	10/14/2022	09/30/2022	9/30/2022 11:59:59 PM
8207	10/29/2022	09/30/2022	9/30/2022 11:59:59 PM

Como um period_no de -1 foi usado como o argumento offset na função quarterend(), a função primeiro identifica o ano em que as transações ocorrem. Em seguida, ela muda para um trimestre antes e identifica o último milissegundo desse trimestre.

A transação 8203 ocorreu em 8 de agosto. A função quarterend() identifica que o trimestre anterior à realização da transação foi entre 1º de abril e 30 de junho. A função então retorna o último milissegundo desse trimestre, 30 de junho, às 11:59:59 PM.

Exemplo 3: first_month_of_year

Visão geral

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova guia.

O script de carregamento contém:

Um conjunto de dados contendo um conjunto de transações em 2022 que é carregado em uma tabela denominada "Transactions".
Um carregamento anterior que contém o seguinte:
- A função quarterend() que é definida como o campo “end_of_quarter” e retorna um carimbo de data/hora para o final do trimestre em que as transações ocorreram.
- A função timestamp() que é definida como o campo “end_of_quarter_timestamp” e retorna o carimbo de data/hora exato do final do trimestre selecionado.

No entanto, neste exemplo, a política da empresa é que o exercício financeiro comece em 1º de março.

Script de carregamento

SET DateFormat='MM/DD/YYYY'; 

Transactions: 
    Load 
       *, 
       quarterend(date, 0, 3) as end_of_quarter, 
       timestamp(quarterend(date, 0, 3)) as end_of_quarter_timestamp 
       ; 
Load 
* 
Inline  
[ 
id,date,amount 
8188,1/7/2022,17.17 
8189,1/19/2022,37.23 
8190,2/28/2022,88.27 
8191,2/5/2022,57.42 
8192,3/16/2022,53.80 
8193,4/1/2022,82.06 
8194,5/7/2022,40.39 
8195,5/16/2022,87.21 
8196,6/15/2022,95.93 
8197,6/26/2022,45.89 
8198,7/9/2022,36.23 
8199,7/22/2022,25.66 
8200,7/23/2022,82.77 
8201,7/27/2022,69.98 
8202,8/2/2022,76.11 
8203,8/8/2022,25.12 
8204,8/19/2022,46.23 
8205,9/26/2022,84.21 
8206,10/14/2022,96.24 
8207,10/29/2022,67.67 
];

Resultados

Tabela de resultados
id	date	end_of_quarter	end_of_quarter_timestamp
8188	1/7/2022	02/28/2022	2/28/2022 11:59:59 PM
8189	1/19/2022	02/28/2022	2/28/2022 11:59:59 PM
8190	2/5/2022	02/28/2022	2/28/2022 11:59:59 PM
8191	2/28/2022	02/28/2022	2/28/2022 11:59:59 PM
8192	3/16/2022	05/31/2022	5/31/2022 11:59:59 PM
8193	4/1/2022	05/31/2022	5/31/2022 11:59:59 PM
8194	5/7/2022	05/31/2022	5/31/2022 11:59:59 PM
8195	5/16/2022	05/31/2022	5/31/2022 11:59:59 PM
8196	6/15/2022	08/31/2022	8/31/2022 11:59:59 PM
8197	6/26/2022	08/31/2022	8/31/2022 11:59:59 PM
8198	7/9/2022	08/31/2022	8/31/2022 11:59:59 PM
8199	7/22/2022	08/31/2022	8/31/2022 11:59:59 PM
8200	7/23/2022	08/31/2022	8/31/2022 11:59:59 PM
8201	7/27/2022	08/31/2022	8/31/2022 11:59:59 PM
8202	8/2/2022	08/31/2022	8/31/2022 11:59:59 PM
8203	8/8/2022	08/31/2022	8/31/2022 11:59:59 PM
8204	8/19/2022	08/31/2022	8/31/2022 11:59:59 PM
8205	9/26/2022	11/30/2022	11/30/2022 11:59:59 PM
8206	10/14/2022	11/30/2022	11/30/2022 11:59:59 PM
8207	10/29/2022	11/30/2022	11/30/2022 11:59:59 PM

Como o argumento first_month_of_year de 3 é usado na função quarterend(), o início do ano passa de 1º de janeiro a 1º de março.

A transação 8203 ocorreu em 8 de agosto. Como o início do ano é em 1º de março, os trimestres do ano ocorrem entre março e maio, junho e agosto, setembro e novembro e dezembro e fevereiro.

A função quarterend() identifica que a transação ocorreu no trimestre entre o início de junho e agosto e retorna o último milissegundo desse trimestre, que é 31 de agosto às 11:59:59 PM.

Exemplo 4: Exemplo de objeto de gráfico

Visão geral

São usados o mesmo conjunto de dados e cenário do primeiro exemplo.

No entanto, neste exemplo, o conjunto de dados permanece inalterado e é carregado no aplicativo. O cálculo que retorna um carimbo de data/hora para o final do trimestre em que as transações ocorreram é criado como uma medida em um gráfico no aplicativo.

Script de carregamento

SET DateFormat='MM/DD/YYYY'; 

Transactions: 
Load 
* 
Inline  
[ 
id,date,amount 
8188,1/7/2022,17.17 
8189,1/19/2022,37.23 
8190,2/28/2022,88.27 
8191,2/5/2022,57.42 
8192,3/16/2022,53.80 
8193,4/1/2022,82.06 
8194,5/7/2022,40.39 
8195,5/16/2022,87.21 
8196,6/15/2022,95.93 
8197,6/26/2022,45.89 
8198,7/9/2022,36.23 
8199,7/22/2022,25.66 
8200,7/23/2022,82.77 
8201,7/27/2022,69.98 
8202,8/2/2022,76.11 
8203,8/8/2022,25.12 
8204,8/19/2022,46.23 
8205,9/26/2022,84.21 
8206,10/14/2022,96.24 
8207,10/29/2022,67.67 
];

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:

id
date

Para calcular a data de término do trimestre em que uma transação ocorre, crie as seguintes medidas:

=quarterend(date)
=timestamp(quarterend(date))

Tabela de resultados
id	date	=quarterend(date)	=timestamp(quarterend(date))
8188	1/7/2022	03/31/2022	3/31/2022 11:59:59 PM
8189	1/19/2022	03/31/2022	3/31/2022 11:59:59 PM
8190	2/5/2022	03/31/2022	3/31/2022 11:59:59 PM
8191	2/28/2022	03/31/2022	3/31/2022 11:59:59 PM
8192	3/16/2022	03/31/2022	3/31/2022 11:59:59 PM
8193	4/1/2022	06/30/2022	6/30/2022 11:59:59 PM
8194	5/7/2022	06/30/2022	6/30/2022 11:59:59 PM
8195	5/16/2022	06/30/2022	6/30/2022 11:59:59 PM
8196	6/15/2022	06/30/2022	6/30/2022 11:59:59 PM
8197	6/26/2022	06/30/2022	6/30/2022 11:59:59 PM
8198	7/9/2022	09/30/2022	9/30/2022 11:59:59 PM
8199	7/22/2022	09/30/2022	9/30/2022 11:59:59 PM
8200	7/23/2022	09/30/2022	9/30/2022 11:59:59 PM
8201	7/27/2022	09/30/2022	9/30/2022 11:59:59 PM
8202	8/2/2022	09/30/2022	9/30/2022 11:59:59 PM
8203	8/8/2022	09/30/2022	9/30/2022 11:59:59 PM
8204	8/19/2022	09/30/2022	9/30/2022 11:59:59 PM
8205	9/26/2022	09/30/2022	9/30/2022 11:59:59 PM
8206	10/14/2022	12/31/2022	12/31/2022 11:59:59 PM
8207	10/29/2022	12/31/2022	12/31/2022 11:59:59 PM

O campo "end_of_quarter" é criado na instrução de carregamento anterior usando a função quarterend() e transmitindo o campo de data como o argumento da função.

A função quarterend() identifica inicialmente em qual trimestre o valor da data cai e, em seguida, retorna um carimbo de data/hora para o último milissegundo desse trimestre.

Exemplo 5: Cenário

Visão geral

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova guia.

O script de carregamento contém:

Um conjunto de dados é carregado em uma tabela chamada "Employee_Expenses". A tabela contém os seguintes campos:
- IDs de funcionários
- Nomes de funcionários
- As reivindicações de despesas médias diárias de cada funcionário.

O usuário final deseja um objeto de gráfico que mostre, por ID de funcionário e nome de funcionário, as reivindicações de despesas estimadas ainda a serem acumuladas para o restante do trimestre. O exercício financeiro começa em janeiro.

Script de carregamento

Employee_Expenses: 
Load 
* 
Inline  
[ 
employee_id,employee_name,avg_daily_claim 
182,Mark, $15 
183,Deryck, $12.5  
184,Dexter, $12.5 
185,Sydney,$27 
186,Agatha,$18 
];

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:

employee_id
employee_name

Para calcular os juros acumulados, crie a seguinte medida:

=(quarterend(today(1))-today(1))*avg_daily_claim

Defina o Formato numérico da medida como Dinheiro.

Tabela de resultados
employee_id	employee_name	=(quarterend(today(1))-today(1))*avg_daily_claim
182	Mark	$480.00
183	Deryck	$400.00
184	Dexter	$400.00
185	Sydney	$864.00
186	Agatha	$576.00

A função quarterend() usa a data de hoje como seu único argumento e retorna a data de término do mês atual. Em seguida, ela subtrai a data de hoje da data de término do ano, e a expressão retorna o número de dias que restam neste mês.

Esse valor é então multiplicado pela média de solicitações de despesas diárias de cada funcionário para calcular o valor estimado das solicitações que cada funcionário deve fazer no trimestre restante.

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