Date Difference Calculator

date-difference-calculator é uma biblioteca Node.js para calcular a diferença de tempo entre a data atual e uma data fornecida em dias, horas e minutos. Se a data fornecida estiver no passado, a função retornará uma mensagem de erro.

Instalação

Você pode instalar a biblioteca via npm:

npm install date-difference-calculator

Uso

Aqui está um exemplo de como usar a biblioteca:

const { calculateTimeDifference } = require('date-difference-calculator');

try {
    const result = calculateTimeDifference('2024-12-25T00:00:00');
    if (result.error) {
        console.error(result.error);
    } else {
        console.log(`Days: ${result.days}, Hours: ${result.hours}, Minutes: ${result.minutes}`);
    }
} catch (error) {
    console.error(error.message);
}

API

calculateTimeDifference(targetDate)

Calcula a diferença de tempo entre a data atual e a data fornecida.

Parâmetros

• targetDate (string): A data alvo em um formato reconhecido pelo construtor Date do JavaScript.

Retorno

• Um objeto contendo a diferença de tempo em dias, horas e minutos, ou uma mensagem de erro se a data fornecida estiver no passado.

Exemplo de Retorno

Se a data fornecida estiver no futuro:

{
    "days": 10,
    "hours": 5,
    "minutes": 30
}

Se a data fornecida estiver no passado:

{
    "error": "The date provided is in the past"
}

Contribuição

Se você encontrar algum problema ou tiver sugestões de melhoria, sinta-se à vontade para abrir uma issue ou um pull request no repositório do GitHub.

Licença

Este projeto está licenciado sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

Autor

Thiago Lima

Agradecimentos

Obrigado por usar date-difference-calculator! Se você tiver alguma dúvida ou precisar de ajuda, entre em contato.

Certifique-se de atualizar as informações de acordo com suas necessidades específicas, incluindo seu nome e quaisquer outros detalhes que sejam relevantes para o seu projeto.