Partilhar 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

Description
date_time_part Uma cadeia de caracteres que representa uma parte de uma especificação de formato de data ISO 8601. Esta parte é usada para indicar qual aspeto da data deve ser modificado pela expressão numérica relacionada.
numeric_expr Uma expressão numérica que resulta em um inteiro assinado.
date_time Uma cadeia de caracteres de data e hora UTC (Tempo Universal Coordenado) no formato YYYY-MM-DDThh:mm:ss.fffffffZISO 8601.

Nota

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

Tipos de devolução

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

Exemplos

O exemplo a seguir adiciona vários valores (um ano, um mês, um dia, uma hora) à data de 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. Finalmente, este 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"
  }
]

Observações

  • Esta função retorna undefined pelos seguintes motivos:
    • A parte de data e hora especificada é inválida.
    • A expressão numérica não é um número inteiro válido.
    • A data e a hora no argumento não são uma cadeia de caracteres de data e hora ISO 8601 válida.
  • O formato de data ISO 8601 especifica as peças de data e hora válidas a serem usadas com esta função: | | Formato | | --- | --- | | Ano | year, yyyy, yy | | Mês | month, mm, m | | Dia | day, dd, d | | Hora | hour, hh | | Ata | minute, mi, n | | Segundo | second, ss, s | | Milissegundo | millisecond, ms | | Microssegundo | microsecond, mcs | | Nanossegundo | nanosecond, ns |

Conteúdos relacionados