Персонализирани низове за формат на дата/час, поддържани от FORMAT() в SQL Server

Тази статия предоставя справка за персонализираните спецификатори на формата за дата и час, които могат да се използват при форматиране на дати и/или часове с помощта на FORMAT() функция в SQL Server, заедно с примери.

Можете да комбинирате всеки от тези спецификатори на формат, за да създадете персонализиран форматен низ. Вижте по-долу пример за код и обяснение как работят низовете за персонализиран формат.

Примерите в таблицата предполагат отместване на датата и времето стойност на 2080-05-01 23:09:08.1234567 +07:00 .

Всеки друг знак се копира в резултантния низ без промяна.

Важно: Когато използвате низ за персонализиран формат от един знак, трябва да го поставите преди знака за процент (% ). Като алтернатива можете да добавите интервал. Ако не направите това, или ще получите NULL, или спецификаторът на формата може да се интерпретира като стандартен спецификатор на формат и ще получите непредвидени резултати.

Какво представляват низовете с персонализиран формат?

Низът за персонализиран формат се състои от един или повече спецификатори на персонализиран формат. Таблицата по-горе изброява спецификаторите на персонализиран формат, налични за форматиране на стойности за дата и час в низ.

Има и стандартни низове за формат на дата и час. Всеки от тях е псевдоним за низ за персонализиран формат. Низовете за стандартен формат се състоят от един спецификатор на формат, така че са по-бързи за използване (но по-малко гъвкави от низовете за персонализиран формат).

Всеки форматен низ, който не е стандартен низ за формат на дата и час, се интерпретира като персонализиран низ за формат на дата и час.

Пример за употреба

Начинът, по който работят спецификаторите на персонализиран формат, е, че можете да ги комбинирате заедно, за да образувате низ за персонализиран формат, когато използвате 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 |
+----------+-------+------+------+

Получаваме съвсем различен резултат.