Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Dotyczy:
Aplikacje kanwy Copilot Studio Desktop przepływy formuły Dataverse kolumny Oparte na modelu Aplikacje interfejsu wiersza polecenia platformy Power Platform Funkcje usługi PowerVerse w usłudze Power Pages
Konwertuje wartość i formatuje liczbę lub wartość daty/godziny na ciąg tekstowy.
Opis
Funkcja Text formatuje liczbę lub wartość daty/godziny na podstawie jednego z następujących typów argumentów:
- Wstępnie zdefiniowany format daty/godziny, który można określić za pomocą wyliczenia DateTimeFormat. To podejście jest preferowane w przypadku dat i godzin, ponieważ automatycznie dostosowuje się do języka i regionu każdego użytkownika.
- Format niestandardowy, który składa się z ciągu symboli zastępczych definiujących na przykład, czy w liczbie są pokazywane separatory dziesiętne i daty, czy nazwa miesiąca ma zawierać pełną nazwę, czy skrót nazwy miesiąca lub miesiąc jako liczbę. Power Apps obsługuje podzbióry symboli zastępczych, obsługiwanych w Microsoft Excel. W tym ciągu symbol zastępczy języka określa język, w którym można interpretować pozostałe symbole zastępcze. Jeśli format niestandardowy zawiera kropkę, na przykład symbol zastępczy formatu języka określa, czy kropla jest separatorem dziesiętnym (ja-JP), czy separatorem tysięcy (es-ES).
Zobacz artykuł dotyczący pracy z datami i godzinami, aby uzyskać więcej informacji.
Funkcja Text może również konwertować dowolny typ danych na reprezentację tekstową przy użyciu formatu domyślnego. W tym celu należy przekazać wartości nietekstowe do funkcji tekstowych, takich jak Len, Right i IsMatch.
Wstępnie zdefiniowane formaty daty/godziny
W przypadku tych przykładów data i godzina wykorzystano wtorek, 7 kwietnia 2020 8:26:59.180 PM, w strefie czasowej UTC-7 godzin.
| Wyliczenie DateTimeFormat | Opis | Przykłady (korzystając z en-US) |
|---|---|---|
| LongDate (Długa data) | Pełny rok, nazwa miesiąca, dzień miesiąca i dzień tygodnia. Nazwy miesiąca i dnia tygodnia nie są skrócone. | „Wtorek, 7 kwietnia 2020” |
| LongDateTime (Godzina i godzina) | Pełny rok, nazwa miesiąca, dzień miesiąca i dzień tygodnia oraz godzina (zegar 12-godzinny), minuty, sekundy i oznaczenie AM/PM. Nazwy miesiąca i dnia tygodnia nie są skrócone. | „Wtorek, 7 kwietnia 2020 8:26:59 PM” |
| LongDateTime24 powiedział: | Pełny rok, nazwa miesiąca, dzień miesiąca i dzień tygodnia oraz godzina (zegar 24-godzinny), minuty i sekundy. Nazwy miesiąca i dnia tygodnia nie są skrócone. | „Wtorek, 7 kwietnia 2020 20:26:59” |
| Długoletni | Godzina (zegar 12-godzinny), minuty, sekundy i oznaczenie AM/PM. | „8:26:59 PM” |
| LongTime24 powiedział: | Godzina (zegar 24-godzinny), minuty, sekundy. | „20:26:59” |
| Krótka data | Czterocyfrowy rok, miesiąc wyrażony liczbowo i dzień miesiąca. | „4/7/2020” |
| ShortDateTime (Godzina krótkiej daty) | Czterocyfrowy rok, miesiąc wyrażony liczbowo i dzień miesiąca oraz godzina (zegar 12-godzinny), minuty i oznaczenie AM/PM. | „4/7/2020 8:26 PM” |
| ShortDateTime24 powiedział: | Czterocyfrowy rok, miesiąc wyrażony liczbowo i dzień miesiąca oraz godzina (zegar 24-godzinny) i minuty. | „4/7/2020 20:26” |
| Krótki czas | Godzina (zegar 12-godzinny), minuty i oznaczenie AM/PM. | „8:26 PM” |
| Krótki czas24 | Godzina (zegar 24-godzinny) i minuty. | „20:26” |
| UTC | Wartość daty/godziny jest konwertowana na czas UTC zgodnie z bieżącą strefą czasową użytkownika i formatowana zgodnie ze standardem ISO 8601. | „2020-04-08T 03:26:59.180Z” |
Symbole zastępcze liczb
| Symbol zastępczy | Opis |
|---|---|
| 0 (zero) | Wyświetla nieznaczące zera, jeśli liczba ma mniej cyfr niż jest zer w formacie. Na przykład użyj formatu #.00, jeśli chcesz wyświetlić liczbę 8.9 jako 8.90. |
| # | Te same reguły co w przypadku symbolu zastępczego 0 (zero). Jednak nie zwraca dodatkowych zer, Text gdy liczba ma mniej cyfr po obu stronach dziesiętnych niż symbole #w formacie. Na przykład jest wyświetlana liczba 8.9, jeśli niestandardowy format to #.##, a liczba do sformatowania to 8.9. |
| . (kropka) | Wyświetla przecinek dziesiętny w liczbie. Zależy od języka niestandardowego formatu; zobacz aplikacje globalne, aby poznać więcej szczegółów. |
| , (przecinek) | Wyświetla w liczbie separator grupowania zwykle używany do rozdzielania tysięcy. Text rozdziela grupy przecinkami, jeśli format zawiera przecinek, który jest ujęta przez znaki liczbowe (#) lub przez zera. Zależy od języka niestandardowego formatu; zobacz aplikacje globalne, aby poznać więcej szczegółów. |
Jeśli liczba ma więcej cyfr po prawej stronie przecinka dziesiętnego niż symboli zastępczych w formacie, to liczba zostanie zaokrąglona do tylu miejsc dziesiętnych, ile jest symboli zastępczych. Jeśli liczba ma więcej cyfr po lewej stronie przecinka dziesiętnego niż jest symboli zastępczych, to dodatkowe cyfry są wyświetlane. Jeśli format zawiera tylko znaki cyfry (#) po lewej stronie przecinka dziesiętnego, liczby mniejsze od 1 będą zaczynać się przecinkiem dziesiętnym (na przykład .47).
Symbole zastępcze daty i godziny
| Symbol zastępczy | Opis |
|---|---|
| m | Wyświetla miesiąc jako liczbę bez wiodącego zera. |
| mm | Wyświetla miesiąc jako liczbę z wiodącym zerem, jeśli jest potrzebne. |
| mmm | Wyświetla miesiąc jako skrót (sty do gru). |
| mmmm | Wyświetla pełną nazwę miesiąca (styczeń do grudzień). |
| d | Wyświetla dzień jako liczbę bez wiodącego zera. |
| dd | Wyświetla dzień jako liczbę z wiodącym zerem, jeśli jest potrzebne. |
| ddd | Wyświetla dzień jako skrót (nie do sob). |
| dddd | Wyświetla pełną nazwę dnia (niedziela do sobota). |
| yy | Wyświetla rok jako liczbę dwucyfrową. |
| yyyy | Wyświetla rok jako liczbę czterocyfrową. |
| h | Wyświetla godzinę jako liczbę bez wiodącego zera. |
| hh | Wyświetla godzinę jako liczbę z wiodącym zerem, jeśli jest potrzebne. Jeśli format zawiera oznaczenie AM lub PM, godzina jest wyświetlana w formacie 12-godzinnym. W przeciwnym przypadku godzina jest wyświetlana za pomocą zegara 24-godzinnego. |
| m | Wyświetla minuty jako liczbę bez wiodącego zera. Ten symbol zastępczy musi pojawić się natychmiast po kodzie h lub hh lub bezpośrednio przed kodem ss ; Text w przeciwnym razie zwraca miesiąc zamiast minut. |
| mm | Wyświetla minuty jako liczbę z wiodącym zerem, jeśli jest potrzebne. Ten symbol zastępczy musi występować bezpośrednio po symbolu zastępczym h lub hh albo bezpośrednio przed symbolem zastępczym ss. Text W przeciwnym razie zwraca miesiąc zamiast minut. |
| s | Wyświetla sekundy jako liczbę bez wiodącego zera. |
| ss | Wyświetla sekundy jako liczbę z wiodącym zerem, jeśli jest potrzebne. |
| f | Wyświetla ułamki sekundy. |
| AM/PM,a/p | Wyświetla godzinę na podstawie zegara 12-godzinnego. Text zwraca wartość "AM" lub "a" dla godzin od północy do południa i "PM" lub "p" dla godzin od południa do północy |
Symbole zastępcze literałów
Możesz umieścić dowolny z tych znaków w ciągu formatu. Będą one wyświetlane w wyniku tego, Text jak to jest. Dodatkowe znaki są zastrzeżone dla przyszłych symboli zastępczych, więc nie należy ich używać.
| Znak | Opis |
|---|---|
| Dowolny symbol waluty | Znak dolara, centów, euro itp. |
| + | Znak plus |
| ( | Lewy nawias okrągły |
| : | Dwukropek |
| ^ | Akcent przeciągły (daszek) |
| ' | Apostrof |
| { | Lewy nawias klamrowy |
| < | Znak mniejszości |
| = | Znak równości |
| - | Znak minus |
| / | Ukośnik |
| ) | Prawy nawias okrągły |
| & | Et |
| ~ | Tylda |
| } | Prawy nawias klamrowy |
| > | Znak większości |
| Znak spacji |
Aplikacje globalne
Funkcja Text jest globalnie świadoma. W przypadku dużej liczby języków „wie”, jak poprawnie zapisać daty, godziny, waluty i liczby. Aby to zrobić, potrzebuje dwóch informacji:
- Język formatu niestandardowego: Jak powinien być interpretowany format niestandardowy dla twórców? Znaki separatora (. i ,) mają różne znaczenie w różnych językach. W przypadku określenia formatu niestandardowego można dodać symbol zastępczy języka lub ustawić wartość domyślną, która odzwierciedla język, w którym jest ustawiane urządzenie. Jeszcze prościej, można użyć jednego z predefiniowanych formatów data/godzina, które nie zależą od języka.
- Język wyniku: W jakim języku powinien być wyświetlany wynik funkcji dla użytkowników? Nazwy miesięcy i dni powszednie muszą być w odpowiednim języku dla użytkownika aplikacji, który można określić przez dodanie trzeciego, opcjonalnego argumentu Text do funkcji.
W przypadku obu typów język można określić przy użyciu tagu języka. Aby wyświetlić listę obsługiwanych języków, wpisz Text( 1234, "", ) na pasku formuły lub karcie Zaawansowane okienka po prawej stronie, a następnie przewiń listę ustawień regionalnych sugerowanych dla trzeciego argumentu.
Symbol zastępczy języka
Aby określić język niestandardowego formatu, użyj następujących symboli:
| Symbol zastępczy | Opis |
|---|---|
| [$-Znacznik języka] | LanguageTag jest tagiem języka zwracanym przez funkcję Language . Może określać tylko język (np. [$-en] dla języka angielskiego) lub może także określać region (np. [$-en-GB], aby bardziej szczegółowo określić Wielką Brytanię). |
Symbol zastępczy języka może występować w dowolnym miejscu niestandardowego formatu, ale tylko raz.
Jeśli zostanie określony format niestandardowy bez symbolu zastępczego języka, a format jest niejednoznaczny w stosunku globalnym, znacznik języka w bieżącym języku jest wstawiany automatycznie.
[$-en-US] zakłada się, że ten symbol zastępczy nie jest obecny po uruchomieniu aplikacji.
Uwaga
W przyszłej wersji składnia symbolu zastępczego może ulec zmianie, aby uniknąć mylenia go z podobnym, lecz innym symbolem zastępczym obsługiwanym przez program Excel.
Tag języka wyniku
Wynik obejmuje Text przetłumaczone ciągi miesięcy, dni powszednie i oznaczenia AM/PM, a także odpowiednie separatory grup i dziesiętne.
Domyślnie Text używa języka użytkownika uruchamiającego aplikację. Funkcja Language zwraca tag języka dla bieżącego użytkownika. Tę wartość domyślną można zastąpić, podając tag języka dla trzeciego argumentu na Text.
Składnia
Text( NumberOrDateTime, DateTimeFormatEnum [, ResultLanguageTag ] )
- NumberOrDateTime - wymagane. Liczba lub wartość daty/godziny do sformatowania.
- DateTimeFormat - Wymagane. Element wyliczenia DateTimeFormat.
- ResultLanguageTag - Opcjonalne. Tag języka używany dla tekstu wynikowego. Domyślnie jest używany język bieżącego użytkownika.
Text( NumberOrDateTime, CustomFormat [, ResultLanguageTag ] )
- Liczba - Wymagane. Liczba lub wartość daty/godziny do sformatowania.
- CustomFormat - Wymagane. Co najmniej jeden symbol zastępczy w cudzysłowie.
- ResultLanguageTag - Opcjonalne. Tag języka używany dla tekstu wynikowego. Domyślnie jest używany język bieżącego użytkownika.
Text( AnyValue )
- AnyValue - Wymagane. Wartość do konwersji na reprezentację tekstową. Używany jest format domyślny.
Text ( Dynamiczny )
- Dynamiczny — wymagany. Wartość dynamiczna reprezentująca ciąg. Dopuszczalne wartości są zależne od niewpisanego dostawcy. W przypadku formatu JSON, jeśli wartość dynamiczna jest liczbą lub wartością logiczną, zostanie przekonwertowana na tekst.
Przykłady
Jeżeli nie określono inaczej, użytkownik uruchamiający formuły znajduje się na terenie Stanów Zjednoczonych i wybrał jako język angielski. Funkcja Language zwraca ciąg „en-US”.
Numer
| Wzór | Opis | Wynik |
|---|---|---|
| Text( 1234.59, "####.#" ) | Formatuje liczbę, stosując jedno miejsce dziesiętne. | „1234.6” |
| Text( 8.9, "#.000" ) | Dopełnia część dziesiętną liczby końcowymi zerami, jeśli to konieczne. | „8.900” |
| Text( 0.631, "0.#" ) | Dopełnia część całkowitą liczby wiodącymi zerami, jeśli to konieczne. | „0.6” |
|
Text( 12, "#.0#" ) Text( 1234.568, "#.0#" ) |
Dopełnia część dziesiętną liczby zerami do jednego miejsca dziesiętnego i dołącza drugie miejsce dziesiętne, jeśli jest podane. | „12.0” „1234.57” |
|
Text( 12000, "$ #,##" ) Text( 1200000, "$ #,##" ) |
Umieszcza separator tysięcy co trzy cyfry i dołącza symbol waluty. | "$ 12,000" "$ 1,200,000" |
Data/godzina
- Godzina 2:37:47 PM w poniedziałek, 23 listopada 2015
- Czas pacyficzny Stanów Zjednoczonych (UTC-8)
| Wzór | Opis | Wynik |
|---|---|---|
| Text( Now(), DateTimeFormat.LongDate ) | Formatuje jako długi ciąg daty w języku i za pomocą ustawień regionalnych bieżącego użytkownika. | „Monday, November 23, 2015” |
| Text( Now(), DateTimeFormat.LongDateTime ) | Formatuje jako długi ciąg daty i godziny (zegar 12-godzinny) w języku i za pomocą ustawień regionalnych bieżącego użytkownika. | „Monday, November 23, 2015 2:37:47 PM” |
| Text( Now(), DateTimeFormat.LongTime24 ) | Formatuje jako długi ciąg godziny (zegar 24-godzinny). | „14:37:47” |
| Text( Now(), DateTimeFormat.ShortDate ) | Formatuje jako krótki ciąg daty w języku i za pomocą ustawień regionalnych bieżącego użytkownika. | „11/23/2015” |
| Text( Now(), "d-mmm-yy" ) | Formatuje przy użyciu symboli zastępczych:
|
„23-Lis-15” |
| Text(1448318857*1000, "mmm. dd, rrrr (hh:mm:ss AM/PM)") | Wyświetlanie wartości daty i godziny systemu Unix w formacie czytelnym dla użytkownika, jeśli wartość źródłowa jest mnożona przez 1 000. | „Lis. 23, 2015 (02:47:37 PM)” |
Aplikacje globalne
| Wzór | Opis | Wynik |
|---|---|---|
| Text(1234567.89, "[$-fr-FR]# ##,## €", "fr-FR") | Pokazuje spację jako separator grupowania, przecinek jako separator dziesiętny i € jako symbol waluty. | "1 234 567,89 €" |
| Text(1234567,89; "[$-fr-FR]# ##,## €") | Jeśli dane źródłowe są zgodne z francuskim zwyczajem używania przecinka jako separatora dziesiętnego, musisz zmienić ustawienia regionalne na francuski i oddzielić argumenty średnikiem zamiast przecinka, aby uzyskać taki sam wynik jak powyżej. | "1 234 567,89 €" |
| Text( Date(2016,1,31), "dddd mmmm d" ) | Zwraca dzień tygodnia, miesiąc i dzień miesiąca w języku bieżącego użytkownika. Ponieważ żaden z symboli zastępczych nie zależy od języka, nie ma potrzeby stosowanie tagu języka w ciągu formatu. | "Niedziela 31 stycznia" |
| Text( Date(2016,1,31), "dddd mmmm d", "es-ES" ) | Zwraca dzień tygodnia, miesiąc i dzień miesiąca w języku „es-ES”. | "santo enero 31" |
Konwersja wartości na tekst
| Wzór | Opis | Wynik |
|---|---|---|
| Text( 1234567.89 ) | Konwertuje liczbę na ciąg. Brak separatora tysięcy lub kontroli nad liczbą cyfr przed lub za separatorem dziesiętnym; Aby zwiększyć kontrolę, jako drugi argument należy podać symbole zastępcze liczb. | „1234567.89” |
| Text( DateTimeValue( "01/04/2003" ) ) | Konwertuje wartość daty/godziny na ciąg tekstowy. Aby kontrolować konwersję, należy przekazać element z wyliczenia DateTimeFormat lub ciągu w formacie niestandardowym. | „1/4/2003 12:00 AM” |
| Text( true ) | Konwertuje wartość logiczną na ciąg. | „prawda” |
| Text( GUID() ) | Konwertuje wygenerowaną wartość GUID na ciąg. | "f8b10550-0f12-4f08-9aa3-bb10958bc3ff" |
| Left( Text( GUID() ), 4 ) | Zwraca pierwsze cztery znaki wygenerowanego identyfikatora GUID. | "2d9c" |