Método Date toLocaleString() do JavaScript

Definição e uso

toLocaleString() O método usa o ajuste regional para converter o objeto Date em uma string.

O idioma padrão depende das configurações regionais do seu computador.

Exemplo

Use o ajuste regional para converter o objeto Date em uma string:

var d = new Date();
var n = d.toLocaleString();

Experimente pessoalmente

Gramática

Date.toLocaleString(locales, opções)

Valor do parâmetro

Parâmetro Descrição

locales

Testar

Opcional. Escolha o formato específico da linguagem.

Clique no botão "Testar" para ver todos os valores em execução.

Valores válidos:

  • ar-SA Árabe (Arábia Saudita)
  • bn-BD Bangla (Bangladesh)
  • bn-IN Bengali (Índia)
  • cs-CZ Checo (República Tcheca)
  • da-DK Dinamarquês (Dinamarca)
  • de-AT Alemão da Áustria
  • de-CH Alemão "Suiço"
  • de-DE Alemão padrão (usado na Alemanha)
  • el-GR Grego moderno
  • en-AU Inglês da Austrália
  • en-CA Inglês do Canadá
  • en-GB Inglês britânico
  • en-IE Inglês da Irlanda
  • en-IN Inglês da Índia
  • en-NZ Inglês da Nova Zelândia
  • en-US Inglês dos Estados Unidos
  • en-ZA Inglês (África do Sul)
  • es-AR Espanhol da Argentina
  • es-CL Espanhol do Chile
  • es-CO Espanhol da Colômbia
  • es-ES Castelhano espanhol (usado no centro-norte da Espanha)
  • es-MX Espanhol do México
  • es-US Espanhol americano
  • fi-FI Finlandês (Finlândia)
  • fr-BE Francês da Bélgica
  • fr-CA Francês do Canadá
  • fr-CH “Suíço” Francês
  • fr-FR Francês padrão (especialmente na França)
  • he-IL Hebraico (Israel)
  • hi-IN Hindi (Índia)
  • hu-HU Húngaro (Hungria)
  • id-ID Indonésio (Indonésia)
  • it-CH “Suíço” Italiano
  • it-IT Italiano padrão (Italiano)
  • jp-JP Japonês (Japão)
  • ko-KR Coreano (República da Coreia)
  • nl-BE Holandês da Bélgica
  • nl-NL Holandês padrão (Holandês)
  • no-NO Norueguês (Noruega)
  • pl-PL Polonês (Polônia)
  • pt-BR Português do Brasil
  • pt-PT Português europeu (escrito e usado em Portugal)
  • ro-RO Romeno (Romênia)
  • ru-RU Russo (Federação Russa)
  • sk-SK Eslovaco (Eslováquia)
  • sv-SE Sueco (Suécia)
  • ta-IN Tâmil da Índia
  • ta-LK Tâmil do Sri Lanka
  • th-TH Tailandês (Tailândia)
  • tr-TR Turco (Turquia)
  • zh-CN China continental, caracteres simplificados
  • zh-HK Hong Kong, caracteres tradicionais
  • zh-TW Taiwan, caracteres tradicionais
opções

Opcional. Objeto que pode definir algumas propriedades.

Atributos válidos podem ser encontrados na tabela a seguir:
Atributos válidos Valores válidos:
estiloDeData
  • "completa"
  • "longo"
  • "média"
  • "curto"
estiloDeTempo
  • "completa"
  • "longo"
  • "média"
  • "curto"
localeMatcher
  • "melhor ajuste"(padrão)
  • "pesquisa"
timeZone
hour12
  • false
  • true
hourCycle
  • "h11"
  • "h12"
  • "h23"
  • "h24"
formatMatcher
  • "básico"
  • "melhor ajuste"(padrão)
    		•
    dia da semana
    • "longo"
    • "curto"
    • "apertado"
    ano
    • "2-dígitos"
    • "numérico"
    mês
    • "2-dígitos"
    • "longo"
    • "apertado"
    • "numérico"
    • "curto"
    dia
    • "2-dígitos"
    • "longo"
    hora
    • "2-dígitos"
    • "longo"
    minuto
    • "2-dígitos"
    • "longo"
    segundo
    • "2-dígitos"
    • "longo"
    timeZoneName
    • "longo"
    • "curto"

    Detalhes técnicos

    Retorno: Cadeia, que representa a data e hora na forma de string.
    Versão do JavaScript： ECMAScript 1

    Suporte do navegador

    Método Chrome IE Firefox Safari Opera
    toLocaleString() Suporte Suporte Suporte Suporte Suporte

    Páginas relacionadas

    Tutorial:Data JavaScript

    Tutorial:Formatação de data JavaScript

    Tutorial:String JavaScript