Udostępnij za pośrednictwem


DateTimePart (zapytanie NoSQL)

DOTYCZY: NoSQL

Zwraca wartość określonej części daty i godziny dla podanej daty i godziny.

Składnia

DateTimePart(<date_time_part> , <date_time>)

Argumenty

opis
date_time Ciąg daty i godziny koordynowanego czasu uniwersalnego (UTC) w formacie YYYY-MM-DDThh:mm:ss.fffffffZISO 8601.
date_time_part Ciąg reprezentujący część specyfikacji formatu daty ISO 8601. Ta część służy do wskazywania, który aspekt daty ma być wyodrębniony i zwracany.

Uwaga

Aby uzyskać więcej informacji na temat formatu ISO 8601, zobacz ISO 8601.

Typy zwracane

Zwraca wartość liczbową, która jest dodatnią liczbą całkowitą.

Przykłady

Poniższy przykład zwraca różne części daty i godziny 29 maja 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
  }
]

Uwagi

  • Ta funkcja zwraca undefined następujące przyczyny:
    • Określona część daty i godziny jest nieprawidłowa.
    • Data i godzina nie są prawidłowym ciągiem daty i godziny ISO 8601.
  • Format daty ISO 8601 określa prawidłowe części daty i godziny do użycia z tą funkcją: | | Format | | --- | --- | | Rok | year, yyyy, yy | | Miesiąc | month, mm, m | | Dzień | day, dd, d | | Godzina | hour, hh | | Minuta | minute, mi, n | | Drugi | second, ss, s | | Milisekundy | millisecond, ms | | Mikrosekundy | microsecond, mcs | | Nanosekundy | nanosecond, ns |
  • Ta funkcja nie używa indeksu.