Tipo de datos datetime

El datetime tipo de datos representa un instante en el tiempo, normalmente expresado como una fecha y hora del día. Los valores van de 00:00:00 (medianoche), 1 de enero de 0001 Anno Domini (Era común) a 11:59:59 p.m., 31 de diciembre de 9999 A.D. (C.E.) en el calendario gregoriano.

Los valores de tiempo se miden en unidades de 100 nanosegundos denominadas tics y una fecha determinada es el número de tics desde la medianoche de 12:00, 1 de enero de 0001 A.D. (C.E.) en el calendario GregorianoCalendar (excepto los tics que se agregarían por segundos bisiesto). Por ejemplo, un valor de tics de 31241376000000000 representa la fecha, viernes 1 de enero de 0100 a las 00:00:00. A veces, a esto se le denomina "un momento en el tiempo lineal".

Los tipos de datetime datos y date son equivalentes.

Nota

Un valor datetime de Kusto siempre se encuentra en la zona horaria local. datetime Si se requieren valores en otras zonas horarias, use datetime_utc_to_local() o datetime_local_to_utc().

Literales datetime

Para especificar un datetime literal, use una de las siguientes opciones de sintaxis:

Sintaxis Descripción Ejemplo
datetime(año.Mes.:minuto díaminuto:segundo.milisegundos) Fecha y hora en formato UTC. datetime(2015-12-31 23:59:59.9)
datetime(año.Mes.Día) Una fecha en formato UTC. datetime(2015-12-31)
datetime() Devuelve la hora actual.
datetime(null) Representa el valor NULL.

Más información sobre las convenciones de sintaxis.

Funciones now() y ago() especiales

Kusto proporciona dos funciones especiales, now() y ago(), para permitir que las consultas hagan referencia a la hora en la que la consulta inicia la ejecución.

Formatos compatibles

Hay varios formatos para datetime que se admiten como literales de datetime() y la función todatetime().

Advertencia

Se recomienda usar solo los formatos ISO 8601.

ISO 8601

Formato Ejemplo
%Y-%m-%dT%H:%M:%s%z 2014-05-25T08:20:03.123456Z
%Y-%m-%dT%H:%M:%s 2014-05-25T08:20:03.123456
%Y-%m-%dT%H:%M 2014-05-25T08:20
%Y-%m-%d %H:%M:%s%z 2014-11-08 15:55:55.123456Z
%Y-%m-%d %H:%M:%s 2014-11-08 15:55:55
%Y-%m-%d %H:%M 2014-11-08 15:55
%Y-%m-%d 2014-11-08

RFC 822

Formato Ejemplo
%w, %e %b %r %H:%M:%s %Z Sáb, 8 Nov 14 15:05:02 GMT
%w, %e %b %r %H:%M:%s Sáb, 8 Nov 14 15:05:02
%w, %e %b %r %H:%M Sáb, 8 Nov 14 15:05
%w, %e %b %r %H:%M %Z Sáb, 8 Nov 14 15:05 GMT
%e %b %r %H:%M:%s %Z 8 Nov 14 15:05:02 GMT
%e %b %r %H:%M:%s 8 Nov 14 15:05:02
%e %b %r %H:%M 8 Nov 14 15:05
%e %b %r %H:%M %Z 8 Nov 14 15:05 GMT

RFC 850

Formato Ejemplo
%w, %e-%b-%r %H:%M:%s %Z Sábado, 08-Nov-14 15:05:02 GMT
%w, %e-%b-%r %H:%M:%s Sábado, 08-Nov-14 15:05:02
%w, %e-%b-%r %H:%M %Z Sábado, 08-Nov-14 15:05 GMT
%w, %e-%b-%r %H:%M Sábado, 08-Nov-14 15:05
%e-%b-%r %H:%M:%s %Z 08-Nov-14 15:05:02 GMT
%e-%b-%r %H:%M:%s 08-Nov-14 15:05:02
%e-%b-%r %H:%M %Z 08-Nov-14 15:05 GMT
%e-%b-%r %H:%M 08-Nov-14 15:05

Ordenable

Formato Ejemplo
%Y-%m-%e %H:%M:%s 2014-11-08 15:05:25
%Y-%m-%e %H:%M:%s %Z 2014-11-08 15:05:25 GMT
%Y-%m-%e %H:%M:%s %Z 2014-11-08 15:05
%Y-%m-%e %H:%M %Z 2014-11-08 15:05 GMT
%Y-%m-%eT%H:%M:%s 2014-11-08T15:05:25
%Y-%m-%eT%H:%M:%s %Z 2014-11-08T15:05:25 GMT
%Y-%m-%eT%H:%M 2014-11-08T15:05
%Y-%m-%eT%H:%M %Z 2014-11-08T15:05 GMT