Форматирование десятичных строк и денежных значений (драйвер PDO_SQLSRV)

Скачать драйвер PHP

Чтобы сохранить точность, типы decimal или numeric всегда извлекаются как строки с особой точностью и масштабом. Если какое-либо значение меньше 1, начальный ноль отсутствует. Это аналогично полям money и smallmoney, так как они являются десятичными полями с фиксированным масштабом равным 4.

Добавление ведущих нулей, если они отсутствуют

Начиная с версии 5.6.0, атрибут подключения или инструкции PDO::SQLSRV_ATTR_FORMAT_DECIMALS позволяет пользователю форматировать десятичные строки. Этот атрибут ожидает логическое значение (true или false) и влияет только на форматирование десятичных и других числовых значений в полученных результатах. Иными словами, этот атрибут не влияет на другие операции, такие как вставка или обновление.

Значение PDO::SQLSRV_ATTR_FORMAT_DECIMALS по умолчанию — false. Если задано значение true, то начальные нули в десятичных строках будут добавлены для любого десятичного значения меньше 1.

Настройка числа десятичных знаков

Если включен параметр PDO::SQLSRV_ATTR_FORMAT_DECIMALS, другой атрибут подключения или инструкции, PDO::SQLSRV_ATTR_DECIMAL_PLACES, позволяет пользователям настраивать количество знаков после запятой при отображении данных типов money и smallmoney. Он принимает целочисленные значения в диапазоне [0, 4] и может выполнять округление отображаемого числа. Однако базовые денежные данные остаются неизменными.

Атрибуты выписки всегда переопределяют соответствующие параметры соединения. Обратите внимание, что параметр PDO::SQLSRV_ATTR_DECIMAL_PLACES влияет только на денежные данные, а для параметра PDO::SQLSRV_ATTR_FORMAT_DECIMALS необходимо задать значение true. В противном случае форматирование отключается независимо от параметра PDO::SQLSRV_ATTR_DECIMAL_PLACES.

Примечание.

Так как поля money или smallmoney имеют масштаб 4, то при установке значения PDO::SQLSRV_ATTR_DECIMAL_PLACES любое отрицательное число или любое значение больше 4, будет игнорироваться. Не рекомендуется использовать какие-либо отформатированные денежные данные в качестве входных данных для каких-либо вычислений.

Установка атрибутов соединения

  • Задайте атрибуты в точке соединения:

    $attrs = array(PDO::SQLSRV_ATTR_FORMAT_DECIMALS => true,
               PDO::SQLSRV_ATTR_DECIMAL_PLACES => 2);

$conn = new PDO("sqlsrv:Server = <server>; Database = <database>", $username, $password, $attrs);

  • Задайте атрибуты после соединения:

    $conn = new PDO("sqlsrv:Server = <server>; Database = <database>", $username, $password);
$conn->setAttribute(PDO::SQLSRV_ATTR_FORMAT_DECIMALS, true);
$conn->setAttribute(PDO::SQLSRV_ATTR_DECIMAL_PLACES, 2);

Пример: форматирование денежных данных

В следующем примере показано, как извлечь данные о денежных средствах с помощью PDOStatement::bindColumn:

<?php
$database = "<database>";
$server = "(local)";
$conn = new PDO( "sqlsrv:server=$server; Database = $database", "", "");
$conn->setAttribute(PDO::SQLSRV_ATTR_FORMAT_DECIMALS, true);

$numDigits = 3;
$query = "SELECT smallmoney1 FROM aTable";
$options = array(PDO::SQLSRV_ATTR_DECIMAL_PLACES => $numDigits);
$stmt = $conn->prepare($query, $options);
$stmt->execute();

$stmt->bindColumn('smallmoney1', $field);
$result = $stmt->fetch(PDO::FETCH_BOUND);
echo $field;    // expect a number string with 3 decimal places

unset($stmt);
unset($conn);
?>

Пример. Переопределение атрибутов соединения

В следующем примере показано, как переопределить атрибуты соединения.

<?php
$database = '<database>';
$server = '<server>';
$username = '<user_id>';
$password = '<password>'

$conn = new PDO("sqlsrv:server=$server; Database = $database", $username, $password);
$conn->setAttribute(PDO::SQLSRV_ATTR_FORMAT_DECIMALS, true);
$conn->setAttribute(PDO::SQLSRV_ATTR_DECIMAL_PLACES, 2);

$query = 'SELECT smallmoney1 FROM testTable1';
$options = array(PDO::SQLSRV_ATTR_FORMAT_DECIMALS => false);
$stmt = $conn->prepare($query, $options);
$stmt->execute();

$stmt->bindColumn('smallmoney1', $field);
$result = $stmt->fetch(PDO::FETCH_BOUND);  
echo $field;   // expect a number string showing the original scale -- 4 decimal places

unset($stmt);
unset($conn);
?>

Связанные материалы

  • Последнее обновление: