Compartilhar via

DateTimePart (consulta NoSQL)

  • Artigo

APLICA-SE A: NoSQL

Retorna o valor da parte de data e hora especificada para a data e hora fornecidas.

Sintaxe

DateTimePart(<date_time_part> , <date_time>)

Argumentos

Descrição
date_time Uma cadeia de caracteres de data e hora do Tempo Universal Coordenado (UTC) no formato ISO 8601 YYYY-MM-DDThh:mm:ss.fffffffZ.
date_time_part Uma cadeia de caracteres que representa uma parte de uma especificação de formato de data ISO 8601. Essa parte é usada para indicar qual aspecto da data a ser extraída e retornada.

Observação

Para obter mais informações sobre o formato ISO 8601, consulte ISO 8601.

Tipos de retorno

Retorna um valor numérico que é um inteiro positivo.

Exemplos

O exemplo a seguir retorna várias partes da data e hora 29 de maio 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
  }
]

Comentários

  • Essa função retorna undefined por estes motivos:
    • A parte de data e hora especificada é inválida.
    • A data e hora não é uma cadeia de caracteres de data e hora ISO 8601 válida.
  • O formato de data ISO 8601 especifica as partes válidas de data e hora a serem usadas com essa função: | | Formato | | --- | --- | | Ano | year, yyyy, yy | | Mês | month, mm, m | | Dia | day, dd, d | | Hora | hour, hh | | Minuto | minute, mi, n | | Segundo | second, ss, s | | Milissegundo | millisecond, ms | | Microssegundo | microsecond, mcs | | Nanossegundo | nanosecond, ns |
  • Essa função não usa o índice.

Conteúdo relacionado