Funkcie DateValue, TimeValue a DateTimeValue
Vzťahuje sa na: aplikácie plátna
toky na počítači
aplikácie riadené modelom
Power Pages
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
DateValue( String [, Language ])
DateTimeValue( String [, Language ])
TimeValue( String [, 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!).