Funkcje Date, DateTime i Time
Dotyczy: Aplikacje kanwy Przepływy pulpitu Aplikacje oparte na modelu Power Pages 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"
)