DATETIMEADD - Lenguaje de consulta en Cosmos DB (en Azure y Fabric)

La DATETIMEADD función devuelve un valor de cadena de fecha y hora que es el resultado de agregar un valor de número especificado a la cadena de fecha y hora proporcionada.

Syntax

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

Arguments

	Description
date_time_part	Cadena que representa una parte de una especificación de formato de fecha ISO 8601. Esta parte se usa para indicar qué aspecto de la fecha se va a modificar mediante la expresión numérica relacionada.
numeric_expr	Expresión numérica que da como resultado un entero con signo.
date_time	Cadena de fecha y hora universal coordinada (UTC) en formato ISO 8601 YYYY-MM-DDThh:mm:ss.fffffffZ.

Tipos de retorno

Devuelve una cadena de fecha y hora UTC en el formato YYYY-MM-DDThh:mm:ss.fffffffZISO 8601 .

Examples

Esta sección contiene ejemplos de cómo usar esta construcción del lenguaje de consulta.

Agregar y restar partes de fecha

En este ejemplo, la DATETIMEADD función se usa para agregar y restar años, meses, días y horas de una fecha.

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"
  }
]

Observaciones

• El formato de fecha ISO 8601 especifica partes de fecha y hora válidas que se usarán con esta función: | | Formato | | --- | --- | | Año | year, yyyy, yy | | Mes | month, mm, m | | Día | day, dd, d | | Hora | hour, hh | | Minute | minute, mi, n | | Segundo | second, ss, s | | Milisegundos | millisecond, ms | | Microsegundos | microsecond, mcs | | Nanosecond | nanosecond, ns |
• Esta función devuelve undefined por estas razones:
  • La parte de fecha y hora especificada no es válida.
  • La expresión numérica no es un entero válido.
  • La fecha y hora del argumento no es una cadena de fecha y hora ISO 8601 válida.