Calculadora de aniversário laboral

Dias de calendário inválidos e pares 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. 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 calculam o próximo aniversário e os dias restantes

O motor primeiro conta os anos de aniversário completados somando anos de calendário inteiros à data de admissão com ajuste ao fim do mês, e então pergunta se essa data ajustada cai exatamente na referência. Se cair, e pelo menos um ano de emprego já passou, hoje é o aniversário e a contagem é zero. Caso contrário a próxima data é mais um ano de calendário à frente. É uma intenção de busca diferente de uma calculadora de tempo de casa já cumprido: aquela responde quanto tempo já foi completado; esta responde quando o próximo pin, cartão ou lembrete do Slack deve disparar. Em caso de sucesso a resposta ecoa hire_date e reference_date normalizados como YYYY-MM-DD, e então next_anniversary como a data civil do próximo aniversário de emprego na referência ou depois dela. O campo days_remaining é a diferença exclusiva de dias inteiros entre esses dois ordinais, de modo que o próprio dia do aniversário rende zero dias restantes e is_anniversary é verdadeiro. O campo anniversary_number é o ordinal até o qual se conta ou que se celebra hoje: o primeiro aniversário é um ano após a admissão, o quinto é cinco anos depois, e assim por diante. Admissões em vinte e nove de fevereiro tornam-se vinte e oito de fevereiro em anos-alvo não bissextos, alinhadas à prática civil comum de recursos humanos, e leap_adjusted é verdadeiro quando esse ajuste se aplicou à próxima data. O campo last_anniversary só entra quando pelo menos um aniversário já ocorreu; omite-se no próprio dia da admissão e ao longo do primeiro ano incompleto para que chaves opcionais nunca apareçam como null.

Uso da API, preços, fluxos de lembrete 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 lembretes, agendadores de cartões eletrônicos, widgets de intranet ou bots do Slack 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 tempo de casa já cumprido quando você também precisar de anos, meses e dias de serviço já ganhos, ou com uma de contagem de dias genérica quando o produto só precisa do comprimento de um intervalo sem se importar com o número do aniversário. Autores de SDK podem mapear next_anniversary e days_remaining para um selo principal de contagem e expor anniversary_number mais a string formatted em rótulos de acessibilidade, com a mesma forma de resposta em cada binding de idioma.