|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1-) Parâmetros indicados entre parênteses são opcionais.
2-) UTC (Coordinated Universal Time) é o padrão atual de tempo de
acordo com os fusos horários. É continuação moderna do GMT (Greenwich
Mean Time). Algumas vezes são considerados sinônimos, mas
rigorosamente não são.
3-) Algumas funções (obsoletas ou de pouco uso) de data e hora não são apresentadas.
|
|
|
|
|
|
|
|
Permite trabalhar com datas e horas. Pode ser criado
por uma das formas abaixo:
new Date()
new Date(ms)
new Date(string_de_data)
new Date(nAno, nMês, nDia [, nHora, nMin, nSeg, nMs] )
A data é dada em milissegundos, a partir de 00:00:00 h GMT de 01 de
janeiro de 1970.
Se nenhum parâmetro é fornecido (primeira forma), são assumidas a
data e hora locais, isto é, do computador que executa o script.
Parâmetros:
ms: milissegundos desde a data inicial dada acima.
string_de_data: uma seqüência de caracteres em um formato
suportado. Exemplo: "Mon, 27 Dec 2004 12:00:00 GMT".
nAno, nMês, nDia, etc: valores inteiros representando partes da
data. Exemplo: Janeiro 0, Fevereiro 1,
etc.
Exemplo de aplicação 1: a variável intervalo armazena o tempo de execução em
milissegundos das outras instruções.
tempo_1 = new Date();
// outras instruções
tempo_2 = new Date();
intervalo = tempo_2 - tempo_1
Exemplo de aplicação 2: este é um exemplo dinâmico, que
atualiza o objeto Date() a cada segundo, permitindo um relógio na
tela em vez da simples hora e data do carregamento da página.
O script abaixo deve estar entre <head> e </head> da
página:
<script language="JavaScript">
function DataHora(){
var data = new Date();
tempo.innerHTML = data;
setTimeout("DataHora()",1000)
}
</script>
O código seguinte deve estar dentro de <body>:
onLoad="DataHora()"
E este no corpo da página (entre <body> e </body>):
<span id=tempo></span>
E o resultado é:
|
|
|
É evidente que os nomes aparecem em inglês. Para outra língua, mais
códigos são necessários.
|
|
|
|
|
|
|
|
Retorna um número inteiro entre 1 e 31, que
representa o dia do mês do objeto Date.
Exemplo: a variável dia contém dia do mês da data
atual.
data = new Date();
dia = data.getDate();
|
|
|
|
|
|
|
|
Retorna um número inteiro do dia da semana. Domingo
0, segunda 1, terça 2, etc.
Exemplo: a variável dia_semana contém o dia da
semana da data atual.
data = new Date();
dia_semana = data.getDay();
|
|
|
|
|
|
|
|
Retorna o ano do objeto Date em números absolutos,
por exemplo 1998.
Exemplo: a variável ano contém o ano da data atual.
data = new Date();
ano = data.getFullYear();
|
|
|
|
|
|
|
|
Retorna a hora do objeto Date, um número inteiro
entre 0 e 23.
Exemplo:
data = new Date();
hora = data.getHours();
|
|
|
|
|
|
|
|
Retorna os milissegundos do objeto Date, um inteiro
entre 0 e 999.
Exemplo:
data = new Date();
ms = data.getMilliseconds();
|
|
|
|
|
|
|
|
Retorna os minutos do objeto Date, um inteiro entre
0 e 59.
Exemplo:
data = new Date();
min = data.getMinutes();
|
|
|
|
|
|
|
|
Retorna o mês do objeto Date, um inteiro entre 0 e
11 (0 janeiro, 1 fevereiro, etc).
Exemplo:
data = new Date();
mes = data.getMonth();
|
|
|
|
|
|
|
|
Retorna os segundos do objeto Date, um número
inteiro entre 0 e 59.
Exemplo:
data = new Date();
seg = data.getSeconds();
|
|
|
|
|
|
|
|
Retorna o número de milissegundos da data conforme
informado no primeiro tópico. Em
geral usado para especificar a data e hora de um outro objeto Date.
Exemplo:
certo_dia = new Date("May 15, 1998");
outro_dia = new Date();
outro_dia.setTime(certo_dia.getTime());
|
|
|
|
|
|
|
|
Retorna a diferença, em minutos, entre a hora local
e a hora GMT.
Exemplo:
data = new Date();
dif_gmt_horas = data.getTimezoneOffset() / 60;
|
|
|
|
Date.parse(string_de_data)
|
↑Topo • Fim↓
|
|
|
|
Retorna o número de milissegundos de uma
seqüência de caracteres (string) de data, desde 01 de janeiro de
1970 00:00:00 h (hora local).
A string de data deve estar dentro do padrão aceito. Exemplo: Tue,
28 Dec 2004 11:00:00 GMT-0330. Se não especificado o fuso horário,
o horário local é considerado.
Deve sempre ser usado na forma Date.parse() e não com um objeto
Date criado. Em geral usado com setTime() para especificar uma nova
data para o objeto.
Exemplo:
data = new Date();
data.setTime(Date.parse("Apr 15, 2004"));
|
|
|
|
|
|
|
|
Especifica um dia do mês para um objeto Date. nDia
deve ser um inteiro entre 1 e 31, de acordo com o mês corrente.
Exemplo:
certo_dia = new Date("May 15, 1998");
certo_dia.setDate(25);
|
|
|
|
setFullYear(nAno
[, nMes, nDia])
|
↑Topo • Fim↓
|
|
|
|
Especifica um ano (em 4 dígitos) para um objeto
date existente. nAno é um inteiro de 4 dígitos representando o
ano, nMes um inteiro de 0 a 11 para o mês (0 janeiro, 1 fevereiro,
etc) e nDia um inteiro de 1 a 31 para o dia do mês. Se é dado um
valor para nDia, é obrigatório um valor para nMes.
Se um parâmetro é especificado fora da faixa, a função tenta
atualizar os demais de forma coerente. Exemplo: se um valor de 15 é
dado para nMes, o ano é aumentado de 1 e o valor 4 é usado para
nMes.
Exemplo:
certo_dia = new Date();
certo_dia.setFullYear(1995);
|
|
|
|
setHours(nHora
[, nMin, nSeg, nMs])
|
↑Topo • Fim↓
|
|
|
|
Especifica a hora para um objeto Date. nHora é um
inteiro entre 0 e 23. Os demais parâmetros são opcionais: nMin
(inteiro entre 0 e 59), nSeg (inteiro entre 0 e 59) e nMs (inteiro
entre 0 e 999 para os milissegundos). Se nSeg é fornecido, nMin
também deve ser dado. Se nMs é especificado, nMin e nSeg também
devem ser.
Se um parâmetro é especificado fora da faixa, a função tenta
atualizar os demais de forma coerente. Exemplo: se 70 é dado para
nMin, a hora é aumentada de 1 e 10 é usado para nMin.
Exemplo:
certo_dia = new Date();
certo_dia.setHours(10);
|
|
|
|
|
|
|
|
Especifica os milissegundos para um objeto Date. nMs
deve ser um inteiro entre 0 e 999.
Se nMs é dado fora da faixa, o objeto Date é atualizado de forma
coerente. Exemplo: se nMs é 1100, os segundos são aumentados de 1
e 100 é usado para os milissegundos.
Exemplo:
certo_dia = new Date();
certo_dia.setMilliseconds(500);
|
|
|
|
setMinutes(nMin
[, nSeg, nMs])
|
↑Topo • Fim↓
|
|
|
|
Especifica os minutos para um objeto Date. nMin deve
ser um inteiro entre 0 e 59. Os demais parâmetros são opcionais:
nSeg (inteiro entre 0 e 59) e nMs (inteiro entre 0 e 999 para os
milissegundos). Se nSeg é especificado, nMin também deve ser. Se
nMs é dado, nMin e nSeg também devem ser.
Se um parâmetro é dado fora da faixa, a função tenta atualizar
os demais de forma coerente. Exemplo: se nSeg é 80, os minutos são
aumentados de 1 e 20 é usado para os segundos.
Exemplo:
certo_dia = new Date();
certo_dia.setMinutes(25);
|
|
|
|
setMonth(nMes
[, nDia])
|
↑Topo • Fim↓
|
|
|
|
Especifica o mês de um objeto Date. nMes deve ser
um inteiro entre 0 e 11 (0 janeiro, 1 fevereiro, etc). nDia é um
parâmetro opcional para o dia do mês (inteiro entre 0 e 31).
Se um parâmetro é dado fora da faixa, a função tenta atualizar o
objeto de forma coerente. Exemplo: se 12 é dado para o mês, o ano
é aumentado de 1 e 1 é usado para o mês.
Exemplo:
certo_dia = new Date();
certo_dia.setMonth(4);
|
|
|
|
setSeconds(nSeg
[, nMs])
|
↑Topo • Fim↓
|
|
|
|
Especifica os segundos de um objeto Date. nSeg deve
ser um inteiro entre 0 e 59. nMs é um parâmetro opcional para os
milissegundos (inteiro entre 0 e 999).
Se um parâmetro é dado fora da faixa, a função tenta atualizar o
objeto de forma coerente. Exemplo: se 70 é dado para nSeg, os
minutos são aumentados de 1 e 10 é usado para os segundos.
Exemplo:
certo_dia = new Date();
certo_dia.setSeconds(15);
|
|
|
|
|
|
|
|
Especifica um valor para o objeto Date. nMs é um
inteiro correspondente ao número de milissegundos desde 01 de
janeiro de 1970 00:00:00 h.
Exemplo:
certo_dia = new Date("May 15, 1998");
outro_dia = new Date();
outro_dia.setTime(certo_dia.getTime());
|
|
|
|
|
|
|
|
Retorna uma seqüência de caracteres (string) de
data, com formato definido pelas configurações do sistema
operacional.
Exemplo:
<script language="JavaScript">
var d = new Date();
document.write(d.toLocaleString());
</script>
E o resultado desse script é:
|
|
|
Se o seu sistema operacional não é inglês configurado para o
padrão americano, notar a diferença com o exemplo dado no primeiro
tópico, O objeto Date().
|
|
|
|
|
|
|
|
Retorna uma string formatada de acordo com a
convenção UTC. Pode variar de acordo com o sistema operacional.
Exemplo:
data = new Date();
var str = data.toUTCString();
|
|
|
|
Date.UTC(nA, nM, nD
[, nHora, nMin, nSeg, nMs])
|
↑Topo • Fim↓
|
|
|
|
Retorna o número de milissegundos desde 01 de
janeiro de 1970 00:00:00 h, hora universal.
nA: ano depois de 1900. nM: inteiro de 0 a 11 para o mês. nD:
inteiro de 1 a 31 para o dia do mês. nHora: inteiro de 0 a 23 para
as horas. nMin: inteiro de 0 a 59 para os minutos. nSeg: inteiro de
0 a 59 para os segundos. nMs: inteiro de 0 a 999 para os
milissegundos.
Se um parâmetro for dado fora da faixa, a função tenta ajustar os
demais de forma coerente. Exemplo: se 12 é usado para mês, ano é
incrementado de 1 e 1 é usado para mês.
Deve sempre ser usado na forma Date.UTC(...) e não com um objeto
Date criado.
Exemplo:
data_utc = new Date(Date.UTC(2004, 11, 15, 12, 0, 0));
|
|
|
|
|
|
|
|
|
|