Compartilhar via

DateTimeAdd (consulta NoSQL)

  • Artigo

APLICA-SE A: NoSQL

Retorna um valor de cadeia de caracteres de data e hora que é o resultado da adição de um valor de número especificado à cadeia de caracteres de data e hora fornecida.

Sintaxe

DateTimeAdd(<date_time_part>, <numeric_expr> ,<date_time>)

Argumentos

Descrição
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 modificada pela expressão numérica relacionada.
numeric_expr Uma expressão numérica que resulta em um inteiro com sinal.
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.

Observação

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

Tipos de retorno

Retorna uma cadeia de caracteres de data e hora UTC no formato ISO 8601 YYYY-MM-DDThh:mm:ss.fffffffZ.

Exemplos

O exemplo a seguir adiciona vários valores (um ano, um mês, um dia, uma hora) à data 3 de julho de 2020 à meia-noite (00:00 UTC). O exemplo também subtrai vários valores (dois anos, dois meses, dois dias, duas horas) da mesma data. Por fim, esse exemplo usa uma expressão para modificar os segundos da mesma data.

SELECT VALUE {
    addOneYear: DateTimeAdd("yyyy", 1, "2020-07-03T00:00:00.0000000"),
    addOneMonth: DateTimeAdd("mm", 1, "2020-07-03T00:00:00.0000000"),
    addOneDay: DateTimeAdd("dd", 1, "2020-07-03T00:00:00.0000000"),
    addOneHour: DateTimeAdd("hh", 1, "2020-07-03T00:00:00.0000000"),
    subtractOneYear: DateTimeAdd("yyyy", -1, "2020-07-03T00:00:00.0000000"),
    subtractOneMonth: DateTimeAdd("mm", -1, "2020-07-03T00:00:00.0000000"),
    subtractOneDay: DateTimeAdd("dd", -1, "2020-07-03T00:00:00.0000000"),
    subtractOneHour: DateTimeAdd("hh", -1, "2020-07-03T00:00:00.0000000"),
    modifySecondsExpression: DateTimeAdd("ss", 5 * -5, "2020-07-03T00:00:00.0000000")
}

[
  {
    "addOneYear": "2021-07-03T00:00:00.0000000Z",
    "addOneMonth": "2020-08-03T00:00:00.0000000Z",
    "addOneDay": "2020-07-04T00:00:00.0000000Z",
    "addOneHour": "2020-07-03T01:00:00.0000000Z",
    "subtractOneYear": "2019-07-03T00:00:00.0000000Z",
    "subtractOneMonth": "2020-06-03T00:00:00.0000000Z",
    "subtractOneDay": "2020-07-02T00:00:00.0000000Z",
    "subtractOneHour": "2020-07-02T23:00:00.0000000Z",
    "modifySecondsExpression": "2020-07-02T23:59:35.0000000Z"
  }
]

Comentários

  • Essa função retorna undefined por estes motivos:
    • A parte de data e hora especificada é inválida.
    • A expressão numérica não é um inteiro válido.
    • A data e a hora no argumento não é uma cadeia de caracteres de data de 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 |

Conteúdo relacionado