ClickHouse/docs/es/sql-reference/functions/date-time-functions.md

machine_translated	machine_translated_rev	toc_priority	toc_title
true	72537a2d52	39	Trabajar con fechas y horas

Funciones para trabajar con fechas y horas

Soporte para zonas horarias

Todas las funciones para trabajar con la fecha y la hora que tienen un uso lógico para la zona horaria pueden aceptar un segundo argumento de zona horaria opcional. Ejemplo: Asia/Ekaterimburgo. En este caso, utilizan la zona horaria especificada en lugar de la local (predeterminada).

SELECT
    toDateTime('2016-06-15 23:00:00') AS time,
    toDate(time) AS date_local,
    toDate(time, 'Asia/Yekaterinburg') AS date_yekat,
    toString(time, 'US/Samoa') AS time_samoa

┌────────────────time─┬─date_local─┬─date_yekat─┬─time_samoa──────────┐
│ 2016-06-15 23:00:00 │ 2016-06-15 │ 2016-06-16 │ 2016-06-15 09:00:00 │
└─────────────────────┴────────────┴────────────┴─────────────────────┘

Solo se admiten las zonas horarias que difieren de UTC por un número entero de horas.

Todos los derechos reservados

Convierta la hora o la fecha y la hora a la zona horaria especificada.

paraAño

Convierte una fecha o fecha con hora en un número UInt16 que contiene el número de año (AD).

aTrimestre

Convierte una fecha o fecha con hora en un número UInt8 que contiene el número de trimestre.

ParaMes

Convierte una fecha o fecha con hora en un número UInt8 que contiene el número de mes (1-12).

Todos los derechos reservados

Convierte una fecha o fecha con hora en un número UInt16 que contiene el número del día del año (1-366).

Todos los derechos reservados

Convierte una fecha o fecha con hora en un número UInt8 que contiene el número del día del mes (1-31).

Todos los derechos reservados

Convierte una fecha o fecha con hora en un número UInt8 que contiene el número del día de la semana (el lunes es 1 y el domingo es 7).

ParaHora

Convierte una fecha con hora en un número UInt8 que contiene el número de la hora en el tiempo de 24 horas (0-23). This function assumes that if clocks are moved ahead, it is by one hour and occurs at 2 a.m., and if clocks are moved back, it is by one hour and occurs at 3 a.m. (which is not always true – even in Moscow the clocks were twice changed at a different time).

ToMinute

Convierte una fecha con hora en un número UInt8 que contiene el número del minuto de la hora (0-59).

aSegundo

Convierte una fecha con hora en un número UInt8 que contiene el número del segundo en el minuto (0-59). Los segundos de salto no se contabilizan.

Todos los derechos reservados

Para el argumento DateTime: convierte el valor a su representación numérica interna (Unix Timestamp). Para el argumento String: analice la fecha y hora de la cadena de acuerdo con la zona horaria (segundo argumento opcional, la zona horaria del servidor se usa de forma predeterminada) y devuelve la marca de tiempo de Unix correspondiente. Para el argumento Date : el comportamiento no está especificado.

Sintaxis

toUnixTimestamp(datetime)
toUnixTimestamp(str, [timezone])

Valor devuelto

• Devuelve la marca de tiempo de Unix.

Tipo: UInt32.

Ejemplo

Consulta:

SELECT toUnixTimestamp('2017-11-05 08:07:47', 'Asia/Tokyo') AS unix_timestamp

Resultado:

┌─unix_timestamp─┐
│     1509836867 │
└────────────────┘

Todos los derechos reservados

Redondea una fecha o fecha con la hora hasta el primer día del año. Devuelve la fecha.

Todos los derechos reservados

Redondea una fecha o fecha con la hora hasta el primer día del año ISO. Devuelve la fecha.

Todos los derechos reservados

Redondea una fecha o fecha con la hora hasta el primer día del trimestre. El primer día del trimestre es el 1 de enero, el 1 de abril, el 1 de julio o el 1 de octubre. Devuelve la fecha.

Todos los derechos reservados

Redondea una fecha o fecha con la hora hasta el primer día del mes. Devuelve la fecha.

!!! attention "Atención" El comportamiento de analizar fechas incorrectas es específico de la implementación. ClickHouse puede devolver una fecha cero, lanzar una excepción o hacer “natural” desbordamiento.

