Compartir a través de

Patrones de fecha y hora

Se aplica a:casilla marcada como Sí Databricks SQL casilla marcada como Sí Databricks Runtime

Hay varios escenarios comunes para el uso de datetime en Azure Databricks:

Tabla de patrones

Azure Databricks usa las letras del patrón de la tabla siguiente para el análisis y el formato de fecha y marca de tiempo:

Símbolo Significado Presentación Ejemplos
G era texto Año del Señor; Después de Cristo
y año año 2020; 20
D día del año número(3) 189
M/L mes del año mes 7; 07; Jul; Julio
d día del mes número(3) 28
Q/q trimestre del año number/text 3; 03; T3; tercer trimestre
E día de la semana texto Mar; Martes
F día de la semana alineado en el mes número(1) 3
un am o pm del día am-pm PM
h hora de reloj de am o pm (1-12) número(2) 12
K hora de am o pm (0-11) número(2) 0
k hora de reloj de día (1-24) número(2) 0
H hora de día (0-23) número(2) 0
m minuto de hora número(2) 30
s segundo de minuto número(2) 55
S fracción de segundo fracción 978
V id. de zona horaria zone-id América/Los_Angeles; Z; -08:30
z nombre de zona horaria nombre de zona Hora estándar del Pacífico; PST
O diferencia horaria localizada offset-O GMT+8; GMT+08:00; UTC-08:00;
X desplazamiento de zona "Z" para cero offset-X Z; -08; -0830; -08:30; -083015; -08:30:15;
x desplazamiento de zona offset-x +0000; -08; -0830; -08:30; -083015; -08:30:15;
Z desplazamiento de zona offset-Z +0000; -0800; -08:00;
" escape para texto delimitador
'' comillas simples Literal '
[ inicio de sección opcional
] fin de sección opcional

El recuento de letras del patrón determina el formato.

  • Texto: el estilo del texto se determina en función del número de letras del patrón usadas. Con menos de cuatro letras del patrón se usa el formato de texto corto, normalmente una abreviatura, por ejemplo, el día de la semana Lunes podría generar "Lun". Con exactamente cuatro letras del patrón se usa el formato de texto completo, normalmente la descripción completa, por ejemplo, el día de la semana Lunes podría generar "Lunes". Con cinco o más letras se produce un error.

  • Número(n): aquí n representa el recuento máximo de letras que se pueden usar en este tipo de patrón de fecha y hora. Si el recuento de letras es uno, el valor se genera mediante el número mínimo de dígitos y sin relleno. De lo contrario, el recuento de dígitos se usa como ancho del campo de salida, con el valor rellenado con ceros según sea necesario.

  • Número o texto: si el recuento de letras del patrón es tres o más, use las reglas de texto anteriores. De lo contrario, use las reglas de número anteriores.

  • Fracción: use uno o más (hasta nueve) caracteres 'S' contiguos, por ejemplo, SSSSSS, para analizar la fracción de segundo y darle formato. Para el análisis, la longitud aceptable de la fracción puede ser [1, el número de 'S' contiguos]. Para el formato, la longitud de la fracción se completaría hasta el número de 'S' contiguas con ceros. Azure Databricks admite datetime con una precisión de microsegundos, que tiene hasta 6 dígitos significativos, pero puede analizar nanosegundos con la parte superada truncada.

  • Año: el recuento de letras determina el ancho mínimo de campo por debajo del que se usa relleno. Si el recuento de letras es dos, se usa un formato reducido de dos dígitos. A la hora de imprimir, esto genera los dos dígitos más a la derecha. A la hora de analizar, se analiza con el valor base de 2000, lo que da como resultado un año dentro del intervalo de 2000 a 2099, ambos incluidos. Si el recuento de letras es inferior a cuatro (pero no dos), el signo solo se genera para años negativos. De lo contrario, el signo se muestra si se supera el ancho de relleno cuando 'G' no está presente. Con siete o más letras se produce un error.

  • Mes: sigue la regla de número o texto. El formulario de texto depende de las letras: 'M' indica el formulario "estándar" y 'L' es para el formulario "independiente". Estos dos formatos solo son diferentes en algunos idiomas determinados. Por ejemplo, en ruso, "Июль" es la forma independiente de julio, y "Июля" es la forma estándar. Estos son ejemplos de todas las letras del patrón admitidas:

    • 'M' o 'L': número de mes en un año a partir de 1. No hay ninguna diferencia entre 'M' y 'L'. Los meses del 1 al 9 se imprimen sin relleno.

      > SELECT date_format(date '1970-01-01', 'M');
  1

