Aangepaste tekenreeksen voor datum-/tijdnotatie ondersteund door FORMAT() in SQL Server

Dit artikel bevat een referentie voor de aangepaste datum- en tijdnotatiespecificaties die kunnen worden gebruikt bij het opmaken van datums en/of tijden met behulp van de FORMAT() functie in SQL Server, samen met voorbeelden.

U kunt elk van deze indelingsspecificaties combineren om een ​​aangepaste indelingsreeks te maken. Zie hieronder voor een codevoorbeeld en een uitleg over hoe strings met aangepaste opmaak werken.

De voorbeelden in de tabel gaan uit van een datetimeoffset waarde van 2080-05-01 23:09:08.1234567 +07:00 .

Elk ander teken wordt ongewijzigd naar de resultaatreeks gekopieerd.

Belangrijk: Als u een tekenreeks met een aangepaste notatie van één teken gebruikt, moet u deze vooraf laten gaan door het procentteken (% ). Als alternatief kunt u een spatie toevoegen. Als u dit niet doet, krijgt u ofwel NULL, of de formaatspecificatie kan worden geïnterpreteerd als een standaardformaatspecificatie en u krijgt onbedoelde resultaten.

Wat zijn Custom Format Strings?

Een tekenreeks voor aangepaste indelingen bestaat uit een of meer specificaties voor aangepaste indelingen. De bovenstaande tabel bevat de aangepaste indelingsspecificaties die beschikbaar zijn voor het opmaken van datum- en tijdwaarden in een tekenreeks.

Er zijn ook standaard strings voor datum- en tijdnotatie. Elk van deze is een alias voor een tekenreeks met aangepaste indeling. Strings met standaardopmaak bestaan ​​uit een enkele opmaakspecificatie, dus ze zijn sneller te gebruiken (maar minder flexibel dan strings met aangepaste opmaak).

Elke notatietekenreeks die geen standaard datum- en tijdnotatietekenreeks is, wordt geïnterpreteerd als een aangepaste datum- en tijdnotatietekenreeks.

Gebruiksvoorbeeld

De manier waarop specificaties voor aangepaste opmaak werken, is dat u ze kunt combineren om een ​​tekenreeks voor aangepaste opmaak te vormen bij gebruik van de FORMAT() functie. Dit bepaalt hoe het resultaat wordt opgemaakt.

Hier zijn enkele voorbeelden:

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

Resultaat:

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

Het biedt dus veel flexibiliteit in de manier waarop u uw datums en tijden presenteert.

Hier is een voorbeeld van het gebruik van een opmaakreeks die bestaat uit een enkele opmaakspecificatie.

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

Resultaat:

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

Zoals vermeld, moet u deze met een percentageteken toevoegen om te voorkomen dat u NULL krijgt en zodat de formaatspecificatie niet per ongeluk wordt geïnterpreteerd als een standaardnotatietekenreeks.

Dit gebeurt er als ik het procentteken uit het vorige voorbeeld verwijder:

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

Resultaat:

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

We krijgen een heel ander resultaat.