Javascript: O Objeto Date()

Olá! O objeto deste artigo permite trabalhar com datas e horas, mostrarei como pode ser instanciado o objeto e comentarei seus principais métodos e propriedades. No final mostrarei um simples script usando o objeto.

Objeto

Com esse objeto é possível trabalhar com datas e horas em Javascript. Para que isso seja possível é preciso instanciar o objeto. Para criar o objeto Date, basta instanciar a classe, se nenhum parâmetro for fornecido, são assumidas a data e hora corrente, isto é, do computador que executa script.

new Date()

Para instanciar a classe com data e hora determinada, deve ser passado parâmetros. Existem varias maneiras de criar, como apresentadas a seguir:

new Date(milissegundos)

new Date(string_de_data)

new Date(ano, mes, dia)

new Date(ano, mes, dia, hora, minuto, segundo, milissegundo)

Todos os parâmetros passados no construtor devem ser numéricos. Com relação ao parâmetro mês, o numero 0 representa Janeiro e o 11 Dezembro. Se não for passada a hora, o objeto iniciará com a hora 00:00:00.

Com exceção da segunda opção que pode ser instanciada passando uma string da seguinte maneira:

var data = new Date("Jan 1, 2000 00:00:00");

A data e hora no Javascript começam em 00:00:00 h GMT de 01 de janeiro de 1970. Se você tentar criar uma instancia com uma data anterior irá obter um resultado aleatório.

Métodos

O objeto Date não possui propriedade, por outro lado, possui muitos métodos. A seguir serão apresentados alguns dos seus principais métodos.

- getDate()
Devolve o dia do mês, um inteiro entre 1 e 31. Não confundir com getDay que retorna o dia da semana.

- getDay()
Devolve o dia da semana, inteiro entre 0 e 6 (0 para Domingo).

- getHours()
Retorna a hora, inteiro entre 0 e 23.

- getMinutes()
Devolve os minutos, inteiro entre 0 e 59.

- getSeconds()
Devolve os segundos, inteiro entre 0 e 59.

- getMonth()
Devolve o mês, um inteiro entre 0 e 11 (0 para Janeiro).

- getTime()
Devolve os segundos transcorridos entre o dia 1 de janeiro de 1970 e a data correspondente ao objeto ao que se passa a mensagem.

- getYear()
Retorna o ano, os últimos dois números do ano. Por exemplo, para o 2006 retorna 06. Este método está obsoleto em Netscape a partir da versão 1.3 de Javascript e agora se utiliza getFullYear().

- getFullYear()
Retorna o ano com todos os dígitos. Funciona com datas posteriores ao ano 2000.

- setDate(d)
Atualiza o dia do mês.

- setHours(h)
Atualiza a hora.

- setMinutes(m)
Muda os minutos.

- setMonth(m)
Muda o mês (atenção ao mês que começa por 0).

- setSeconds(s)
Muda os segundos.

- setTime(t)
Atualiza a data completa. Recebe um número de segundos desde 1 de janeiro de 1970.

- setYear(y)
Muda o ano, recebe um número, ao que lhe soma 1900 antes de colocá-lo como ano data. Por exemplo, se receber 95 colocará o ano 1995. Este método está obsoleto a partir de Javascript 1.3 em Netscape. Agora se utiliza setFullYear(), indicando o ano com todos os dígitos.

- setFullYear()
Muda o ano da data ao número que recebe por parâmetro. O número se indica completo ex: 2005 ou 1995. Utilizar este método para estar certo de que tudo funciona para datas posteriores a 2000.

- getimezoneOffse()
Devolva a diferença entre a hora local e a hora GMT (Greenwich, UK Mean Time) sob a forma de um inteiro representando o número de minutos (e não em horas).

- toGMTString()
Devolva o valor do atual em hora GMT (Greenwich Mean Time)

Aplicação

A página abaixo é a página que terá todas as funções JavaScript apresentadas a seguir. A DIV chamada de datahora é utilizada para mostrar a hora e a data, que serão geradas por uma função JavaScript chamada “mostrarDataHora()”.

A função recebe como parâmetros a hora, o dia da semana, o dia do mês, o mês e o ano. Realiza uma formatação e retorna a DIV chamada de datahora já apresentada.

Na tag body do html existe um método chamado onload, esse método chama a função atualizarDataHora(), que seja mostrada a seguir. O evento onload de Javascript se ativa quando termina de ser carregada. Deve ser colocado na tag <body>, embora em versões modernas de Javascript, também o aceitam outros elementos como as imagens.

Com o evento onload podemos executar ações justo quando terminem de se carregar todos os elementos da página. É um evento bastante utilizado, pois é muito habitual que seja desejado realizar ações nesse preciso instante. Em nosso exemplo, vamos ver ativar uma função para atualizar a hora a cada segundo.

A função cria um objeto Date() na linha 3, esse objeto será usado para pegar todos os dados que precisamos para a nossa aplicação utilizando os principais métodos que já foram apresentados neste artigo.

Nas linhas 5 e 6 são chamadas duas funções, para pegar o dia e o mês por extenso respectivamente passando apenas um inteiro. Os arrays foram inicializados com os dias da semana e os meses do ano.

Com todas as informações nas mãos, é chamado o método mostrarDataHora() passando todos os parâmetros já mencionados anteriormente.

A função setTimeout() recebe dois parâmetros, o primeiro é a função que o programador deseja executar e o segundo parâmetro seta um tempo em milissegundos para ser realizada a função, período configurado neste exemplo para 1000 milissegundos, ou seja, 1(um) segundo.

Clique aqui para fazer o download do código-fonte

Um abraço a todos e até a próxima.

Referencias

http://www.w3schools.com