Condividi tramite

IS_DATETIME (query NoSQL)

  • Si applica a: ✅ Azure Cosmos DB for NoSQL, ✅ Cosmos DB in Microsoft Fabric

Restituisce un valore booleano che indica se la stringa datetime è valida.

Sintassi

IS_DATETIME(<expr>)

Arguments

Description
expr Espressione da valutare.

Tipi restituiti

Restituisce un'espressione booleana.

Esempi

Nell'esempio seguente vengono illustrati vari usi della funzione IS_DATETIME con formati datetime diversi.

SELECT VALUE {
    "case1": IS_DATETIME("2024-12-12"),
    "case2": IS_DATETIME("2024-12-12Z"),
    "case3": IS_DATETIME("2024-12-12 20:21:25"),
    "case4": IS_DATETIME("2024-12-12T20:21:25Z"),
    "case5": IS_DATETIME("2024-12-12T20:21:25.123"),
    "case6": IS_DATETIME("2024-12-12 20:21:25.123Z"),
    "case7": IS_DATETIME("2024-12-12T20Z"),
    "case8": IS_DATETIME("2024-12-12 20:21:25.")
}

[
    {
        "case1": true,
        "case2": true,
        "case3": true,
        "case4": true,
        "case5": true,
        "case6": true,
        "case7": false,
        "case8": false
    }
]

Osservazioni:

  • Una stringa DateTime valida deve iniziare con quattro cifre per l'anno (AAAA) seguita da un trattino - , ad esempio, 2023-
  • Una stringa DateTime valida deve quindi avere un mese a due cifre seguito da un trattino - , ad esempio, 2023-03-
  • Una stringa DateTime valida deve quindi avere un giorno a due cifre, ad esempio 2023-03-06
  • Una stringa DateTime valida può terminare con il giorno a due cifre e essere valida senza un'ora
  • Può anche terminare dopo il giorno del mese con Z ed essere ancora valido, ad esempio 2023-03-06Z
  • Se la stringa DateTime include l'ora, il giorno del mese può includere uno spazio o T un identificatore di ora, ad esempio, 2023-03-06 15:29:00Z o 2023-03-06T15:29:00Z
  • Qualsiasi altro carattere oltre a spazio o T non è valido
  • Dopo il carattere di progettazione dell'ora, deve essere presente un'ora a due cifre seguita da : un separatore di tempo di due cifre seguito da un separatore di due cifre, seguito da : una seconda parte a due cifre, che può concludere una stringa DateTime valida, ad esempio 2023-03-06T15:29:59
  • I secondi possono anche essere seguiti con un Z valore UTC e validi, ad esempio 2023-03-06T15:29:59Z
  • Se sono presenti secondi frazionari, devono essere preceduti da un .
  • Per essere valido, questo . designatore di secondi frazionari deve essere seguito con almeno una cifra e un massimo di sette cifre, 2023-03-06T15:29:59.9 ad esempio o o 2023-03-06T15:29:59.9Z o o 2023-03-06T15:29:59.12345672023-03-06T15:29:59.1234567Z
  • Questa funzione esegue un'analisi completa.

Contenuti correlati

  • Last updated on