Funkce Date, DateTime a Time

  • Článek

Platí pro: aplikace plátna desktopové toky modelem řízené aplikace Power Platform CLI

Převede součásti data a času na hodnotu data a času.

Description

Funkce Date převede jednotlivé hodnoty Rok, Měsíc a Den na hodnotu data a času. Jako čas se předpokládá půlnoc.

  • Pokud je Rok v rozmezí 0 až 1899 (včetně), funkce přidá tuto hodnotu k hodnotě 1900 a vypočítá rok. Z 70 se stane 1970.
  • Pokud je Měsíc menší než 1 nebo větší než 12, výsledek odečte nebo přičte tolik měsíců od začátku zadaného roku.
  • Pokud je Den vyšší než počet dní v zadaném měsíci, funkce přidá tento počet dní k prvnímu dni měsíce a vrátí odpovídající datum z následujícího měsíce. Pokud je Den menší než 1, funkce odečte daný počet dní, plus 1, od prvního dne určeného měsíce.

Funkce Time převede jednotlivé hodnoty Hodina, Minuta, Sekunda a volitelně Milisekunda na hodnotu data a času. Výsledek nemá přiřazené žádné datum.

Funkce DateTime kombinuje funkce Date a Time do jediné funkce, přičemž vezme argumenty data a času a vrátí hodnotu data/času, která má složku datum i čas.

Informace o tom, jak převést řetězec na hodnotu, najdete v článcích o funkcích DateValue, TimeValue a DateTimeValue.

Další informace najdete také v části týkající se práce s daty a časy.

Syntaxe

Date( Rok; Měsíc; Den )

  • Rok – povinné. Čísla větší než 1899 se interpretují jako absolutní (1980 se interpretuje jako 1980); čísla v rozsahu od 0 do 1899 se interpretují jako relativní k 1900. (Například 80 se interpretuje jako 1980.)
  • Měsíc – povinné. Číslo od 1 do 12.
  • Den – povinné. Číslo od 1 do 31.

Time( Hodina, Minuta, Sekunda [, Milisekunda ] )

  • Hodina – povinné. Počet hodin, obvykle v rozsahu 0 (00:00) až 23 (23:00).
  • Minuta – povinné. Počet minut, obvykle v rozsahu 0 až 59.
  • Sekunda – povinné. Počet sekund, obvykle v rozsahu 0 až 59.
  • Milisekundy – volitelné. Počet milisekund, obvykle v rozsahu 0 až 999.

DateTime( Rok, Měsíc, Den, Hodina, Minuta, Sekunda [, Milisekunda ] )

  • Rok – povinné. Čísla větší než 1899 se interpretují jako absolutní (1980 se interpretuje jako 1980); čísla v rozsahu od 0 do 1899 se interpretují jako relativní k 1900. (Například 80 se interpretuje jako 1980.)
  • Měsíc – povinné. Číslo od 1 do 12.
  • Den – povinné. Číslo od 1 do 31.
  • Hodina – povinné. Počet hodin, obvykle v rozsahu 0 (00:00) až 23 (23:00)
  • Minuta – povinné. Počet minut, obvykle v rozsahu 0 až 59.
  • Sekunda – povinné. Počet sekund, obvykle v rozsahu 0 až 59.
  • Milisekundy – volitelné. Počet milisekund, obvykle v rozsahu 0 až 999.

Příklady

Date

Pokud uživatel zadal

  • 1979 v ovládacím prvku pro zadávání textu s názvem HireYear
  • 3 v ovládacím prvku pro zadávání textu s názvem HireMonth
  • 17 v ovládacím prvku pro zadávání textu s názvem HireDay

tento vzorec by vrátil 3/17/1979:

Date( Value(HireYear.Text), Value(HireMonth.Text), Value(HireDay.Text) )

Čas

Pokud uživatel zadal

  • 14 v ovládacím prvku pro zadávání textu s názvem BirthHour
  • 50 v ovládacím prvku pro zadávání textu s názvem BirthMinute
  • 24 v ovládacím prvku pro zadávání textu s názvem BirthSecond

tento vzorec by vrátil 02:50:24 P:

Text( 
    Time(Value(BirthHour.Text), Value(BirthMinute.Text), Value(BirthSecond.Text)), 
    "hh:mm:ss A/P" 
)

DateTime

Pokud uživatel zadal

  • 2023 v ovládacím prvku pro zadávání textu s názvem EclipseYear
  • 10 v ovládacím prvku pro zadávání textu s názvem EclipseMonth
  • 28 v ovládacím prvku pro zadávání textu s názvem EclipseDate
  • 13 v ovládacím prvku pro zadávání textu s názvem EclipseHour
  • 14 v ovládacím prvku pro zadávání textu s názvem EclipseMinute
  • 5 v ovládacím prvku pro zadávání textu s názvem EclipseSecond
  • 231 v ovládacím prvku pro zadávání textu s názvem EclipseMillisecond

tento vzorec by vrátil 10/28/23 01:14:05.231 PM:

Text(
    DateTime(Value(EclipseYear.Text), Value(EclipseMonth.Text), Value(EclipseDate.Text), 
        Value(EclipseHour.Text), Value(EclipseMinute.Text), 
        Value(EclipseSecond.Text), Value(EclipseSecond.Millisecond)
    ), 
    "yy/mm/dd hh:mm:ss.000 AM/PM"
)