Niestandardowe ciągi formatu daty/godziny obsługiwane przez FORMAT() w SQL Server

Ten artykuł zawiera odniesienie do niestandardowych specyfikatorów formatu daty i godziny, których można używać podczas formatowania dat i/lub godzin za pomocą FORMAT() funkcji w SQL Server, wraz z przykładami.

Możesz połączyć dowolne z tych specyfikatorów formatu, aby utworzyć dostosowany ciąg formatu. Zobacz poniżej przykład kodu i wyjaśnienie, jak działają niestandardowe ciągi formatu.

Przykłady w tabeli zakładają przesunięcie daty i godziny wartość 2080-05-01 23:09:08.1234567 +07:00 .

Każdy inny znak jest kopiowany do ciągu wynikowego bez zmian.

Ważne: Używając jednoznakowego ciągu formatu niestandardowego, należy poprzedzić go znakiem procentu (% ). Alternatywnie możesz dodać spację. Jeśli tego nie zrobisz, otrzymasz albo NULL, albo specyfikator formatu może być zinterpretowany jako specyfikator formatu standardowego i otrzymasz niezamierzone wyniki.

Co to są niestandardowe ciągi formatujące?

Ciąg formatu niestandardowego składa się z co najmniej jednego specyfikatora formatu niestandardowego. W powyższej tabeli wymieniono specyfikatory formatu niestandardowego dostępne do formatowania wartości daty i godziny w ciągu.

Istnieją również standardowe ciągi formatu daty i godziny. Każdy z nich jest aliasem niestandardowego ciągu formatu. Standardowe ciągi formatujące składają się z jednego specyfikatora formatu, więc są szybsze w użyciu (ale mniej elastyczne niż niestandardowe ciągi formatujące).

Każdy ciąg formatu, który nie jest standardowym ciągiem formatu daty i godziny, jest interpretowany jako niestandardowy ciąg formatu daty i godziny.

Przykład użycia

Sposób, w jaki działają specyfikatory formatu niestandardowego, polega na tym, że można je połączyć, aby utworzyć ciąg formatu niestandardowego podczas korzystania z FORMAT() funkcjonować. To określa sposób formatowania wyniku.

Oto kilka przykładów:

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

Wynik:

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

Pozwala więc na dużą elastyczność w prezentowaniu dat i godzin.

Oto przykład użycia ciągu formatu zawierającego pojedynczy specyfikator formatu.

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

Wynik:

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

Jak wspomniano, należy poprzedzić je znakiem procentu, aby uniknąć uzyskania wartości NULL i aby specyfikator formatu nie został przypadkowo zinterpretowany jako standardowy ciąg formatu.

Oto, co się stanie, jeśli usunę znak procentu z poprzedniego przykładu:

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

Wynik:

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

Otrzymujemy zupełnie inny wynik.