A função CUPNÚM do Excel conta quantos pagamentos de cupom (juros periódicos) existem entre a data de liquidação e a data de vencimento de um título, considerando a frequência de pagamento informada. É comum ver essa função sendo procurada pelo nome “CUPJUROS”, mas esse não é o nome real de nenhuma função do Excel — o nome correto é CUPNÚM.
Se você já precisou saber quantos pagamentos de cupom ainda faltam receber de um título de renda fixa até o vencimento, para montar uma tabela de fluxo de caixa completa ou apenas para conferir a contagem de um relatório, provavelmente tentou contar manualmente num calendário, de seis em seis meses (ou de três em três, dependendo da frequência), até a data de vencimento.
Esse tipo de contagem manual é sujeito a erro, principalmente quando a data de liquidação não cai exatamente numa data “redonda”, ou quando o intervalo entre liquidação e vencimento é longo o suficiente para ser fácil perder a conta de um pagamento a mais ou a menos.
Neste artigo iremos mostrar a sintaxe exata da função CUPNÚM, a família completa de funções CUP* do Excel (para você saber qual usar em cada caso), um exemplo prático completo, e os erros mais comuns na hora de aplicá-la.
A família de funções CUP* do Excel
O Excel tem seis funções relacionadas a cupons de títulos, todas começando com o prefixo “CUP”, e é fácil confundir uma com a outra — inclusive dar a uma delas um nome que não existe, como “CUPJUROS”. Veja o papel de cada uma:
| Função | O que calcula |
|---|---|
| CUPDATANT | A data de pagamento de cupom imediatamente anterior à liquidação |
| CUPDATPROX | A data de pagamento de cupom imediatamente posterior à liquidação |
| CUPDIAS | O número de dias no período de cupom que contém a data de liquidação |
| CUPDIASINLIQ | O número de dias do início do período de cupom até a data de liquidação |
| CUPDIASPROX | O número de dias da liquidação até a próxima data de cupom |
| CUPNÚM | O número de cupons a pagar entre a liquidação e o vencimento (o tema deste artigo) |
Este artigo é dedicado especificamente à CUPNÚM, que responde a uma pergunta simples e recorrente: “quantos pagamentos de cupom ainda vão acontecer até o título vencer?”.
Sintaxe da função CUPNÚM
A sintaxe da função é:
=CUPNÚM(liquidação; vencimento; frequência; [base])
Em inglês, essa mesma função se chama COUPNUM. Os três primeiros argumentos são obrigatórios, e o quarto é opcional:
| Parâmetro | Obrigatório? | O que representa |
|---|---|---|
| liquidação | Sim | A data de liquidação do título — a data em que ele é efetivamente negociado com o comprador, após a emissão |
| vencimento | Sim | A data de vencimento do título |
| frequência | Sim | Número de pagamentos de cupom por ano: 1 (anual), 2 (semestral) ou 4 (trimestral) |
| base | Não | O tipo de base de contagem de dias a usar (0 a 4). Se omitido, assume 0 |
O argumento base muda a forma como os dias entre as datas são contados internamente, o que pode afetar o resultado em casos de borda (quando a data de liquidação está muito próxima de uma data de cupom):
| Valor de base | Convenção de contagem de dias |
|---|---|
| 0 ou omitido | EUA (NASD) 30/360 |
| 1 | Real/Real (dias corridos reais, ano real) |
| 2 | Real/360 |
| 3 | Real/365 |
| 4 | Europeu 30/360 |
Exemplo prático completo
Considere um título com liquidação em 25 de janeiro de 2007, vencimento em 15 de novembro de 2008, pagamentos semestrais (frequência 2) e base 1 (Real/Real). A fórmula fica:
=CUPNÚM(DATA(2007;1;25); DATA(2008;11;15); 2; 1)
O resultado é 4 pagamentos de cupom. Veja como a função chega nesse número, projetando o calendário de cupons de trás para frente a partir do vencimento:
| Data de cupom projetada (a partir do vencimento, de trás para frente) | Está depois da liquidação (25/01/2007)? | Conta no resultado? |
|---|---|---|
| 15/11/2008 (vencimento) | Sim | Sim |
| 15/05/2008 | Sim | Sim |
| 15/11/2007 | Sim | Sim |
| 15/05/2007 | Sim | Sim |
| 15/11/2006 | Não (antes da liquidação) | Não |
A data de 15/11/2006 fica antes da liquidação (25/01/2007), então não é contada. As outras quatro datas — de 15/05/2007 até 15/11/2008 — caem todas depois da liquidação, resultando no total de 4 pagamentos de cupom.
Como a contagem funciona por trás dos panos
Um ponto importante para entender o resultado é que a CUPNÚM não projeta o calendário a partir da data de emissão original do título, e sim de trás para frente, a partir da data de vencimento, no intervalo definido pela frequência. Isso garante que o calendário de pagamentos sempre “bata” exatamente com a data de vencimento, mesmo que a data de emissão original do título tenha sido em um dia qualquer do calendário.
Para que serve na prática
O resultado da CUPNÚM é um dado de entrada usado em várias outras contas de renda fixa — inclusive internamente pela função PREÇO, que precisa saber quantos pagamentos de cupom trazer a valor presente para calcular o preço de um título. Ela também é útil sozinha, como conferência rápida de quantas parcelas de juros um investidor ainda vai receber antes do vencimento, ou para montar manualmente uma tabela de fluxo de caixa completa de um título, célula por célula, combinando o resultado da CUPNÚM com as funções CUPDATANT e CUPDATPROX para descobrir as datas exatas de cada pagamento.
Erros comuns ao usar a função CUPNÚM
O erro mais comum é buscar essa função pelo nome errado — “CUPJUROS” não existe no Excel, o nome correto é CUPNÚM, com acento. Outro erro frequente é esquecer que a CUPNÚM conta apenas cupons futuros a partir da liquidação, não o total de cupons pagos durante toda a vida do título — se você precisa saber quantos cupons já foram pagos desde a emissão, é preciso calcular isso separadamente. Também é comum usar uma frequência que não corresponde ao cronograma real do título (por exemplo, informar 1 para um título que na verdade paga cupons semestrais), o que faz a contagem sair errada mesmo com as datas certas.
Disponibilidade
A função CUPNÚM está disponível em praticamente todas as versões modernas do Excel, incluindo Excel 2007 em diante, Excel 2016, 2019, 2021, 2024, Excel para Microsoft 365 (Windows e Mac) e Excel Online. No Google Sheets, a função equivalente se chama COUPNUM (ou CUPNÚM na interface em português), com a mesma sintaxe e os mesmos quatro argumentos.
Perguntas frequentes
CUPJUROS é o nome certo dessa função no Excel?
Não. “CUPJUROS” não é o nome de nenhuma função real do Excel — é uma confusão comum com a família de funções que começam com “CUP” e lidam com cupons de títulos. A função que conta o número de pagamentos de cupom entre a liquidação e o vencimento se chama, oficialmente, CUPNÚM (com acento no Ú), equivalente à COUPNUM em inglês.
A função CUPNÚM conta o cupom que já foi pago antes da liquidação?
Não. A CUPNÚM conta apenas os pagamentos de cupom que ainda estão por vir a partir da data de liquidação informada — o cupom mais recente já pago antes dessa data não entra na contagem. Se a data de liquidação coincidir exatamente com uma data de pagamento, esse cupom específico também não é contado como futuro; a contagem começa do próximo pagamento seguinte.
Como a CUPNÚM sabe quais são as datas de pagamento de cupom, se eu não informei nenhuma?
A função reconstrói o calendário de pagamentos sozinha, projetando as datas de trás para frente a partir da data de vencimento, em intervalos regulares definidos pela frequência informada (a cada 12 meses se frequência for 1, a cada 6 meses se for 2, e a cada 3 meses se for 4). Depois, ela conta quantas dessas datas projetadas caem depois da data de liquidação.
Compartilhe ou Comente
Se você curtiu esse artigo aonde mostramos como contar o número de cupons de um título no Excel usando a função CUPNÚM, compartilhe com as suas redes sociais e não se esqueça de deixar um comentário aqui embaixo caso você tenha ficado com alguma dúvida.
Você já precisou contar cupons manualmente antes de conhecer essa função? Chegou a procurar por “CUPJUROS” antes de descobrir o nome certo? Quer ver um próximo artigo explicando as outras funções da família CUP*? Conta para nós nos comentários!