Funkcie DateValue, TimeValue a DateTimeValue

Vzťahuje sa na: Aplikácie plátna Postupy v počítačovom prostredí Modelom riadené aplikácie Power Platform CLI

Konvertuje dátum, čas alebo obe veličiny v reťazci na hodnoty dátumu/času.

Popis

  • Funkcia DateValue konvertuje reťazec dátumu (napr. 10/01/2014) na hodnotu dátumu/času.

  • Funkcia TimeValue konvertuje reťazec času (napr. 12:15) na hodnotu dátumu/času.

  • Funkcia DateTimeValue konvertuje reťazec dátumu a času (napr. 10 januára 2013, 12:13) na hodnotu dátumu/času.

Funkcia DateValue ignoruje všetky informácie o čase v reťazci dátumu a funkcia TimeValue ignoruje všetky informácie o dátume v reťazci času.

Poznámka

Funkcie DateValue, TimeValue a DateTimeValue štandardne používajú jazyk podľa aktuálneho nastavenia používateľa. Môžete ho prepísať, aby ste sa uistili, že reťazce sú správne interpretované. Napríklad „10/1/1920“ sa interpretuje ako 1. októbra v angličtine(en) a 10. januára v slovenčine (sk).

Dátumy musia byť v jednom z nasledujúcich formátov:

  • MM/DD/RRRR alebo MM-DD-RRRR
  • DD/MM/RRRR alebo DD-MM-RRRR
  • RRRR/MM/DD alebo RRRR-MM-DD
  • MM/DD/RR alebo MM-DD-RR
  • DD/MM/RR alebo DD-MM-RR
  • DD Mes RRRR
  • Mesiac DD, RRRR

Ak chcete previesť z číselných komponentov deň, mesiac a rok, prečítajte si Date.
Ak chcete previesť z číselných hodina, minúta a sekunda, prečítajte si Time.

Ďalšie informácie nájdete v časti:

Syntax

DateValueString [, Language ])
DateTimeValueString [, Language ])
TimeValueString [, Language ])

  • String – povinné. Textový reťazec, ktorý obsahuje hodnoty dátumu a času alebo kombináciu dátumu a času.
  • Language – voliteľné. Reťazec jazyka, ktorý by vrátila funkcia Language v prvých dvoch znakoch. Ak nie je uvedený, použije sa jazyk nastavenia aktuálneho používateľa.

DateValue( netypové )
DateTimeValue( netypové )
TimeValue( netypové )

  • Untyped – povinné. Netypový objekt, ktorý predstavuje dátum alebo čas. Prijateľné hodnoty závisia od netypového poskytovateľa. V prípade JSON sa očakáva, že netypový objekt bude reťazec JSON, ktorý obsahuje dátum a čas vo formáte ISO 8601. Dátumy alebo časy v iných formátoch budú mať za následok chybu. Zvážte konverziu takýchto hodnôt najprv na Text, potom na dátum alebo čas. Majte na pamäti, že časové pásma a formáty súvisiace s miestnym nastavením sú dôležité pri komunikácii s externými systémami.

Príklady

DateValue

Ak napíšete 10/11/2014 do ovládacieho prvku na zadávanie textu s názvom Startdate, a potom nastavíte vlastnosť Text označenia na tieto vzorce:

  • Konverzia dátumu z reťazca v miestnom nastavení používateľa a zobrazenie výsledku v podobe dlhého dátumu.

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

    Zariadenie s miestnym nastavením en zobrazuje označenie ako Sobota, 11. októbra 2014.

    Poznámka

    Môžete použiť niekoľko možností s enumeráciou DateTimeFormat. Ak chcete zobraziť zoznam možností, zadajte parameter nasledovaný bodkou (.) na paneli vzorcov alebo začiarknite odkaz na funkciu Text.

  • Konverzia dátumu z reťazca v miestnom nastavení fr a zobrazenie výsledku v podobe dlhého dátumu. V tomto príklade sa mesiace a deň v mesiaci interpretujú odlišne od angličtiny.

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

    Zariadenie s miestnym nastavením en zobrazuje označenie ako Pondelok, 10. novembra 2014.

Ak ste napísali 20. októbra 2014 namiesto:

  • Konverzia dátumu z reťazca v miestnom nastavení používateľa a výpočet rozdielu medzi dvoma dňami, v dňoch

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

    Zariadenie má miestne nastavenie en a zobrazuje označenie ako 9, s uvedením počtu dní medzi 11. októbrom a 20. októbrom. Funkcia DateDiff tiež dokáže zobraziť rozdiel v mesiacoch, štvrťrokoch alebo rokoch.

DateTimeValue

Ak ste napísali 10/11/2014 1:50:24.765 PM do ovládacieho prvku na zadávanie textu s názvom Start, a potom nastavili vlastnosť Text označenia na nasledujúci vzorec:

  • Konverzia reťazca dátumu a času na aktuálne miestne nastavenie.

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

    Zariadenie s miestnym nastavením en zobrazuje označenie ako Sobota, 11. októbra 2014 1:50:24 PM.

    Poznámka

    Môžete použiť niekoľko možností s enumeráciou DateTimeFormat. Ak chcete zobraziť zoznam možností, zadajte parameter nasledovaný bodkou (.) na paneli vzorcov alebo začiarknite odkaz na funkciu Text.

  • Konverzia reťazca dátumu a času na miestne nastavenie fr. Mesiac a deň v mesiaci sa interpretujú odlišne.

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

    Zariadenie s miestnym nastavením en zobrazuje označenie ako Pondelok, 10. novembra 2014 1:50:24 PM.

  • Konverzia reťazca dátumu a času v miestnom nastavení používateľa a zobrazenie výsledku so zlomovými sekundami.

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

    Zariadenie s miestnym nastavením en zobrazuje označenie ako Sobota, 11. októbra 2014 01:50:24.765 PM.

    Ako alternatívu môžete zadať hh:mm:ss.f alebo hh:mm:ss.ff, ak chcete čas zaokrúhliť na najbližšiu desatinu alebo stotinu sekundy.

TimeValue

Pomenujte ovládací prvok na zadávanie textu FinishedAt a vlastnosť označenia Text nastavte na tento vzorec:

If( TimeValue( FinishedAt.Text ) < TimeValue( "5:00:00.000 PM" ),
    "You made it!",
    "Too late!"
)
  • Ak do ovládacieho prvku FinishedAt zadáte 4:59:59.999 PM, označenie zobrazí „You made it!“ (Zvládol si to!).
  • Ak do ovládacieho prvku FinishedAt zadáte 5:00:00.000 PM, označenie zobrazí „Too late!“ (Príliš neskoro!).