SQL ServerのFORMAT（）でサポートされているカスタムの日付/時刻形式の文字列

この記事では、FORMAT()を使用して日付や時刻をフォーマットするときに使用できるカスタムの日付と時刻のフォーマット指定子のリファレンスを提供します。 例とともに、SQLServerの関数。

これらのフォーマット指定子のいずれかを組み合わせて、カスタマイズされたフォーマット文字列を生成できます。コード例とカスタムフォーマット文字列の仕組みの説明については、以下を参照してください。

表の例は、 datetimeoffsetを想定しています。 2080-05-01 23:09:08.1234567 +07:00の値 。

その他の文字は変更されずに結果文字列にコピーされます。

重要： 1文字のカスタム形式の文字列を使用する場合は、パーセント記号（%を前に付ける必要があります ）。または、スペースを追加することもできます。これを行わないと、NULLになるか、フォーマット指定子が標準のフォーマット指定子として解釈される可能性があり、意図しない結果が得られます。

カスタムフォーマット文字列とは何ですか？

カスタムフォーマット文字列は、1つ以上のカスタムフォーマット指定子で構成されます。上記の表は、日付と時刻の値を文字列にフォーマットするために使用できるカスタムフォーマット指定子を示しています。

標準の日付と時刻の形式の文字列もあります。これらはそれぞれ、カスタムフォーマット文字列のエイリアスです。標準形式の文字列は単一の形式指定子で構成されているため、使用が速くなります（ただし、カスタム形式の文字列よりも柔軟性が低くなります）。

標準の日付と時刻の形式の文字列ではない形式の文字列は、カスタムの日付と時刻の形式の文字列として解釈されます。

使用例

カスタムフォーマット指定子が機能する方法は、FORMAT()を使用するときに、それらを組み合わせてカスタムフォーマット文字列を形成できることです。 働き。これにより、結果のフォーマット方法が決まります。

次にいくつかの例を示します。

DECLARE @date datetimeoffset;
SET @date = '2080-05-01 23:09:08.1234567 +07:00';
SELECT 
  FORMAT(@date, 'd, MMM yy') AS 'd, MMM yy',
  FORMAT(@date, 'dd, MMMM yyyy') AS 'dd, MMMM yyyy',
  FORMAT(@date, 'dddd, MMM dd yyyy') AS 'dddd, MMM dd yyyy',
  FORMAT(@date, 'hh:mm:ss') AS 'hh:mm:ss',
  FORMAT(@date, 'hh:mm tt') AS 'hh:mm tt';

結果：

+-------------+-----------------+------------------------+------------+------------+
| d, MMM yy   | dd, MMMM yyyy   | dddd, MMM dd yyyy      | hh:mm:ss   | hh:mm tt   |
|-------------+-----------------+------------------------+------------+------------|
| 1, May 80   | 01, May 2080    | Wednesday, May 01 2080 | 11:09:08   | 11:09 PM   |
+-------------+-----------------+------------------------+------------+------------+

そのため、日付と時刻の表示方法に多くの柔軟性があります。

単一のフォーマット指定子で構成されるフォーマット文字列を使用する例を次に示します。

DECLARE @date datetimeoffset;
SET @date = '2080-05-01 23:09:08.1234567 +07:00';
SELECT 
  FORMAT(@date, '%d') AS '%d',
  FORMAT(@date, '%M') AS '%M',
  FORMAT(@date, '%K') AS '%K',
  FORMAT(@date, '%z') AS '%z';

結果：

+------+------+--------+------+
| %d   | %M   | %K     | %z   |
|------+------+--------+------|
| 1    | 5    | +07:00 | +7   |
+------+------+--------+------+

前述のように、NULLにならないように、またフォーマット指定子が誤って標準のフォーマット文字列として解釈されないように、これらの前にパーセント記号を付ける必要があります。

前の例からパーセント記号を削除すると、次のようになります。

DECLARE @date datetimeoffset;
SET @date = '2080-05-01 23:09:08.1234567 +07:00';
SELECT 
  FORMAT(@date, 'd') AS 'd',
  FORMAT(@date, 'M') AS 'M',
  FORMAT(@date, 'K') AS 'K',
  FORMAT(@date, 'z') AS 'z';

結果：

+----------+-------+------+------+
| d        | M     | K    | z    |
|----------+-------+------+------|
| 5/1/2080 | May 1 | NULL | NULL |
+----------+-------+------+------+

まったく異なる結果が得られます。