共用方式為

FORMAT (Transact-SQL)

  • 發行項

適用於：SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Microsoft Fabric 中的 SQL 分析端點 Microsoft Fabric 中的倉儲

傳回以指定格式與選擇性文化特性所格式化的值。 使用函 FORMAT 式將日期/時間和數位值的地區設定感知格式設定為字串。 針對一般資料類型轉換，請使用 CAST 或 CONVERT。

Transact-SQL 語法慣例

Syntax

FORMAT( value , format [ , culture ] )

注意

若要檢視 SQL Server 2014 (12.x) 和更早版本的 Transact-SQL 語法，請參閱舊版文件。

引數

value

要格式化之受支援資料類型的運算式。 如需有效類型的清單，請參閱一節中的表格。

format

nvarchar 格式模式。

format 自變數必須包含有效的 .NET Framework 格式字串，可以是標準格式字串（例如 "C" 或 "D"），或是日期和數值的自定義字元模式（例如 ， "MMMM DD, yyyy (dddd)"。 不支援複合格式設定。

如需這些格式模式的完整說明，請參閱 .NET Framework 文件中有關一般字串格式、自訂日期與時間格式，以及自訂數字格式的資訊。 如需詳細資訊，請參閱格式類型。

culture

指定文化特性的選用 nvarchar 引數。

如果未提供文化特性自變數，則會使用目前會話的語言。 此語言會隱含設定，或使用語句明確 SET LANGUAGE 設定。 culture 接受 .NET Framework 支援的任何文化特性做為自變數;不限於 SQL Server 明確支持的語言。 如果文化特性自變數無效，FORMAT則會引發錯誤。

傳回類型

nvarchar 或 null

傳回值的長度取決於 format。

備註

FORMAT傳NULL回無效之文化特性以外的錯誤。 例如，NULL如果格式中指定的值無效，則會傳回 。

函 FORMAT 式不具決定性。

FORMAT 依賴 .NET Framework Common Language Runtime （CLR） 的存在。

此函式無法遠端，因為它取決於CLR的存在。 從遠端處理需要 CLR 的函數可能會導致遠端伺服器發生錯誤。

FORMAT 依賴 CLR 格式規則，該規則會指出必須逸出冒號和句點。 因此，當格式字串 （second parameter） 包含冒號或句點時，當輸入值 （first parameter） 是 time 數據類型時，必須使用反斜杠逸出冒號或句號。 請參閱 D. 具有 time 資料類型的 FORMAT。

下表列出 value 引數可接受的資料類型，以及其 .NET Framework 對應的對等類型。

類別 類型 .NET 類型
數值 bigint Int64
數值 int Int32
數值 smallint Int16
數值 tinyint Byte
數值 decimal SqlDecimal
數值 numeric SqlDecimal
數值 float Double
數值 real Single
數值 smallmoney Decimal
數值 money Decimal
日期及時間 date DateTime
日期和時間 time TimeSpan
日期及時間 datetime DateTime
日期及時間 smalldatetime DateTime
日期及時間 datetime2 DateTime
日期及時間 datetimeoffset DateTimeOffset

範例

A. 簡單的 FORMAT 範例

下列範例會傳回針對不同文化特性格式化的簡單日期。

DECLARE @d DATE = '11/22/2020';

SELECT FORMAT(@d, 'd', 'en-US') 'US English',
    FORMAT(@d, 'd', 'en-gb') 'British English',
    FORMAT(@d, 'd', 'de-de') 'German',
    FORMAT(@d, 'd', 'zh-cn') 'Chinese Simplified (PRC)';

SELECT FORMAT(@d, 'D', 'en-US') 'US English',
    FORMAT(@d, 'D', 'en-gb') 'British English',
    FORMAT(@d, 'D', 'de-de') 'German',
    FORMAT(@d, 'D', 'zh-cn') 'Chinese Simplified (PRC)';

以下為結果集。

US English   British English  German      Simplified Chinese (PRC)
-----------  ---------------- ----------- -------------------------
8/9/2024     09/08/2024       09.08.2024  2024/8/9

US English              British English  German                    Chinese (Simplified PRC)
----------------------- ---------------- ------------------------  -------------------------
Friday, August 9, 2024  09 August 2024   Freitag, 9. August 2024   2024年8月9日

B. 包含自訂格式字串的 FORMAT

