將十進位字串及貨幣值格式化 (SQLSRV 驅動程式)

發行項
06/02/2023

為了維持正確性，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
}

另請參閱

將十進位字串及貨幣值格式化 (PDO_SQLSRV 驅動程式)

擷取資料