O método toString()
retorna uma cadeia de caracteres (string) representando o objeto Date
especificado.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
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
BCD tables only load in the browser
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.