Funkcie DateValue, TimeValue a DateTimeValue

Článok
06/10/2024

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!).

Zdieľať cez