Funkcje Date, DateTime i Time

  • Artykuł

Dotyczy: Aplikacje oparte na kanwie Przepływy pulpitu Aplikacje oparte na modelach Power Platform CLI

Konwertuje datę i godzinę na składniki wartości daty/godziny.

Popis

Funkcja Date konwertuje poszczególne wartości roku, miesiąca i dnia na wartość daty/godziny. Część godzinowa to północ.

  • Jeśli wartość roku jest z zakresu od 0 do 1899 (włącznie), funkcja dodaje tę wartość do wartości 1900 w celu obliczenia roku. Ciąg 70 staje się ciągiem 1970.
  • W przypadku wartości miesiąca wynoszącej mniej niż 1 lub więcej niż 12 wynik jest tworzony przez odjęcie lub dodanie odpowiedniej liczby miesięcy względem początku danego roku.
  • Jeśli wartość dnia jest większa niż liczba dni w danym miesiącu, funkcja dodaje tę liczbę dni do pierwszego dnia miesiąca i zwraca odpowiednią datę z kolejnego miesiąca. Jeśli wartość dnia jest mniejsza niż 1, funkcja odejmuje tę liczbę dni powiększoną o 1 od pierwszego dnia określonego miesiąca.

Funkcja Time konwertuje poszczególne wartości godziny, minuty, sekundy i opcjonalnie milisekundy na wartość daty/godziny. Z wynikiem tym nie jest skojarzona data.

Funkcja DateTime łączy funkcje Date i Time w jedną funkcję, podejmowania argumentów daty i godzin oraz zwracania wartości Data/Time, która zawiera składniki data i godzina.

Aby uzyskać informacje na temat sposobu konwertowania ciągu na wartość, zobacz opisy funkcji DateValue, TimeValue, i DateTimeValue.

Więcej informacji można także uzyskać w artykule na temat pracy z datami i godzinami.

Składnia

Date( Rok, Miesiąc, Dzień )

  • Rok – wymagane. Liczby większe niż 1899 są interpretowane jako bezwzględne (wartość 1980 jest interpretowana jako rok 1980); liczby z zakresu od 0 do 1899 są interpretowane względem roku 1900. (Na przykład wartość 80 jest interpretowany jako rok 1980).
  • Miesiąc – wymagane. Liczba z zakresu od 1 do 12.
  • Dzień – wymagane. Liczba z zakresu od 1 do 31.

Time( Godzina, Minuta, Sekunda [, Milisekundy ] )

  • Godzina – wymagane. Liczba godzin, zazwyczaj w zakresie od 0 (00:00) do 23 (23:00).
  • Minuta – wymagane. Liczba minut, normalnie z zakresu od 0 do 59.
  • Sekunda – wymagane. Liczba sekund, normalnie z zakresu od 0 do 59.
  • Milisekundy — opcjonalne. Liczba milisekund, normalnie z zakresu od 0 do 999.

DateTime( Rok, Miesiąc, Dzień, Godzina, Minuta, Sekunda [, Milisekundy ] )

  • Rok – wymagane. Liczby większe niż 1899 są interpretowane jako bezwzględne (wartość 1980 jest interpretowana jako rok 1980); liczby z zakresu od 0 do 1899 są interpretowane względem roku 1900. (Na przykład wartość 80 jest interpretowany jako rok 1980).
  • Miesiąc – wymagane. Liczba z zakresu od 1 do 12.
  • Dzień – wymagane. Liczba z zakresu od 1 do 31.
  • Godzina – wymagane. Liczba godzin, zazwyczaj w zakresie od 0 (00:00) do 23 (23:00)
  • Minuta – wymagane. Liczba minut, normalnie z zakresu od 0 do 59.
  • Sekunda – wymagane. Liczba sekund, normalnie z zakresu od 0 do 59.
  • Milisekundy — opcjonalne. Liczba milisekund, normalnie z zakresu od 0 do 999.

Przykłady

Date

Jeśli użytkownik wpisze

  • 1979 w kontrolce tekstowej o nazwie HireYear
  • 3 w kontrolce tekstowej o nazwie HireMonth
  • 17 w kontrolce tekstowej o nazwie HireDay

Ta formuła zwraca 3/17/1979:

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

Czas

Jeśli użytkownik wpisze

  • 14 w kontrolce tekstowej o nazwie BirthHour
  • 50 w kontrolce tekstowej o nazwie BirthMinute
  • 24 w kontrolce tekstowej o nazwie BirthSecond

Ta formuła zwraca 02:50:24 P:

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

DateTime

Jeśli użytkownik wpisze

  • 2023 w kontrolce tekstowej o nazwie EclipseYear
  • 10 w kontrolce tekstowej o nazwie EclipseMonth
  • 28 w kontrolce tekstowej o nazwie EclipseDate
  • 13 w kontrolce tekstowej o nazwie EclipseHour
  • 14 w kontrolce tekstowej o nazwie EclipseMinute
  • 5 w kontrolce tekstowej o nazwie EclipseSecond
  • 231 w kontrolce tekstowej o nazwie EclipseMilisecond

Ta formuła zwraca 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"
)