Método Date.parse

O método Date.parse retorna o número de milissegundos até a data passada como parâmetro em formato de string ISO. O formato ISO é assim: 'YYYY-MM-DDTHH:mm:ss.sssZ', onde: 'YYYY-MM-DD' - data; 'T' - separador; 'HH:mm:ss.sss' - hora; 'Z' - Fuso horário. Não é necessário passar o formato completo, basta passar 'YYYY-MM-DD' ou apenas YYYY.

Sintaxe

javascriptDate.parse('YYYY-MM-DDTHH:mm:ss.sssZ');

Exemplo

Vamos usar o método Date.parse para descobrir quantos milissegundos se passaram desde 1 de janeiro de 1970 até 16.11.2016, 12:59:59:

javascriptlet res = Date.parse('2016-11-16T12:59:59');
console.log(res);

Resultado da execução do código:

javascript1479290399000

Exemplo

Agora vamos exibir o número de milissegundos, especificando apenas o ano:

javascriptlet res = Date.parse('2016');
console.log(res);

Resultado da execução do código:

javascript1451606400000

Exemplo

Vamos definir uma data incorreta no parâmetro do método Date.parse:

javascriptlet res = Date.parse('20162016');
console.log(res);

Resultado da execução do código:

javascriptNaN

Veja também

  • método getTime,
    que também obtém timestamp
  • método Date.now,
    que também obtém timestamp