Funkce DateValue, TimeValue a DateTimeValue

  • Článek

Platí pro: aplikace plátna desktopové toky modelem řízené aplikace 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. 1. 2014) na hodnotu data a času.

  • Funkce TimeValue převede řetězec času (například 12:15) na hodnotu data a času.

  • Funkce DateTimeValue převede řetězec data a času (například 10. ledna 2013 12:13) na hodnotu data a času.

Funkce DateValue ignoruje všechny informace o čase v řetězci data a funkce TimeValue ignoruje všechny informace o datu v řetězci času.

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( Untyped )
DateTimeValue( Untyped )
TimeValue( Untyped )

  • Untyped – povinné. Netypovaný 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ě!).