Calculadora de anos de serviço
Quem foi admitido em 15 de março de 2018 soma 8 anos, 4 meses e 10 dias em 25 de julho de 2026. Digite a admissão e a data de corte para conferir prêmios por tempo de casa ou prazos de carência em anos completos. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Data de contratação
- 2018-03-15
- Data de referência
- 2026-07-25
- Anos de serviço
- 8
- Meses
- 4
- Dias
- 10
- Total de dias
- 3.054
Equipes de RH, engenharia de folha e administradores de benefícios procuram uma calculadora de anos de serviço quando precisam do tempo completo entre a data de admissão e uma data de corte que nunca deslize com o relógio do servidor. Esta capacidade aceita a data de início do emprego e uma data de referência obrigatória, aplica regras gregorianas prolépticas com ajuste ao fim do mês e devolve anos de serviço inteiros completados mais meses e dias restantes. Use-a sempre que o texto do produto fale de cinco anos de serviço, pins de dez anos ou penhascos de vesting medidos em anos de calendário completados, e não em contagens brutas de dias divididas por trezentos e sessenta e cinco.
Data de admissão, data de referência e por que o relógio nunca é usado
Cada valor deve ser um dia civil no formato YYYY-MM-DD, por exemplo dois mil e dezoito hífen zero três hífen quinze para a admissão e dois mil e vinte e seis hífen zero sete hífen vinte e cinco para o instantâneo de avaliação. Você pode enviar um prefixo de data-hora ISO-8601 completo; se houver hora, só a parte de calendário é usada, porque anos de serviço para benefícios são uma medida de data a data, não uma duração de relógio com fusos.
Os anos vão de um a nove mil novecentos e noventa e nove, os meses de um a doze, e o dia deve existir nesse mês sob regras de bissexto gregorianas, incluindo vinte e nove de fevereiro só em anos bissextos. Se a data de referência cair estritamente antes da admissão, a solicitação falha com uma mensagem clara de que os anos de serviço não podem ser negativos, em vez de inventar um tempo com sinal que a maioria das interfaces rotularia mal como serviço completado.
Como se contam os anos, meses e dias completados
Os campos months e days completam o trecho residual após esses anos inteiros, para que painéis mostrem tanto o penhasco de vesting quanto um resto legível. O algoritmo mede meses de calendário inteiros da admissão em direção à referência, ajustando o dia do mês quando o mês de destino é mais curto: uma admissão em trinta e um de janeiro avança um mês até o último dia de fevereiro em anos bissextos e não bissextos.
Se essa data provisória ao avançar meses ultrapassar a referência, o motor recua um mês e informa o trecho restante em dias civis inteiros. Os anos de serviço são o total de meses inteiros dividido por doze; os meses, o resto módulo doze; os dias fecham o triplo. Esse desdobramento alinha-se melhor à linguagem comum de RH sobre anos de serviço completados do que dividir os dias totais por um comprimento médio fixo de ano, que desvia em bissextos e meses longos.
Tempo de casa para benefícios e limites do cálculo
Use a calculadora gratuita de anos de serviço no navegador para demos de RH, autoatendimento de gestores e checagens pontuais de prêmios sem instalar bibliotecas de data nem enviar um banco de fusos a cada cliente. Mantenha expectativas honestas: esta capacidade mede tempo civil gregoriano entre duas datas explícitas; não ignora fins de semana como tempo comercial, não carrega calendários de feriados, não aplica tabelas sindicais de aniversário, não rateia prêmios de ano parcial nem define a referência como hoje no servidor.
As entradas seguem as mesmas regras de retenção de outros itens parse do KIT. Como a implementação é parse pura de nível A, cada chamada bem-sucedida permanece barata, determinística e livre de tokens de modelo ou rede de saída, exatamente o que suítes de regressão precisam ao fixar casos de aniversário por décadas de datas de admissão.
Perguntas frequentes
E se a data de referência for anterior à admissão?
Anos de serviço não podem ser negativos; corrija o par ou troque campos só se o seu produto medir de propósito uma data de início futura.
Como são tratadas admissões em dia bissexto e aniversários de fim de mês?
Meses e anos avançam com ajuste ao último dia válido do mês de destino. Uma admissão em 29 de fevereiro vira 28 de fevereiro em aniversários de anos não bissextos, alinhada à prática civil comum de RH.
Quanto custa a calculadora de anos de serviço?
A ferramenta no navegador é gratuita no seu dispositivo.
Por que não basta dividir os dias trabalhados por 365?
Porque prêmios e regras de carência contam anos de calendário completos, e os anos bissextos fazem uma contagem de dias se desviar. Contar anos, depois meses e depois dias dá o número que a política de RH quer dizer.
O tempo de serviço é calculado até hoje automaticamente?
Não. A data de referência é sempre obrigatória e nenhum relógio é consultado, então as mesmas duas datas dão o mesmo tempo de serviço em qualquer computador, país ou momento.
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
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/years-of-service \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"hire_date":"2018-03-15","reference_date":"2026-07-25"}'const res = await fetch("https://api.kit.forhosting.com/date/years-of-service", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"hire_date": "2018-03-15",
"reference_date": "2026-07-25"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/years-of-service",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"hire_date": "2018-03-15",
"reference_date": "2026-07-25"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/years-of-service", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"hire_date":"2018-03-15","reference_date":"2026-07-25"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"hire_date":"2018-03-15","reference_date":"2026-07-25"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/years-of-service", 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
{
"hire_date": "2018-03-15",
"reference_date": "2026-07-25"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.years_of_service",
"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
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
Dias de calendário inválidos e pares de datas invertidos falham com invalid_input e não são cobrados; itens corretos custam US$ 0,002 do saldo KIT.
Data de admissão, data de referência e por que o relógio nunca é usado
Envie dois campos de string obrigatórios: hire_date e reference_date. Os aliases opcionais hire, start_date, employment_start e from mapeiam para o campo de admissão; reference, as_of, to, on e evaluation_date para o de referência, para que formulários de RH e SDKs mantenham nomes familiares. Ambos os campos são obrigatórios de propósito: uma calculadora de tempo de casa que substitui em silêncio o relógio do host produz respostas diferentes em CI, em um laptop de outra região e em um worker de API em UTC, o que quebra auditorias de prêmios e exportações de folha reproduzíveis. Pares impossíveis como dois mil e vinte e três hífen zero dois hífen vinte e nove são rejeitados com invalid_input em vez de serem forçados para março.
Como se contam os anos, meses e dias completados
Em caso de sucesso a resposta ecoa hire_date e reference_date normalizados como YYYY-MM-DD, e então years_of_service como a contagem de anos de calendário inteiros de tempo de casa completados—o número que as regras de elegibilidade costumam significar ao dizer cinco anos de serviço. O campo total_days é a diferença civil exclusiva entre os dois ordinais: o mesmo dia de calendário rende zero total_days e zero anos de serviço, enquanto o dia seguinte rende um dia de serviço. Os campos last_anniversary e next_anniversary são as datas de aniversário de admissão após years_of_service e years_of_service mais um ano completado, com admissões em vinte e nove de fevereiro ajustadas para vinte e oito de fevereiro em anos-alvo não bissextos.
Uso da API, preços, fluxos de benefícios e limites honestos
Faça POST de um corpo JSON compacto com as strings hire_date e reference_date. Chame a API pré-paga quando lotes de folha, portões de vesting de equity, faixas de acúmulo de PTO ou programas de prêmio por serviço precisarem de um contrato estável sob saldo KIT a US$ 0,002 por item bem-sucedido; falhas de validação nunca consomem saldo após a rejeição do motor. Combine este endpoint com uma ferramenta de contagem de dias quando você também precisar só do comprimento do intervalo, ou com uma de idade em anos, meses e dias quando o produto deva calcular idade civil a partir de um nascimento e não tempo de emprego a partir de uma admissão—são intenções de busca e nomes de campo diferentes embora a aritmética de calendário seja aparentada. Autores de SDK podem mapear years_of_service para um selo principal de elegibilidade e expor months, days e a string formatted em rótulos de acessibilidade, com a mesma forma de resposta em cada binding de idioma.
Casos de integração
Prêmios de serviço e programas de reconhecimento
Avalie hire_date contra uma cerimônia de prêmio ou um reference_date de corte fiscal para decidir quem completou cinco, dez ou vinte anos de serviço antes de imprimir certificados.
Vesting de benefícios e penhascos de elegibilidade
Condicione o vesting de match de plano, licença por longo serviço ou benefícios de educação a years_of_service completados do início do emprego até a data de avaliação do plano.
Exportações em lote de folha e HRIS
Capture o tempo de cada colaborador contra uma única data as-of de folha para que relatórios e testes golden reproduzam os mesmos anos, meses e dias a cada execução.
Perguntas técnicas
Como calcular anos de serviço a partir de uma data de admissão?
Envie JSON com hire_date e reference_date em YYYY-MM-DD. A resposta inclui years_of_service (anos inteiros completados), months, days, total_days, last_anniversary, next_anniversary e uma string formatted.
Isto usa a data de hoje automaticamente?
Não. reference_date é obrigatório. O motor nunca lê o relógio do sistema, então os resultados ficam idênticos em CI, navegadores e workers de API.