Calculadora de sobriedade

Envie duas datas do calendário gregoriano no formato YYYY-MM-DD. sobriety_date é o início da sobriedade contínua, e current_date é o dia de referência porque este motor nunca lê um relógio de parede. A resposta informa os anos, meses e dias decorridos, a contagem exclusiva total_days e uma frase curta elapsed que você pode imprimir em uma ficha ou um cartão. Se a data de sobriedade cair depois da data atual, a tarefa falha com invalid_input e não é faturada.

O que o tempo decorrido em sobriedade significa em anos, meses e dias civis

Esta calculadora trata as duas pontas como datas gregorianas sem hora do dia, de modo que um início 2020-01-15 e um dia de referência 2026-07-25 equivalem a seis anos, seis meses e dez dias, com uma contagem exclusiva total_days dos dias civis inteiros entre aquelas duas meias-noites. A mesma data nos dois campos é um intervalo zero válido: se sobriety_date coincide com current_date o motor devolve zero anos, zero meses, zero dias e total_days igual a zero, o tempo exclusivo honesto no dia um.

Contrato de entrada, a regra de início futuro e o formato da resposta

Chaves de saída opcionais são omitidas em vez de definidas como null. Envie por POST um objeto JSON com dois campos de calendário obrigatórios. sobriety_date é o primeiro dia de sobriedade contínua como cadeia estrita de ano com quatro dígitos, hífen, mês com dois dígitos, hífen e dia com dois dígitos; aceitam-se os alias start_date, sober_since e date_from para que diários e formulários mantenham os nomes habituais. current_date é o dia de referência usado como hoje ou como o dia cujo tempo decorrido você quer informar; os alias as_of, as_of_date, today e date_to mapeiam para o mesmo analisador. Cada campo é validado como dia gregoriano real nos anos de um a nove mil novecentos e noventa e nove, inclusive as regras de dia bissexto, de modo que valores como 31 de abril, 29 de fevereiro num ano comum, 13-01, cadeias vazias e não cadeias falham com invalid_input nomeando o campo. Se sobriety_date cair depois de current_date o início está no futuro em relação ao dia de referência e a tarefa falha com invalid_input; o tempo decorrido em sobriedade não está definido para um início que ainda não aconteceu, e essa falha não é faturada. Em caso de sucesso o corpo ecoa as cadeias normalizadas sobriety_date e current_date, devolve inteiros years, months e days do detalhamento civil, informa total_days como a diferença ordinal exclusiva e anexa elapsed, uma frase imprimível com unidades no singular e no plural corretas, por exemplo '6 years, 6 months, 10 days' ou '1 year, 0 months, 1 day'. Acompanhe os números com o próprio texto se quiser uma inscrição na ficha; este endpoint faz só a aritmética de calendário e não emite roteiros de reunião, conselho médico nem um diagnóstico de transtorno por uso de substâncias.

Onde uma API de tempo decorrido em sobriedade agrega valor, preços e limites honestos

Fichas de recuperação, cartões de aniversário e acompanhamentos com o padrinho são o trabalho habitual: você já conhece a data de início e quer uma linha estável de anos-meses-dias para ler em voz alta ou imprimir sem subtrair meses à mão e errar fevereiro. Não conta horas, minutos nem segundos, não modela janelas de recaída e não decide se um deslize reinicia um relógio pessoal: essa política pertence à pessoa e ao programa dela. Aplicativos de bem-estar, diários de recuperação e bots de acompanhamento podem chamar o mesmo contrato em vez de recodificar tabelas de ano bissexto em cada cliente, fixando current_date a partir do dia de calendário local da pessoa para que quem cruza uma linha de data continue vendo o dia que pretendeu. Chamadas API pré-pagas usam saldo KIT a US$ 0,002 por item bem-sucedido; falhas de validação nunca consomem saldo. Isto é uma heurística de calendário, não um dispositivo médico de diagnóstico nem um substituto de um programa de recuperação, de um clínico ou do atendimento de emergência. Não confunda este endpoint com uma ferramenta genérica de diferença entre datas que as pessoas buscam quando querem subtrair duas datas quaisquer: a intenção de busca aqui é o tempo sóbrio a partir de um início de sobriedade, e o contrato de erro é a regra de início futuro que um subtrator geral não anunciaria. Mantenha as solicitações pequenas, fixe nos testes os years, months, days e total_days devolvidos, e você obtém sobriedade decorrida reproduzível para corretores de tarefa, plugins de LMS e workers de borda sem levantar uma biblioteca de calendário própria.