Condividi tramite


DateValueFunzioni , TimeValuee DateTimeValue

Si applica a: App canvas Flussi desktop di Copilot Studio App basate su modello Funzioni power platform dell'interfaccia della riga di comando di Power Platform Power Pages

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

Descrizione

  • DateValue la funzione converte una stringa di data (ad esempio "10/01/2014") in un valore di data/ora .

  • TimeValue la funzione converte una stringa di ora (ad esempio "12:15 PM") in un valore di data/ora .

  • DateTimeValue la funzione converte una stringa di data e ora (ad esempio "10 gennaio 2013 12:13 AM") in un valore di data/ora .

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

Nota

Le DateValuefunzioni , TimeValuee DateTimeValue per impostazione predefinita usano 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" e come 10 gennaio in "fr".

Le date devono usare uno dei formati seguenti:

  • 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 altre informazioni, vedere:

Sintassi

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

  • 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( Dinamico )
DateTimeValue( Dinamico )
TimeValue( Dinamico )

  • Dinamico : obbligatorio. Valore dinamico che rappresenta una data o un'ora. I valori accettabili dipendono dal provider non tipizzato. Per JSON, il valore dinamico deve essere una stringa JSON che contiene una data e un'ora in formato ISO 8601. Date o ore in altri formati generano 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 immette il 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!"