環境を設定して出力オプションを制御する

# ingres_set_environment

(PECL ingres >= 1.2.0)

ingres_set_environment — 環境を設定して出力オプションを制御する

### 説明

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

ingres_set_environment() をコールして、 Ingres からの値の出力に影響する環境設定をします。 タイムゾーンや日付の書式、桁区切り文字や小数点の桁数などが含まれます。

### パラメータ

`link`

  接続リンク ID。

`options`

  オプション名とその値のペアの配列。 オプション名と型は次のとおりです。

  オプション名 | 型 | 説明 | 例
  --- | --- | --- | ---
  date_century_boundary | integer | 2 桁表記の年が今世紀を表すのか来世紀を表すのかの区切り。 II_DATE_CENTURY_BOUNDARY と同じです。 | 50
  timezone | string | セッションのタイムゾーンを設定します。未設定の場合は II_TIMEZONE_NAME で定義したデフォルトを使います。 II_TIMEZONE_NAME が定義されていない場合は NA-PACIFIC (GMT-8 +夏時間) を使います。 | UNITED-KINGDOM
  date_format | integer | Ingres の日付の入出力フォーマットを設定します。 デフォルトは II_DATE_FORMAT で定義した値です。II_DATE_FORMAT が未設定の場合は デフォルトの日付フォーマットは US、つまり mm/dd/yy 形式となります。 date_format には次の値を使えます。 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 | 数値の桁区切り文字 | ","
  money_lort | integer | 通貨記号を先頭と末尾のどちらにつけるか。 money_lort には次の値を使えます。 INGRES_MONEY_LEADING INGRES_MONEY_TRAILING | INGRES_MONEY_LEADING
  money_sign | string | MONEY 型で使う通貨記号 | €
  money_precision | integer | MONEY 型の小数点以下の桁数 | 2
  float4_precision | integer | FLOAT4 型の小数点以下の桁数 | 10
  float8_precision | integer | FLOAT8 型の小数点以下の桁数 | 10
  blob_segment_length | integer | BLOB や CLOB のデータを取得するときの一回あたりの取得バイト数。 明示的に指定しない場合のデフォルトは 4096 バイト。 | 8192

### 返り値

成功した場合に `TRUE` を、失敗した場合に `FALSE` を返します。

### 例

例1 date_format を 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";
}
}
?>`

例2 タイムゾーンを 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";
}
}
?>`

### 参考

- ingres_connect() - Ingres データベースへの接続をオープンする
- ingres_query() - Ingres に SQL クエリを送信する