paraLunes

Redondea una fecha o fecha con hora al lunes más cercano. Devuelve la fecha.

¿Cómo puedo hacerlo?])

Redondea una fecha o fecha con hora al domingo o lunes más cercano por modo. Devuelve la fecha. El argumento mode funciona exactamente igual que el argumento mode a toWeek() . Para la sintaxis de argumento único, se utiliza un valor de modo de 0.

Todos los derechos reservados

Redondea una fecha con el tiempo hasta el comienzo del día.

Todos los derechos reservados

Redondea una fecha con el tiempo hasta el comienzo de la hora.

Todos los derechos reservados

Redondea una fecha con el tiempo hasta el inicio del minuto.

Acerca de nosotros

Redondea una fecha con el tiempo hasta el inicio del intervalo de cinco minutos.

Acerca de Nosotros

Redondea una fecha con el tiempo hasta el inicio del intervalo de diez minutos.

Para comenzar de quince minutos

Redondea la fecha con el tiempo hasta el inicio del intervalo de quince minutos.

También puede usar una interfaz de usuario.])

Esta es una generalización de otras funciones llamadas toStartOf*. Por ejemplo, toStartOfInterval(t, INTERVAL 1 year) devuelve lo mismo que toStartOfYear(t), toStartOfInterval(t, INTERVAL 1 month) devuelve lo mismo que toStartOfMonth(t), toStartOfInterval(t, INTERVAL 1 day) devuelve lo mismo que toStartOfDay(t), toStartOfInterval(t, INTERVAL 15 minute) devuelve lo mismo que toStartOfFifteenMinutes(t) sucesivamente.

Tiempo

Convierte una fecha con hora en una fecha fija determinada, preservando al mismo tiempo la hora.

Todos los derechos reservados

Convierte una fecha con hora o fecha en el número del año, a partir de un determinado punto fijo en el pasado.

Nombre de la red inalámbrica (SSID):

Convierte una fecha con hora o fecha en el número del trimestre, a partir de un determinado punto fijo en el pasado.

Nombre de la red inalámbrica (SSID):

Convierte una fecha con hora o fecha en el número del mes, a partir de un determinado punto fijo en el pasado.

Nombre de la red inalámbrica (SSID):

Convierte una fecha con hora o fecha en el número de la semana, a partir de un determinado punto fijo en el pasado.

Nombre de la red inalámbrica (SSID):

Convierte una fecha con hora o fecha en el número del día, a partir de un determinado punto fijo en el pasado.

Nombre de la red inalámbrica (SSID):

Convierte una fecha con hora o fecha en el número de la hora, a partir de un determinado punto fijo en el pasado.

Todos los derechos reservados

Convierte una fecha con hora o fecha en el número del minuto, a partir de un cierto punto fijo en el pasado.

Todos los derechos reservados

Convierte una fecha con hora o fecha en el número de la segunda, a partir de un cierto punto fijo en el pasado.

AISOAño

Convierte una fecha o fecha con hora en un número UInt16 que contiene el número ISO Year.

paraISOWeek

Convierte una fecha o fecha con hora en un número UInt8 que contiene el número de semana ISO.

ToWeek(fecha[,modo])

Esta función devuelve el número de semana para la fecha o la fecha y hora. La forma de dos argumentos de toWeek() le permite especificar si la semana comienza el domingo o el lunes y si el valor de retorno debe estar en el rango de 0 a 53 o de 1 a 53. Si se omite el argumento mode, el modo predeterminado es 0. toISOWeek()es una función de compatibilidad que es equivalente a toWeek(date,3). La siguiente tabla describe cómo funciona el argumento mode.

Modo	Primer día de la semana	Gama	Week 1 is the first week …
0	Domingo	0-53	con un domingo de este año
1	Lunes	0-53	con 4 o más días este año
2	Domingo	1-53	con un domingo de este año
3	Lunes	1-53	con 4 o más días este año
4	Domingo	0-53	con 4 o más días este año
5	Lunes	0-53	con un lunes de este año
6	Domingo	1-53	con 4 o más días este año
7	Lunes	1-53	con un lunes de este año
8	Domingo	1-53	contiene 1 de enero
9	Lunes	1-53	contiene 1 de enero

Para valores de modo con un significado de “with 4 or more days this year,” semanas están numeradas según ISO 8601:1988:

• Si la semana que contiene el 1 de enero tiene 4 o más días en el nuevo año, es la semana 1.

• De lo contrario, es la última semana del año anterior, y la semana siguiente es la semana 1.

Para valores de modo con un significado de “contains January 1”, la semana contiene 1 de enero es la semana 1. No importa cuántos días en el nuevo año contenía la semana, incluso si contenía solo un día.

toWeek(date, [, mode][, Timezone])

Parámetros

• date – Date or DateTime.
• mode – Optional parameter, Range of values is [0,9], default is 0.
• Timezone – Optional parameter, it behaves like any other conversion function.

Ejemplo

SELECT toDate('2016-12-27') AS date, toWeek(date) AS week0, toWeek(date,1) AS week1, toWeek(date,9) AS week9;

┌───────date─┬─week0─┬─week1─┬─week9─┐
│ 2016-12-27 │    52 │    52 │     1 │
└────────────┴───────┴───────┴───────┘

aYearWeek(fecha[,modo])

Devuelve año y semana para una fecha. El año en el resultado puede ser diferente del año en el argumento de fecha para la primera y la última semana del año.

El argumento mode funciona exactamente igual que el argumento mode a toWeek() . Para la sintaxis de argumento único, se utiliza un valor de modo de 0.

toISOYear()es una función de compatibilidad que es equivalente a intDiv(toYearWeek(date,3),100).

Ejemplo

SELECT toDate('2016-12-27') AS date, toYearWeek(date) AS yearWeek0, toYearWeek(date,1) AS yearWeek1, toYearWeek(date,9) AS yearWeek9;

┌───────date─┬─yearWeek0─┬─yearWeek1─┬─yearWeek9─┐
│ 2016-12-27 │    201652 │    201652 │    201701 │
└────────────┴───────────┴───────────┴───────────┘

ahora

Acepta cero argumentos y devuelve la hora actual en uno de los momentos de ejecución de la solicitud. Esta función devuelve una constante, incluso si la solicitud tardó mucho en completarse.

hoy

Acepta cero argumentos y devuelve la fecha actual en uno de los momentos de ejecución de la solicitud. Lo mismo que ‘toDate(now())’.

ayer

Acepta cero argumentos y devuelve la fecha de ayer en uno de los momentos de ejecución de la solicitud. Lo mismo que ‘today() - 1’.

timeSlot

Redondea el tiempo a la media hora. Esta función es específica de Yandex.Metrica, ya que media hora es la cantidad mínima de tiempo para dividir una sesión en dos sesiones si una etiqueta de seguimiento muestra las páginas vistas consecutivas de un solo usuario que difieren en el tiempo en estrictamente más de esta cantidad. Esto significa que las tuplas (el ID de etiqueta, el ID de usuario y el intervalo de tiempo) se pueden usar para buscar páginas vistas que se incluyen en la sesión correspondiente.

paraYYYYMM

Convierte una fecha o fecha con hora en un número UInt32 que contiene el número de año y mes (YYYY * 100 + MM).

paraYYYYMMDD

Convierte una fecha o fecha con hora en un número UInt32 que contiene el número de año y mes (AAAA * 10000 + MM * 100 + DD).

paraYYYYMMDDhhmmss

Convierte una fecha o fecha con hora en un número UInt64 que contiene el número de año y mes (YYYY * 10000000000 + MM * 100000000 + DD * 1000000 + hh * 10000 + mm * 100 + ss).

Por ejemplo, en el caso de que el usuario pueda acceder a la página de inicio de sesión, seleccione la página de inicio de sesión

La función agrega un intervalo de fecha / fecha y hora a una fecha / fecha y hora y luego devuelve la fecha / fecha y hora. Por ejemplo:

WITH
    toDate('2018-01-01') AS date,
    toDateTime('2018-01-01 00:00:00') AS date_time
SELECT
    addYears(date, 1) AS add_years_with_date,
    addYears(date_time, 1) AS add_years_with_date_time

┌─add_years_with_date─┬─add_years_with_date_time─┐
│          2019-01-01 │      2019-01-01 00:00:00 │
└─────────────────────┴──────────────────────────┘

