Condividi tramite


DateTimePart (query NoSQL)

SI APPLICA A: NoSQL

Restituisce il valore della parte di data e ora specificata per la data e l'ora specificate.

Sintassi

DateTimePart(<date_time_part> , <date_time>)

Argomenti

Descrizione
date_time Stringa di data e ora UTC (Coordinated Universal Time) nel formato YYYY-MM-DDThh:mm:ss.fffffffZISO 8601 .
date_time_part Stringa che rappresenta una parte di una specifica del formato di data ISO 8601. Questa parte viene utilizzata per indicare quale aspetto della data estrarre e restituire.

Nota

Per altre informazioni sul formato ISO 8601, vedere ISO 8601.

Tipi restituiti

Restituisce un valore numerico che è un numero intero positivo.

Esempi

Nell'esempio seguente vengono restituite varie parti della data e dell'ora del 29 maggio 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
  }
]

Osservazioni:

  • Questa funzione restituisce undefined per questi motivi:
    • La parte di data e ora specificata non è valida.
    • La data e l'ora non sono una stringa di data e ora ISO 8601 valida.
  • Il formato di data ISO 8601 specifica parti di data e ora valide da utilizzare con questa funzione: | | Formato | | | --- | --- | | Year | year, yyyy, yy | | Month | month, mm, | m | Giorno | day, dd, d | | Hour | hour, hh | | Minute | minute, mi, , n | | Secondo | second, ss, s | | Millisecondo | millisecond, ms | | Microsecondo | microsecond, mcs | | Nanosecondo | nanosecond, ns |
  • Questa funzione non usa l'indice.