Função setlocale() do PHP

Funções String PHP

Exemplo

Defina a região para US English e configure novamente para o padrão do sistema:

<?php
echo setlocale(LC_ALL, "US");
echo "<br>";
echo setlocale(LC_ALL, NULL);
?>

Exemplo de execução

Definição e uso

A função setlocale() configura as informações regionais (informações geográficas).

As informações regionais se referem ao idioma, moeda, hora e outras informações de uma região geográfica.

Comentários:A função setlocale() altera as informações regionais apenas para o script atual.

Dica:As informações regionais podem ser definidas como padrão do sistema usando setlocale(LC_ALL, NULL).

Dica:Para obter informações de formatação de números, consulte localeconv() Função.

Sintaxe

setlocale(constante,localização)
Parâmetros Descrição
constante

Obrigatório. Define qual informação regional deve ser configurada.

Constantes disponíveis:

  • LC_ALL - Inclui todas as opções abaixo
  • LC_COLLATE - Ordem de classificação
  • LC_CTYPE - Categoria de Caracteres e Conversão (por exemplo, todos os caracteres em maiúsculas ou minúsculas)
  • LC_MESSAGES - Formato de Mensagens do Sistema
  • LC_MONETARY - Formato Monetário
  • LC_NUMERIC - Formato Numérico
  • LC_TIME - Formato de Data e Hora
localização

Obrigatório. Define qual país/região deve ser configurado como informações de região. Pode ser uma string ou um array. Múltiplas localizações podem ser passadas.

Se localização Se o parâmetro for NULL ou uma string vazia "", o nome da localização será configurado para o valor da variável de ambiente com o mesmo nome nas constantes acima ou será configurado com base em "LANG".

Se localização O parâmetro for "0", a configuração de localização não será afetada e apenas a configuração atual será retornada.

Se localização O parâmetro é um array, setlocale() tentará cada elemento do array até encontrar um código de linguagem ou código de região válido. Isso é útil se uma região tiver diferentes nomes em diferentes sistemas.

Comentários:Para visualizar todos os códigos de linguagem disponíveis, acesse nossoManual de Referência de Código de Linguagem.

Detalhes Técnicos

Valor de Retorno: Retorna a configuração de área geográfica atual, ou FALSE em caso de falha. O valor de retorno depende do sistema no qual o PHP está executando.
Versão PHP: 4+
Log de Atualizações:

No PHP 4.2.0, a passagem de constantes como strings foi descontinuada. Use constantes disponíveis em vez disso. A passagem de constantes como strings gerará uma mensagem de aviso.

No PHP 4.3.0, múltiplas locations podem ser passadas.

A partir do PHP 5.3.0, se passado para constante O parâmetro é uma string, não uma constante LC_ alguma, a função lançará um aviso E_DREPRECATED.

Funções String PHP