Anpassade formatsträngar för datum/tid som stöds av FORMAT() i SQL Server

Den här artikeln ger en referens till de anpassade datum- och tidsformatspecifikationerna som kan användas när du formaterar datum och/eller tider med FORMAT() funktion i SQL Server, tillsammans med exempel.

Du kan kombinera vilken som helst av dessa formatspecifikationer för att skapa en anpassad formatsträng. Se nedan för ett kodexempel och en förklaring om hur anpassade formatsträngar fungerar.

Exemplen i tabellen antar en datum- och tidsförskjutning värde på 2080-05-01 23:09:08.1234567 +07:00 .

Alla andra tecken kopieras till resultatsträngen oförändrade.

Viktigt: När du använder en anpassad formatsträng med ett tecken bör du sätta procenttecknet före den (% ). Alternativt kan du lägga till ett mellanslag. Om du inte gör detta får du antingen NULL eller så kan formatspecifikationen tolkas som en standardformatspecifikation, och du får oavsiktliga resultat.

Vad är anpassade formatsträngar?

En anpassad formatsträng består av en eller flera anpassade formatspecifikationer. Tabellen ovan listar de anpassade formatspecifikationerna som är tillgängliga för att formatera datum- och tidsvärden till en sträng.

Det finns också standardsträngar för datum- och tidsformat. Var och en av dessa är ett alias för en anpassad formatsträng. Standardformatsträngar består av en enda formatspecifikation, så de är snabbare att använda (men mindre flexibla än anpassade formatsträngar).

Alla formatsträngar som inte är en standardsträng för datum- och tidsformat tolkas som en anpassad datum- och tidsformatsträng.

Exempel på användning

Sättet som specificerar anpassade format fungerar är att du kan kombinera dem för att bilda en anpassad formatsträng när du använder FORMAT() fungera. Detta avgör hur resultatet formateras.

Här är några exempel:

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';

Resultat:

+-------------+-----------------+------------------------+------------+------------+
| 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   |
+-------------+-----------------+------------------------+------------+------------+

Så det ger en stor flexibilitet i hur du presenterar dina datum och tider.

Här är ett exempel på hur du använder en formatsträng som består av en enda formatspecifikator.

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';

Resultat:

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

Som nämnts bör du sätta ett procenttecken på dessa för att undvika att få NULL och så att formatspecifikationen inte av misstag tolkas som en standardformatsträng.

Så här händer om jag tar bort procenttecknet från föregående exempel:

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';

Resultat:

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

Vi får ett helt annat resultat.