← 返回首页
Date - JavaScript | MDN
HTML

HTML: Markup language

HTML reference HTML guides Markup languages
CSS

CSS: Styling language

CSS reference CSS guides Layout cookbook
JavaScriptJS

JavaScript: Scripting language

JS reference JS guides
Web APIs

Web APIs: Programming interfaces

Web API reference Web API guides
All

All web technology

Technologies Topics
Learn

Learn web development

Frontend developer course Learn HTML Learn CSS Learn JavaScript
Tools

Discover our tools

About

Get to know MDN better

Blog
Toggle sidebar
  1. Tecnologia Web para desenvolvedores
  2. JavaScript
  3. Referência JavaScript
  4. Objetos Globais
  5. Date
Theme
  • OS default
  • Light
  • Dark
Português (do Brasil)
Remember language Learn more

Esta página foi traduzida do inglês pela comunidade. Saiba mais e junte-se à comunidade MDN Web Docs.

View in English Always switch to English

Date

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since julho de 2015.

* Some parts of this feature may have varying levels of support.

Resumo

Cria 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).

In this article

Construtor

js
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.

Parâmetros para o constructor Date

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.

Descrição

  • Se nenhum argumento for fornecido, o construtor criará um objeto JavaScript Date com a data e hora corrente de acordo com as configurações do sistema.
  • Se ao menos 2 argumentos forem fornecidos, os argumentos ausentes serão configurados como 1 (se o dia estiver ausente) ou 0 para todos os outros.
  • A data do JavaScript é baseada no valor de tempo em milisegundos desde a meia noite de 01 de Janeiro de 1970, UTC. Um dia corresponde a 86.400,000 milisegundos. O intervalo do objeto Date no JavaScript é de -100.000,000 dias a 100.000,000 dias relativo a 01 de Janeiro de 1970, UTC.
  • O objeto Date no JavaScript tem um comportamento uniforme nas plataformas. O valor do tempo pode ser transmitido entre sistemas para representar o mesmo instante no tempo e se for usado para criar um objeto de data local, ele refletirá o tempo local equivalente.
  • O objeto Date JavaScript suporta vários métodos UTC (universal), assim como métodos de tempo locais. UTC, também conhecido como Tempo Médio de Greenwich (Greenwich Mean Time, GMT), refere-se ao tempo como definido pelo Padrão de Tempo Mundial (World Time Standard). O tempo local é o tempo conhecido pelo computador onde o JavaScript é executado.
  • Invocar o objeto Date no JavaScript como uma função (i.e., sem o operador new) retornatá uma string representando a data e hora corrente.

Propriedades

Date.prototype

Permite adicionar propriedades a um objeto javaScript Date.

Date.length

O valor de Date.length é 7. Esse é o número de argumentos manipulados pelo construtor.

Métodos

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.

Instâncias JavaScript de 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.

Métodos

Exemplos

Várias formas de se criar um objeto 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.

js
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);

Anos com dois dígitos mapeados para 1900 - 1999

Para criar e obter datas entre os anos 0 e 99 os métodos Date.prototype.setFullYear() e Date.prototype.getFullYear() devem ser usados.

js
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)

Calculando o tempo decorrido

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.

js
// 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
js
// 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
js
// 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().

Especificações

Specification
ECMAScript® 2027 Language Specification
# sec-date-objects

Compatibilidade com navegadores

Enable JavaScript to view this browser compatibility table.

Help improve MDN

Was this page helpful to you?
Yes No
Learn how to contribute

This page was last modified on 24 de jun. de 2025 by MDN contributors.

View this page on GitHub • Report a problem with this content
  1. Objetos Globais
  2. Date
  3. Construtor
    1. Date()
  4. Métodos estáticos
    1. Date.now()
    2. Date.parse()
    3. Date.UTC()
  5. Métodos de instância
    1. Date.prototype.getDate()
    2. Date.prototype.getDay()
    3. Date.prototype.getFullYear()
    4. Date.prototype.getHours()
    5. Date.prototype.getMilliseconds()
    6. Date.prototype.getMinutes()
    7. Date.prototype.getMonth()
    8. Date.prototype.getSeconds()
    9. Date.prototype.getTime()
    10. Date.prototype.getTimezoneOffset()
    11. Date.prototype.getUTCDate()
    12. Date.prototype.getUTCDay()
    13. Date.prototype.getUTCFullYear()
    14. Date.prototype.getUTCHours()
    15. Date.prototype.getUTCMilliseconds()
    16. Date.prototype.getUTCMinutes()
    17. Date.prototype.getUTCMonth()
    18. Date.prototype.getUTCSeconds()
    19. Date.prototype.getYear()
    20. Date.prototype.setDate()
    21. Date.prototype.setFullYear()
    22. Date.prototype.setHours()
    23. Date.prototype.setMilliseconds()
    24. Date.prototype.setMinutes()
    25. Date.prototype.setMonth()
    26. Date.prototype.setSeconds()
    27. Date.prototype.setTime()
    28. Date.prototype.setUTCDate()
    29. Date.prototype.setUTCFullYear()
    30. Date.prototype.setUTCHours()
    31. Date.prototype.setUTCMilliseconds()
    32. Date.prototype.setUTCMinutes()
    33. Date.prototype.setUTCMonth()
    34. Date.prototype.setUTCSeconds()
    35. Date.prototype.setYear()
    36. Date.prototype.toDateString()
    37. Date.prototype.toISOString()
    38. Date.prototype.toJSON()
    39. Date.prototype.toLocaleDateString()
    40. toLocaleString()
    41. Date.prototype.toLocaleTimeString()
    42. Date.prototype.toString()
    43. toTemporalInstant()
    44. Date.prototype.toTimeString()
    45. Date.prototype.toUTCString()
    46. Date.prototype.valueOf()
    47. Date.prototype[@@toPrimitive]
  6. Herança
  7. Object/Function
  8. Métodos estáticos
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.toString()
    5. [Symbol.hasInstance]()
  9. Propriedades estáticas
    1. Function.displayName
    2. Function.length
    3. Function.name
    4. prototype
    5. Function.arguments
    6. Function.caller
  10. Métodos de instância
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toString()
    10. Object.prototype.valueOf()
  11. Propriedades de instância
    1. Object.prototype.__proto__
    2. Object.prototype.constructor

Your blueprint for a better internet.

MDN Contribute Developers

Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.