setlocale

Set locale information

Syntax

setlocale ( int $category , string $locale [, string $... ] ) : string
setlocale ( int $category , array $locale ) : string

Parameters

category

category is a named constant specifying the category of the functions affected by the locale setting:

LC_ALL all below
LC_COLLATE string comparison, see strcoll()
LC_CTYPE character classification and conversion, for example strtoupper()
LC_MONETARY localeconv()
LC_NUMERIC decimal separator (See localeconv())
LC_TIME date and time formatting with strftime()
LC_MESSAGES system responses (available if PHP was compiled with libintl)
locale

If locale is NULL or the empty string "", the locale names will be set from the values of environment variables with the same names as the above categories, or from "LANG". If locale is "0", the locale setting is not affected, only the current setting is returned. If locale is an array or followed by additional parameters then each array element or parameter is tried to be set as new locale until success. This is useful if a locale is known under different names on different systems or for providing a fallback for a possibly not available locale.

...

(Optional string or array parameters to try as locale settings until success.)

Return

Returns the new current locale, or FALSE if the locale functionality is not implemented on your platform, the specified locale does not exist or the category name is invalid. An invalid category name also causes a warning message. Category/locale names can be found in RFC 1766 and ISO 639. Different systems have different naming schemes for locales.

Note: The return value of setlocale() depends on the system that PHP is running. It returns exactly what the system setlocale function returns.

Examples

1

<?

$category = LC_ALL;
$locale = "en_US";

$return = setlocale($category, $locale);

echo $return;

?>
en_US

2

<?

$category = LC_ALL;
$locale1 = "de_DE@euro";
$locale2 = "de_DE";
$locale3 = "de";
$locale4 = "ge";

$return = setlocale($category, $locale1, $locale2, $locale3, $locale4);

echo "preferred locale: $return";

?>
preferred locale: de_DE@euro

3

<?

$category = LC_ALL;
$locale = array("de_DE@euro", "de_DE", "de", "ge");

$return = setlocale($category, $locale);

echo "preferred locale: $return";

?>
preferred locale: de_DE@euro

4

<?

$category = LC_TIME;
$locale = "nl_NL";

setlocale($category, $locale);

$format = "%A %d %B %Y";
$hour = 0;
$minute = 0;
$second = 0;
$month = 1;
$day = 1;
$year = 2000;
$timestamp = mktime($hour, $minute, $second, $month, $day, $year);
$strftime = strftime($format, $timestamp);

echo $strftime;

?>
zaterdag 01 januari 2000

addcslashes

addslashes

bin2hex

chop

chr

chunk_split

convert_uudecode

convert_uuencode

count_chars

crc32

crypt

echo

explode

fprintf

get_html_translation_table

hebrev

hebrevc

hex2bin

html_entity_decode

htmlentities

htmlspecialchars

htmlspecialchars_decode

implode

join

lcfirst

levenshtein

localeconv

ltrim

md5

md5_file

metaphone

nl_langinfo

nl2br

number_format

ord

parse_str

print

printf

quoted_printable_decode

quoted_printable_encode

quotemeta

rtrim

sha1

sha1_file

similar_text

soundex

sprintf

sscanf

str_contains

str_ends_with

str_getcsv

str_ireplace

str_pad

str_repeat

str_replace

str_rot13

str_shuffle

str_split

str_starts_with

str_word_count

strcasecmp

strchr

strcmp

strcoll

strcspn

strip_tags

stripcslashes

stripos

stripslashes

stristr

strlen

strnatcasecmp

strnatcmp

strncasecmp

strncmp

strpbrk

strpos

strrchr

strrev

strripos

strrpos

strspn

strstr

strtok

strtolower

strtoupper

strtr

substr

substr_compare

substr_count

substr_replace

trim

ucfirst

ucwords

vfprintf

vprintf

vsprintf

wordwrap

PHP

Home Menu