Calculadora de tempo de serviço
De 1º de março de 2018 a 20 de agosto de 2024 são 6 anos, 5 meses e 19 dias, 2364 dias no total. Informe a data de admissão e a de referência e veja o tempo de serviço como na ficha funcional. 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 início
- 2018-03-01
- Data final
- 2024-08-20
- Anos
- 6
- Meses
- 5
- Dias
- 19
- Total de dias
- 2.364
Tempo de serviço é o intervalo civil decorrido entre uma data de início e uma data de término, escrito como anos completos, meses restantes e dias restantes. Folhas de pagamento, listas de premiação por tempo de casa, extratos de empréstimo, pedidos de visto e quadros de antiguidade sindical pedem esse detalhamento em vez de um total bruto de dias. Esta calculadora de tempo de serviço aceita dois dias de calendário ISO estritos, valida-os no calendário gregoriano proléptico —incluindo fevereiros bissextos— e devolve anos, meses, dias, o trecho total de dias civis e uma frase curta de tempo de casa.
Como o tempo de serviço civil é contado em anos, meses e dias
O tempo de serviço civil é o vão de calendário já concluído entre uma data de contratação, originação ou início e um dia de corte ou de desligamento, escrito como um dossiê de pessoal escreveria o tempo de casa: anos, depois meses restantes, depois dias restantes. Subtrair contagens de dias e dividir por 365.25 não produz essa forma, porque os meses têm comprimentos desiguais e fevereiro muda nos anos bissextos. Esta calculadora analisa duas datas de calendário ISO estritas no formato ano-mês-dia com quatro, dois e dois dígitos.
Cada ano deve estar entre um e nove mil novecentos e noventa e nove, cada mês entre um e doze, e cada dia deve existir naquele mês segundo as regras bissextas gregorianas prolépticas: um ano é bissexto quando é divisível por quatro, salvo que um ano secular só o é quando também é divisível por quatrocentos. Essa regra torna legal o vinte e nove de fevereiro em dois mil e vinte e quatro e dois mil, e ilegal em dois mil e vinte e três e mil e novecentos.
Depois que ambas as datas são válidas, o motor conta meses de calendário do início rumo ao término e os soma com recorte de fim de mês, de modo que o trinta e um de janeiro mais um mês cai no vinte e oito ou no vinte e nove de fevereiro, nunca em um dia impossível. Se a data recortada ainda ficar depois do término, a contagem de meses recua um para não reivindicar um mês que não foi concluído.
Os dias restantes são o resto inteiro do número de dia juliano desde essa última soma completa de mês até a data de término. Os anos são a contagem de meses dividida por doze; os meses restantes são o resto.
Onde uma calculadora de tempo de serviço entra em RH, finanças e conformidade
Equipes de recursos humanos e operações de pessoas calculam o tempo de casa para períodos de experiência, premiações, cliffs de vesting e quadros de antiguidade, e precisam de anos-meses-dias em vez de uma contagem bruta de dias. Motores de folha e benefícios guardam uma data ISO de contratação e um dia de corte quando imprimem uma linha de tempo de serviço em um holerite ou em um extrato de benefícios.
Servicers de hipoteca e empréstimo pessoal informam há quanto tempo uma facilidade está em aberto desde a originação até a data do extrato, uma busca diferente de uma calculadora EMI que toma o prazo como entrada em meses. Balcões de imigração, sindicatos e setor público costumam exigir anos completos e meses restantes de serviço contínuo em um dia de protocolo. Autores de currículo de aritmética de calendário querem um oráculo que recuse datas invertidas e fevereiros impossíveis em vez de uma planilha que transborda dias em silêncio.
Se mais adiante você precisar de idade civil a partir de um nascimento, de um número de aniversário concluído, só de meses inteiros ou de uma diferença de dias com sinal, trate isso como intenções de busca e páginas distintas, sem sobrecarregar esta página de tempo de serviço. A consulta digitada é calculadora de tempo de serviço; o contrato obtido são duas datas ISO na entrada e um detalhamento de anos, meses e dias na saída.
Casos de uso
Tempo de casa no emprego
A partir de uma data ISO de contratação e um dia de corte, obtenha anos completos, meses restantes, dias restantes e uma frase legível de tempo de serviço para experiência, premiações e listas de antiguidade.
Período em aberto de empréstimo ou facilidade
Meça há quanto tempo um empréstimo, um arrendamento ou uma facilidade está em aberto desde a originação até a data do extrato, em anos, meses e dias — não como um prazo EMI em meses.
Serviço contínuo e datas de protocolo
Calcule o tempo de serviço civil concluído para protocolos de imigração, sindicato ou setor público que pedem a duração do serviço contínuo em um dia de calendário específico.
Perguntas frequentes
Como calcular o tempo de serviço entre duas datas?
O mesmo dia de calendário nos dois lados é tempo de serviço zero.
O que acontece se a data de término for anterior à de início?
O tempo de serviço decorrido não pode ser negativo; um par invertido é erro do cliente e não é cobrado.
O dia de início conta como um dia inteiro de tempo de serviço?
O tempo de serviço é tempo civil concluído, como a idade: o próprio dia de início são zero anos, zero meses e zero dias.
Como são tratados inícios em fim de mês e em dia bissexto?
Ao somar meses de calendário, o dia é recortado para o último do mês de destino, de modo que 31 de janeiro mais um mês é 28 ou 29 de fevereiro. Um início em 29 de fevereiro observado em um ano comum recorta para 28 de fevereiro. Datas impossíveis como 2023-02-29 são recusadas.
Por que não basta dividir os dias pela duração de um ano?
Porque os meses têm tamanhos diferentes e fevereiro muda nos anos bissextos. A calculadora conta primeiro os meses completos do calendário e depois os dias que sobram, que é o formato pedido pela folha de pagamento e pelo RH.
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/fin/tenure \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"start_date":"2018-03-01","end_date":"2024-08-20"}'const res = await fetch("https://api.kit.forhosting.com/fin/tenure", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"start_date": "2018-03-01",
"end_date": "2024-08-20"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/fin/tenure",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"start_date": "2018-03-01",
"end_date": "2024-08-20"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/fin/tenure", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"start_date":"2018-03-01","end_date":"2024-08-20"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"start_date":"2018-03-01","end_date":"2024-08-20"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/tenure", 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_date": "2018-03-01",
"end_date": "2024-08-20"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "fin.tenure",
"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.
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
Se a data de término for anterior à de início, a tarefa falha com invalid_input em vez de inventar uma duração negativa.
Contrato de entrada, forma da resposta e erros de datas invertidas
A primeira é o dia de início, contratação ou originação; a segunda é o dia de corte ou o último dia do intervalo. Cada valor deve ser um dia de calendário ISO estrito, por exemplo dois mil e dezoito hífen zero três hífen zero um. Ligue o formulário gratuito do navegador para checagens de mesa e chame o mesmo contrato a partir de scripts quando precisar de listas em lote de tempo de casa. Envie duas strings obrigatórias, start_date e end_date. Os aliases start, from, begin e hire_date para o primeiro campo, e end, to, until, as_of e reference_date para o segundo, são aceitos pelo mesmo núcleo para que scripts de folha e formulários de busca mantenham nomes familiares sem mudar a matemática. Campos ausentes, strings vazias, valores que não são string, strings que não coincidem com o padrão de quatro-dois-dois dígitos, anos fora de um a nove mil novecentos e noventa e nove, meses fora de um a doze, e dias que não existem naquele mês (o trinta e um de abril, o vinte e nove de fevereiro em um ano comum) falham todos com invalid_input nomeando o campo, e essas falhas não são cobradas. Se end_date for anterior a start_date, a tarefa também falha com invalid_input: o tempo de serviço decorrido não pode ser negativo, e um par invertido é erro do cliente, não uma duração com sinal. O mesmo dia de calendário nos dois lados é legal e devolve zero anos, zero meses, zero dias e zero total_days: o intervalo começou, mas nenhum dia civil foi concluído. Em caso de sucesso, o corpo ecoa as strings ISO normalizadas de start_date e end_date; os inteiros years, months e days; total_days como o trecho não negativo de dias civis; uma frase curta de tempo de serviço em inglês com unidades no singular ou no plural; e uma string formula que documenta o algoritmo de meses civis. Chamadas API bem-sucedidas usam a base publicada de US$ 0,002 por item; falhas de validação não consomem saldo pré-pago.
Onde uma calculadora de tempo de serviço entra em RH, finanças e conformidade
Como esta capacidade é um motor parse puro, cada chamada bem-sucedida custa o preço base publicado de US$ 0,002 sem tokens de modelo e sem rede de saída, e a validação falha não consome saldo pré-pago.
Perguntas técnicas
Quanto custa a calculadora de tempo de serviço?
A ferramenta do navegador é gratuita. Solicitações API usam saldo pré-pago KIT a US$ 0,002 por chamada bem-sucedida; entrada inválida não é cobrada.