Sdílet prostřednictvím

DateTimeFromParts (dotaz NoSQL)

  • Článek

PLATÍ PRO: NoSQL

Vrátí hodnotu řetězce data a času sestavenou ze vstupních číselných hodnot pro různé části data a času.

Syntaxe

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

Argumenty

Popis
numeric_year Kladná číselná celočíselná hodnota pro rok. Tento argument je ve formátu yyyyISO 8601 .
numeric_month Kladná číselná celočíselná hodnota pro měsíc. Tento argument je ve formátu mmISO 8601 .
numeric_day Kladná číselná celočíselná hodnota pro den. Tento argument je ve formátu ddISO 8601 .
numeric_hour(Volitelné) Volitelná kladná číselná celočíselná hodnota pro hodinu. Tento argument je ve formátu hhISO 8601 . Pokud není zadána, je výchozí hodnota 0.
numeric_minute(Volitelné) Volitelná kladná číselná celočíselná hodnota pro minutu. Tento argument je ve formátu mmISO 8601 . Pokud není zadána, je výchozí hodnota 0.
numeric_second(Volitelné) Volitelná kladná číselná celočíselná hodnota pro sekundu. Tento argument je ve formátu ssISO 8601 . Pokud není zadána, je výchozí hodnota 0.
numeric_second_fraction(Volitelné) Volitelná kladná číselná celočíselná hodnota pro zlomek sekundy. Tento argument je ve formátu fffffffZISO 8601 . Pokud není zadána, je výchozí hodnota 0.

Poznámka:

Další informace o formátu ISO 8601 naleznete v tématu ISO 8601.

Návratové typy

Vrátí řetězec data a času UTC ve formátu YYYY-MM-DDThh:mm:ss.fffffffZISO 8601 .

Příklady

Následující příklad používá různé kombinace argumentů k vytvoření řetězců data a času. Tento příklad používá datum a čas 20. dubna 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"
  }
]

Poznámky

  • Pokud zadané celé číslo vytvoří neplatné datum a čas, vrátí undefinedfunkce .

Související obsah