Tutorial JavaScript - Objeto Date

JavaScript - Guia de Referência
© 1997 Anderson Barros Torres

Date

Objeto muito útil que retorna a data e hora do sistema no seguinte formato: Dia da semana, Nome do mês, Dia do mês, Hora:Minuto:Segundo e Ano.

Como todo objeto, podem ser criadas novas instâncias para este objeto, o que é muito comum por sinal, essa prática possibilita a utilização de quantos objetos data você precisar.

Forma geral:
NovoObjeto = NEW date( )

Onde:
NovoObjeto = Objeto definido pelo usuário, para manipular datas. (este objeto foi definido com o comando NEW, que criou uma nova instância do objeto date( )).

Métodos:
getMonth - Obtém o número do mês. Retornando um valor entre 0 e 11. ( janeiro=0)
Ex: Mes=NovoObjeto.getMonth( )

setMonth - Estabelece um novo valor para o mês. O valor deve estar entre 0..11
Ex: NovoObjeto.setMonth(NumeroDoMes)

getDate - Obtém o número do dia, considerando-se o mês. Retornando um valor numérico entre 1..31.
Ex: dia = NovoObjeto.getDate( )

setDate - Estabelece um novo valor para o dia do mês. Este valor deve estar entre 1..31
Ex: NovoObjeto.setDate(NumeroDoDia)

getDay - Obtém o número do dia, considerando-se a semana. Retornando um valor numérico entre 0..6. Lembre-se de que a semana começa no domingo, logo 0, corresponde ao domingo.
Ex: DiaDaSemana = NovoObjeto.getDay( )

getHours - Obtém um número correspondente a hora. Retornando um valor numérico entre 0..23
Ex: Hora = NovoObjeto.getHours( )

setHours - Estabelece um novo valor para a hora. O valor deve estar entre 0..23
Ex: NovoObjeto.setHours(NovaHora)

getMinutes - Obtém um número correspondente aos minutos. Retornando um valor numérico entre 0..59
Ex: Minutos = NovoObjeto.getMinutes( )

setMinutes - Estabelece um novo valor para os minutos. O valor deve estar entre 0..59
Ex: NovoObjeto.setMinutes(Minutos)

getSeconds - Obtém um número correspondente aos segundos. Retornando um valor numérico entre 0..59
Ex: Segundos = NovoObjeto.getSeconds( )

setSeconds - Estabelece um novo valor para os segundos. O valor deve estar entre 0..59
Ex: NovoObjeto.setSeconds(Segundos)

getTime - Obtém o tempo decorrido desde 01/01/70 até o presente momento. O único incoveniente é que esta data é dada em milissegundos.
Ex: TempoDecorrido=NovoObjeto.getTime( )

setTime - Estabelece uma nova data.
Ex: DataDeNascimento=New Date("August 2, 1970")

uma outra forma para definir a data seria:
OutraForma = New Date( )
OutraForma.setTime(DataDeNascimento.getTime( ))

getTimezoneOffset - Obtém a diferença entre o horário local e o horário do meridiano central (Greenwich). Este tempo é dado em minutos, logo, para saber o fuso-horário, deve-se dividir o resultado obtido por esta função por 60.
Ex: FusoHorário=NovoObjeto.getTimezoneOffset( ) / 60

getYear - Obtém um valor numérico correspondente ao ano.
Ex: Ano=NovoObjeto.getYear ( )

setYear - Estabelece um novo valor ao ano. O valor deve ser maior ou igual a 1900.
Ex: NovoObjeto.setYear(1997)

toGMTstring - Converte um objeto data para uma string seguindo o padrão Internet GMT.
Ex: NovoObjeto.toGMTstring( )

toLocaleString - Converte uma data para uma string seguindo o padrão local.
Ex: NovoObjeto.toLocalString( )

Exemplo:

<HTML>
<HEAD>
<TITLE>Exemplo - Objeto Date</TITLE>

<SCRIPT>



</SCRIPT>
</head>

<BODY BACKGROUND="b190.gif" onLoad="startclock ()">

<H1>Exemplo:</H1>

Demonstração do objeto Date, conforme visto na página anterior. Funcionamento: a data e hora ficam sendo mostradas no rodapé do browser.

<FORM>
<CENTER>
<BR>
<INPUT TYPE="button" VALUE="Página Anterior" onClick="history.go(-1)">
</CENTER>
</FORM>
<CENTER>

<H6>Página desenvolvida por <A HREF="mailto:esaex@canudos.ufba.br">Anderson Barros Torres</A>. Julho/97</H6>

</CENTER>
</BODY>
</HTML>

Página desenvolvida por Anderson Barros Torres. Julho/97
Última alteração: