Funzioni DateValue, TimeValue e DateTimeValue

Articolo
03/22/2024

Si applica a: app canvas flussi desktop app basate su modello Power Platform CLI

Convertono una data, un'ora o entrambe in una stringa in un valore data/ora.

Descrizione

La funzione DateValue converte una stringa di data (ad esempio, "10/01/2014") in un valore data/ora.
La funzione TimeValue converte una stringa di ora (ad esempio, "12:15 PM") in un valore data/ora.
La funzione DateTimeValue converte una stringa di data e di ora (ad esempio, "10 gennaio 2013 12:13 AM") in un valore data/ora.

La funzione DateValue ignora tutte le informazioni sull'ora nella stringa di data e la funzione TimeValue ignora tutte le informazioni sulla data nella stringa di ora.

Nota

Per impostazione predefinita le funzioni DateValue, TimeValue e DateTimeValue utilizzano la lingua dalle impostazioni dell'utente corrente. È possibile sovrascrivere questa lingua per assicurare una corretta interpretazione delle stringhe. Ad esempio, "10/1/1920" viene interpretato come 1 ottobre in en (inglese) e come 10 gennaio in "fr" (francese).

Le date devono essere in uno dei seguenti formati:

MM/GG/AAAA o MM-GG-AAAA
GG/MM/AAAA o GG-MM-AAAA
AAAA/MM/GG o AAAA-MM-GG
MM/GG/AA o MM-GG-AA
GG/MM/AA o GG-MM-AA
GG Mes AAAA
Mese GG, AAAA

Per convertire da componenti numerici di data, mese e anno, leggere Date.
Per convertire da componenti numerici di ore, minuti e secondi, leggere Time.

Per ulteriori informazioni, vedere:

Sintassi

DateValue( String [, Language ])
DateTimeValue( String [, Language ])
TimeValue( String [, Language ])

String: obbligatorio. Una stringa di testo che contiene un valore data, ora o una combinazione di data e ora.
Language: facoltativo. Una stringa di lingua, simile a quella restituita dai primi due caratteri dalla funzione Language. Se omessa, viene usata la lingua delle impostazioni dell'utente corrente.

DateValue( Untyped )
DateTimeValue( Untyped )
TimeValue( Untyped )

Untyped: obbligatorio. Oggetto non tipizzato che rappresenta una data o un'ora. I valori accettabili dipendono dal provider non tipizzato. Per JSON, l'oggetto non tipizzato deve essere una stringa JSON che contiene una data e un'ora in formato ISO 8601. Date o orari in altri formati restituiscono un errore. Prendi in considerazione la conversione di tali valori in Text, poi in una data o un'ora. Tieni presente che i fusi orari e i formati relativi alle impostazioni locali sono considerazioni importanti quando si comunica con i sistemi esterni.

Esempi

DateValue

Se si digita 10/11/2014 in un controllo text-input denominato Startdate e quindi si imposta la proprietà Text di un'etichetta su queste formule:

Si converte una data da una stringa nelle impostazioni locali dell'utente e il risultato viene visualizzato come una data lunga.
```
Text( DateValue( Startdate.Text ), DateTimeFormat.LongDate )
```
Il dispositivo impostato su en mostra l'etichetta come Sabato 11 ottobre 2014.

Nota

È possibile utilizzare diverse opzioni con l'enumerazione DateTimeFormat. Per visualizzare un elenco di opzioni, digitare il parametro seguito da un punto (.) nella barra della formula o selezionare il riferimento della funzione Text.
Si converte una data da una stringa nelle impostazioni locali francesi e il risultato viene visualizzato come una data lunga. In questo esempio, i mesi e il giorno del mese sono interpretati diversamente dall'inglese.
```
Text( DateValue( Startdate.Text, "fr" ), DateTimeFormat.LongDate )
```
Il dispositivo impostato su en mostra l'etichetta come Lunedì 10 novembre 2014.

Se invece si è digitato 20 ottobre 2014:

Si converte una data da una stringa nelle impostazioni locali dell'utente e viene calcolata la differenza tra due giorni, in giorni
```
DateDiff( DateValue( Startdate.Text ), Today() )
```
Il dispositivo impostato sulle impostazioni locali en mostra l'etichetta come 9, indicando il numero di giorni tra l'11 e il 20 ottobre. La funzione DateDiff può anche visualizzare la differenza in mesi, trimestri o anni.

DateTimeValue

Se si è digitato 10/11/2014 1:50:24.765 PM in un controllo text-input denominato Start e quindi si imposta la proprietà Text di un'etichetta sulla formula seguente:

Si converte una stringa di data e ora nelle impostazioni locali correnti.
```
Text( DateTimeValue( Start.Text ), DateTimeFormat.LongDateTime )
```
Il dispositivo impostato sulle impostazioni locali en mostra l'etichetta come Sabato 11 ottobre 2014 1:50:24 PM.

Nota

È possibile utilizzare diverse opzioni con l'enumerazione DateTimeFormat. Per visualizzare un elenco di opzioni, digitare il parametro seguito da un punto (.) nella barra della formula o selezionare il riferimento della funzione Text.
Si converte una stringa di data e ora nelle impostazioni locali francesi. Il mese e il giorno del mese vengono interpretati in modo diverso.
```
Text( DateTimeValue( Start.Text, "fr"), DateTimeFormat.LongDateTime )
```
Il dispositivo impostato sulle impostazioni locali en mostra l'etichetta come Lunedì 10 ottobre 2014 1:50:24 PM.
Si converte una stringa di data e ora nelle impostazioni locali dell'utente e il risultato viene visualizzato con un secondo frazionario.
```
Text( DateTimeValue( Start.Text ), "dddd, mmmm dd, yyyy hh:mm:ss.fff AM/PM" )
```
Il dispositivo impostato sulle impostazioni locali it mostra l'etichetta come Sabato 11 ottobre 2014 01:50:24.765 PM.

In alternativa, è anche possibile specificare hh:mm:ss.f o hh:mm:ss.ff per arrotondare l'ora al decimo o al centesimo di secondo più vicino.

TimeValue

Denominare un controllo text-input FinishedAt e impostare la proprietà Text di un'etichetta su questa formula:

If( TimeValue( FinishedAt.Text ) < TimeValue( "5:00:00.000 PM" ),
    "You made it!",
    "Too late!"
)

Se si digita 4:59:59.999 PM nel controllo FinishedAt, l'etichetta visualizza "Ce l'hai fatta!"
Se si digita 5:00:00.000 PM nel controllo FinishedAt, l'etichetta visualizza "Troppo tardi!"