Funzioni DateValue, TimeValue e DateTimeValue

Si applica a: App Canvas Flussi Desktop App basate su modello Power Pages 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 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 ora (ad esempio, "10 gennaio, 2013 12:13 AM") in un valore data/ora .

La funzione DateValue ignora qualsiasi informazione oraria nella stringa data, mentre la funzione TimeValue ignora qualsiasi informazione oraria nella stringa 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( Stringa [, Lingua ])
DateTimeValue( Stringa [, Lingua ])
TimeValue( Stringa [, Lingua ])

  • Stringa - Obbligatorio. Una stringa di testo che contiene un valore data, ora o una combinazione di data e ora.
  • Lingua - 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( Non tipizzato )
DateTimeValue( Non tipizzato )
TimeValue( Non tipizzato )

  • Non tipizzato - 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!"