Funkce DateValue, TimeValue a DateTimeValue

Článek
10/16/2024

Platí pro: aplikace na plátně toky na počítači modelem řízené aplikace Power Pages Power Platform CLI

Převede datum, čas nebo obojí v řetězci na hodnotu data a času.

Popis

Funkce DateValue převede řetězec data (například „10/01/2014“) na datum/ čas hodnota.
Funkce TimeValue převádí časový řetězec (například „12:15 PM“) na datum/čas hodnota.
Funkce DateTimeValue převede řetězec data a času (například „10. ledna, 2013 12:13 AM“) na datum/čas hodnota.

Funkce DateValue ignoruje jakoukoli informaci o čase v řetězci data a funkce TimeValue ignoruje jakoukoli informaci o datu v časovém řetězci.

Poznámka:

Funkce DateValue, TimeValue a DateTimeValue ve výchozím nastavení používají jazyk aktuálního uživatelského nastavení. Můžete jej přepsat, abyste zajistili, že řetězce budou správně interpretovány. Například 10/1/1920 se interpretuje jako 1^. října v angličtině (en) a 10^. ledna v češtině (cs).

Data musí být v jednom z následujících formátů:

MM/DD/RRRR nebo MM-DD-RRRR
DD/MM/RRRR nebo DD-MM-RRRR
RRRR/MM/DD nebo RRRR-MM-DD
MM/DD/RR nebo MM-DD-RR
DD/MM/RR nebo DD-MM-RR
DD Měs RRRR
Měsíc DD, RRRR

Chcete-li provést převod z číselné komponenty data, měsíce a roku, přečtěte si část Date.
Chcete-li provést převod z číselné komponenty hodin, minut a sekund, přečtěte si Time.

Další informace najdete v článku:

Syntaxe

DateValue( Řetězec [, Jazyk ])
DateTimeValue( Řetězec [, Jazyk ])
TimeValue( Řetězec [, Jazyk ])

Řetězec – Povinný. Textový řetězec, který obsahuje hodnotu data, času nebo kombinace data a času.
Jazyk – volitelný. Řetězec jazyka, který by vrátila funkce Language v prvních dvou znacích. Pokud není uvedený, použije se jazyk nastavení aktuálního uživatele.

DateValue( Nezadáno )
DateTimeValue( Nezadáno )
TimeValue( Nezadáno )

Nezadáno – Povinné. netypový objekt který představuje datum nebo čas. Přijatelné hodnoty závisí na poskytovateli netypovaného objektu. Pro JSON se očekává, že netypovaný objekt bude řetězec JSON, který obsahuje datum a čas ve formátu ISO 8601. Data nebo časy v jiných formátech budou mít za následek chybu. Zvažte nejprve převod takových hodnot na Text a až potom na datum nebo čas. Mějte na paměti, že časová pásma a formáty související s národním prostředím jsou důležitými faktory při komunikaci s externími systémy.

Příklady

DateValue

Pokud jste do ovládacího prvku Text input s názvem Startdate zadali 10/11/2014 a potom nastavili vlastnost Text popisku k těmto vzorcům:

Převede datum z řetězce v místním prostředí uživatele a výsledek zobrazí jako dlouhé datum.
```
Text( DateValue( Startdate.Text ), DateTimeFormat.LongDate )
```
Zařízení nastaveno na en národní prostředí zobrazuje popisek jako Saturday, October 11, 2014.

Poznámka:

Můžete použít několik možností výčtu DateTimeFormat. Chcete-li zobrazit seznam možností, zadejte parametr následovaný tečkou nebo tečkou (.) na řádku vzorců nebo zaškrtněte referenční funkci Text.
Převede datum z řetězce v národním francouzském prostředí a výsledek zobrazí jako dlouhé datum. V tomto příkladu jsou měsíce a den v měsíci interpretovány odlišně od angličtiny.
```
Text( DateValue( Startdate.Text, "fr" ), DateTimeFormat.LongDate )
```
Zařízení nastaveno na en národní prostředí zobrazuje popisek jako Monday, November 10, 2014.

Pokud jste zadali October 20, 2014:

Převede datum z řetězce v místním prostředí uživatele a vypočítá rozdíl mezi dvěma dny, ve dnech
```
DateDiff( DateValue( Startdate.Text ), Today() )
```
Zařízení nastaveno na en národní prostředí zobrazuje popisek jako 9 s uvedením počtu dní mezi 11. říjnem a 20. říjnem. Funkce DateDiff také může zobrazit rozdíl v měsících, čtvrtletích nebo rocích.

DateTimeValue

Pokud jste do ovládacího prvku Text input s názvem Start zadali 10/11/2014 1:50:24.765 PM a potom nastavili vlastnost Text popisku na tento vzorec:

Převede řetězec data a času v aktuálním národním prostředí.
```
Text( DateTimeValue( Start.Text ), DateTimeFormat.LongDateTime )
```
Zařízení nastaveno na en národní prostředí zobrazuje popisek jako Saturday, October 11, 2014 1:50:24 PM.

Poznámka:

Můžete použít několik možností výčtu DateTimeFormat. Chcete-li zobrazit seznam možností, zadejte parametr následovaný tečkou nebo tečkou (.) na řádku vzorců nebo zaškrtněte referenční funkci Text.
Převede řetězec data a času ve francouzském národním prostředí. Měsíc a den v měsíci jsou interpretovány odlišně.
```
Text( DateTimeValue( Start.Text, "fr"), DateTimeFormat.LongDateTime )
```
Zařízení nastaveno na en národní prostředí zobrazuje popisek jako Monday, November 10, 2014 1:50:24 PM.
Převeďte řetězec data a času v národním prostředí uživatele a zobrazí výsledek s vteřinami.
```
Text( DateTimeValue( Start.Text ), "dddd, mmmm dd, yyyy hh:mm:ss.fff AM/PM" )
```
Zařízení nastaveno na en národní prostředí zobrazuje popisek jako Saturday, October 11, 2014 01:50:24.765 PM.

Jako alternativu můžete zadat hh:mm:ss.f nebo hh:mm:ss.ff, pokud chcete čas zaokrouhlit na nejbližší desetinu nebo setinu sekundy.

TimeValue

Pojmenujte ovládací prvek Text input FinishedAt a nastavte vlastnost Text popisku na tento vzorec:

If( TimeValue( FinishedAt.Text ) < TimeValue( "5:00:00.000 PM" ),
    "You made it!",
    "Too late!"
)

Pokud do ovládacího prvku FinishedAt zadáte 4:59:59.999 PM, zobrazí popisek You made it! (Zvládl jsi to!).
Pokud do ovládacího prvku FinishedAt zadáte 5:00:00.000 PM, zobrazí popisek Too late! (Už je pozdě!).

Sdílet prostřednictvím