DateValue-, TimeValue- ja DateTimeValue-funktio

  • Artikkeli

Koskee seuraavia: Pohjaan perustuvat sovellukset Työpöytätyönkulut Mallipohjaiset sovellukset Power Platform CLI

Muuntavat merkkijonon päivämäärän ja/tai ajan päivämäärä- ja aika-arvoksi.

Kuvaus

  • DateValue-funktio muuntaa päivämäärämerkkijonon (esimerkiksi ”10/01/2014”) päivämäärä- ja aika-arvoksi.

  • TimeValue-funktio muuntaa aikamerkkijonon (esimerkiksi ”12:15 PM”) päivämäärä- ja aika-arvoksi.

  • DateTimeValue-funktio muuntaa päivämäärä- ja aikamerkkijonon (esimerkiksi ”January 10, 2013 12:13 AM”) päivämäärä- ja aika-arvoksi.

DateValue-funktio jättää huomiotta kaikki aikatiedot päivämäärämerkkijonossa ja TimeValue-funktio jättää huomiotta aikamerkkijonon kaikki päivämäärätiedot.

Muistiinpano

DateValue-, TimeValue- ja DateTimeValue-funktiot käyttävät oletusarvoisesti kieltä nykyisen käyttäjän asetuksista. Voit ohittaa sen varmistaaksesi, että merkkijonot tulkitaan oikein. Esimerkiksi 10/1/1920 tulkitaan päivämääräksi 1. lokakuuta kielessäEN ja päivämääräksi 10. tammikuuta kielessä FR.

Päivämäärien täytyy olla jossakin seuraavista muodoista:

  • MM/DD/YYYY tai MM-DD-YYYY
  • DD/MM/YYYY tai DD-MM-YYYY
  • YYYY/MM/DD tai YYYY-MM-DD
  • MM/DD/YY tai MM-DD-YY
  • DD/MM/YY tai DD-MM-YY
  • PP Kuu VVVV
  • Kuukausi PP, VVVV

Jos haluat muuntaa numeerisesta päivämäärästä, kuukausi- ja vuosiosat, lue Date.
Jos haluat muuntaa numeerisesta tunnista, minuutista ja sekunnista lue Time.

Lisätietoja on aiheessa:

Syntaksi

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

  • String – Pakollinen. Tekstimerkkijono, joka sisältää päivämäärän, kellonajan tai niiden yhdistelmän.
  • Language – Valinnainen. Kielimerkkijono, vastaa Language-funktion kahta ensimmäistä merkkiä. Jos kieltä ei syötetä, käytetään nykyisen käyttäjän asetusten kieltä.

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

  • Untyped – Pakollinen. Tyypittämätön objekti, joka edustaa päivämäärää tai kellonaikaa. Hyväksyttävät arvot riippuvat tyypittämätömästä palvelusta. Kun käytät JSON:ää, tyypittämättömän objektin odotetaan olevan JSON-merkkijono, joka sisältää päivämäärän ja kellonajan ISO 8601 -muodossa. Muissa muodoissa olevat päivämäärät tai kellonajat johtavat virheeseen. Harkitse näiden arvojen muuntamista ensin tekstiksi ja sitten päivämääräksi tai kellonajaksi. Pidä mielessäsi, että aikavyöhykkeet ja kielialueisiin liittyvät muodot ovat tärkeitä seikkoja kommunikoidessa ulkoisten järjestelmien kanssa.

Esimerkkejä

DateValue

Jos syötit 10/11/2014 tekstinsyöttöohjausobjektiin, jonka nimi on Aloituspäivä, ja asetit sitten näille kaavoille selitteen ominaisuuden Text:

  • Muunna päivämäärä käyttäjän alueen merkkijonosta ja näytä tulos pitkänä päivämääränä.

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

    Laiteasetus en-kielialue näyttää otsikkona Saturday, October 11, 2014.

    Muistiinpano

    Voit käyttää useita vaihtoehtoja DateTimeFormat-luettelon kanssa. Saat näkyviin luettelon vaihtoehdoista kirjoittamalla parametrin, sen perään pisteen (.) kaavarivillä tai katso Text-toiminnon viite.

  • Muunna päivämäärä Ranskan alueen merkkijonosta ja näytä tulos pitkänä päivämääränä. Tässä esimerkissä kuukauden kuukausi ja päivä tulkitaan eri tavalla kuin englanti-valinnassa.

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

    Laiteasetus en-kielialue näyttää otsikkona Monday, November 10, 2014.

Jos kirjoitit sen sijaan October 20, 2014:

  • Muunna päivämäärä käyttäjän alueella olevasta merkkijonosta ja laske kahden päivän ero päivinä

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

    Laite, jonka kieliasetus on en, näyttää merkinnän muodossa 9, joka ilmaisee, että on lokakuun 11. ja lokakuun 20. päivän välillä oleiven päivien määrän. DateDiff-funktio voi näyttää eron myös kuukausina, vuosineljänneksinä tai vuosina.

DateTimeValue

Jos syötät 10/11/2014 1:50:24.765 PM tekstinsyöttöohjausobjektiin, jonka nimi on Alku, ja määrität sitten selitteen Text-ominaisuuden seuraavaan kaavaan:

  • Muunna sekä päivämäärä- että kellonaikamerkkijono nykyiseen kielialueeseen.

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

    Laiteasetus en-kielialue näyttää otsikkona Saturday, October 11, 2014 1:50:24 PM.

    Muistiinpano

    Voit käyttää useita vaihtoehtoja DateTimeFormat-luettelon kanssa. Saat näkyviin luettelon vaihtoehdoista kirjoittamalla parametrin, sen perään pisteen (.) kaavarivillä tai katso Text-toiminnon viite.

  • Muunna sekä päivämäärä- että kellonaikamerkkijono Ranskan kielialueeseen. Kuukauden kuukausi ja päivä tulkitaan eri tavoin.

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

    Laiteasetus en-kielialue näyttää otsikkona Monday, November 10, 2014 1:50:24 PM.

  • Muunna sekä päivämäärä- että aikamerkkijono käyttäjän kielialueelle ja näytä tulos sekunnin murto-osana.

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

    Laiteasetus en-kielialue näyttää otsikkona Saturday, October 11, 2014 01:50:24.765 PM.

    Vaihtoehtoisesti voit valita määrityksen hh:mm:ss.f tai hh:mm:ss.ff, jolloin aika pyöristetään lähimpään sekunnin kymmenes- tai sadasosaan.

TimeValue

Määritä tekstinsyöttöohjausobjekti FinishedAt ja määritä selitteen Text-ominaisuus tähän kaavaan:

If( TimeValue( FinishedAt.Text ) < TimeValue( "5:00:00.000 PM" ),
    "You made it!",
    "Too late!"
)
  • Jos kirjoitat 4:59:59.999 PM ohjausobjektiin FinishedAt, selitteessä näkyy ”Ehdit!”
  • Jos kirjoitat 5:00:00.000 PM ohjausobjektiin FinishedAt, selitteessä näkyy ”Myöhästyit!”