ForHosting KIT · Datas e tempo

Adicionar meses a uma data

Adicione meses inteiros a uma data e receba o dia posterior no calendário: 31 de janeiro de 2024 mais 1 mês é 29 de fevereiro de 2024, porque um dia que não existe passa para o último do mês. Grátis no seu navegador.

Grátis
Funciona no seu navegador
Sem cadastro
Seus dados não saem do seu aparelho

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Exemplo resolvido

Se você digitar

Data: 2024-01-31
Meses: 1

Você obtém

Resultado: 2024-02-29
Ano: 2.024
Mês: 2
Dia: 29

Esta calculadora de adição de meses a uma data recebe uma única data do calendário gregoriano no formato AAAA-MM-DD e um número não negativo de meses inteiros, e retorna o dia do calendário resultante após esse número de meses a partir da base. Verificações clássicas incluem 2024-01-31 mais um mês caindo em 2024-02-29 em um ano bissexto, 2023-01-31 mais um mês caindo em 2023-02-28 em um ano comum, e 2024-03-15 mais três meses caindo em 2024-06-15 sem ajuste. O mecanismo usa apenas aritmética gregoriana prolética determinística: valida que o dia base realmente existe no calendário, desloca o ano e o mês pelo número solicitado, ajusta o dia ao último dia válido do mês de destino quando o dia original ultrapassaria esse limite, e retorna um resultado estruturado sem chamadas de rede, amostragem aleatória ou o relógio do host.

O que significa a adição de meses e o que a resposta contém

Somar meses inteiros de calendário responde a uma pergunta diferente de somar um número fixo de dias ou contar períodos úteis: avança o ano e o mês no calendário civil gregoriano mantendo o mesmo dia do mês quando esse dia existe, e ajustando para o último dia do mês de destino quando não existe.

Você informa uma data base como uma string estrita AAAA-MM-DD e um valor months não negativo e inteiro; zero deixa a data inalterada, um avança para o mesmo dia nominal no mês seguinte quando possível, e valores maiores atravessam fronteiras de ano automaticamente. Os casos clássicos de fim de mês são explícitos: 31 de janeiro mais um mês vira 28 ou 29 de fevereiro dependendo do ano bissexto, 31 de março mais um mês vira 30 de abril, e 31 de maio mais um mês vira 30 de junho.

Se você precisa de subtração de dias, dias úteis, conversão de epoch, análise de múltiplos formatos ou números de semana ISO, use essas ferramentas dedicadas; esta página responde apenas à data gregoriana posterior após somar meses inteiros a uma base ISO validada, com ajuste ao último dia do mês.

Onde datas deslocadas por mês se encaixam em cobrança, renovações e software

Equipes de operações e finanças somam meses quando uma assinatura é renovada a cada três meses do calendário, quando o vencimento de uma fatura é definido como um mês após a emissão, ou quando uma janela de garantia é de doze meses após uma data de envio, relativa a um carimbo base fixo e não a um relógio ao vivo.

Analistas que constroem janelas de coorte usam o mesmo movimento para rotular períodos de observação que começam em um dia conhecido e terminam um número fixo de meses depois, evitando erros de contagem em fins de mês e dias bissextos. Educadores e redatores de normas usam a ferramenta para demonstrar o comportamento de ajuste, como 31-01-2024 mais um mês em um ano bissexto versus 31-01-2023 mais um mês em um ano comum, sem depender de números seriais de planilha que diferem entre produtos.

Combine-a com subtração de dias, conversão de epoch, normalização de data ou ferramentas de semana ISO quando precisar de passos de calendário relacionados, e com outras ferramentas determinísticas gratuitas ao montar um pequeno laboratório de utilitários de data.

Casos de uso

Ciclos de assinatura e cobrança

Projete a próxima renovação ou o vencimento de fatura N meses após uma data de emissão validada, com os dias de fim de mês ajustados corretamente.

Ajustes de fim de mês e dia bissexto

Verifique que 31 de janeiro mais um mês cai em 29 de fevereiro apenas em anos bissextos, e em 28 de fevereiro em anos comuns, sem peculiaridades do Date.

Perguntas frequentes

Como a data posterior é definida?

O mecanismo soma um número inteiro não negativo de meses do calendário gregoriano a uma base AAAA-MM-DD validada, mantendo o mesmo dia do mês quando possível e ajustando ao último dia válido do mês de destino caso contrário.

O que acontece com fins de mês e anos bissextos?

Os comprimentos de mês e os dias bissextos são validados e aplicados. Por exemplo, 2024-01-31 mais 1 mês é 2024-02-29, enquanto 2023-01-31 mais 1 mês é 2023-02-28. O campo clamped é verdadeiro quando o dia foi reduzido.

Quais formatos de data e valores de meses são aceitos?

Apenas datas estritas AAAA-MM-DD de calendário para a base, e um valor inteiro de months de 0 a 119988.

Isso converte fusos horários ou usa o relógio atual?

Não. Ele apenas mapeia uma data de calendário validada mais N meses inteiros com aritmética pura.

