Stringhe di formato data/ora personalizzate supportate da FORMAT() in SQL Server

Questo articolo fornisce un riferimento per gli identificatori di formato di data e ora personalizzati che possono essere utilizzati durante la formattazione di date e/o ore utilizzando FORMAT() funzione in SQL Server, insieme agli esempi.

È possibile combinare uno qualsiasi di questi identificatori di formato per produrre una stringa di formato personalizzata. Vedi sotto per un esempio di codice e una spiegazione su come funzionano le stringhe di formato personalizzato.

Gli esempi nella tabella presuppongono un datetimeoffset valore di 2080-05-01 23:09:08.1234567 +07:00 .

Qualsiasi altro carattere viene copiato nella stringa del risultato invariato.

Importante: Quando si utilizza una stringa di formato personalizzata di un carattere, è necessario anteporre il segno di percentuale (% ). In alternativa, puoi aggiungere uno spazio. Se non lo fai, otterrai NULL o l'identificatore di formato potrebbe essere interpretato come un identificatore di formato standard e otterrai risultati non desiderati.

Cosa sono le stringhe di formato personalizzate?

Una stringa di formato personalizzata è costituita da uno o più identificatori di formato personalizzati. La tabella precedente elenca gli identificatori di formato personalizzati disponibili per la formattazione dei valori di data e ora in una stringa.

Esistono anche stringhe di formato di data e ora standard. Ognuno di questi è un alias per una stringa di formato personalizzata. Le stringhe di formato standard sono costituite da un unico identificatore di formato, quindi sono più veloci da usare (ma meno flessibili delle stringhe di formato personalizzate).

Qualsiasi stringa di formato che non sia una stringa di formato di data e ora standard viene interpretata come una stringa di formato di data e ora personalizzata.

Esempio di utilizzo

Il modo in cui funzionano gli identificatori di formato personalizzati è che puoi combinarli insieme per formare una stringa di formato personalizzata quando usi FORMAT() funzione. Questo determina come viene formattato il risultato.

Ecco alcuni esempi:

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

Risultato:

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

Quindi consente molta flessibilità nel modo in cui presenti le date e gli orari.

Ecco un esempio di utilizzo di una stringa di formato costituita da un unico identificatore di formato.

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

Risultato:

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

Come accennato, dovresti anteporre questi con un segno di percentuale per evitare di ottenere NULL e in modo che l'identificatore di formato non venga inavvertitamente interpretato come una stringa di formato standard.

Ecco cosa succede se rimuovo il segno di percentuale dall'esempio precedente:

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

Risultato:

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

Otteniamo un risultato completamente diverso.