Condividi tramite

DateTimeAdd (query NoSQL)

  • Articolo

SI APPLICA A: NoSQL

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>)

Argomenti

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

Nota

Per altre informazioni sul formato ISO 8601, vedere ISO 8601.

Tipi restituiti

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

Esempi

Nell'esempio seguente vengono aggiunti vari valori (un anno, un mese, un giorno, un'ora) alla data 3 luglio 2020 a mezzanotte (00:00 UTC). L'esempio sottrae anche vari valori (due anni, due mesi, due giorni, due ore) dalla stessa data. In questo esempio viene infine utilizzata un'espressione per modificare i secondi della stessa 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:

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

Contenuto correlato