PHP setlocale() Funktion

Beispiel

Setzen Sie die Region auf US English und stellen Sie sie dann zurück auf die Standardwerte des Systems:

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

Laufende Beispiele

Definition und Verwendung

Die Funktion setlocale() setzt die Regionaleinstellungen (Regionale Informationen).

Regionale Informationen beziehen sich auf die Sprache, Währung, Zeit und andere Informationen eines geografischen Gebiets.

Kommentare:Die Funktion setlocale() ändert nur die Regionaleinstellungen für das aktuelle Skript.

Hinweis:Die Regionaleinstellungen können durch setlocale(LC_ALL, NULL) auf die Standardwerte des Systems gesetzt werden.

Hinweis:Für Informationen über die Nummerierungsformate siehe localeconv() Funktion.

Syntax

setlocale(Konstante,Ort)
Parameter Beschreibung
Konstante

Erforderlich. Legt fest, welche Regionaleinstellungen gesetzt werden sollen.

Verfügbare Konstanten:

  • LC_ALL - Beinhaltet alle folgenden Optionen
  • LC_COLLATE - Sortierreihenfolge
  • LC_CTYPE - Zeichenkategorie und Konvertierung (z.B. alle Zeichen groß oder klein)
  • LC_MESSAGES - Systemmeldungsformat
  • LC_MONETARY - Währungsformat
  • LC_NUMERIC - Zahlenformat
  • LC_TIME - Datum- und Zeitformat
Ort

Erforderlich. Legt fest, welche Regionaleinstellungen für das Land oder die Region festgelegt werden sollen. Dies kann ein String oder ein Array sein. Mehrere Positionen können übergeben werden.

Wenn Ort Das Argument ist NULL oder eine leere Zeichenfolge "", dann wird der Ortsname auf den Wert der entsprechenden Umgebungsvariable in den oben genannten Konstanten oder basierend auf "LANG" gesetzt.

Wenn Ort Das Argument ist "0", wird die Positionseinstellung nicht beeinflusst und nur die aktuelle Einstellung zurückgegeben.

Wenn Ort Das Argument ist ein Array, setlocale() versucht, jeden Arrayelement zu verwenden, bis ein gültiges Sprach- oder Regionenkennzeichen gefunden wird. Dies ist nützlich, wenn eine Region in verschiedenen Systemen unterschiedliche Namen hat.

Kommentare:Um alle verfügbaren Sprachcodes anzuzeigen, besuchen Sie bitte unsereSprachcode Referenzhandbuch.

Technische Details

Rückgabewert: Gibt die aktuelle Regionaleinstellung zurück, falls der Fehler auftritt, wird FALSE zurückgegeben. Der Rückgabewert hängt vom Betriebssystem ab, auf dem PHP ausgeführt wird.
PHP-Version: 4+
Aktualisierungsprotokoll:

In PHP 4.2.0 wurde das Übergeben von Konstanten als Strings abgelehnt. Bitte verwenden Sie verfügbare Konstanten. Das Übergeben von Konstanten als Strings führt zu einer Warnmeldung.

In PHP 4.3.0 können mehrere locations übergeben werden.

Ab PHP 5.3.0, wenn Konstante Das Argument ist ein String, nicht einer der LC_-Konstanten, und die Funktion wirft eine E_DREPRECATED-Nachricht aus.