Megosztás a következőn keresztül:

DateTimeFromParts (NoSQL-lekérdezés)

  • Cikk

A KÖVETKEZŐRE VONATKOZIK: NoSQL

Egy dátum- és idősztring-értéket ad vissza, amely a különböző dátum- és időrészek bemeneti numerikus értékeiből épül fel.

Syntax

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

Argumentumok

Leírás
numeric_year Az év pozitív numerikus egészértéke. Ez az argumentum ISO 8601 formátumban yyyyvan.
numeric_month Pozitív numerikus egész szám a hónapra vonatkozóan. Ez az argumentum ISO 8601 formátumban mmvan.
numeric_day Pozitív numerikus egész számérték a napra vonatkozóan. Ez az argumentum ISO 8601 formátumban ddvan.
numeric_hour(Nem kötelező) Egy opcionális pozitív numerikus egész számérték az órára vonatkozóan. Ez az argumentum ISO 8601 formátumban hhvan. Ha nincs megadva, az alapértelmezett érték a következő 0: .
numeric_minute(Nem kötelező) Választható pozitív numerikus egész számérték a perchez. Ez az argumentum ISO 8601 formátumban mmvan. Ha nincs megadva, az alapértelmezett érték a következő 0: .
numeric_second(Nem kötelező) Nem kötelező pozitív numerikus egész számérték a másodikhoz. Ez az argumentum ISO 8601 formátumban ssvan. Ha nincs megadva, az alapértelmezett érték a következő 0: .
numeric_second_fraction(Nem kötelező) Nem kötelező pozitív numerikus egész számérték a másodperc törtrészéhez. Ez az argumentum ISO 8601 formátumban fffffffZvan. Ha nincs megadva, az alapértelmezett érték a következő 0: .

Feljegyzés

További információ az ISO 8601 formátumról: ISO 8601.

Visszatérési típusok

EGY UTC dátum- és idősztringet ad vissza ISO 8601 formátumban YYYY-MM-DDThh:mm:ss.fffffffZ.

Példák

Az alábbi példa az argumentumok különböző kombinációit használja dátum- és idősztringek létrehozásához. Ez a példa a 2017. április 20., 13:15 (UTC) dátumot és időpontot használja.

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

Megjegyzések

  • Ha a megadott egész számok érvénytelen dátumot és időt hoznak létre, a függvény ad vissza undefined.

Kapcsolódó tartalom