ingres_set_environment

(PECL ingres >= 1.2.0)

ingres_set_environment — Establece las características de entorno que controlan las opciones de salida

Descripción

bool ingres_set_environment ( resource $link , array $options )

ingres_set_environment() se invoca para establecer las opciones de entorno que afectan a la salida de cierots valores desde Ingres, tales como la zona horaria, el format de fecha, el carácter separador decimal, y la precisión del tipo float.

Parámetros

link

El identificador de enlace de la conexión

options

Un array enumerado de pares nombre/valor de opciones. La siguiente tabla enumera el nombre de la opción y el tipo esperado

Nombre de la opción Tipo de la opción Descripción Ejemplo
date_century_boundary integer El umbral por el cual se determina si un año de dos dígitos está en el siglo actual o en el siglo siguiente. Equivalente a II_DATE_CENTURY_BOUNDARY. 50
timezone string Controla la zona horaria de la sesión. Si no se establece, se usará el valor definido por II_TIMEZONE_NAME. Si II_TIMEZONE_NAME no está definido, se usarán NA-PACIFIC (GMT-8 con horara de verano). UNITED-KINGDOM
date_format integer

Establece el formato de entrada y salida permisible para las fechas de Ingres. El valor predeterminado es el definido por II_DATE_FORMAT. Si II_DATE_FORMAT no está establecido, se usará el formato de fecha US, p.j. mm/dd/aa. Los valores válidos para date_format son:

  • 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_MULTINATIONAL4
decimal_separator string El identificador del carácter para los datos decimales ","
money_lort integer

El símbolo monetario que va antes o después del valor. Los valores válidos para money_lort son:

  • INGRES_MONEY_LEADING
  • INGRES_MONEY_TRAILING

 INGRES_MONEY_TRAILING
money_sign string El símpbolo monetario a usar con el tipo de datos MONEY €
money_precision integer La precisión del tipo de datos MONEY 3
float4_precision integer La precisión del tipo de datos FLOAT4 10
float8_precision integer La precisión del tipo de datos FLOAT8 10
blob_segment_length integer La cantidad de datos en bytes a obtener de una vez cuando se recuperan datos BLOB o CLOB. El valor predeterminado es de 4096 si no se establece explícitamente 8192

Valores devueltos

Devuelve TRUE en caso de éxito o FALSE en caso de error.

Ejemplos

Ejemplo #1 Establecer el formato de fecha a ISO4

<?php
$opciones = array( "date_format" => INGRES_DATE_ISO4 );

if (ingres_set_environment($enlace, $opciones))
{
    $result=ingres_query($enlace,"select date('now') as date");

    while ( $objeto = ingres_fetch_object ($resultado) ) {
        echo $objeto->date."\n";
    }
}
?>

Ejemplo #2 Set timezone to HONG-KONG

<?php

$opciones = array( "timezone" => "HONG-KONG");

if (ingres_set_environment($enlace, $opciones))
{
    $result=ingres_query($enlace,"select date('now') as date");

    while ( $objeto = ingres_fetch_object ($resultado) ) {
        echo $objeto->date."\n";
    }
}
?>

Ver también