Compartir vía

DateTimePart (consulta NoSQL)

  • Artículo

SE APLICA A: NoSQL

Devuelve el valor de la parte de fecha y hora especificada para la fecha y hora proporcionadas.

Sintaxis

DateTimePart(<date_time_part> , <date_time>)

Argumentos

Descripción
date_time Cadena de fecha y hora de hora universal coordinada (UTC) en el formato ISO 8601 YYYY-MM-DDThh:mm:ss.fffffffZ.
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.

Nota

Para más información sobre el formato ISO 8601, consulte ISO_8601.

Tipos de valores devueltos

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

Ejemplos

En el ejemplo siguiente se devuelven varias partes de la fecha y hora 29 de mayo de 2016 08:30 UTC.

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
  }
]

Comentarios

  • Esta función devuelve undefined por estas razones:
    • La parte de fecha y hora especificadas no es válida.
    • La fecha y hora no es una cadena de fecha y hora ISO 8601 válida.
  • 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 | | Minuto | minute, mi, n | | Segundo | second, ss, s | | Milisegundo | millisecond, ms | | Microsegundo | microsecond, mcs | | Nanosegundo | nanosecond, ns |
  • Esta función no emplea el índice.

Contenido relacionado