DATETIMEADD - Linguaggio di query in Cosmos DB (in Azure e Fabric)

La DATETIMEADD funzione restituisce un valore stringa di data e ora risultante dall'aggiunta di un valore numerico specificato alla stringa di data e ora specificata.

Sintassi

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

Arguments

	Description
date_time_part	Stringa che rappresenta una parte di una specifica del formato di data ISO 8601. Questa parte viene utilizzata per indicare quale aspetto della data modificare dall'espressione numerica correlata.
numeric_expr	Espressione numerica che genera un intero con segno.
date_time	Stringa di data e ora UTC (Coordinated Universal Time) nel formato YYYY-MM-DDThh:mm:ss.fffffffZISO 8601 .

Tipi restituiti

Restituisce una stringa di data e ora UTC nel formato YYYY-MM-DDThh:mm:ss.fffffffZISO 8601 .

Esempi

Questa sezione contiene esempi di come usare questo costrutto di linguaggio di query.

Aggiungere e sottrarre parti di data

In questo esempio la DATETIMEADD funzione viene usata per aggiungere e sottrarre anni, mesi, giorni e ore da una 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"
  }
]

Osservazioni:

• Il formato di data ISO 8601 specifica parti di data e ora valide da utilizzare con questa funzione: | | Formato | | | --- | --- | | Year | year, yyyy, yy | | Month | month, mm, | m | Giorno | day, dd, d | | Hour | hour, hh | | Minute | minute, mi, , n | | Secondo | second, ss, s | | Millisecondo | millisecond, ms | | Microsecondo | microsecond, mcs | | Nanosecondo | nanosecond, ns |
• Questa funzione restituisce undefined per questi motivi:
  • La parte di data e ora specificata non è valida.
  • L'espressione numerica non è un numero intero valido.
  • La data e l'ora nell'argomento non sono una stringa di data e ora ISO 8601 valida.