ingres_set_environment

(PECL ingres >= 1.2.0)

ingres_set_environment — Setzt Eigenschaften der Umgebung zur Ausgabesteuerung

Beschreibung

bool ingres_set_environment ( resource $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.

Parameter-Liste

link

Die Verbindungskennung

options

Ein 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_DMY
  • INGRES_DATE_FINISH
  • INGRES_DATE_GERMAN
  • INGRES_DATE_ISO
  • INGRES_DATE_ISO4
  • INGRES_DATE_MDY
  • INGRES_DATE_MULTINATIONAL
  • INGRES_DATE_MULTINATIONAL4
  • INGRES_DATE_YMD
  • INGRES_DATE_US

 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
  • INGRES_MONEY_TRAILING

 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

Rückgabewerte

Gibt bei Erfolg TRUE zurück. Im Fehlerfall wird FALSE zurückgegeben.

Beispiele

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";
    }
}
?>

Siehe auch