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

Use

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(targetData)

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

Parâmetros

• targetDate (String): Adata 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 de a data fornecida estiver no passado.

Exemplos 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.

Autor

Lucikelly Santos

Agradecimentos

Obrigada 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.