TIME tipo

Se aplica a:check marcado yes Databricks SQL check marcado yes Databricks Runtime 18.3 y versiones posteriores

Important

Esta característica se encuentra en su versión beta. Los administradores del área de trabajo pueden controlar el acceso a esta característica desde la página Vistas previas . Consulte Administrar versiones preliminares de Azure Databricks.

Representa una hora del día que comprende los valores de los campos hora, minuto y segundo, sin una zona horaria.

Syntax

TIME | TIME(p)

p: precisión opcional que especifica el número de dígitos fraccionarios en el campo de segundos. Los valores válidos son 0 para 6. Si p se omite, la precisión predeterminada es 6 (microsegundos).

Limits

El intervalo de valores de tiempo admitidos es 00:00:00.000000 para 23:59:59.999999.

Literals

TIME timeString

timeString
{ '[h]h:[m]m' |
  '[h]h:[m]m:[s]s' |
  '[h]h:[m]m:[s]s.[f...]' |
  '[h]h:[m]m AM|PM' |
  '[h]h:[m]m:[s]s AM|PM' |
  '[h]h:[m]m:[s]s.[f...] AM|PM' }
  • [h]h: una hora de uno o dos dígitos entre 00 y (formato de 24 horas) o entre 01 y 12 (formato de 12 horas con AM/PM).23
  • [m]m: un minuto de uno o dos dígitos entre 00 y 59.
  • [s]s: un segundo de uno o dos dígitos entre 00 y 59.
  • [f...]: hasta 6 dígitos de fracciones de segundo.
  • AM o PM: un sufijo opcional que no distingue mayúsculas de minúsculas que indica un valor de reloj de 12 horas.

El prefijo TIME no distingue mayúsculas de minúsculas.

Si no se especifica el segundo componente, el 0valor predeterminado es .

Si el literal no representa un tiempo adecuado Azure Databricks genera un error.

Reglas de precisión

Cuando se combinan dos TIME valores con distintas precisiónes (por ejemplo, en COALESCE, CASE, UNION o aritmética), el resultado usa el mayor ancho de las dos precisiónes.

Por ejemplo, el tipo menos común de TIME(3) y TIME(6) es TIME(6).

Al convertir un TIME valor en una precisión inferior, las fracciones de segundos se truncan, no se redondean:

> SELECT CAST(TIME'12:30:45.987654' AS TIME(3));
  12:30:45.987

Al agregar o restar un intervalo de tiempo de día a TIME, el resultado usa el más amplio de la TIME precisión y la precisión del segundo fraccionario del intervalo. Por ejemplo, TIME(0) + INTERVAL '1.123456' SECOND devuelve TIME(6). Si el resultado está fuera de [00:00:00, 24:00:00), Azure Databricks genera DATETIME_OVERFLOW.

Notas

Todas las operaciones de TIME los valores se realizan sin tener en cuenta ninguna zona horaria.

Para usar TIME columnas en tablas de Delta Lake, la compatibilidad se habilita automáticamente al crear una nueva tabla Delta con una columna de TIME tipo . Para agregar una TIME columna a una tabla existente, primero debe habilitar la característica:

ALTER TABLE table_name SET TBLPROPERTIES ('delta.feature.timeType' = 'supported')

El TIME tipo tiene las siguientes limitaciones:

  • No se admite en columnas generadas.
  • No se admite para los índices de filtro bloom.
  • No se admite para Z-Ordering.

Ejemplos

> SELECT TIME'10:30:00';
  10:30:00

> SELECT TIME'08:15';
  08:15:00

> SELECT TIME'23:59:59.123456';
  23:59:59.123456

> SELECT CAST('14:30:00' AS TIME);
  14:30:00

> SELECT CAST('09:15:30.5' AS TIME(3));
  09:15:30.500

> SELECT current_time();
  16:57:04.304361

> SELECT make_time(6, 30, 45.887);
  06:30:45.887000
  • Last updated on