Funktionerna DateValue, TimeValue och DateTimeValue

  • Artikel

Gäller: Arbetsyteappar Datorflöden Modellbaserade appar Power Platform CLI

Konverterar ett datum, en tid eller bägge i en sträng till ett datum-/tidvärde.

Beskrivning

  • Funktionen DateValue konverterar en datumsträng (till exempel, "10/01/2014") till en datum-/tid-värde

  • Funktionen TimeValue konverterar en tidsträng (till exempel "12:15 PM") till ett datum-/tid-värde.

  • Funktionerna DateTimeValue konverterar en datum- och tidsträng (till exempel "10 januari 2013, 24:13") till ett datum-/tidvärde.

Funktionen DateValue ignorerar eventuell tidsinformation i datumsträngen, och funktionen TimeValue ignorerar eventuell datuminformation i tidsträngen.

Kommentar

Funktionerna DateValue, TimeValue och DateTimeValue använder som standard språket från den aktuella användarens inställningar. Du kan åsidosätta det för att säkerställa att strängar tolkas korrekt. Till exempel så tolkas "10/1/1920" som 1 oktober på "en" och som 10 januari på "fr".

Datum måste vara i något av följande format:

  • MM/DD/ÅÅÅÅ eller MM-DD-ÅÅÅÅ
  • DD/MM/ÅÅÅÅ eller DD-MM-ÅÅÅÅ
  • ÅÅÅÅ/MM/DD eller ÅÅÅÅ-MM-DD
  • MM/DD/ÅÅ eller MM-DD-ÅÅ
  • DD/MM/ÅÅ eller DD-MM-ÅÅ
  • DD månad ÅÅÅÅ
  • Månad DD ÅÅÅÅ

Om du vill konvertera från numeriska komponenter, månads- och årskomponenter, läs Date.
Om du vill konvertera från numeriska komponenter i timme, minut och sekund läser du Time.

För mer information, läs:

Syntax

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

  • String – Krävs. En textsträng som innehåller ett datum, en tid eller ett kombinerat datum- och tidvärde.
  • Language – valfritt. En språksträng, som den returneras via de första två tecknen från funktionen Language. Om detta inte används så används den aktuella användarens inställningar.

DateValue( Utan typ )
DateTimeValue( Utan typ )
TimeValue( Utan typ )

  • Utan typ – Obligatoriskt. Objekt utan angiven typ som representerar ett datum eller en tid. Acceptabla värden är beroende av leverantören utan angiven typ. För JSON förväntas objektet utan angiven typ vara en JSON-sträng som innehåller ett datum och en tid i ISO 8601-format. Datum och tid i andra format resulterar i ett fel. Överväg att först konvertera sådana värden till Text först och sedan till ett datum eller en tid. Tänk på att tidszoner och språkrelaterade format är viktiga saker att tänka på när du kommunicerar med externa system.

Exempel

DateValue

Om du skriver 10/11/2014 i en Text Input-kontroll kallad Startdate och sedan anger egenskapen Text för en etikett till dessa formler:

  • Konvertera ett datum från en sträng i användarens språk och visa resultatet som ett långt datum.

    Text( DateValue( Startdate.Text ), DateTimeFormat.LongDate )

    Enhet som anges till en språket visar etiketten som lördag 11 oktober 2014.

    Kommentar

    Du kan använda flera alternativ med hjälp av uppräkningen DateTimeFormat. Om du vill visa en lista med alternativ skriver du parametern följt av en punkt (.) i formelfältet eller kontrollera Text funktionsreferens.

  • Konvertera ett datum från en sträng på franska språket och visa resultatet som ett långt datum. I det här exemplet tolkas både månader och dagen i månaden på olika sätt från engelska.

    Text( DateValue( Startdate.Text, "fr" ), DateTimeFormat.LongDate )

    Enhet som anges till en språket visar etiketten som måndag 10 november 2014.

Om du skrev 20 oktober 2014 i stället:

  • Konvertera ett datum från en sträng på användarens språk och beräkna skillnaden mellan två dagar, i dagar

    DateDiff( DateValue( Startdate.Text ), Today() )

    En enhet som anges till språket en visar etiketten som 9 och anger antalet dagar mellan den 11 oktober och 20 oktober. Funktionen DateDiff kan också visa skillnaden i månader, kvartal eller år.

DateTimeValue

Om du har skrivit 10/11/2014 1:50:24.765 PM i en Text Input-kontroll kallas Start och sedan anger egenskapen Text för en etikett till följande formel:

  • Konvertera både en datum- och tidssträng på det aktuella språket.

    Text( DateTimeValue( Start.Text ), DateTimeFormat.LongDateTime )

    Enhet som anges till en språket visar etiketten som lördag 11 oktober 2014 kl. 13:50:24.

    Kommentar

    Du kan använda flera alternativ med hjälp av uppräkningen DateTimeFormat. Om du vill visa en lista med alternativ skriver du parametern följt av en punkt (.) i formelfältet eller kontrollera Text funktionsreferens.

  • Konvertera både en datum- och tidssträng på franska språket. Månad och dag i månaden tolkas annorlunda.

    Text( DateTimeValue( Start.Text, "fr"), DateTimeFormat.LongDateTime )

    Enhet som anges till en språket visar etiketten som måndag 10 november 2014 kl. 13:50:24.

  • Konvertera både en datum- och tidssträng i användarens nationella inställningar och visa resultatet med en bråkdels sekund.

    Text( DateTimeValue( Start.Text ), "dddd, mmmm dd, yyyy hh:mm:ss.fff AM/PM" )

    Enhet som anges till en språket visar etiketten som lördag 11 oktober 2014 kl. 13:50:24.765.

    Alternativt kan du ange hh:mm:ss.f eller hh:mm:ss.ff för att avrunda tiden till närmaste 10 eller 100 av en sekund.

TimeValue

Namnge en Text Input-kontroll FinishedAt och ange egenskapen Text för en etikett till den här formeln:

If( TimeValue( FinishedAt.Text ) < TimeValue( "5:00:00.000 PM" ),
    "You made it!",
    "Too late!"
)
  • Om du skriver 4:59:59.999 PM i FinishedAt-kontrollen visar etiketten "Du hann!"
  • Om du skriver 5:00:00.000 PM i kontrollen FinishedAt visas etiketten "För sent!"