Compartir a través de

DateTimeFromParts (consulta NoSQL)

  • Artículo

SE APLICA A: NoSQL

Devuelve un valor de cadena de fecha y hora construido a partir de valores numéricos de entrada para varias partes de fecha y hora.

Sintaxis

DateTimeFromParts(<numeric_year>, <numeric_month>, <numeric_day> [, <numeric_hour>]  [, <numeric_minute>]  [, <numeric_second>] [, <numeric_second_fraction>])

Argumentos

Descripción
numeric_year Valor entero numérico positivo para el año. Este argumento tiene el formato ISO 8601 yyyy.
numeric_month Valor entero numérico positivo para el mes. Este argumento tiene el formato ISO 8601 mm.
numeric_day Valor entero numérico positivo para el día. Este argumento tiene el formato ISO 8601 dd.
numeric_hour(Opcional) Valor entero numérico positivo opcional para la hora. Este argumento tiene el formato ISO 8601 hh. Si no se especifica, el valor predeterminado es 0.
numeric_minute(Opcional) Valor entero numérico positivo opcional para el minuto. Este argumento tiene el formato ISO 8601 mm. Si no se especifica, el valor predeterminado es 0.
numeric_second(Opcional) Valor entero numérico positivo opcional para el segundo. Este argumento tiene el formato ISO 8601 ss. Si no se especifica, el valor predeterminado es 0.
numeric_second_fraction(Opcional) Valor entero numérico positivo opcional para la fracción de segundo. Este argumento tiene el formato ISO 8601 fffffffZ. Si no se especifica, el valor predeterminado es 0.

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 usan varias combinaciones de argumentos para crear cadenas de fecha y hora. En este ejemplo se usa la fecha y hora 20 de abril de 2017 13:15 UTC.

SELECT VALUE {
    constructMinArguments: DateTimeFromParts(2017, 4, 20),
    constructMinEquivalent: DateTimeFromParts(2017, 4, 20, 0, 0, 0, 0),
    constructAllArguments: DateTimeFromParts(2017, 4, 20, 13, 15, 20, 3456789),
    constructPartialArguments: DateTimeFromParts(2017, 4, 20, 13, 15),
    constructInvalidArguments: DateTimeFromParts(-2000, -1, -1)
}

[
  {
    "constructMinArguments": "2017-04-20T00:00:00.0000000Z",
    "constructMinEquivalent": "2017-04-20T00:00:00.0000000Z",
    "constructAllArguments": "2017-04-20T13:15:20.3456789Z",
    "constructPartialArguments": "2017-04-20T13:15:00.0000000Z"
  }
]

Comentarios

  • Si los enteros especificados crearan una fecha y hora no válidas, la función devuelve undefined.

Contenido relacionado