Baseline Widely available *
ResumoCria uma instância JavaScript de Date que representa um único momento no tempo. Objetos Date são baseados no valor de tempo que é o número de milisegundos desde 1º de Janeiro de 1970 (UTC).
new Date();
new Date(valor);
new Date(dataString);
new Date(ano, mês, dia, hora, minuto, segundo, milissegundo);
Nota: Note que objetos JavaScript Date só podem ser instanciados chamando JavaScript Date como um construtor: chamá-lo como uma função regular (ou seja, sem o operador new) irá retornar uma string ao invés de um objeto Date; ao contrário de outros tipos de objetos JavaScript, objetos JavaScript Date não têm sintaxe literal.
Nota: Quando Date for chamado como um construtor com mais de um argumento, se os valores forem maiores do que seu limite lógico (e.g. se 13 for fornecido como um valor para mês ou 70 for o valor para minuto), o valor adjacente será ajustado. E.g. new Date(2013, 13, 1) é equivalente a new Date(2014, 1, 1), ambos criam uma data para 2014-02-01 (note que o mês começa em 0). Similarmente para outros valores: new Date(2013, 2, 1, 0, 70) é equivalente a new Date(2013, 2, 1, 1, 10), pois ambos criam uma data para 2013-03-01T01:10:00.
value
Um valor inteiro representando o número de milisegundos desde 1 de Janeiro de 1970 00:00:00 UTC (Era Unix ou Marco Zero).
dataString
Um valor do tipo String que representa uma data. A string deverá estar uma formato reconhecido pelo método Date.parse() (IETF-compliant RFC 2822 timestamps e também uma versão da ISO8601).
year
Um valor inteiro que representa o ano. Valores de 0 a 99 correspondem aos anos de 1900 a 1999. Veja o exemplo abaixo.
month
Um valor inteiro que representa o mês, começando com 0 para Janeiro até 11 para Dezembro.
day
Um valor inteiro que representa o dia do mês.
hour
Um valor inteiro que representa a hora do dia.
minute
Um valor inteiro que representa o segmento de um minuto de tempo.
second
Um valor inteiro que representa o segmento de segundo do tempo.
millisecond
Um valor inteiro que representa o segmento de milisegundo do tempo.
Date.prototype
Permite adicionar propriedades a um objeto javaScript Date.
O valor de Date.length é 7. Esse é o número de argumentos manipulados pelo construtor.
Date.now()
Retorna o valor numérico correspondente ao tempo corrente - o número de milisegundos passados desde 1 de Janeiro de 1970 00:00:00 UTC.
Date.parse()
Analisa uma string que representa uma data e retorna o número de milisegundos desde 1 de Janeiro, 1970, 00:00:00, hora local.
Date.UTC()
Aceita os mesmos parâmetros como a forma mais longa do construtor (i.e. 2 até 7) e retorna o número de milisegundos desde 1 de Janeiro, 1970, 00:00:00 UTC.
Date
Todas as instâncias Date são herdadas de Date.prototype. O objeto protótipo do construtor Date pode ser modificado para afetar todas as instâncias de Date.
Os seguintes exemplos mostram várias formas de se criar datas em JavaScript:
Nota: A conversão de strings com o construtor de Date (Date.parse é equivalente ao contrutor) é fortemente desencorajada devido às inconsistências e diferenças dos navegadores.
var today = new Date();
var birthday = new Date("December 17, 1995 03:24:00");
var birthday = new Date("1995-12-17T03:24:00");
var birthday = new Date(1995, 11, 17);
var birthday = new Date(1995, 11, 17, 3, 24, 0);
Para criar e obter datas entre os anos 0 e 99 os métodos Date.prototype.setFullYear() e Date.prototype.getFullYear() devem ser usados.
var data = new Date(98, 1); // Dom Fev 01 1998 00:00:00 GMT+0000 (GMT)
// Métodos em desuso, 98 mapeia para 1998 aqui também
data.setYear(98); // Dom Fev 01 1998 00:00:00 GMT+0000 (GMT)
data.setFullYear(98); // Sab Fev 01 0098 00:00:00 GMT+0000 (BST)
Os seguintes exemplos mostram como determinar o tempo decorrido entre duas datas no JavaScript em milissegundos.
Devido aos tamanhos diferentes dos dias (devido à mudança do horário de verão), meses e dias, expressar o tempo decorrido em unidades maiores que horas, minutos e segundos requer analisar os problemas e deve ser cuidadosamente investigado antes de se tentar utilizar.
// usando objetos Date
var inicio = Date.now();
// o evento para o tempo vai aqui:
facaAlgoPorUmLongoTempo();
var fim = Date.now();
var decorrido = fim - inicio; // tempo decorrido em milisegundos
// utilizando métodos embutidos
var inicio = new Date();
// o evento para o tempo vai aqui:
facaAlgoPorUmLongoTempo();
var fim = new Date();
var decorrido = fim.getTime() - inicio.getTime(); // tempo decorrido em milisegundos
// para testar uma função e obter o seu retorno
function imprimirTempoDecorrido(fTeste) {
var nHoraInicial = Date.now(),
vRetorno = fTeste(),
nHoraFinal = Date.now();
alert(
"Tempo decorrido: " + String(nHoraFinal - nHoraInicial) + " milisegundos",
);
return vRetorno;
}
retornoDaSuaFuncao = imprimirTempoDecorrido(suaFuncao);
Nota: Em navegadores que suportam a API de Desempenho Web (Web Performance API) com o recurso de tempo de alta resolução, Performance.now() pode fornecer medidas de tempo decorrido mais confiáveis e precisas do que Date.now().
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4