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.
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().
Nota informativaA 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. Para obter mais informações, consulte Modificando configurações regionais para aplicativos e scripts.
As configurações regionais padrão nos aplicativos são baseadas no perfil do usuário. Essas configurações de formato regional não estão relacionadas ao idioma exibido na interface do usuário do Qlik Cloud. O Qlik Cloud será exibido no mesmo idioma do navegador que você está usando.
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.
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.
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.
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.
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.
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.
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 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.
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!