PHP Conference Nagoya 2025

nl_langinfo

(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)

nl_langinfoConsulta informação de língua e localidade

Descrição

nl_langinfo(int $item): string|false

nl_langinfo() é usada para acessar elementos individuais de categorias de localidade. Diferentemente de localeconv(), que retorna todos os elementos, nl_langinfo() permite selectionar qualquer elemento específico.

Parâmetros

item

item pode ser um valor inteiro do elemento ou o nome da constante do elemento. A lista de nomes de constantes que podem ser usadas para o parâmetro item e suas descrições está apresentada abaixo. Algumas destas constantes podem não estar definidas ou podem não conter valor para certas localidades.

nl_langinfo Constants
Constante Descrição
Constantes da Categoria LC_TIME
ABDAY_(1-7) Nome abreviado no n-ésimo dia da semana.
DAY_(1-7) Nome do n-ésimo dia da semana (DAY_1 = domingo).
ABMON_(1-12) Nome abreviado do n-ésimo mês do ano.
MON_(1-12) Nome do n-ésimo mês do ano.
AM_STR String para horários antes do meio-dia (ante meridiem).
PM_STR String para horário após o meio-dia (post meridiem).
D_T_FMT String que pode ser usada como formatação para strftime() para representar horário e data.
D_FMT String que pode ser usada como formatação para strftime() para representar data.
T_FMT String que pode ser usada como formatação para strftime() para representar horário.
T_FMT_AMPM String que pode ser usada como formatação para strftime() para representar horário em formato de 12 horas com ante/post meridiem.
ERA Era alternativa.
ERA_YEAR Ano no formato da era alternativa.
ERA_D_T_FMT Data e horário em formato da era alternativa (string pode ser usada em strftime()).
ERA_D_FMT Data em formato da era alternativa (string pode ser usada em strftime()).
ERA_T_FMT Horário em formato da era alternativa (string pode ser usada em strftime()).
Constantes da Categoria LC_MONETARY
INT_CURR_SYMBOL Símbolo internacional da moeda.
CURRENCY_SYMBOL Símbolo local da moeda.
CRNCYSTR O mesmo que CURRENCY_SYMBOL.
MON_DECIMAL_POINT Caractere de seperação de decimais.
MON_THOUSANDS_SEP Separador de milhares (grupos de três dígitos).
MON_GROUPING O mesmo que o elemento "grouping".
POSITIVE_SIGN Sinal para valores positivos.
NEGATIVE_SIGN Sinal para valores negativos.
INT_FRAC_DIGITS Dígitos fracionários internacionais.
FRAC_DIGITS Dígitos fracionários locais.
P_CS_PRECEDES Retorna 1 se CURRENCY_SYMBOL precede um valor positivo.
P_SEP_BY_SPACE Retorna 1 se um espaço separa CURRENCY_SYMBOL de um valor positivo.
N_CS_PRECEDES Retorna 1 se CURRENCY_SYMBOL precedes a negative value.
N_SEP_BY_SPACE Retorna 1 se um espaço separa CURRENCY_SYMBOL de um valor negativo.
P_SIGN_POSN
N_SIGN_POSN
Constantes da Categoria LC_NUMERIC
DECIMAL_POINT Caractere separador de decimais.
RADIXCHAR O mesmo valor de DECIMAL_POINT.
THOUSANDS_SEP Caractere separador de milhares (grupos de três dígitos).
THOUSEP O mesmo valor de THOUSANDS_SEP.
GROUPING  
Constantes da Categoria LC_MESSAGES
YESEXPR String de expressão regular para corresponder à entrada "yes" (sim).
NOEXPR String de expressão regular para corresponder à entrada "no" (não).
YESSTR String de saída para "yes" (sim).
NOSTR String de saída para "no" (não).
Constantes da Categoria LC_CTYPE
CODESET Retorna uma string com o nome da codificação de caracteres.

Valor Retornado

Retorna o elemento como uma string ou false se item não for válido.

Exemplos

Exemplo #1 Exemplo de nl_langinfo()

<?php

var_dump
(nl_langinfo(CODESET));
var_dump(nl_langinfo(YESEXPR));
?>

O exemplo acima produzirá algo semelhante a:

string(14) "ANSI_X3.4-1968"
string(5) "^[yY]"

Notas

Nota: Esta função não foi implementada em plataformas Windows.

Veja Também

adicione uma nota

Notas Enviadas por Usuários (em inglês) 1 note

up
4
avatar_at_hot_ee
18 years ago
The value MON_(1-12) has special behavior in Russian locale: it returns declinated month names, that can be used as part of a date string, but not on their own.

For instance instead of "Январь" (the proper nominative form) it returns "Января" (form declinated for use in dates).

There seems to be no way to get the nominative form of the month name - one has to use translations instead.
To Top