DATETIMEADD - Linguagem de consulta no Cosmos DB (no Azure e no Fabric)

A DATETIMEADD função 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>)

Arguments

	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.

Tipos de devolução

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

Examples

Esta seção contém exemplos de como usar essa construção de linguagem de consulta.

Adicionar e subtrair partes de data

Neste exemplo, a DATETIMEADD função é usada para adicionar e subtrair anos, meses, dias e horas de uma 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

• 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 |
• 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.