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 (en-US), não Object.prototype (en-US). 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 com navegadores

BCD tables only load in the browser

Veja também