restarAños, restarMeses, restarSemanas, restarDías, restarHoras, restarMinutos, restarSegundos, restarCuartos

La función resta un intervalo de fecha / fecha y hora a una fecha / fecha y hora y luego devuelve la fecha / fecha y hora. Por ejemplo:

WITH
    toDate('2019-01-01') AS date,
    toDateTime('2019-01-01 00:00:00') AS date_time
SELECT
    subtractYears(date, 1) AS subtract_years_with_date,
    subtractYears(date_time, 1) AS subtract_years_with_date_time

┌─subtract_years_with_date─┬─subtract_years_with_date_time─┐
│               2018-01-01 │           2018-01-01 00:00:00 │
└──────────────────────────┴───────────────────────────────┘

dateDiff

Devuelve la diferencia entre dos valores Date o DateTime.

Sintaxis

dateDiff('unit', startdate, enddate, [timezone])

Parámetros

• unit — Time unit, in which the returned value is expressed. Cadena.

  Supported values:
  
  | unit   |
  | ---- |
  |second  |
  |minute  |
  |hour    |
  |day     |
  |week    |
  |month   |
  |quarter |
  |year    |
  

• startdate — The first time value to compare. Fecha o FechaHora.

• enddate — The second time value to compare. Fecha o FechaHora.

• timezone — Optional parameter. If specified, it is applied to both startdate y enddate. Si no se especifica, las zonas horarias startdate y enddate se utilizan. Si no son lo mismo, el resultado no está especificado.

Valor devuelto

Diferencia entre startdate y enddate expresado en unit.

Tipo: int.

Ejemplo

Consulta:

SELECT dateDiff('hour', toDateTime('2018-01-01 22:00:00'), toDateTime('2018-01-02 23:00:00'));

Resultado:

┌─dateDiff('hour', toDateTime('2018-01-01 22:00:00'), toDateTime('2018-01-02 23:00:00'))─┐
│                                                                                     25 │
└────────────────────────────────────────────────────────────────────────────────────────┘

timeSlots(Hora de inicio, Duración, [, Tamaño])

Para un intervalo de tiempo a partir de ‘StartTime’ y continuando por ‘Duration’ segundos, devuelve una matriz de momentos en el tiempo, que consiste en puntos de este intervalo ‘Size’ en segundos. ‘Size’ es un parámetro opcional: una constante UInt32, establecida en 1800 por defecto. Por ejemplo, timeSlots(toDateTime('2012-01-01 12:20:00'), 600) = [toDateTime('2012-01-01 12:00:00'), toDateTime('2012-01-01 12:30:00')]. Esto es necesario para buscar páginas vistas en la sesión correspondiente.

formatDateTime(Hora, Formato[, Zona horaria])

Function formats a Time according given Format string. N.B.: Format is a constant expression, e.g. you can not have multiple formats for single result column.

Modificadores compatibles para Formato: (“Example” columna muestra el resultado de formateo para el tiempo 2018-01-02 22:33:44)

Modificador	Descripci	Ejemplo
%C	año dividido por 100 y truncado a entero (00-99)	20
%d	día del mes, cero acolchado (01-31)	02
%D	Fecha corta de MM/DD/YY, equivalente a %m/%d/%y	01/02/18
%e	día del mes, espacio acolchado ( 1-31)	2
%F	fecha corta AAAA-MM-DD, equivalente a %Y-%m-%d	2018-01-02
%H	hora en formato 24h (00-23)	22
%I	hora en formato 12h (01-12)	10
%j	día del año (001-366)	002
Más información	mes como un número decimal (01-12)	01
%M	minutos (00-59)	33
%y	carácter de nueva línea ('')
%p	Designación AM o PM	PM
%R	HH de 24 horas: Tiempo del milímetro, equivalente a %H: %M	22:33
%S	segundo (00-59)	44
% t	carácter de pestaña horizontal (')
%T	Formato de hora ISO 8601 (HH:MM:SS), equivalente a %H:%M:%S	22:33:44
%u	ISO 8601 día de la semana como número con el lunes como 1 (1-7)	2
%V	Número de semana ISO 8601 (01-53)	01
% w	día de la semana como un número decimal con domingo como 0 (0-6)	2
%y	Año, últimos dos dígitos (00-99)	18
%Y	Año	2018
%%	signo	%

Artículo Original