DateValue, TimeValuei DateTimeValue funkcje

Dotyczy: Aplikacje kanwy Copilot Studio Desktop przepływy oparte na modelu Aplikacje oparte na modelu Interfejs wiersza polecenia platformy PowerVerse funkcje Power Pages

Konwertuje datę i/lub godzinę w ciągu na wartość daty/godziny.

Opis

• DateValue funkcja konwertuje ciąg daty (na przykład "10.01.2014") na wartość daty/godziny .

• TimeValue funkcja konwertuje ciąg czasu (na przykład "12:15 PM") na wartość daty/godziny .

• DateTimeValue funkcja konwertuje ciąg daty i godziny (na przykład "10 stycznia 2013 12:13") na wartość daty/godziny .

DateValue funkcja ignoruje wszelkie informacje o czasie w ciągu daty, a TimeValue funkcja ignoruje wszelkie informacje o dacie w ciągu godziny.

Daty muszą używać jednego z następujących formatów:

• MM/DD/RRRR lub MM-DD-RRRR
• DD/MM/RRRR lub DD-MM-RRRR
• RRR/MMDD lub RRRR-MM-DD
• MM/DD/RR lub MM-DD-RR
• DD/MM/RR lub DD-MM-RR
• DD Mies. RRRR
• Mies. DD, RRRR

Aby przekonwertować składniki daty, miesiąca i roku na wartość liczbową, należy odczytać Date.
Aby dokonać konwersji z liczbowych godzin, minut i sekund na składniki numeryczne, odczytaj Time.

Aby uzyskać więcej informacji, zobacz:

• Praca z datą i godziną
• Data/godzina i typy danych

Składnia

DateValue( Ciąg [, język] )
DateTimeValue( Ciąg [, język ] )
TimeValue( Ciąg [, język ] )

• Ciąg - wymagane. Ciąg tekstowy zawierający datę, godzinę lub wartość stanowiącą połączenie daty i godziny.
• Język - opcjonalny. Ciąg języka – dwa pierwsze znaki wartości uzyskanej za pomocą funkcji Language. Jeśli ta wartość nie jest określona, jest używany język bieżących ustawień.

DateValue( Dynamiczny )
DateTimeValue( Dynamiczny )
TimeValue( Dynamiczny )

• Dynamiczny — wymagany. Wartość dynamiczna reprezentująca datę lub godzinę. Dopuszczalne wartości są zależne od niewpisanego dostawcy. W przypadku formatu JSON wartość dynamiczna powinna być ciągiem JSON zawierającym datę i godzinę w formacie ISO 8601. Daty lub godziny w innych formatach powodują błąd. Rozważ przekonwertowanie takich wartości najpierw na Text, a następnie na datę lub godzinę. Pamiętaj, że strefy czasowe i formaty związane z ustawieniami regionalnymi są ważnymi kwestiami podczas komunikowania się z systemami zewnętrznymi.

Przykłady

DateValue

Jeśli w kontrolce wprowadzania danych o nazwie Startdate został wpisany ciąg 10/11/2014, a właściwość Tekst etykiety została ustawiona na funkcję:

• Należy przekonwertować datę z ciągu w ustawieniach regionalnych użytkownika i wyświetlić wynik jako długą datę.

  Text( DateValue( Startdate.Text ), DateTimeFormat.LongDate )
  

  W rozwiązaniu z urządzeniem ustawionym na region en wyświetlana jest etykieta w formacie Sobota, 11 października 2014.

  Uwaga

  Z typem enum DateTimeFormat można skorzystać z szeregu opcji. Aby wyświetlić listę opcji, wpisz parametr, a po nim kropkę lub przecinek (.) na pasku formuł albo sprawdź informacje dot. funkcji Text.

• Należy przekonwertować datę z ciągu we francuskich ustawieniach regionalnych użytkownika i wyświetlić wynik jako długą datę. W tym przykładzie miesiące i dni miesiąca są interpretowane inaczej niż w języku angielskim.

  Text( DateValue( Startdate.Text, "fr" ), DateTimeFormat.LongDate )
  

  W rozwiązaniu z urządzeniem ustawionym na region en wyświetlana jest etykieta w formacie Poniedziałek, Listopad 10, 2014.

Jeśli wprowadzisz 20 października 2014 r. :

• Konwertowanie daty na podstawie ciągu w ustawieniach regionalnych użytkownika i obliczenie różnicy między dwiema dniami (w dniach)

  DateDiff( DateValue( Startdate.Text ), Today() )
  

  W urządzeniu z ustawioną wartością regionu en etykieta będzie wyświetlona jako 9, wskazując liczbę dni od 11 października do 20 października. Funkcja DateDiff umożliwia także wyświetlenie różnicy w kontekście miesięcy, kwartałów i lat.

DateTimeValue

Jeśli w kontrolce wprowadzania danych o nazwie Start został wpisany ciąg 10/11/2014 1:50:24.765 PM, a właściwość Text etykiety została ustawiona na następującą formułę:

• Przekonwertuj łańcuch daty i godziny w bieżących ustawieniach regionalnych.

  Text( DateTimeValue( Start.Text ), DateTimeFormat.LongDateTime )
  

  W rozwiązaniu z urządzeniem ustawionym na region en wyświetlana jest etykieta w formacie Sobota, 11 października 2014 1:50:24 PM.

  Uwaga

  Z typem enum DateTimeFormat można skorzystać z szeregu opcji. Aby wyświetlić listę opcji, wpisz parametr, a po nim kropkę lub przecinek (.) na pasku formuł albo sprawdź informacje dot. funkcji Text.

• Przekonwertuj łańcuch daty i godziny na polskie ustawienia regionalne. Miesiąc i dzień miesiąca są interpretowane w różny sposób.

  Text( DateTimeValue( Start.Text, "fr"), DateTimeFormat.LongDateTime )
  

  W rozwiązaniu z urządzeniem ustawionym na region en wyświetlana jest etykieta w formacie Poniedziałek, listopad 10 2014 1:50:24 PM.

• Konwertowanie ciągu daty i godziny w ustawieniach regionalnych użytkownika i wyświetlenie wyniku z częściową sekundą.

  Text( DateTimeValue( Start.Text ), "dddd, mmmm dd, yyyy hh:mm:ss.fff AM/PM" )
  

  W rozwiązaniu z urządzeniem ustawionym na region en wyświetlana jest etykieta w formacie Sobota, 11 października 2014 01:50:24.765 PM.

  Alternatywnie można też określić ustawienie hh:mm:ss.f lub hh:mm:ss.ff, aby zaokrąglić godzinę do najbliższej części dziesiętnej lub setnej sekundy.

TimeValue

Nadaj kontrolce wprowadzania danych nazwę FinishedAt i ustaw dla właściwości Tekst etykiety następującą funkcję:

If( TimeValue( FinishedAt.Text ) < TimeValue( "5:00:00.000 PM" ),
    "You made it!",
    "Too late!"
)

• W przypadku wpisania wartości 4:59:59.999 PM PM w kontrolce FinishedAt na etykiecie będzie wyświetlany ciąg „Udało się!”
• W przypadku wpisania wartości 5:00:00.000 PM PM w kontrolce FinishedAt na etykiecie będzie wyświetlany ciąg „Za późno!”.