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>
 
<!--
var timerID = null;
var timerRunning = false;
function startclock ()
{
     stopclock();
     time();
}
 
function stopclock ()
{
     if(timerRunning)
     clearTimeout(timerID);
     timerRunning = false;
}
 
function time ()
{
     var now = new Date();
     var yr = now.getYear();
     var mName = now.getMonth() + 1;
     var dName = now.getDay() + 1;
     var dayNr = ((now.getDate()<10) ? "0" : "")+ now.getDate();
     var ampm = (now.getHours() >= 12) ? " P.M." : " A.M."
     var hours = now.getHours();
     hours = ((hours > 12) ? hours - 12 : hours);
     var minutes = ((now.getMinutes() < 10) ? ":0" : ":") + now.getMinutes();
     var seconds = ((now.getSeconds() < 10) ? ":0" : ":") + now.getSeconds();
 
     if(dName==1) Day = "Domingo";
     if(dName==2) Day = "Segunda";
     if(dName==3) Day = "Terça";
     if(dName==4) Day = "Quarta";
     if(dName==5) Day = "Quinta";
     if(dName==6) Day = "Sexta";
     if(dName==7) Day = "Sabado";
 
     if(mName==1) Month="Janeiro";
     if(mName==2) Month="Fevereiro";
     if(mName==3) Month="Março";
     if(mName==4) Month="Abril";
     if(mName==5) Month="Maio";
     if(mName==6) Month="Junho";
     if(mName==7) Month="Julho";
     if(mName==8) Month="Augosto";
     if(mName==9) Month="Setembro";
     if(mName==10) Month="Outubro";
     if(mName==11) Month="Novembro";
     if(mName==12) Month="Dezembro";
 
     var DayDateTime=(" "
                                   + Day
                                   + ", "
                                   + dayNr
                                   + " de "
                                   + Month
                                   + " de "
                                   + ""
                                   + "19"
                                   + yr
                                   + ". Agora são:"
                                   + hours
                                   + minutes
                                   + seconds
                                   + " "
                                   + ampm
                                   );
 
     window.status=DayDateTime;
     timerID = setTimeout("time()",1000);
     timerRunning = true;
}
 
function clearStatus()
{
     if(timerRunning)
     clearTimeout(timerID);
 
     timerRunning = false;
     window.status=" ";
}
 
//-->
 
</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>

<IMG SRC="S177.GIF"><BR>

<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: