Udostępnij za pośrednictwem

Funkcj Text

  • Artykuł

Dotyczy: Aplikacje kanwy Kolumny z formułami w aplikacjach Dataverse kanwy Interfejs wiersza polecenia aplikacji Power Pages Power Platform opartych na modelu

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 (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 długie) 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ótka) 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 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. Tekst oddziela grupy przecinkami, jeśli format zawiera przecinek ujęty w znaki liczbowe (#) lub 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 powiedział: Wyświetla pełną nazwę dnia (niedziela do sobota).
Rr Wyświetla rok jako liczbę dwucyfrową.
yyyy Wyświetla rok jako liczbę czterocyfrową.
h Wyświetla godzinę jako liczbę bez wiodącego zera.
Gg 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.
ß 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. Tekst zwraca "AM" lub "a" dla czasu od północy do południa oraz "PM" lub "p" dla czasu od południa do północy

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ęzyk formatu niestandardowego: Jak należy interpretować 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 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
[$-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] jest zakładany, jeśli ten symbol zastępczy nie jest obecny podczas uruchamiania 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

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 — 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.

Tekst ( niewpisany )

  • Niewpisane - Wymagane. Obiekt bez typu , który reprezentuje ciąg znaków. 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
Tekst( 1234.59, "####.#" ) Formatuje liczbę, stosując jedno miejsce dziesiętne. „1234.6”
Tekst( 8.9, "#.000" ) Dopełnia część dziesiętną liczby końcowymi zerami, jeśli to konieczne. „8.900”
Tekst( 0.631, "0.#" ) Dopełnia część całkowitą liczby wiodącymi zerami, jeśli to konieczne. „0.6”
Tekst( 12, "#.0#" )
Tekst( 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”
Tekst( 12000, "$ #,###" )
Tekst( 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:
  • d oznacza jednocyfrowy lub dwucyfrowy dzień miesiąca
  • - jako znak literału skopiowany do wyniku
  • mmm dla trzyliterowego skrótu miesiąca
  • - jako inny znak literału skopiowany do wyniku
  • yy oznacza dwucyfrowy skrót roku
 „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 Wynik
Tekst(1234567.89, "[$-fr-FR]# ###,## €", "fr-FR") Pokazuje spację jako separator grupowania, przecinek jako separator dziesiętny i € jako symbol waluty. "1 234 567,89 €"
Tekst(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 €"
Tekst( Data(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"
Tekst( Data(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
Tekst( 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( "2003-01-04" ) ) 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”
Tekst( prawda ) Konwertuje wartość logiczną na ciąg. „prawda”
Text( GUID() ) Konwertuje wygenerowaną wartość GUID na ciąg. "f8b10550-0f12-4f08-9aa3-bb10958bc3ff"
Po lewej( Tekst( GUID()) ), 4 ) Zwraca pierwsze cztery znaki wygenerowanego identyfikatora GUID. "2d9c"