ForHosting KIT · Datas e tempo

Adicionar anos a uma data

Some ou subtraia anos inteiros de uma data: 15 de março de 2024 mais 2 anos é 15 de março de 2026. Um 29 de fevereiro vira 28 quando o ano de destino não é bissexto. 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-03-15
Anos: 2

Você obtém

Resultado: 2026-03-15
Ano: 2.026
Mês: 3
Dia: 15

Deslocar uma data civil por um número inteiro de anos é uma operação comum que ainda tropeça em dias bissextos quando a base é o vinte e nove de fevereiro. Sistemas de RH renovam contratos em aniversários, mesas de garantia calculam prazos após a compra, equipes financeiras projetam marcos fiscais e autores de material didático precisam de um oráculo confiável que rejeite bases impossíveis como o vinte e nove de fevereiro em ano comum. Esta ferramenta aceita uma data base ISO estrita no formato ano-mês-dia mais um deslocamento inteiro de anos (positivo, negativo ou zero), valida que o dia base realmente existe sob as regras gregorianas de ano bissexto, avança ou recua o ano e, quando a base é vinte e nove de fevereiro e o ano de destino não é bissexto, ajusta o dia para vinte e oito de fevereiro para que o resultado continue sendo uma data civil real.

Como funciona a adição de anos de calendário sem relógio

Comece com uma data de calendário escrita como ano, mês e dia na forma ISO internacional com hífens e larguras fixas para que todo cliente concorde com os mesmos três inteiros.

Confirme que o ano está em um intervalo gregoriano prático do ano um até nove mil novecentos e noventa e nove, que o mês está entre um e doze, e que o dia existe para aquele mês sob as regras de bissexto: um ano é bissexto quando é divisível por quatro, exceto que anos seculares só são bissextos quando também são divisíveis por quatrocentos.

Essa regra torna legal o vinte e nove de fevereiro em anos como dois mil vinte e quatro e dois mil, e ilegal em dois mil vinte e três e mil novecentos. Quando a tripla é válida, some o deslocamento inteiro de anos ao componente do ano mantendo o mês fixo.

Se o dia base for vinte e nove de fevereiro e o ano resultante não for bissexto, ajuste o dia para vinte e oito para que a saída continue uma data civil real; caso contrário mantenha o dia do mês original. Formate o resultado como string ISO quatro-dois-dois.

Onde calculadoras de adicionar anos aparecem no trabalho real

Plataformas de recursos humanos calculam renovação de contrato e fim de experiência como data de admissão mais um ou dois anos de calendário sem puxar uma biblioteca completa de agendamento. Mesas de garantia e suporte definem prazos plurianuais a partir de uma string ISO de compra. Sistemas de educação e associação projetam janelas de aniversário para matrícula e mensalidades.

Engenheiros de dados materializam colunas derivadas para políticas de retenção plurianual, licenças plurianuais e anos de fim de campanha a partir de uma única base ISO mais um deslocamento inteiro em configuração.

Se mais tarde você precisar de deslocamentos em dias em vez de anos, contagens de dias úteis que pulam fins de semana, a diferença em dias entre duas datas, idade a partir de uma data de nascimento ou só ordinais do dia do ano, trate-os como intenções de busca e landings separados em vez de sobrecarregar esta página de adicionar anos a uma data.

Casos de uso

Aniversários de contrato e garantia

Some um, dois ou cinco anos de calendário a uma data ISO de admissão ou compra para produzir aniversários e prazos estáveis entre hosts.

Renovações de licença e associação

Projete datas de fim de licença plurianual e renovações de associação a partir de uma string ISO de início mais um deslocamento inteiro de anos configurado.

Tratamento de aniversário em dia bissexto

Calcule aniversários civis de nascimentos ou eventos de 29 de fevereiro com ajuste explícito para 28 de fevereiro em anos de resultado não bissextos.

Perguntas frequentes

O que significa adicionar anos a uma data?

Significa pegar um dia válido do calendário gregoriano e avançar ou recuar um número inteiro de anos de calendário, mantendo mês e dia quando possível e ajustando 29 de fevereiro para 28 quando o ano de resultado não for bissexto.

Como o 29 de fevereiro é tratado?

Se a data base for 29 de fevereiro e o ano de resultado for bissexto, o resultado permanece 29 de fevereiro.

Qual formato de data é exigido?

ISO estrito YYYY-MM-DD com ano de quatro dígitos e mês e dia de dois dígitos. Valores como 2024-3-15 ou 2024/03/15 são rejeitados para que todo cliente concorde com a mesma string.

O que acontece com uma data base inválida como 2023-02-29?

A mensagem de erro explica que o dia não é válido para aquele ano e mês.

Quanto custa?

A ferramenta do navegador é gratuita e roda localmente.

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-years

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-years \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-03-15","years":2}'

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

import os, requests

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

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

body := bytes.NewBufferString(`{"date":"2024-03-15","years":2}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/add-years", 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-03-15",
  "years": 2
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.add_years",
  "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.

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 você envia e o que recebe de volta

Envie dois campos obrigatórios: date como dia de calendário ISO estrito, por exemplo dois mil vinte e quatro hífen zero três hífen um cinco, e years como contagem inteira finita de anos, por exemplo dois, zero ou menos um. Checagens clássicas incluem somar dois anos ao quinze de março de dois mil vinte e quatro para chegar ao quinze de março de dois mil vinte e seis, somar um ano ao vinte e nove de fevereiro de dois mil vinte e quatro para chegar ao vinte e oito de fevereiro de dois mil vinte e cinco com clamp verdadeiro, somar quatro anos ao mesmo dia bissexto para manter o vinte e nove de fevereiro em dois mil vinte e oito, e subtrair um ano de uma data de meio de ano para pousar no aniversário anterior. Campos ausentes, datas que não são string, strings que não batem com o padrão de dígitos quatro-dois-dois, deslocamentos não inteiros e bases que batem com o padrão mas não são datas de calendário reais falham com invalid_input e não são cobradas. Em sucesso a resposta ecoa a data base normalizada, o deslocamento inteiro de years aplicado, a string ISO do resultado após a adição, o ano, mês e dia numéricos do resultado, um booleano is_leap_year para o ano do resultado, um booleano clamped_leap_day verdadeiro só quando o vinte e nove de fevereiro foi reduzido a vinte e oito, e uma string formula curta que documenta a regra de ajuste bissexto. O preço de chamadas API bem-sucedidas é a base publicada de US$ 0,002 por item; falhas de validação não consomem saldo pré-pago.

Onde calculadoras de adicionar anos aparecem no trabalho real

Como esta capacidade é um motor de parse puro, o preço da API é a base publicada de US$ 0,002 por item bem-sucedido e validação falha não consome saldo.

Ver a documentação completa do KIT →

Executar grátis

Exemplo resolvido

Como funciona a adição de anos de calendário sem relógio

Onde calculadoras de adicionar anos aparecem no trabalho real

Casos de uso

Aniversários de contrato e garantia

Renovações de licença e associação

Tratamento de aniversário em 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

Erros

Notas técnicas

O que você envia e o que recebe de volta

Onde calculadoras de adicionar anos aparecem no trabalho real

obrigado