Řetězce vlastního formátu data a času Podporováno FORMAT() na serveru SQL Server

Tento článek poskytuje odkaz na vlastní specifikátory formátu data a času, které lze použít při formátování dat a/nebo časů pomocí FORMAT() funkce v SQL Server, spolu s příklady.

Kterýkoli z těchto specifikátorů formátu můžete zkombinovat a vytvořit tak přizpůsobený formátovací řetězec. Níže naleznete příklad kódu a vysvětlení, jak fungují vlastní formátovací řetězce.

Příklady v tabulce předpokládají datetimeoffset hodnota 2080-05-01 23:09:08.1234567 +07:00 .

Jakýkoli jiný znak se zkopíruje do výsledného řetězce beze změny.

Důležité: Při použití jednoznakového řetězce vlastního formátu byste před něj měli přidat znak procenta (% ). Případně můžete přidat mezeru. Pokud to neuděláte, dostanete buď NULL, nebo lze specifikátor formátu interpretovat jako standardní specifikátor formátu a získáte nezamýšlené výsledky.

Co jsou řetězce vlastního formátu?

Vlastní formátovací řetězec se skládá z jednoho nebo více vlastních specifikátorů formátu. Výše uvedená tabulka uvádí vlastní specifikátory formátu dostupné pro formátování hodnot data a času do řetězce.

Existují také standardní řetězce formátu data a času. Každý z nich je alias pro vlastní formátovací řetězec. Standardní formátovací řetězce se skládají z jednoho specifikátoru formátu, takže se používají rychleji (ale méně flexibilní než vlastní formátovací řetězce).

Jakýkoli formátovací řetězec, který není standardním formátovacím řetězcem data a času, je interpretován jako vlastní formátovací řetězec data a času.

Příklad použití

Vlastní specifikátory formátu fungují tak, že je můžete zkombinovat a vytvořit vlastní formátovací řetězec při použití FORMAT() funkce. To určuje, jak bude výsledek formátován.

Zde je několik příkladů:

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

Výsledek:

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

Umožňuje tedy velkou flexibilitu v tom, jak prezentujete svá data a časy.

Zde je příklad použití formátovacího řetězce skládajícího se z jediného specifikátoru formátu.

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

Výsledek:

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

Jak již bylo zmíněno, měli byste je přidat znakem procenta, abyste se vyhnuli získání NULL a aby specifikátor formátu nebyl neúmyslně interpretován jako standardní formátovací řetězec.

Zde je to, co se stane, když odstraním znak procenta z předchozího příkladu:

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

Výsledek:

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

Dostaneme úplně jiný výsledek.