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.