Skip to content

Latest commit

 

History

5 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 

Repository files navigation

time.js

Biblioteca para cálculo de Horas em Javascript puro, sem dependência da classe Date();

Básica

Criar uma instância de Time() com valor 0
var t = new Time(); Time {timestamp: 0, value: "00:00:00:000"}

Criar uma instância com hora
var t = new Time('12:02:05:100'); Time {timestamp: 43325100, value: "+12:02:05:100"}

Métodos

Altera o horário, de acordo com os parâmetros fornecidos
setTime(h,m,s,ms);

Altera o horário, de acordo com a string fornecida, conforme o formato do [value] acima.
setTime(horario)

Alteram cada parte da hora. Se o valor da parte alterada exceder o valor máximo, o valor subsequente é alterado.
setHours(h);
setMinutes(m);
setSeconds(s);
setMiliseconds(ms);
Ex: setMinutes(120) aumenta 2 horas.

Retornam a parte da hora atual. O parãmetro [d] é opcional e indica o número de dígitos do retorno.
getHours(d);
getMinutes(d);
getSeconds(d);
getMiliseconds(d);
Ex: Hora = 12:03:57
getMinutes(); //retorna 3;
getMinutes(2); //retorna 03;

Retornam o valor da Hora atual, convertido no padrão solicitado.
toMinutes();
toSeconds();
toMiliseconds();
Ex: Hora = 12:03:57
toMinutes(); //retorna 12*60 + 3 = 723 minutos

positive(); //Transforma uma hora em hora positiva
negative(); //TRansforma uma hora em hora negativa

merge(Time); Combina dois objetos Time();
add(Time); Adiciona a hora de um objeto Time() ao objeto atual;
sub(Time); Subtrai a hora de um objeto Time() do objeto atual;
diff(Time); Retorna a diferença entre o objeto atual e o informado;

modify(valor); Modifica o horário atual; sintaxe similar ao PHP;
[+,-, sem sinal] hour(s) minute(s) second(s) milisecond(s)
Ex: Hora = 12:00
modify('+1 hour'); //13:00
modify('-15 minutes') //12:45
modify('60 seconds') //12:46

Adiciona o valor ao Time atual;
addHour(h);
addMinute(m);
addSecond(s);
addMilisecond(ms);
Ex: Hora = 12:00
addHour(5); //17:00

Extrai a hora de uma data;
fromDate(data);
Ex: var d = new Date();
var t = new Time;
t.fromDate(d) //Pega o horário de d;

Diferença da Hora atual do sistema;
fromNow(); //a partir de agora pra uma hora futura;
toNow(); //de uma hora passada até agora;

Novos construtores;
Time.create(hora); //Cria uma hora (parametro hora opcional);
Time.now(); //Cria uma nova hora com a hora atual;
Time.fromDate(data); //Cria uma nova hora de uma data;

log()
Método utilizado apenas durante o desenvolvimento, deve ser descontinuado na versão final
Faz o console.log() dos atributos;

About

Versão inicial da Classe Javascript Time.js

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages