Funkcijas DateValue, TimeValue un DateTimeValue

  • Raksts

Attiecas uz: Audekla programmām Darbvirsmas plūsmas Modeļa vadītas programmas Power Platform CLI

Konvertē datumu, laiku vai tos abus virknē par datuma/laika vērtību.

Apraksts

  • Funkcija DateValue konvertē datuma virkni (piemēram, "10/01/2014") par datuma/laika vērtību.

  • Funkcija TimeValue konvertē laika virkni (piemēram, "12:15 PM") par datuma/laika vērtību.

  • DateTimeValue funkcija konvertē datuma un laika virkni (piemēram, "2013. gada 10, janvāris 12:13 AM") par Datuma/laika vērtību.

Funkcija DateValue ignorē jebkādu laika informāciju datuma virknē, bet funkcija TimeValue ignorē jebkādu datuma informāciju laika virknē.

Note

Funkcijas DateValue, TimeValue un DateTimeValue pēc noklusējuma izmanto valodu no pašreizējiem lietotāja iestatījumiem. Varat to ignorēt, lai nodrošinātu, ka virknes tiek pareizi interpretētas. Piemēram, "10/1/1920" tiek interpretēta kā 1. oktobris "en" un 10. janvāris "fr".

Datumiem jābūt kādā no šiem formātiem:

  • MM/DD/GGGG vai MM-DD-GGGG
  • DD/MM/GGGG vai DD-MM-GGGG
  • GG/MM/DD vai GGGG-MM-DD
  • MM/DD/GG vai MM-DD-GG
  • DD/MM/GG vai DD-MM-GG
  • DD mēn. GGGG;
  • Mēnesis DD, GGGG.

Lai konvertētu no skaitliskiem datuma, mēneša un gada komponentiem izlasiet sadaļu Date.
Lai konvertētu no skaitliskiem stundu, minūšu un sekunžu komponentiem, skatiet sadaļu Time.

Papildinformāciju skatiet šeit:

Sintakse

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

  • Virkne — Obligāti. Teksta virkne, kurā ir datuma, laiks vai datuma un laika vērtības apvienojums.
  • Valoda — Neobligāti. Valodas virkne, kādu to atgriezīs pirmās divas rakstzīmes no funkcijas Language. Ja to nenodrošina, tiek izmantota valoda no pašreizējā lietotāja iestatījumiem.

DateValue ( netipēts )
DateTimeValue ( netipēts )
TimeValue ( netipēts )

  • Nav ievadīts — nepieciešams. Netipēts objekts, kas apzīmē datumu vai laiku. Atkarīgās vērtības ir atkarīgas no netipa nodrošinātāja. JSON objektam, kas nav ievadīts, ir jābūt JSON virknei, kuras datums un laiks ir ISO 8601 formātā. Datumi vai laiks citos formātos radīs kļūdu. Vispirms apsveriet iespēju šādas vērtības pārvērst vispirms par Tekstu un pēc tam — par datumu vai laiku. Ņemiet vērā, ka ar laika joslas un ar lokalizāciju saistītie formāti ir svarīgi apsvērumi, sazinoties ar ārējām sistēmām.

Piemēri

DateValue

Ja ierakstāt 10/11/2014 teksta ievades vadīklā ar nosaukumu StartDate, un pēc tam iestatāt etiķetes rekvizītu Teksts uz šīm formulām:

  • Pārvērtiet datumu no virknes lietotāja lokalizācijā un rādiet rezultātu kā garu datumu.

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

    Ierīce, kas ir iestatīta uz lokalizāciju en rāda etiķeti kā Saturday, October 11, 2014.

    Note

    Varat izmantot vairākas opcijas ar uzskaitījumu DateTimeFormat. Lai parādītu opciju sarakstu, formulas joslā ierakstiet parametru, kam seko punkts (.), vai pārbaudiet Text funkcijas atsauci.

  • Pārvērtiet datumu no virknes franču lokalizācijā un rādiet rezultātu kā garu datumu. Šajā piemērā mēneši un mēneša dienas interpretē atšķirīgi no angļu valodas.

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

    Ierīce, kas ir iestatīta uz lokalizāciju en rāda etiķeti kā Monday, November 10, 2014.

Ja tā vietā ievadījāt October 20, 2014.

  • Konvertējiet datumu no virknes lietotāja lokalizācijā un aprēķiniet atšķirību starp divām dienām, dienās

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

    Ierīce, kas ir iestatīta uz en lokalizāciju, rāda etiķeti kā 9, norādot dienu skaitu no 11. oktobra līdz 20. oktobrim. Funkcija DateDiff var arī rādīt atšķirību mēnešos, ceturkšņos vai gados.

DateTimeValue

Ja ierakstījāt 10/11/2014 1:50:24.765 PM teksta ievades vadīklā ar nosaukumu Start, un pēc tam iestatāt etiķetes rekvizītu Teksts uz šīm formulām:

  • Pārvērtiet gan datuma, gan laika virkni pašreizējā lokalizācijā.

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

    Ierīce, kas ir iestatīta uz lokalizāciju en rāda etiķeti kā Saturday, October 11, 2014 1:50:24 PM.

    Note

    Varat izmantot vairākas opcijas ar uzskaitījumu DateTimeFormat. Lai parādītu opciju sarakstu, formulas joslā ierakstiet parametru, kam seko punkts (.), vai pārbaudiet Text funkcijas atsauci.

  • Pārvērtiet gan datuma, gan laika virkni franču lokalizācijā. Mēnesis un mēneša diena tiek intepretēti atšķirīgi.

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

    Ierīce, kas ir iestatīta uz lokalizāciju en rāda etiķeti kā Monday, November 10, 2014 1:50:24 PM.

  • Pārvērtiet gan datuma, gan laika virkni lietotāja lokalizācijā un rādiet rezultātu ar daļskaitļa sekundi.

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

    Ierīce, kas ir iestatīta uz lokalizāciju en rāda etiķeti kā Saturday, October 11, 2014 01:50:24.765 PM.

    Varat arī konkretizēt hh:mm:ss.f vai hh:mm:ss.ff, lai noapaļotu laiku uz tuvāko sekundesdesmitdaļu vaisimtdaļu.

TimeValue

Nodēvējiet teksta ievades vadīklu par FinishedAtun iestatiet etiķetes Teksta rekvizītu uz šo formulu:

If( TimeValue( FinishedAt.Text ) < TimeValue( "5:00:00.000 PM" ),
    "You made it!",
    "Too late!"
)
  • Ja vadīklā FinishedAt ievadāt 4:59:59.999 PM, etiķetē būs redzams "Jums izdevās!".
  • Ja vadīklā FinishedAt ievadāt 5:00:00.000 PM, etiķetē būs redzams "Par vēlu!".