Funkcj Text
Dotyczy:
Aplikacje oparte na kanwie Aplikacje oparte na kanwie Kolumny formuły Dataverse Model-driven apps Power Platform CLI
Konwertuje wartość i formatuje liczbę lub wartość daty/godziny na ciąg tekstowy.
Opis
Funkcja Text formatuje liczbę lub wartość daty/godziny na podstawie argumentu jednego z następujących typó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.
Oprócz tego, funkcja Text może przekonwertować dowolny typ danych na tekst reprezentujący format domyślny. 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 | 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 | 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 | 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” |
| LongTime | Godzina (zegar 12-godzinny), minuty, sekundy i oznaczenie AM/PM. | „8:26:59 PM” |
| LongTime24 | Godzina (zegar 24-godzinny), minuty, sekundy. | „20:26:59” |
| ShortDate | Czterocyfrowy rok, miesiąc wyrażony liczbowo i dzień miesiąca. | „4/7/2020” |
| ShortDateTime | 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 | Czterocyfrowy rok, miesiąc wyrażony liczbowo i dzień miesiąca oraz godzina (zegar 24-godzinny) i minuty. | „4/7/2020 20:26” |
| ShortTime | Godzina (zegar 12-godzinny), minuty i oznaczenie AM/PM. | „8:26 PM” |
| ShortTime24 | 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 funkcja Tekst nie zwraca dodatkowych zer, jeśli liczba ma mniej cyfr po dowolnej stronie przecinka dziesiętnego, niż jest symboli # 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. Funkcja Text rozdziela grupy przecinkami, jeśli format zawiera przecinek otoczony znakami cyfry (#) lub zerami. 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 występować bezpośrednio po kodzie h lub hh albo bezpośrednio przed kodem ss. W przeciwnym razie funkcja Tekst zwróci 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. W przeciwnym razie funkcja Tekst zwróci 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. Funkcja Tekst zwraca ciąg „AM”, „am”, „A” lub „a” dla godzin między północą a południem oraz „PM”, „pm”, „P” lub „p” dla godzin między południem a północą |
Symbole zastępcze literałów
Możesz umieścić dowolny z tych znaków w ciągu formatu. Zostaną one umieszczone w wyniku funkcji Tekst bez zmian. 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 obsługuje globalizację. 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ęzyka niestandardowego formatu: jak, w przypadku twórców, należy interpretować niestandardowy format? 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: Dla użytkowników, w jakim języku powinien pojawić się wynik funkcji? Nazwy miesięcy i dni tygodnia muszą znajdować się w odpowiednim języku użytkownika aplikacji, który można podać przez dodanie trzeciego, opcjonalnego argumentu do funkcji Text.
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 na karcie Zaawansowane w okienku po prawej stronie i 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 |
|---|---|
| [$-LanguageTag] | LanguageTag to tag języka w postaci zwracanej 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.
Jeśli ten symbol zastępczy nie jest obecny podczas uruchamiania aplikacji, zostanie użyty język [$-en-US].
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
W wyniku funkcji Tekst znajdują się przetłumaczone ciągi miesięcy, dni tygodnia i oznaczenia AM/PM, a także odpowiednie separatory grup i miejsca dziesiętnego.
Domyślnie funkcja Tekst używa języka użytkownika uruchamiającego aplikację. Funkcja Language zwraca tag języka dla bieżącego użytkownika. Możesz zastąpić tę wartość domyślną, podając tag języka w trzecim argumencie funkcji Tekst.
Składnia
Text( NumberOrDateTime, DateTimeFormatEnum [, ResultLanguageTag ] )
- NumberOrDateTime - wymagany. Liczba lub wartość daty/godziny do sformatowania.
- DateTimeFormat - wymagany. Element wyliczenia DateTimeFormat.
- ResultLanguageTag- opcjonalny. Tag języka używany dla tekstu wynikowego. Domyślnie jest używany język bieżącego użytkownika.
Text( NumberOrDateTime, CustomFormat [, ResultLanguageTag ] )
- Number — wymagane. Liczba lub wartość daty/godziny do sformatowania.
- CustomFormat - wymagany. Co najmniej jeden symbol zastępczy w cudzysłowie.
- ResultLanguageTag- opcjonalny. Tag języka używany dla tekstu wynikowego. Domyślnie jest używany język bieżącego użytkownika.
Text( AnyValue )
- AnyValue - wartość wymagana Wartość do konwersji na reprezentację tekstową. Używany jest format domyślny.
Text ( Untyped )
- Bez typu — wymagane. Obiekt bez typu reprezentujący identyfikator ciągu. Dopuszczalne wartości są zależne od niewpisanego dostawcy. Jeśli dla JSON obiekt bez typu jest liczbą lub wartością logiczną, zostanie on przekonwertowany 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, yyyy (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 | Result |
|---|---|---|
| Text(1234567.89, "[$-fr-FR]# ###,## €", "fr-FR") | Obszar jest wyświetlany jako separator grupowania, przecinek jako separator dziesiętny, a € 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. | "Sunday January 31" |
| Text( Date(2016,1,31), "dddd mmmm d", "es-ES" ) | Zwraca dzień tygodnia, miesiąc i dzień miesiąca w języku „es-ES”. | "domingo 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" |