Comparteix a través de

DateTimeAdd (consulta NoSQL)

  • Article

SE APLICA A: NoSQL

Devuelve un valor de cadena de fecha y hora que es el resultado de agregar un valor numérico especificado a la cadena de fecha y hora proporcionada.

Sintaxis

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

Argumentos

Descripción
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 UTC (hora universal coordinada) en el formato ISO 8601 YYYY-MM-DDThh:mm:ss.fffffffZ.

Nota

Para más información sobre el formato ISO 8601, consulte ISO_8601.

Tipos de valores devueltos

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

Ejemplos

En el ejemplo siguiente se agregan varios valores (un año, un mes, un día, una hora) a la fecha 3 de julio de 2020 a medianoche (00:00 UTC). En el ejemplo también se restan varios valores (dos años, dos meses, dos días, dos horas) de la misma fecha. Por último, en este ejemplo se usa una expresión para modificar los segundos de la misma 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"
  }
]

Comentarios

  • Esta función devuelve undefined por estas razones:
    • La parte de fecha y hora especificadas 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.
  • 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 | | Minuto | minute, mi, n | | Segundo | second, ss, s | | Milisegundo | millisecond, ms | | Microsegundo | microsecond, mcs | | Nanosegundo | nanosecond, ns |

Contenido relacionado