下列範例會藉由指定自訂格式顯示格式數值。 此範例假設目前的日期為 2024 年 8 月 9 日。 如需有關這些自訂格式和其他自訂格式的詳細資訊，請參閱自訂數值格式字串。

DECLARE @d DATE = GETDATE();

SELECT FORMAT(@d, 'dd/MM/yyyy', 'en-US') AS 'Date',
    FORMAT(123456789, '###-##-####') AS 'Custom Number';

以下為結果集。

Date         Custom Number
-----------  --------------
09/08/2024   123-45-6789

C. 數值類型的 FORMAT

下列範例會從資料庫中的Sales.CurrencyRateAdventureWorks2022數據表傳回五個數據列。 數據行EndOfDateRate會儲存為數據表中的 money 類型。 在此範例中，資料行會以未格式化的狀態傳回，然後藉由指定 .NET Number 格式、General 格式和 Currency 格式類型進行格式化。 如需有關這些數值格式和其他數值格式的詳細資訊，請參閱標準數值格式字串。

SELECT TOP (5) CurrencyRateID,
    EndOfDayRate,
    FORMAT(EndOfDayRate, 'N', 'en-us') AS 'Numeric Format',
    FORMAT(EndOfDayRate, 'G', 'en-us') AS 'General Format',
    FORMAT(EndOfDayRate, 'C', 'en-us') AS 'Currency Format'
FROM Sales.CurrencyRate
ORDER BY CurrencyRateID;

以下為結果集。

CurrencyRateID EndOfDayRate  Numeric Format  General Format  Currency Format
-------------- ------------  --------------  --------------  ---------------
1              1.0002        1.00            1.0002          $1.00
2              1.55          1.55            1.5500          $1.55
3              1.9419        1.94            1.9419          $1.94
4              1.4683        1.47            1.4683          $1.47
5              8.2784        8.28            8.2784          $8.28

此範例會指定德文文化 （de-de）。

SELECT TOP (5) CurrencyRateID,
    EndOfDayRate,
    FORMAT(EndOfDayRate, 'N', 'de-de') AS 'Numeric Format',
    FORMAT(EndOfDayRate, 'G', 'de-de') AS 'General Format',
    FORMAT(EndOfDayRate, 'C', 'de-de') AS 'Currency Format'
FROM Sales.CurrencyRate
ORDER BY CurrencyRateID;

CurrencyRateID EndOfDayRate  Numeric Format  General Format  Currency Format
-------------- ------------  --------------  --------------  ---------------
1              1.0002        1,00            1,0002          1,00 €
2              1.55          1,55            1,5500          1,55 €
3              1.9419        1,94            1,9419          1,94 €
4              1.4683        1,47            1,4683          1,47 €
5              8.2784        8,28            8,2784          8,28 €

D. 具有 time 資料類型的 FORMAT

FORMAT 在這些情況下會傳 NULL 回 ，因為 . 和 : 不會逸出。

SELECT FORMAT(cast('07:35' AS TIME), N'hh.mm');  --> returns NULL
SELECT FORMAT(cast('07:35' AS TIME), N'hh:mm');  --> returns NULL

Format 會傳回格式化的字串，因為會逸出 . 和 :。

SELECT FORMAT(cast('07:35' AS TIME), N'hh\.mm');  --> returns 07.35
SELECT FORMAT(cast('07:35' AS TIME), N'hh\:mm');  --> returns 07:35

Format 會傳回指定 AM 或 PM 的格式化目前時間。

SELECT FORMAT(SYSDATETIME(), N'hh:mm tt');  --> returns 03:46 PM
SELECT FORMAT(SYSDATETIME(), N'hh:mm t');   --> returns 03:46 P

Format 會傳回指定的時間，並顯示AM。

select FORMAT(CAST('2018-01-01 01:00' AS DATETIME2), N'hh:mm tt');  --> returns 01:00 AM
select FORMAT(CAST('2018-01-01 01:00' AS DATETIME2), N'hh:mm t');   --> returns 01:00 A

Format 會傳回指定的時間，並顯示 PM。

select FORMAT(CAST('2018-01-01 14:00' AS DATETIME2), N'hh:mm tt');  --> returns 02:00 PM
select FORMAT(CAST('2018-01-01 14:00' AS DATETIME2), N'hh:mm t');   --> returns 02:00 P

Format 會以 24 小時格式傳回指定的時間。

select FORMAT(CAST('2018-01-01 14:00' AS DATETIME2), N'HH:mm');  --> returns 14:00

相關內容