Dá para subtrair meses?

Não. A calculadora só soma: aceita zero ou um número inteiro positivo de meses, e uma quantidade negativa é recusada. Com zero, a data volta exatamente igual.

Ferramentas relacionadas

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

POSThttps://api.kit.forhosting.com/date/add-months

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

curl -X POST https://api.kit.forhosting.com/date/add-months \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-01-31","months":1}'

const res = await fetch("https://api.kit.forhosting.com/date/add-months", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "date": "2024-01-31",
    "months": 1
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/add-months",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2024-01-31",
    "months": 1
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/add-months", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"date":"2024-01-31","months":1}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"date":"2024-01-31","months":1}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/add-months", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemplo de requisição

{
  "date": "2024-01-31",
  "months": 1
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.add_months",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Limites

`year_min`	1
`year_max`	9999
`months_min`	0
`months_max`	119988

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.

Notas técnicas

O que significa a adição de meses e o que a resposta contém

A calculadora valida que o dia base é um dia real de calendário — 29 de fevereiro apenas em anos bissextos, trinta dias em abril, nunca dia trinta e dois — e então retorna a data base normalizada, o número de months usado, o resultado posterior como result no formato AAAA-MM-DD, os campos year, month e day do resultado, um booleano clamped que é verdadeiro quando o dia foi reduzido, days_in_result_month para o comprimento do mês de destino, os componentes base_year, base_month e base_day da base para facilitar o encadeamento, e um breve lembrete de fórmula. Os casos rejeitados incluem campos date ou months ausentes, formatos errados como 2024/01/31, meses impossíveis, dias que não existem como 2023-02-29, contagens de meses negativas, e resultados cujo ano ficaria fora da janela suportada de um a 9999.

Como a data e o número de meses são interpretados e como o resultado permanece reproduzível

A string deve corresponder a quatro dígitos, um hífen, dois dígitos, outro hífen e dois dígitos; espaços no início ou no fim são removidos, mas datas parciais, apenas o dia ordinal do ano, e nomes de meses não são expandidos aqui. Depois da análise, o ano deve estar entre 1 e 9999, o mês entre 1 e 12, e o dia entre 1 e o comprimento real desse mês naquele ano, com anos bissextos seguindo a regra gregoriana de divisível por quatro, exceto anos de século não divisíveis por quatrocentos. Internamente, o mecanismo converte o ano e o mês civis em um índice de mês baseado em zero, com ano vezes doze mais mês menos um, soma o número inteiro de meses, depois recupera o ano e o mês de destino e ajusta o dia original ao número de dias desse mês de destino — aritmética inteira pura, estável bit a bit entre runtimes. O campo base preferido é date, mas os aliases iso_date, d, value e base são aceitos para que planilhas, strings de consulta e formulários tipados possam reutilizar o mesmo contrato sem renomear colunas. O campo months, com aliases n, count e add, deve ser um inteiro de 0 a 119988; sinais de mais à esquerda opcionais em strings de dígitos são permitidos, enquanto decimais, negativos e tokens não numéricos são rejeitados com uma mensagem clara para que uma célula com erro não vire uma data posterior errada. Combine a execução gratuita no navegador desta página com a API paga quando precisar da mesma data deslocada dentro de um pipeline automatizado.

Onde datas deslocadas por mês se encaixam em cobrança, renovações e software

Nesta página o trabalho roda inteiramente no seu navegador; pela API, cada consulta bem-sucedida custa US$ 0,002, a validação com falha não é cobrada, e nada é armazenado depois que a resposta é devolvida. Essa divisão — exploração interativa gratuita e uma API paga e idêntica — segue o padrão do resto do catálogo tier A do KIT e permite passar de uma verificação pontual para um pipeline sem mudar o resultado matemático.

Casos de integração

Fixtures determinísticas para testes

Gere strings ISO com deslocamento de mês reproduzíveis para testes unitários, verificações de propriedades e asserções de CI sem depender de Date ou do relógio do host.

Perguntas técnicas

Quanto custa a calculadora de adição de meses a uma data?

É gratuita no navegador, nesta página. Pela API, uma solicitação bem-sucedida custa US$ 0,002; entradas inválidas não são cobradas.

Ver a documentação completa do KIT →

Executar grátis

Exemplo resolvido

O que significa a adição de meses e o que a resposta contém

Onde datas deslocadas por mês se encaixam em cobrança, renovações e software

Casos de uso

Ciclos de assinatura e cobrança

Ajustes de fim de mês e dia bissexto

Perguntas frequentes

Ferramentas relacionadas

Para desenvolvedores — acesso via API

Endpoint

Chame do seu código

Exemplo de requisição

Exemplo de resposta

Preço

Limites

Erros

Notas técnicas

O que significa a adição de meses e o que a resposta contém

Como a data e o número de meses são interpretados e como o resultado permanece reproduzível

Onde datas deslocadas por mês se encaixam em cobrança, renovações e software

Casos de integração

Fixtures determinísticas para testes

Perguntas técnicas

obrigado