Cadenas de formato de fecha/hora personalizadas admitidas por FORMAT() en SQL Server

Este artículo proporciona una referencia para los especificadores de formato de fecha y hora personalizados que se pueden usar al formatear fechas y/u horas usando FORMAT() función en SQL Server, junto con ejemplos.

Puede combinar cualquiera de estos especificadores de formato para generar una cadena de formato personalizada. Consulte a continuación un ejemplo de código y una explicación sobre cómo funcionan las cadenas de formato personalizado.

Los ejemplos en la tabla asumen un datetimeoffset valor de 2080-05-01 23:09:08.1234567 +07:00 .

Cualquier otro carácter se copia en la cadena de resultados sin cambios.

Importante: Cuando utilice una cadena de formato personalizado de un solo carácter, debe anteponer el signo de porcentaje (% ). Alternativamente, puede agregar un espacio. Si no hace esto, obtendrá NULL o el especificador de formato podría interpretarse como un especificador de formato estándar y obtendrá resultados no deseados.

¿Qué son las cadenas de formato personalizado?

Una cadena de formato personalizado consta de uno o más especificadores de formato personalizado. La tabla anterior enumera los especificadores de formato personalizados disponibles para formatear valores de fecha y hora en una cadena.

También hay cadenas de formato de fecha y hora estándar. Cada uno de estos es un alias para una cadena de formato personalizado. Las cadenas de formato estándar constan de un único especificador de formato, por lo que son más rápidas de usar (pero menos flexibles que las cadenas de formato personalizado).

Cualquier cadena de formato que no sea una cadena de formato de fecha y hora estándar se interpreta como una cadena de formato de fecha y hora personalizado.

Ejemplo de uso

La forma en que funcionan los especificadores de formato personalizado es que puede combinarlos para formar una cadena de formato personalizado al usar FORMAT() función. Esto determina cómo se formatea el resultado.

Estos son algunos ejemplos:

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

Resultado:

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

Por lo tanto, permite mucha flexibilidad en la forma en que presenta sus fechas y horas.

Este es un ejemplo del uso de una cadena de formato que consta de un único especificador de 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';

Resultado:

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

Como se mencionó, debe anteponerlos con un signo de porcentaje para evitar obtener NULL y para que el especificador de formato no se interprete inadvertidamente como una cadena de formato estándar.

Esto es lo que sucede si elimino el signo de porcentaje del ejemplo anterior:

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

Resultado:

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

Obtenemos un resultado completamente diferente.