Funktsioonid DateValue, TimeValue ja DateTimeValue

Kehtib: Lõuendirakendused Töölauavood Mudelipõhised rakendused Power Platform CLI

Teisendab kuupäeva, kellaaja või mõlemad stringidkuupäeva/kellaaja väärtuseks.

Kirjeldus

  • Funktsioon DateValue teisendab kuupäeva stringi (nt 10/01/2014) kuupäeva/kellaaja väärtuseks.

  • Funktsioon TimeValue teisendab kellaaja stringi (nt 12:15) kuupäeva/kellaaja väärtuseks.

  • Funktsioon DateTimeValue teisendab kuupäeva ja kellaaja stringi (nt 10. jaanuar 2013 00:13) kuupäeva/kellaaja väärtuseks.

DateValue funktsioon ignoreerib mis tahes kellaaja teavet kuupäevastringis ja TimeValue funktsioon ignoreerib mis tahes kuupäeva teavet kellaajastringis.

Märkus.

DateValue, TimeValue ja DateTimeValue funktsioon kasutab vaikimisi keelt praeguse kasutaja sätetest. Saate selle alistada, et tagada stringide õige tõlgendamine. Nt 10/1/1920 tõlgendatakse 1. oktoobrinainglise keeles ja 10. jaanuarinaprantsuse keeles.

Kuupäevad peavad olema ühes järgmistest vormingutest.

  • KK/PP/AAAA või KK-PP-AAAA
  • KK/PP/AAAA või KK-PP-AAAA
  • AAAA/KK/PP või AAAA-KK-PP
  • KK/PP/AA või KK-PP-AA
  • PP/KK/AA või PP-KK-AA
  • PP Kuu AAAA
  • Kuu PP, AAAA

Et teisendada numbrilisest päeva, kuu ja aasta komponentidest, lugege Date.
Et teisendada numbrilisest tunni, minuti ja sekundi komponendist, lugege Time.

Lisateavet vt:

Süntaks

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

  • String - Nõutav. Tekstistring, mis sisaldab kuupäeva, kellaaega või kombinatsiooni kuupäeva ja kellaaja väärtust.
  • Keel – valikuline. Tekstistring tagastatakse esimese kahe tähemärgi abil funktsiooniga Language. Kui ei esitata, kasutatakse praeguse kasutaja sätete keelt.

DateValue( Tüüpimata )
DateTimeValue( Tüüpimata )
TimeValue( Tüüpimata )

  • Tüüpimata – nõutav. Tüüpimata objekt, mis tähistab kuupäeva või kellaaega. Aktsepteeritavad väärtused sõltuvad tüüpimata pakkujast. Funktsiooni JSON korral eeldatakse, et tüüpimata objekt on JSON-i string, mis sisaldab kuupäeva ja kellaaega vormingus ISO 8601. Muudes vormingutes kuupäeva või kellaaja tulemuseks on tõrge. tKaaluge selliste väärtuste teisendamist esmalt Ttekstiks ja seejärel kuupäevaks või kellaajaks. Pidage meeles, et ajavööndid ja lokaadiga seotud vormingud on väliste süsteemidega suhtlemisel olulised.

Näited

DateValue

Kui tipite 10/11/2014 tekstisisendi juhtelementi nimega Alguskuupäev ja seejärel määrate sildi atribuudi Text neile valemitele.

  • Teisendage stringis kuupäev kasutaja lokaadis ja kuvage tulemus pika kuupäevana.

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

    Seade, mis on määratud en lokaadile, näitab silti Laupäeval, 11 oktoobril 2014.

    Märkus.

    DateTimeFormat loetelus saate kasutada mitut võimalust. Suvandite loendi kuvamiseks tippige valemiribal olev parameeter, millele järgneb punkt (.), või kontrollige Text funktsiooni viidet.

  • Teisendage stringis kuupäev prantsuse lokaadis ja kuvage tulemus pika kuupäevana. Selles näites tõlgendatakse kuud ja kuu päeva inglise keelest erinevalt.

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

    Lokaadile en seatud seade kuvab silti Monday, November 10, 2014.

Kui tippisite selle asemel October 20, 2014:

  • Teisendage kuupäev stringist kasutaja lokaadis ja arvutage erinevus kahe päeva vahel, päevades

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

    Seade, mille väärtuseks on en lokaat, kuvatakse silt 9-ga, mis näitab päevade arvu vahemikus 11. oktoober kuni 20. oktoober. Funktsioon DateDiff saab kuvada ka kuude, kvartalite või aastate erinevuse.

DateTimeValue

Kui tipite 10/11/2014 1:50:24.765 PM tekstisisendi juhtelementi nimega Start ja seejärel sildi atribuudi Text väärtuseks järgmise valemi:

  • Teisendage praeguse lokaadi kuupäeva- ja ajastringid.

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

    Seade, mis on määratud lokaadile en, näitab silti kui Saturday, October 11, 2014 1:50:24 PM.

    Märkus.

    DateTimeFormat loetelus saate kasutada mitut võimalust. Suvandite loendi kuvamiseks tippige valemiribal olev parameeter, millele järgneb punkt (.), või kontrollige Text funktsiooni viidet.

  • Teisendage prantsuse lokaadi kuupäeva- ja ajastringid. Kuud ja kuu päeva tõlgendatakse erinevalt.

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

    Seade, mis on seatud lokaadile en näitab silti kui Monday, November 10, 2014 1:50:24 PM.

  • Teisendage kasutaja lokaadis nii kuupäeva kui ka kellaaja string ning kuvage tulemus murdosa sekundist.

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

    Seade, mis on määratud lokaadile en, näitab silti kui Saturday, October 11, 2014 01:50:24.765 PM.

    Alternatiivina saate määrata hh:mm:ss.f või hh:mm:ss.ff, et ümardada aeg lähima 10ndiku või 100ndikuni sekundist.

TimeValue

Nimetage tekstisisendi juhtelement kui FinishedAt ja seadke sildi atribuudi Text väärtuseks see valem:

If( TimeValue( FinishedAt.Text ) < TimeValue( "5:00:00.000 PM" ),
    "You made it!",
    "Too late!"
)
  • Kui tipite 4:59:59.999 PM juhtelementi FinishedAt, kuvatakse sildil "Saite hakkama!"
  • Kui tipite 5:00:00.000 PM juhtelementi FinishedAt, kuvatakse sildil "Liiga hilja!"