Funkcje DateValue, TimeValue i DateTimeValue

  • Artykuł

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

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

Opis

  • Funkcja DateValue konwertuje ciąg daty (np. „10/01/2014”) na wartość daty/godziny.

  • Funkcja TimeValue konwertuje ciąg godziny (np. „12:15 PM”) na wartość daty/godziny.

  • Funkcja DateTimeValue konwertuje ciąg daty i godziny (np. „10 stycznia, 2013 roku 12:13 AM”) na wartość daty/godziny.

Funkcja DateValue ignoruje wszelkie informacje dotyczące godziny znajdujące się w ciągu daty, a funkcja TimeValue ignoruje wszelkie informacje dotyczące daty znajdujące się w ciągu godziny.

Uwaga

Domyślnie funkcje DateValue, TimeValue i DateTimeValue używają języka z ustawień bieżącego użytkownika. Można to zmienić, aby upewnić się, że ciągi są poprawnie interpretowane. Na przykład wartość „10/1/1920” jest interpretowana jako 1 października w przypadku ustawienia języka „en” oraz jako 10 stycznia w przypadku języka „pl”.

Data musi mieć jeden 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:

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.
  • Language – opcjonalne. 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( Untyped )
DateTimeValue( Untyped )
TimeValue( Untyped )

  • Bez typu — wymagane. Obiekt bez typu reprezentujący datę lub godzinę. Dopuszczalne wartości są zależne od niewpisanego dostawcy. W przypadku JSON obiekt bez typu powinien być ciągiem JSON zawierającym datę i godzinę w formacie ISO 8601. Daty lub godziny w innych formatach spowodują 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.

W przypadku wpisania zamiast tego ciągu 20 października 2014:

  • 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!”.