FORMAT は、Sql Server 2012 の一部として導入された新しい組み込み文字列関数の 1 つです。 この関数は、オプションのcultureパラメータ値を使用して、指定された形式でフォーマットされた値を返します。 この関数はSql Serverのネイティブ関数ではなく、.NET CLRに依存した関数です。
SYNTAX: FORMAT ( value, フォーマット )
| Parameter | 説明 |
| 値です。 | フォーマットされる値 |
| format: | このパラメータは、Vlaueがフォーマットされる形式を指定します。 |
| culture: | このパラメータはオプションで、値がフォーマットされる文化を指定します。 |
RETURNS: 戻り値の型はnvarcharです。
例1: FORMAT DATE with Culture
DECLARE @date DATETIME = GETDATE() SELECT @date AS 'GETDATE()', FORMAT( @date, 'd', 'en-US') AS 'DATE IN US Culture', FORMAT( @date, 'd', 'en-IN') AS 'DATE IN INDIAN Culture', FORMAT( @date, 'd', 'de-DE') AS 'DATE IN GERMAN Culture'
Result:
Example 2: FORMAT CURRENCY with Culture
DECLARE @Price INT = 40SELECT FORMAT(@Price,'c','en-US') AS 'CURRENCY IN US Culture', FORMAT(@Price,'c','de-DE') AS 'CURRENCY IN GERMAN Culture'
結果です。
例3: FORMAT CURRENCY
DECLARE @Price DECIMAL(5,3) = 40.356SELECT FORMAT( @Price, 'C') AS 'Default', FORMAT( @Price, 'C0') AS 'With 0 Decimal', FORMAT( @Price, 'C1') AS 'With 1 Decimal', FORMAT( @Price, 'C2') AS 'With 2 Decimal', FORMAT( @Price, 'C3') AS 'With 3 Decimal'
結果です。
例4：FORMAT PERCENTAGE
DECLARE @Percentage float = 0.35674SELECT FORMAT( @Percentage, 'P') AS '% Default', FORMAT( @Percentage, 'P0') AS '% With 0 Decimal', FORMAT( @Percentage, 'P1') AS '% with 1 Decimal', FORMAT( @Percentage, 'P2') AS '% with 2 Decimal', FORMAT( @Percentage, 'P3') AS '% with 3 Decimal'
結果です。
例5：FORMAT NUMBER
DECLARE @Number AS DECIMAL(10,2) = 454545.389SELECT FORMAT( @Number, 'N','en-US') AS 'Number Format in US', FORMAT( @Number, 'N','en-IN') AS 'Number Format in INDIA'SELECT FORMAT( @Number, '#.0') AS 'With 1 Decimal', FORMAT( @Number, '#.00') AS 'With 2 Decimal', FORMAT( @Number, '#,##.00') AS 'With Comma and 2 Decimal', FORMAT( @Number, '##.00') AS 'Without Comma and 2 Decimal'
結果です。
例6：カスタムの日付フォーマット
DECLARE @date DATETIME = GETDATE() SELECT @date AS 'GETDATE()', FORMAT ( @date, 'dd/MM/yyyy') AS 'dd/MM/yyyy', FORMAT ( @date, 'MM/dd/yyyy') AS 'MM/dd/yyyy', FORMAT ( @date, 'yyyy/MM/dd') AS 'yyyy/MM/dd' SELECT FORMAT( @date,'dddd, MMMM dd, yyyy hh:mm:ss tt','en-US') AS 'US', FORMAT( @date,'dddd, MMMM dd, yyyy hh:mm:ss tt','hi-IN') AS 'Hindi', FORMAT( @date,'dddd, MMMM dd, yyyy hh:mm:ss tt','kn-IN') AS 'Kannada'
結果です。
DECLARE @date DATETIME = GETDATE()SELECT FORMAT ( @date, 'dd', 'en-US' ) AS 'US',FORMAT ( @date, 'ddd', 'en-US' ) AS 'US',FORMAT ( @date, 'dddd', 'en-US' ) AS 'US',FORMAT ( @date, 'dddd', 'kn-IN' ) AS 'Kannada',FORMAT ( @date, 'dddd', 'hi-IN' ) AS 'Hindi'SELECT FORMAT ( @date, 'M', 'en-US' ) AS 'US',FORMAT ( @date, 'MM', 'en-US' ) AS 'US',FORMAT ( @date, 'MMM', 'en-US' ) AS 'US',FORMAT ( @date, 'MMMM', 'en-US' ) AS 'US',FORMAT ( @date, 'MMMM', 'kn-IN' ) AS 'Kannada',FORMAT ( @date, 'MMMM', 'hi-IN' ) AS 'Hindi'SELECT FORMAT ( @date, 'y', 'en-US' ) AS 'US', FORMAT ( @date, 'y', 'kn-IN' ) AS 'Kannada', FORMAT ( @date, 'y', 'hi-IN' ) AS 'Hindi', FORMAT ( @date, 'yy', 'en-US' ) AS 'US', FORMAT ( @date, 'yyy', 'en-US' ) AS 'US'
結果です。
例 7: 無効なカルチャ
DECLARE @date DATETIME = GETDATE()SELECT FORMAT(@date,'d','Test') AS 'Invalid Culture'
Result:
Msg 9818, Level 16, State 1, Line 2
関数呼び出しで指定されたカルチャ・パラメータ ‘Test’ はサポートされていません。
Sql Server 2012で導入された新しい組み込み関数については、以下を参照してください。
| Sql Server で導入された新しい組み込み関数 | |
| 変換機能 | |
| PARSE | TRY_PARSE |
| TRY_CONVERT | |
| STRING FUNCTIONS | |
| CONCAT | FORMAT |
| LOGICAL FUNCTIONS | |
| CHOOSE | IIF |
| DATE AND TIME FUNCTIONS | |
| EOMONTH | |
| DATEFROMPARTS | DATETIMEFROMPARTStd |
| SMALLDATETIMEFROMPARTS | DATETIME2FROMPARTS |
| TIMEFROMPARTS | DATETIMEOFFSETFROMPARTS |