> SELECT date_format(date '1970-12-01', 'L');
  12

    • 'MM' o 'LL': número de mes en un año a partir de 1. Se agrega relleno cero para los meses del 1 al 9.

      > SELECT date_format(date '1970-1-01', 'LL');
  01

> SELECT date_format(date '1970-09-01', 'MM');
  09

    • 'MMM': representación textual corta en el formato estándar. El patrón del mes debe ser parte de un patrón de fecha, no solo un mes independiente, excepto en las configuraciones regionales en las que no hay ninguna diferencia entre los formatos estándar e independiente, como en inglés.

      > SELECT date_format(date '1970-01-01', 'd MMM');
  1 Jan

-- Passing a format pattern to to_csv()
> SELECT to_csv(named_struct('date', date '1970-01-01'), map('dateFormat', 'dd MMM', 'locale', 'RU'));
  01 янв.

    • 'MMMM': representación mensual textual completa en el formato estándar. Se usa para analizar meses o darles formato como parte de fechas o marcas de tiempo.

      > SELECT date_format(date '1970-01-01', 'd MMMM');
  1 January

-- Passing a format pttern to to_csv()
> SELECT to_csv(named_struct('date', date '1970-01-01'), map('dateFormat', 'd MMMM', 'locale', 'RU'));
  1 января

  • am-pm: esto indica si se trata de am o pm en el día. El recuento de letras del patrón debe ser 1.

  • Id. de zona (V): genera la representación del identificador de zona horaria. El recuento de letras del patrón debe ser 2.

  • Nombres de zona (Z): esto genera el nombre textual para mostrar del identificador de zona horaria. Si el recuento de letras es uno, dos o tres, se genera el nombre corto. Si el recuento de letras es cuatro, se genera el nombre completo. Con cinco o más letras se produce un error.

  • Diferencia horaria X y x: da formato a la diferencia horaria en función del número de letras del patrón. Una letra genera solo la hora, como "+01", a menos que el minuto no sea cero en cuyo caso también se genera el minuto, como "+0130". Dos caracteres muestran la hora y el minuto, sin dos puntos entre ellos, como '+0130'. Tres letras generan la hora y el minuto, con dos puntos, como '+01:30'. Cuatro cifras producen la hora y el minuto y el segundo opcional, sin dos puntos, como "+013015". Cinco letras muestran la hora y el minuto y el segundo opcional, con dos puntos, como '+01:30:15'. Con seis o más letras se produce un error. La letra de patrón 'X' (mayúscula) generará 'Z' cuando el desplazamiento que se va a mostrar sea cero, mientras que la letra de patrón 'x' (minúscula) generará '+00', '+0000' o '+00:00'.

  • Diferencia horaria O: da formato a la diferencia horaria localizada en función del número de letras del patrón. Una letra genera la forma corta del desplazamiento localizado, que es texto de desplazamiento localizado, como "GMT", con una hora sin cero inicial, un minuto opcional de 2 dígitos y un segundo si no es cero y dos puntos, por ejemplo, "GMT+8". Cuatro letras generan el formulario completo, que es texto de desplazamiento localizado, como "GMT, con campo de hora y minuto de 2 dígitos, segundo campo opcional si no es cero y dos puntos, por ejemplo "GMT+08:00". Con cualquier otro número de letras se produce un error.

  • Diferencia horaria Z: da formato a la diferencia horaria en función del número de letras del patrón. Una, dos o tres letras genera la hora y el minuto, sin dos puntos, como '+0130'. La salida es '+0000' cuando el desplazamiento es cero. Con cuatro letras se genera el formato completo de la diferencia horaria localizada, equivalente a cuatro letras de la diferencia O. La salida es el texto de la diferencia horaria localizada correspondiente si esta es cero. Con cinco letras se genera la hora, el minuto, con el segundo opcional si no es cero, con dos puntos. Genera "Z" si el desplazamiento es cero. Con seis o más letras se produce un error.

  • Inicio y fin de sección opcional: use [] para definir una sección opcional y quizás anidada. Al aplicar formato se generan todos los datos válidos, aunque se encuentren en la sección opcional. Durante el análisis, es posible que falte toda la sección en la cadena analizada. Una sección opcional se inicia mediante [ y termina con ] (o al final del patrón).

  • Los símbolos de 'E', 'F', 'q' y 'Q' solo se pueden usar para el formato datetime, por ejemplo date_format. No se permiten para el análisis de fecha y hora, por ejemplo, to_timestamp.