Udostępnij za pośrednictwem

Funkcje Date, DateTime i Time

  • Artykuł

Dotyczy: Aplikacje kanwy Przepływy pulpitu Aplikacje oparte na modelu Interfejs Power Pages Power Platform wiersza polecenia aplikacji opartych na modelu

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. 70 staje się rokiem 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

Data( 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.

Czas ( 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.
  • Drugi - wymagany. Liczba sekund, normalnie z zakresu od 0 do 59.
  • Milisekundy — opcjonalnie. 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.
  • Drugi - wymagany. Liczba sekund, normalnie z zakresu od 0 do 59.
  • Milisekundy — opcjonalnie. Liczba milisekund, normalnie z zakresu od 0 do 999.

Przykłady

Date

Jeśli użytkownik wpisze

  • 1979 w kontrolce wprowadzania tekstu o nazwie HireYear
  • 3 w kontrolce wprowadzania tekstu o nazwie HireMonth
  • 17 w kontrolce wprowadzania tekstu 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 wprowadzania tekstu o nazwie BirthHour
  • 50 w kontrolce wprowadzania tekstu o nazwie BirthMinute
  • 24 w kontrolce wprowadzania tekstu 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 wprowadzania tekstu o nazwie EclipseYear
  • 10 w kontrolce wprowadzania tekstu o nazwie EclipseMonth
  • 28 w kontrolce wprowadzania tekstu o nazwie EclipseDate
  • 13 w kontrolce wprowadzania tekstu o nazwie EclipseHour
  • 14 w kontrolce wprowadzania tekstu o nazwie EclipseMinute
  • 5 w kontrolce wprowadzania tekstu o nazwie EclipseSecond
  • 231 w kontrolce wprowadzania tekstu o nazwie EclipseMillisecond

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"
)