Brugerdefinerede dato-/tidsformatstrenge, der understøttes af FORMAT() i SQL Server

Denne artikel giver en reference til de brugerdefinerede dato- og klokkeslætformatspecifikationer, der kan bruges ved formatering af datoer og/eller klokkeslæt ved hjælp af FORMAT() funktion i SQL Server, sammen med eksempler.

Du kan kombinere enhver af disse formatspecifikationer for at producere en tilpasset formatstreng. Se nedenfor for et kodeeksempel og en forklaring på, hvordan tilpassede formatstrenge fungerer.

Eksemplerne i tabellen antager en dato-tidsforskydning værdi af 2080-05-01 23:09:08.1234567 +07:00 .

Ethvert andet tegn kopieres til resultatstrengen uændret.

Vigtigt: Når du bruger en streng med et brugerdefineret format med et enkelt tegn, skal du sætte procenttegnet foran den (% ). Alternativt kan du tilføje et mellemrum. Hvis du ikke gør dette, får du enten NULL, eller også kan formatspecifikationen fortolkes som en standardformatspecifikation, og du vil få utilsigtede resultater.

Hvad er strenge til tilpasset format?

En brugerdefineret formatstreng består af en eller flere brugerdefinerede formatspecifikationer. Ovenstående tabel viser de brugerdefinerede formatspecifikationer, der er tilgængelige for formatering af dato- og tidsværdier til en streng.

Der er også standard dato- og tidsformatstrenge. Hver af disse er et alias for en tilpasset formatstreng. Standardformatstrenge består af en enkelt formatspecifikation, så de er hurtigere at bruge (men mindre fleksible end tilpassede formatstrenge).

Enhver formatstreng, der ikke er en standard dato- og tidsformatstreng, fortolkes som en tilpasset dato- og tidsformatstreng.

Eksempel på brug

Måden brugerdefinerede formatspecifikationer fungerer på er, at du kan kombinere dem sammen for at danne en brugerdefineret formatstreng, når du bruger FORMAT() fungere. Dette bestemmer, hvordan resultatet formateres.

Her er nogle eksempler:

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 giver mulighed for en masse fleksibilitet i, hvordan du præsenterer dine datoer og tidspunkter.

Her er et eksempel på brug af en formatstreng, der består af en enkelt formatspecifikation.

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ævnt bør du forankre disse med et procenttegn for at undgå at få NULL og for at formatspecifikationen ikke utilsigtet bliver fortolket som en standardformatstreng.

Her er hvad der sker, hvis jeg fjerner procenttegnet fra det forrige eksempel:

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 et helt andet resultat.