Date.prototype.toString()

O método toString() retorna uma cadeia de caracteres (string) representando o objeto Date especificado.

Sintaxe

dateObj.toString()

Valor de retorno

Uma string representando a data.

Descrição

Instâncias de Date herdam o método toString() de Date.prototype, não Object.prototype. Date.prototype.toString() returna uma string com a representação de Date no formato especificado na ECMA-262 que pode ser resumida como:

  • Dia da semana: 3 letras do nome do dia da semana em Inglês, e.g. "Sat"
  • espaço
  • Nome do mês: 3 letras do nome do mês em Inglês, e.g. "Sep"
  • espaço
  • Dia: Dia do mês em 2 dígitos, e.g. "01"
  • espaço
  • Ano: Ano no formato de 4 dígitos, e.g. "2018"
  • espaço
  • Hora: Hora do dia em 2 dígitos, e.g. "14"
  • dois-pontos
  • Minuto: Minutos da hora em 2 dígitos, e.g. "53"
  • dois-pontos
  • Segundos: Segundos do minuto em 2 dígitos, e.g. "26"
  • espaço
  • A string "GMT"
  • Sinal do deslocamento do fuso horário, pode ser:
    • "+" para deslocamentos positivos (0 ou maior)
    • "-" para deslocamentos negativos (menores que 0)
  • Dois dígitos da hora do deslocamento, e.g. "14"
  • Dois dígitos dos minutos do deslocamento, e.g. "00"
  • Opcionalmente, um nome de fuso horário consistindo de:
    • espaço
    • parênteses esquerdo, i.e. "("
    • Uma representação de string dependente da implementação do fuso horário, que pode ser uma abreviação ou o nome completo (não há um padrão para nomes ou abreviação de fusos horários), e.g. "Line Islands Time" ou "LINT"
    • parênteses direito, i.e. ")"

E.g. "Sat Sep 01 2018 14:53:26 GMT+1400 (LINT)"

Até o ECMAScript 2018 (edição 9), o formato da string retornada pelo Date.prototype.toString era dependente da implementação. Portanto, não se deve confiar que ela está no formato especificado.

O método toString() é automaticamente chamado quando a data deve ser representada como texto, e.g. console.log(new Date()), ou quando a data é utilizada em uma concatenação de string, como var today = 'Today is ' + new Date().

toString() é um método genérico, ele não requer que seu this seja uma instância de Date. Entretanto, ele deve ter uma propriedade interna [[TimeValue]] que não pode ser construída usando JavaScript nativo, então ela é efetivamente limitada a ser usada com instâncias Date. Se chamado em uma instância que não seja Date, um TypeError é jogado.

Exemplos

Usando toString()

O exemplo asseguir atribui o valor de toString() de um objeto Date para myVar:

var x = new Date();
var myVar = x.toString(); // atribui uma string em myVar no mesmo formato que este:
                          // Mon Sep 08 1998 14:36:22 GMT-0700 (PDT)

Especificações

Especificação
ECMAScript (ECMA-262)
The definition of 'Date.prototype.toString' in that specification.

Compatibilidade de navegador

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung InternetNode.js
toStringChrome Full support 1Edge Full support 12Firefox Full support 1IE Full support 3Opera Full support 3Safari Full support 1WebView Android Full support 1Chrome Android Full support 18Firefox Android Full support 4Opera Android Full support 10.1Safari iOS Full support 1Samsung Internet Android Full support 1.0nodejs Full support 0.1.100

Legend

Full support  
Full support

Veja também