ForHosting KIT · Datas e tempo

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
Use pelo WebAPIE-mailTelegramApp em breve
Se você digitar
Data de contratação
2018-03-15
Data de referência
2026-07-25
Você obtém
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.

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.

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.

POSThttps://api.kit.forhosting.com/date/years-of-service

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

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"}'
{
  "hire_date": "2018-03-15",
  "reference_date": "2026-07-25"
}
{
  "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.

por chamadaUS$ 0,002

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

HTTPCódigoO que significa
401unauthorizedToken ausente ou inválido. Confira o header Authorization.
402insufficient_balanceSaldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
404unknown_typeEsse tipo de tarefa não existe. Confira o campo type no catálogo.
429rate_limitedMuitas requisições em pouco tempo. Espere um instante e tente de novo.

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.

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.

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.

Ver a documentação completa do KIT →