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 é minutos. Se a data fornecida estiver no passado, a função retornará uma mensagem de erro.

Instalação

Voçe pode instalar a biblioteca via npm:

npm install date-difference-calculator

Uso

Aqui está um exemplo de como usar a biblioteca:

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

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

API

calculelateTimeDifference(targetData)

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 Data do JavaScript.

Retorno

• Um objeto contendo a diferença de tempo em dias, horas e minutos, ou uma mensagem de erro 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 the past"
}

Contribuição

Se voçê 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 porjeto está licenciado sob a licença MIT. Veja o arquivo LICENSE

Autor

Lauro Silva

Agradecimentos

Obrigado por usar date-difference-calculator! Se voçê tiver alguma duvida 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 quisquer outros detalhes que sejam relevantes para o seu projeto.