Configure les directives contrôlant les résultats Ingres

# ingres_set_environment

(PECL ingres >= 1.2.0)

ingres_set_environment — Configure les directives contrôlant les résultats Ingres

### Description

ingres_set_environment ( resource `$link` , array `$options` ) : bool

ingres_set_environment() assigne des valeurs aux options qui affectent l'affichage des valeurs en provenance d'Ingres, telles que les fuseaux horaires, le format de date, le séparateur décimal ou la précision des nombres décimaux.

### Liste de paramètres

`link`

  La ressource de connexion Ingres

`options`

  Un tableau énuméré de paires clé / valeur. La table suivante liste toutes les options et leur type associé.

  Nom de l'option | Type de l'option | Description | Exemple
  --- | --- | --- | ---
  date_century_boundary | entier | Le seuil qui fait qu'une année exprimée sur deux chiffres fait partie de ce siècle ou du précédent. C'est l'équivalent de II_DATE_CENTURY_BOUNDARY | 50
  timezone | chaîne de caractères | Contrôle le fuseau horaire de la session. S'il n'est pas configuré, il prendra par défaut la valeur définie dans II_TIMEZONE_NAME. Si II_TIMEZONE_NAME n'est pas définie, ce sera NA-PACIFIC (GMT-8 avec horaire d'été), qui sera utilisé. | UNITED-KINGDOM
  date_format | entier | Configure les formats acceptables de dates. Par défaut, c'est la valeur définie dans II_DATE_FORMAT. Si II_DATE_FORMAT n'est pas configuré, le format par défaut est celui de la date US, par exemple mm/dd/yy. Les valeurs valides pour les formats sont : 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 | chaîne de caractères | Le séparateur décimal (en français, la virgule) | ","
  money_lort | entier | Le symbole monétaire, suffixe ou préfixe. Les valeurs valides sont : INGRES_MONEY_LEADING INGRES_MONEY_TRAILING | INGRES_MONEY_LEADING
  money_sign | chaîne de caractères | Le symbole monétaire à utiliser avec les valeurs de type MONEY | €
  money_precision | entier | La précision à utiliser avec les valeurs de type MONEY | 2
  float4_precision | entier | La précision à utiliser avec les valeurs de type FLOAT4 | 10
  float8_precision | entier | La précision à utiliser avec les valeurs de type FLOAT8 | 10
  blob_segment_length | entier | La quantité de données à lire à chaque lecture d'une valeur de type BLOB ou CLOB. Par défaut, c'est 4096 octets | 8192

### Valeurs de retour

Cette fonction retourne `TRUE` en cas de succès ou `FALSE` si une erreur survient.

### Exemples

Exemple #1 Configuration du format de date à ISO4

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

Exemple #2 Configuration du fuseau horaire de Hong-Kong

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

### Voir aussi

- ingres_connect() - Ouvre une connexion sur un serveur Ingres
- ingres_query() - Envoie une requête SQL à Ingres