ForHosting KIT · Casa, cozinha e lazer

Contador de meses

De janeiro de 2020 a junho de 2024 há 53 meses inteiros. Digite só o ano e o mês de cada data, sem o dia, e receba os meses de um aluguel, do tempo de empresa, de uma assinatura ou de um projeto. 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

Ano de início: 2.020
Mês de início: 1
Ano final: 2.024
Mês final: 6

Você obtém

Meses: 53
Número de meses: 53

Um contador de meses responde a uma pergunta mais estreita do que uma diferença completa de datas: conhecendo só o ano e o mês de duas datas de calendário, quantos meses inteiros existem entre elas? Quem precifica um contrato de locação, conta o tempo de casa, agenda uma assinatura ou converte uma janela de projeto em períodos de faturamento procura exatamente esse número.

O que significa a contagem de meses inteiros entre duas datas ano-mês

Um mês de calendário é um encaixe com nome no ano civil — de janeiro a dezembro —, não um número fixo de dias. Quando alguém pergunta quantos meses há entre duas datas e só conhece o ano e o mês de cada uma, não pede dias restantes, ajustes de ano bissexto nem uma idade em anos-meses-dias. Quer o intervalo inteiro na grade ano-mês.

Esse intervalo é a diferença de dois índices ordinais de mês: doze vezes o ano mais o número do mês. Subtraia o índice inicial do índice final e você obtém a contagem de meses inteiros com sinal. De janeiro de 2020 a janeiro de 2021 há doze meses; de janeiro de 2020 a fevereiro de 2020 há um mês; o mesmo ano e o mesmo mês dão zero.

Inverta o par e o resultado com sinal troca de sinal, enquanto a contagem absoluta de meses permanece igual. É a mesma aritmética que as folhas de pagamento usam para períodos de faturamento encerrados e a mesma identidade que uma cláusula de locação quando diz «um prazo de vinte e quatro meses a partir de março de 2024».

Como o dia do mês nunca é informado, o resultado não depende de o mês ter vinte e oito ou trinta e um dias, e não recorta datas de fim de mês como um somador consciente do dia precisa fazer. Isso é uma qualidade da intenção de busca, não um campo de dia ausente: o contador de meses é a ferramenta que você abre quando o dia é irrelevante ou desconhecido.

Onde um contador de meses justifica o seu lugar

Equipes de moradia e instalações contam os meses entre um ano-mês de entrada e um ano-mês de saída quando o contrato é redigido em meses de calendário, e não em dias exatos. Ferramentas de recursos humanos informam o tempo de casa como meses completos desde um ano-mês de contratação até um ano-mês de avaliação, sem inventar um dia do mês que falta. Mesas de faturamento de assinaturas e SaaS convertem a janela de um plano em uma contagem de meses antes de aplicar uma tarifa mensal.

Gestores de projeto transformam um mês de largada e um mês de entrega em uma duração que cabe em um Gantt ou em um orçamento de preço fechado. A validação recusada não consome saldo.

Casos de uso

Prazos de locação e aluguel

Conte meses inteiros de um ano-mês de entrada até um ano-mês de saída quando o contrato é escrito em meses de calendário, não em dias exatos.

Tempo de casa em meses

Informe os meses completos desde um ano-mês de contratação até um ano-mês de avaliação ou desligamento, sem inventar um dia do mês ausente.

Janelas de assinatura e de projeto

Transforme o mês de início de um plano e o mês de término em uma contagem de períodos de faturamento, ou o mês de largada e o de entrega em uma duração de projeto.

Perguntas frequentes

O que acontece se um mês ou um ano for inválido?

Os meses devem ser inteiros de 1 a 12 e os anos inteiros de 1 a 9999. Essas falhas não são cobradas.

O contador de meses precisa do dia do mês?

Não. A intenção de busca é só a grade ano-mês. Para intervalos conscientes do dia com dias restantes, use uma ferramenta de diferença de datas que aceite datas de calendário completas.

E se a data final for anterior à data inicial?

O mesmo par na ordem inversa só inverte o sinal de months.

O mês de início entra na contagem?

Não, o contador mede a distância entre os dois meses. De janeiro de 2020 a fevereiro de 2020 há um mês, de janeiro de 2020 a janeiro de 2021 há doze, e o mesmo ano e mês dão zero.

