setlocale
(PHP 4, PHP 5, PHP 7)
setlocale — Legt regionale (locale) Einstellungen fest
Beschreibung
$category
, string $locale
[, string $...
] ) : string$category
, array $locale
) : stringLegt regionale (locale) Einstellungen fest.
Parameter-Liste
-
category -
categoryist eine benannte Konstante (oder Zeichenkette), die die Kategorie der von den regionalen Einstellungen (Locales) betroffenen Funktionen angibt:-
LC_ALLfür alle folgenden Werte -
LC_COLLATEfür String-Vergleiche, siehe strcoll() -
LC_CTYPEfür Klassifizierung und Umwandlung von Zeichen, zum Beispiel strtoupper() -
LC_MONETARYfür localeconv() -
LC_NUMERICfür das Dezimal-Trennzeichen (Siehe auch localeconv()) -
LC_TIMEfür Zeit- und Datums-Formatierungen mittels strftime() -
LC_MESSAGESfür Systemmeldungen (verfügbar, wenn PHP mit liblintl kompiliert wurde)
-
-
locale -
Ist
localeNULLoder der leere String "", werden die Namen der Locales von den Werten der Umgebungsvariablen gleichen Namens wie die obigen Kategorien oder von "LANG" bestimmt.Ist
locale"0", sind keine regionalen Einstellungen betroffen, und es wird die aktuelle Einstellung zurückgegeben.Ist
localeein Array oder folgen weitere Parameter, dann wird jedes Arrayelement bzw. jeder Parameter versucht als neuer Locale-Wert zu setzen, bis es gelingt. Dies ist dann sinnvoll, wenn eine Locale-Angabe auf unterschiedlichen Systemen unter verschiedenen Namen bekannt ist oder auch als Fallback für eine eventuell nicht vorhandene Locale-Angabe. -
... -
(Optionale string oder array Parameter die als Locale-Einstellungen bis zum Erfolg verwendet werden.)
Hinweis:
Unter Windows setzt setlocale(LC_ALL, '') die Locale Namen aus den Regional/Sprache Einstellungen des Systems; (erreichbar über die Systemsteuerung).
Rückgabewerte
Gibt die neue Locale-Einstellung oder FALSE zurück, wenn die
Locale-Funktionalität von Ihrer Plattform nicht unterstützt wird, die
angegebene Locale nicht existiert oder der Kategorie-Name ungültig ist.
Ein ungültiger Kategorie-Name erzeugt zusätzlich eine Warnmeldung. Kategorien- und Locale-Namen können sie unter » RFC 1766 und » ISO 639 nachlesen. Unterschiedliche Systeme verwenden differierende Namensräume für die Locales.
Hinweis:
Der Rückgabewert von setlocale() ist von dem System abhängig, auf dem PHP läuft. Es wird genau das zurückgegeben, was die Systemfunktion setlocale zurückgibt.
Changelog
| Version | Beschreibung |
|---|---|
| 7.0.0 |
Die Unterstützung für an den category Parameter
übergebene Zeichenketten wurde entfernt. Nur LC_*
Konstanten können ab dieser Version verwendet werden.
|
| 5.3.0 |
Die Funktion wirft nun eine E_DEPRECATED-Notice,
wenn ein String statt einer der LC_*-Konstanten an
den Parameter category übergeben wird.
|
Beispiele
Beispiel #1 setlocale()-Beispiele
<?php
/* locale auf Holländisch setzen */
setlocale (LC_ALL, 'nl_NL');
/* Ausgabe: vrijdag 22 december 1978 */
echo strftime ("%A %e %B %Y", mktime (0, 0, 0, 12, 22, 1978));
/* versuche verschiedene mögliche locale Namen für Deutsch */
$loc_de = setlocale (LC_ALL, 'de_DE@euro', 'de_DE', 'de', 'ge');
echo "Preferred locale for german on this system is '$loc_de'";
?>
Beispiel #2 setlocale()-Beispiele for Windows
<?php
/* locale auf Holländisch setzen */
setlocale(LC_ALL, 'nld_nld');
/* Ausgabe: vrijdag 22 december 1978 */
echo strftime("%A %d %B %Y", mktime(0, 0, 0, 12, 22, 1978));
/* versuche verschiedene mögliche locale Namen für Deutsch ab PHP 4.3.0 */
$loc_de = setlocale(LC_ALL, 'de_DE@euro', 'de_DE', 'deu_deu');
echo "Preferred locale for german on this system is '$loc_de'";
?>
Anmerkungen
Die Locale-Informationen wirken auf den Prozess, nicht auf den Thread. Sofern Sie PHP mit einer Multithreaded Server API wie IIS, HHVM oder Apache unter Windows einsetzen, rechnen Sie mit unerwarteten Änderungen der Locale-Einstellungen zur Laufzeit des Skripts, auch wenn das Skript selbst keinen setlocale()-Aufruf durchführt. Dies passiert, da andere Skripte in verschiedenen Threads des selben Prozesses zur selben Zeit prozessweit die Locale-Einstellungen mittels setlocale() ändern.
Windowsuser finden weitergehende Informationen über
locale-Strings auf Microsofts
MSDN-Webseite. Unterstützte Language-Strings können Sie
in der » Language Strings Dokumentation,
Country/Region-Strings in der » Country/Region Strings Dokumentation
nachschlagen.
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 30/01/2003, zuletzt geändert 26/10/2018
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/php-rf-setlocale.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor Diese Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.
