Calculadora de aniversario laboral

Los días de calendario inválidos y los pares invertidos fallan con invalid_input y no se facturan; los ítems correctos cuestan $0.002 del saldo KIT.

Fecha de alta, fecha de referencia y por qué no se usa el reloj

Cada valor debe ser un día civil en forma YYYY-MM-DD, por ejemplo dos mil diecinueve guion cero seis guion cero uno para el alta y dos mil veintiséis guion cero siete guion veinticinco para la instantánea de evaluación. Puede enviar un prefijo de fecha-hora ISO-8601 completo; si hay hora, solo se usa la parte de calendario, porque un aniversario laboral es un suceso civil de fecha a fecha, no una duración de reloj con zonas horarias. Los años van de uno a nueve mil novecientos noventa y nueve, los meses de uno a doce, y el día debe existir en ese mes bajo reglas de bisiesto gregorianas, incluido el veintinueve de febrero solo en años bisiestos. Si la fecha de referencia cae estrictamente antes del alta, la petición falla con un mensaje claro de que el próximo aniversario laboral no puede preceder al inicio del empleo, en lugar de inventar una cuenta atrás con signo que la mayoría de interfaces etiquetarían mal como días restantes. Envíe dos campos de cadena obligatorios: hire_date y reference_date. Los alias opcionales hire, start_date, employment_start y from se asocian al campo de alta; reference, as_of, to, on y evaluation_date al de referencia, para que formularios de RR. HH. y SDK conserven nombres habituales. Pares imposibles como dos mil veintitrés guion cero dos guion veintinueve se rechazan con invalid_input en lugar de forzarlos a marzo.

Cómo se calculan el próximo aniversario y los días restantes

El motor cuenta primero los años de aniversario completados sumando años de calendario enteros a la fecha de alta con ajuste a fin de mes, y luego pregunta si esa fecha ajustada cae exactamente en la referencia. Si es así, y ha transcurrido al menos un año de empleo, hoy es el aniversario y la cuenta atrás es cero. En caso contrario la fecha siguiente es un año de calendario más adelante. Es una intención de búsqueda distinta de una calculadora de antigüedad ya cumplida: aquella responde cuánto tiempo se ha completado; esta responde cuándo debe dispararse el próximo pin, tarjeta o recordatorio de Slack. En caso de éxito la respuesta repite hire_date y reference_date normalizados como YYYY-MM-DD, y luego next_anniversary como la fecha civil del próximo aniversario de empleo en o después de la referencia. El campo days_remaining es la diferencia exclusiva de días enteros entre esos dos ordinales, de modo que el propio día de aniversario da cero días restantes e is_anniversary es verdadero. El campo anniversary_number es el ordinal al que se cuenta atrás o que se celebra hoy: el primer aniversario es un año después del alta, el quinto es cinco años después, y así sucesivamente. Las altas del veintinueve de febrero pasan al veintiocho de febrero en años destino no bisiestos, según la práctica civil habitual de recursos humanos, y leap_adjusted es verdadero cuando ese ajuste se aplicó a la fecha siguiente. El campo last_anniversary solo se incluye cuando ya ha ocurrido al menos un aniversario; se omite el propio día de alta y durante el primer año incompleto para que las claves opcionales no aparezcan como null.

Uso de la API, precios, flujos de recordatorio y límites honestos

Haga POST de un cuerpo JSON compacto con las cadenas hire_date y reference_date. Llame a la API de prepago cuando lotes de recordatorios, programadores de tarjetas electrónicas, widgets de intranet o bots de Slack necesiten un contrato estable con saldo KIT a $0.002 por ítem correcto; los fallos de validación no consumen saldo tras el rechazo del motor. Los autores de SDK pueden mapear next_anniversary y days_remaining a una insignia principal de cuenta atrás y mostrar anniversary_number más la cadena formatted en etiquetas de accesibilidad, con la misma forma de respuesta en cada enlace de idioma.