將十進位字串及貨幣值格式化 (SQLSRV 驅動程式)
為了維持正確性，decimal 或 numeric 類型一律是以完全符合的精確度與小數位數擷取為字串。 如果任何值小於 1，則會遺漏前置零。 money 和 smallmoney 欄位也是如此，因為其為小數位數固定為 4 的 decimal 欄位。
若遺漏前置零則加以新增
從 5.6.0 版開始，已將 FormatDecimals 選項新增至 sqlsrv 連線和陳述式層級，其可讓使用者格式化十進位字串。 此選項會預期布林值 (true 或 false)，而且只會影響所擷取結果中十進位或數值的格式設定。 換句話說，FormatDecimals 選項不會影響插入或更新等其他作業。
根據預設，FormatDecimals 是 false。 如果設定為 true，則會將十進位字串的前置零新增至小於 1 的任何十進位值。
設定小數位數的數目
當 FormatDecimals 開啟時，另一個 DecimalPlaces 選項可讓使用者設定顯示 money 和 smallmoney 資料時的小數位數。 其接受範圍在 [0, 4] 內的整數值，而在顯示時可能會發生進位。 不過，底層 money 資料會維持不變。
這兩個選項都可以在連線或陳述式層級設定，且陳述式設定一律會覆寫對應的連線設定。 請注意，DecimalPlaces 選項只會影響 money 資料，且 FormatDecimals 必須設定為 true，DecimalPlaces 才會生效。 否則，不論 DecimalPlaces 設定為何，格式設定都會關閉。
注意
因為 money 或 smallmoney 欄位的小數位數為 4，系統將會忽略將 DecimalPlaces 值設定為任何負數或大於 4 的任何值。 不建議使用任何已設定格式的 money 資料作為任何計算的輸入。
範例 - 簡易擷取
下列範例將示範如何使用新的選項進行簡易擷取。
<?php
$username = 'myusername';
$password = 'mypasword';
$tableName = 'mytable';
$connectionInfo = array("UID" => $username, "PWD" => $password, "Database" => "myDB", "FormatDecimals" => true);
$server = "myServer"; // IP address also works
$conn = sqlsrv_connect( $server, $connectionInfo);
$numDigits = 2;
$query = "SELECT money1 FROM $tableName";
$options = array("DecimalPlaces" => $numDigits);
$stmt = sqlsrv_prepare($conn, $query, array(), $options);
sqlsrv_execute($stmt);
if (sqlsrv_fetch($stmt)) {
$field = sqlsrv_get_field($stmt, 0);
echo $field; // expect a numeric value string with 2 decimal places
}
sqlsrv_free_stmt($stmt);
sqlsrv_close($conn);
?>
範例 - 格式化輸出參數
如果 decimal 或 numeric 欄位以輸出參數的形式傳回，系統會將傳回的值視為一般 varchar 字串。 不過，如果已指定 SQLSRV_SQLTYPE_DECIMAL 或 SQLSRV_SQLTYPE_NUMERIC，您可以將 FormatDecimals 設定為 true 以確保數值字串值沒有任何遺失的前置零。 如需詳細資訊，請參閱如何：使用 SQLSRV 驅動程式擷取輸出參數。
下列範例示範如何格式化傳回 decimal(8,4) 值之預存程序的輸出參數。
$outString = '';
$outSql = '{CALL myStoredProc(?)}';
$stmt = sqlsrv_prepare($conn,
$outSql,
array(array(&$outString, SQLSRV_PARAM_OUT, null, SQLSRV_SQLTYPE_DECIMAL(8, 4))),
array('FormatDecimals' => true));
if (sqlsrv_execute($stmt)) {
echo $outString; // expect a numeric value string with no missing leading zero
}