(PECL ingres >= 1.2.0)
ingres_set_environment — Setzt Eigenschaften der Umgebung zur Ausgabesteuerung
$link
, array $options
)ingres_set_environment() wird aufgerufen, um die Optionen zur Ausgabe bestimmter Werte in Ingres zu steuern, beispielsweise für Zeitzonen, Datumsformate, Dezimaltrennzeichen und die Genauigkeit von Fließkommazahlen.
linkDie Verbindungskennung
optionsEin numerisches array mit Name-Wert-Paaren für die Optionen. In der folgenden Tabelle sind die Namen und die erwarteten Werte aufgelistet.
| Name der Option | Typ der Option | Beschreibung | Beispiel |
|---|---|---|---|
| date_century_boundary | integer | Der Schwellwert, anhand dessen geprüft wird, ob eine zweistellige Jahreszahl im aktuellen oder im kommenden Jahrhundert liegt. Äquivalent zu II_DATE_CENTURY_BOUNDARY. | 50 |
| timezone | string | Bestimmt die Zeitzone der Datenbanksitzung. Falls die Option nicht angegeben wurde, wird der Wert von II_TIMEZONE_NAME benutzt. Falls dort auch nichts definiert ist, wird NA-PACIFIC (GMT-8 mit Sommerzeit) benutzt. | UNITED-KINGDOM |
| date_format | integer | Bestimmt die erlaubten Ein- und Ausgabeformate für das Datum in Ingres. Falls nichts angegeben ist, werden die Formate von II_DATE_FORMAT benutzt. Falls dort auch nichts definiert wurde, ist US (mm/dd/yy) das Standardformat. Gültige Werte für date_format sind:
|
INGRES_DATE_ISO4 |
| decimal_separator | string | Das Dezimaltrennzeichen | "," |
| money_lort | integer | Führendes oder angehängtes Währungssymbol. Gültige Werte für money_lort sind:
|
INGRES_MONEY_LEADING |
| money_sign | string | Das Währungssymbol, das mit dem Datentyp MONEY benutzt wird. | € |
| money_precision | integer | Die Genauigkeit des Datentyps MONEY | 2 |
| float4_precision | integer | Die Genauigkeit des Datentyps FLOAT4 | 10 |
| float8_precision | integer | Die Genauigkeit des Datentyps FLOAT8 | 10 |
| blob_segment_length | integer | Die Datenmenge in Bytes, die in einem Zugriff aus einem BLOB/CLOB gelesen werden kann. Falls nichts anderes angegeben wurde, ist der Vorgabewert 4096 Bytes. | 8192 |
Gibt bei Erfolg TRUE zurück. Im Fehlerfall wird FALSE zurückgegeben.
Beispiel #1 Datumsformat auf ISO4 setzen
<?php
$options = array( "date_format" => INGRES_DATE_ISO4 );
if (ingres_set_environment($link, $options))
{
$result=ingres_query($link,"select date('now') as date");
while ( $object = ingres_fetch_object ($result) ) {
echo $object->date."\n";
}
}
?>
Beispiel #2 Die Zeitzone auf HONG-KONG setzen
<?php
$options = array( "timezone" => "HONG-KONG");
if (ingres_set_environment($link, $options))
{
$result=ingres_query($link,"select date('now') as date");
while ( $object = ingres_fetch_object ($result) ) {
echo $object->date."\n";
}
}
?>