Para que serve um contador de meses?

Para tudo o que é contado em meses do calendário, e não em dias: um aluguel da mudança à entrega das chaves, os meses de empresa para uma avaliação, uma assinatura convertida em períodos de cobrança ou um projeto do início à entrega.

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/life/month-counter

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/life/month-counter \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start_year":2020,"start_month":1,"end_year":2024,"end_month":6}'

const res = await fetch("https://api.kit.forhosting.com/life/month-counter", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "start_year": 2020,
    "start_month": 1,
    "end_year": 2024,
    "end_month": 6
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/life/month-counter",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "start_year": 2020,
    "start_month": 1,
    "end_year": 2024,
    "end_month": 6
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/life/month-counter", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"start_year":2020,"start_month":1,"end_year":2024,"end_month":6}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"start_year":2020,"start_month":1,"end_year":2024,"end_month":6}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/life/month-counter", 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

{
  "start_year": 2020,
  "start_month": 1,
  "end_year": 2024,
  "end_month": 6
}

Exemplo de resposta

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

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

Esta capacidade aceita start_year, start_month, end_year e end_month, valida cada ano como inteiro de 1 a 9999 e cada mês como inteiro de 1 a 12, e aplica a identidade months igual a ano final menos ano inicial, vezes doze, mais mês final menos mês inicial. A diferença com sinal é months; o valor absoluto é month_count. Um mês ou um ano inválido falha com invalid_input e não é cobrado.

Contrato de entrada, validação e a resposta que você recebe

Os anos devem ficar entre 1 e 9999 inclusive. Os meses devem ficar entre 1 e 12 inclusive. Cadeias numéricas como "2020" ou "06" são aceitas; booleanos, objetos, cadeias vazias e valores que não sejam inteiros não são. O motor nunca lê o relógio do sistema, de modo que dois chamadores que enviam os mesmos quatro inteiros recebem sempre o mesmo objeto. Envie quatro inteiros obrigatórios: start_year e start_month para o extremo que você trata como início, e end_year e end_month para o outro extremo. Os alias from_year, begin_year, from_month, begin_month, to_year, until_year, to_month e until_month mapeiam os mesmos quatro campos para que um formulário ou um script use os nomes que já existem no esquema. Se qualquer uma das duas datas tiver um mês ou um ano inválido, a tarefa falha com invalid_input que nomeia o campo — essas falhas não são cobradas. Em caso de sucesso o corpo ecoa os quatro inteiros validados, devolve months como a diferença com sinal, devolve month_count como a contagem absoluta de meses e reitera a fórmula para que um cliente possa imprimir a identidade ao lado da resposta. Exemplo: start_year 2020, start_month 1, end_year 2024, end_month 6 produz months 53 e month_count 53, porque quatro anos são quarenta e oito meses e de janeiro a junho somam-se mais cinco.

Onde um contador de meses justifica o seu lugar

Como a implementação é parse pura de nível A, cada chamada bem-sucedida custa o preço-base publicado US$ 0,002, sem tokens de modelo e sem rede de saída. Mantenha os dois pares ano-mês no pedido, fixe month_count nos testes e você terá uma contagem de meses reproduzível para locações, tempo de casa e faturamento sem montar uma biblioteca de calendário própria.

Perguntas técnicas

Como o contador de meses calcula os meses inteiros entre duas datas?

Ele recebe start_year, start_month, end_year e end_month e devolve months = (end_year − start_year) × 12 + (end_month − start_month). month_count é o valor absoluto dessa diferença com sinal.

Quanto custa o contador de meses?

A ferramenta do navegador é gratuita. Pedidos API usam saldo KIT pré-pago a US$ 0,002 por chamada bem-sucedida; entrada inválida não é cobrada.

Ver a documentação completa do KIT →

Executar grátis

Exemplo resolvido

O que significa a contagem de meses inteiros entre duas datas ano-mês

Onde um contador de meses justifica o seu lugar

Casos de uso

Prazos de locação e aluguel

Tempo de casa em meses

Janelas de assinatura e de projeto

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

Contrato de entrada, validação e a resposta que você recebe

Onde um contador de meses justifica o seu lugar

Perguntas técnicas

obrigado