DATETIMEPART - Lenguaje de consulta en Cosmos DB (en Azure y Fabric)

La DATETIMEPART función devuelve el valor de la parte de fecha y hora especificadas para la fecha y hora proporcionadas.

Syntax

DATETIMEPART(<date_time_part>, <date_time>)

Arguments

	Description
date_time_part	Cadena que representa una parte de una especificación de formato de fecha ISO 8601. Esta parte se usa para indicar qué aspecto de la fecha se va a extraer y devolver.
date_time	Cadena de fecha y hora universal coordinada (UTC) en formato ISO 8601 YYYY-MM-DDThh:mm:ss.fffffffZ.

Tipos de retorno

Devuelve un valor numérico que es un entero positivo.

Examples

Esta sección contiene ejemplos de cómo usar esta construcción del lenguaje de consulta.

Extracción de partes de fecha y hora

En este ejemplo, la DATETIMEPART función se usa para extraer año, mes, día, hora, minuto, segundo, milisegundos, microsegundos y nanosegundos de una fecha.

SELECT VALUE {
  getYear: DATETIMEPART("yyyy", "2016-05-29T08:30:00.1301617"),
  getMonth: DATETIMEPART("mm", "2016-05-29T08:30:00.1301617"),
  getDay: DATETIMEPART("dd", "2016-05-29T08:30:00.1301617"),
  getHour: DATETIMEPART("hh", "2016-05-29T08:30:00.1301617"),
  getMinute: DATETIMEPART("mi", "2016-05-29T08:30:00.1301617"),
  getSecond: DATETIMEPART("ss", "2016-05-29T08:30:00.1301617"),
  getMillisecond: DATETIMEPART("ms", "2016-05-29T08:30:00.1301617"),
  getMicrosecond: DATETIMEPART("mcs", "2016-05-29T08:30:00.1301617"),
  getNanosecond: DATETIMEPART("ns", "2016-05-29T08:30:00.1301617")
}

[
  {
    "getYear": 2016,
    "getMonth": 5,
    "getDay": 29,
    "getHour": 8,
    "getMinute": 30,
    "getSecond": 0,
    "getMillisecond": 130,
    "getMicrosecond": 130161,
    "getNanosecond": 130161700
  }
]

Observaciones

• Esta función no utiliza el índice.
• El formato de fecha ISO 8601 especifica partes de fecha y hora válidas que se usarán con esta función: | | Formato | | --- | --- | | Año | year, yyyy, yy | | Mes | month, mm, m | | Día | day, dd, d | | Hora | hour, hh | | Minute | minute, mi, n | | Segundo | second, ss, s | | Milisegundos | millisecond, ms | | Microsegundos | microsecond, mcs | | Nanosecond | nanosecond, ns |
• Esta función devuelve undefined por estas razones:
  • La parte de fecha y hora especificada no es válida.
  • La fecha y hora no es una cadena de fecha y hora ISO 8601 válida.