Chức năng văn bản
Áp dụng cho:
Ứng dụng canvas Ứng dụng canvas Dataverse cột công thức Ứng dụng dựa trên mô hình Power Platform CLI
Chuyển đổi giá trị bất kỳ và định dạng giá trị số hoặc ngày/giờ thành chuỗi văn bản.
Mô tả
Hàm Text định dạng một số hoặc một giá trị ngày/giờ dựa trên một trong các loại đối số sau:
- Định dạng ngày/giờ được xác định trước mà bạn chỉ định bằng cách sử dụng hàm liệt kê DateTimeFormat. Đối với ngày và giờ, phương pháp này được ưa thích vì nó tự động điều chỉnh theo từng ngôn ngữ và khu vực của người dùng.
- Một định dạng tùy chỉnh, bao gồm một chuỗi các chỗ dành sẵn xác định xem các số có hiển thị dấu phân tách thập phân hay không và ngày hiển thị tên đầy đủ của tháng, tháng dưới dạng viết tắt hay tháng dưới dạng số chẳng hạn. Power Apps hỗ trợ một tập hợp con các chỗ dành sẵn mà Microsoft Excel tạo ra. Trong chuỗi này, chỗ dành sẵn cho ngôn ngữ chỉ định ngôn ngữ để diễn giải các chỗ dành sẵn khác trong đó. Ví dụ: nếu định dạng tùy chỉnh bao gồm một dấu chấm, thì chỗ dành sẵn có định dạng ngôn ngữ sẽ chỉ định xem dấu chấm đó là dấu phân tách thập phân (ja-JP) hay dấu phân tách hàng nghìn (es-ES).
Xem cách thao tác với ngày và giờ để biết thêm thông tin.
Hàm Text cũng có thể chuyển đổi bất kỳ loại dữ liệu nào thành bản trình bày văn bản bằng định dạng mặc định. Sử dụng hàm này để chuyển các giá trị không phải là văn bản sang các hàm dựa trên văn bản, chẳng hạn như Len, Right và IsMatch.
Định dạng ngày/giờ được xác định trước
Đối với những ví dụ này, ngày và giờ được sử dụng là Tuesday, April 7, 2020 8:26:59.180 PM (8:26:59.180 chiều, thứ Ba, ngày 7 tháng 4 năm 2020) theo múi giờ UTC-7 giờ.
| Hàm liệt kê DateTimeFormat | Mô tả | Ví dụ (sử dụng en-US) |
|---|---|---|
| LongDate | Năm gồm 4 chữ số, tên tháng, ngày trong tháng và ngày trong tuần. Tên của tháng và ngày trong tuần không được viết tắt. | "Tuesday, April 7, 2020" |
| LongDateTime | Năm gồm 4 chữ số, tên tháng, ngày trong tháng và ngày trong tuần, cộng với giờ (đồng hồ 12 giờ), phút, giây và ký hiệu AM/PM. Tên của tháng và ngày trong tuần không được viết tắt. | "Tuesday, April 7, 2020 8:26:59 PM" |
| LongDateTime24 | Năm gồm 4 chữ số, tên tháng, ngày trong tháng và ngày trong tuần, cộng với giờ (đồng hồ 24 giờ), phút và giây. Tên của tháng và ngày trong tuần không được viết tắt. | "Tuesday, April 7, 2020 20:26:59" |
| LongTime | Giờ (đồng hồ 12 giờ), phút, giây và ký hiệu AM/PM. | "8:26:59 PM" |
| LongTime24 | Giờ (đồng hồ 24 giờ), phút, giây. | "20:26:59" |
| ShortDate | Năm gồm 4 chữ số với tháng và ngày trong tháng có dạng số. | "4/7/2020" |
| ShortDateTime | Năm gồm 4 chữ số với tháng và ngày trong tháng có dạng số, cộng với giờ (đồng hồ 12 giờ), phút và ký hiệu AM/PM. | "4/7/2020 8:26 PM" |
| ShortDateTime24 | Năm gồm 4 chữ số với tháng và ngày trong tháng có dạng số, cộng với giờ đồng hồ 24 giờ và phút. | "4/7/2020 20:26" |
| ShortTime | Giờ (đồng hồ 12 giờ), phút và ký hiệu AM/PM. | "8:26 PM" |
| ShortTime24 | Giờ (đồng hồ 24 giờ) và phút. | "20:26" |
| UTC | Giá trị ngày/giờ được chuyển đổi thành UTC dựa trên múi giờ của người dùng hiện tại và được định dạng theo tiêu chuẩn ISO 8601. | "2020-04-08T03:26:59.180Z" |
Chỗ dành sẵn cho số
| Chỗ dành sẵn | Mô tả |
|---|---|
| 0 (số 0) | Hiển thị các số 0 không quan trọng nếu một số có ít chữ số hơn các số 0 trong định dạng. Ví dụ: sử dụng định dạng #.00 nếu bạn muốn hiển thị 8.9 dưới dạng 8.90. |
| # | Tuân theo các quy tắc tương tự như 0 (số 0). Tuy nhiên, hàm Text không trả về các số 0 bổ sung khi số có chữ số ở hai bên của số thập phân ít hơn các ký hiệu # trong định dạng. Ví dụ: 8.9 hiển thị nếu định dạng tùy chỉnh là #.## và số để định dạng là 8.9. |
| . (dấu chấm) | Hiển thị dấu thập phân trong một số. Tùy thuộc vào ngôn ngữ của định dạng tùy chỉnh, hãy xem các ứng dụng toàn cầu để biết thêm chi tiết. |
| , (dấu phẩy) | Hiển thị dấu phân tách nhóm trong một số, thường dùng cho hàng ngàn. Hàm Text phân tách các nhóm bằng dấu phẩy nếu định dạng chứa dấu phẩy được bao quanh bởi dấu số (#) hoặc số 0. Tùy thuộc vào ngôn ngữ của định dạng tùy chỉnh, hãy xem các ứng dụng toàn cầu để biết thêm chi tiết. |
Nếu một số có chữ số ở bên phải dấu thập phân nhiều hơn là chỗ dành sẵn trong định dạng, thì số đó sẽ làm tròn đến số vị trí thập phân tương đương số chỗ dành sẵn. Nếu có chữ số ở bên trái của dấu thập phân nhiều hơn chỗ dành sẵn, thì các chữ số bổ sung sẽ hiển thị. Nếu định dạng chỉ chứa các dấu số (#) ở bên trái của dấu thập phân, thì các số nhỏ hơn 1 sẽ bắt đầu bằng dấu thập phân (ví dụ: .47).
Chỗ dành sẵn cho ngày và giờ
| Chỗ dành sẵn | Mô tả |
|---|---|
| m | Hiển thị tháng dưới dạng số mà không có số 0 đứng đầu. |
| mm | Hiển thị tháng dưới dạng số với số 0 đứng đầu khi thích hợp. |
| mmm | Hiển thị tháng dưới dạng viết tắt (Jan (Tháng 1) đến Dec (Tháng 12)). |
| mmmm | Hiển thị tháng dưới dạng tên đầy đủ (January (Tháng Giêng) đến December (Tháng Mười Hai)). |
| d | Hiển thị ngày dưới dạng số mà không có số 0 đứng đầu. |
| dd | Hiển thị ngày dưới dạng số với số 0 đứng đầu khi thích hợp. |
| ddd | Hiển thị ngày dưới dạng viết tắt (Sun (CN) đến Sat (Thứ 7)). |
| dddd | Hiển thị ngày dưới dạng tên đầy đủ (Sunday (Chủ Nhật) đến Saturday (Thứ Bảy)). |
| yy | Hiển thị năm dưới dạng một số có 2 chữ số. |
| yyyy | Hiển thị năm dưới dạng một số có 4 chữ số. |
| h | Hiển thị giờ dưới dạng số mà không có số 0 đứng đầu. |
| hh | Hiển thị giờ dưới dạng số với số 0 đứng đầu khi thích hợp. Nếu định dạng chứa AM (SÁNG) hoặc PM (CHIỀU), thì giờ sẽ hiển thị dựa trên đồng hồ 12 giờ. Nếu không, giờ sẽ hiển thị dựa trên đồng hồ 24 giờ. |
| m | Hiển thị phút dưới dạng số mà không có số 0 đứng đầu. Chỗ dành sẵn này phải xuất hiện ngay sau mã h hoặc hh hoặc ngay trước mã ss. Nếu không, hàm Text sẽ trả về tháng thay vì phút. |
| mm | Hiển thị phút dưới dạng số với số 0 đứng đầu khi thích hợp. Chỗ dành sẵn này phải xuất hiện ngay sau chỗ dành sẵn h hoặc hh hoặc ngay trước chỗ dành sẵn ss. Nếu không, hàm Text sẽ trả về tháng thay vì phút. |
| s | Hiển thị giây dưới dạng số mà không có số 0 đứng đầu. |
| ss | Hiển thị giây dưới dạng số với số 0 đứng đầu khi thích hợp. |
| f | Hiển thị các phân số của giây. |
| AM/PM, a/p | Hiển thị giờ dựa trên đồng hồ 12 giờ. Hàm Text trả về "AM" hoặc "a" cho giờ từ nửa đêm đến trưa và "PM" hoặc "p" cho giờ từ trưa đến nửa đêm |
Chỗ dành sẵn cho ký tự
Bạn có thể thêm bất kỳ ký tự nào trong số này vào chuỗi định dạng. Các ký tự đó sẽ xuất hiện y nguyên trong kết quả của hàm Text. Các ký tự bổ sung dành riêng cho chỗ dành sẵn sau này, vì vậy bạn không nên sử dụng các ký tự đó.
| Ký tự | Mô tả |
|---|---|
| Ký hiệu tiền tệ bất kỳ | Ký hiệu đô la, ký hiệu xu, ký hiệu euro, v.v. |
| + | Dấu cộng |
| ( | Dấu ngoặc trái |
| : | Dấu hai chấm |
| ^ | Dấu Circumflex (dấu mũ) |
| ' | Dấu nháy đơn |
| { | Dấu ngoặc nhọn bên trái |
| < | Dấu nhỏ hơn |
| = | Dấu bằng |
| - | Dấu trừ |
| / | Dấu gạch chéo |
| ) | Dấu ngoặc phải |
| & | Dấu và |
| ~ | Dấu ngã |
| } | Dấu ngoặc nhọn bên phải |
| > | Dấu lớn hơn |
| Ký tự khoảng trắng |
Các ứng dụng toàn cầu
Hàm Text áp dụng cho toàn cầu. Đối với nhiều ngôn ngữ, hàm này biết cách viết đúng ngày, giờ, đơn vị tiền tệ và số. Để làm điều đó, hàm này cần có 2 thông tin:
- Ngôn ngữ của định dạng tùy chỉnh: Đối với người tạo ứng dụng, một định dạng tùy chỉnh nên được diễn giải như thế nào? Ký tự dấu phân tách (. và ,) có ý nghĩa khác nhau trong các ngôn ngữ khác nhau. Nếu chỉ định một định dạng tùy chỉnh, thì bạn có thể thêm một chỗ dành sẵn cho ngôn ngữ hoặc lấy giá trị mặc định phản ánh ngôn ngữ đặt cho thiết bị của bạn. Cách dễ hơn đó là bạn có thể sử dụng một trong những định dạng ngày/giờ xác định trước mà bất khả tri ngôn ngữ.
- Ngôn ngữ của kết quả: Đối với người dùng, kết quả của ham nên xuất hiện ở ngôn ngữ nào? Tên của tháng và ngày trong tuần phải bằng ngôn ngữ phù hợp cho người dùng ứng dụng mà bạn có thể chỉ định bằng cách thêm đối số tùy chọn thứ ba vào hàm Text.
Đối với cả hai, hãy chỉ định ngôn ngữ bằng cách sử dụng một thẻ ngôn ngữ. Để xem danh sách các ngôn ngữ được hỗ trợ, hãy nhập Text( 1234, "", ) vào thanh công thức hoặc tab Advanced (Nâng cao) của ngăn bên phải rồi cuộn qua danh sách các ngôn ngữ được đề xuất cho đối số thứ ba.
Chỗ dành sẵn cho ngôn ngữ
Để chỉ định ngôn ngữ của định dạng tùy chỉnh, hãy sử dụng:
| Chỗ dành sẵn | Mô tả |
|---|---|
| [$-LanguageTag] | LanguageTag là một thẻ ngôn ngữ được trả về từ hàm Language. Thẻ này có thể chỉ định ngôn ngữ (chẳng hạn như [$-en] cho tiếng Anh) hoặc cũng có thể chỉ định vùng (chẳng hạn như [$-en-GB] để xác định rõ hơn Vương quốc Anh). |
Chỗ dành sẵn cho ngôn ngữ có thể xuất hiện ở bất cứ đâu trong định dạng tùy chỉnh nhưng chỉ xuất hiện một lần.
Nếu bạn chỉ định một định dạng tùy chỉnh mà không có chỗ dành sẵn cho ngôn ngữ và định dạng đó không rõ ràng từ quan điểm toàn cầu, thì thẻ ngôn ngữ cho ngôn ngữ hiện tại của bạn sẽ được chèn tự động.
[$-en-US] được giả định nếu chỗ dành sẵn này không xuất hiện khi ứng dụng của bạn chạy.
Lưu ý
Trong phiên bản tương lai, cú pháp của chỗ dành sẵn này có thể thay đổi để tránh nhầm lẫn với chỗ dành sẵn tương tự nhưng khác nhau mà Excel hỗ trợ.
Thẻ ngôn ngữ kết quả
Kết quả của hàm Text bao gồm các chuỗi được dịch cho tháng, ngày trong tuần và ký hiệu AM/PM, cũng như các dấu phân tách nhóm và thập phân thích hợp.
Theo mặc định, hàm Text sử dụng ngôn ngữ của người dùng đang chạy ứng dụng. Hàm Language trả về thẻ ngôn ngữ của người dùng hiện tại. Bạn có thể ghi đè giá trị mặc định này bằng cách cung cấp thẻ ngôn ngữ của đối số thứ ba cho hàm Text.
Cú pháp
Text( NumberOrDateTime, DateTimeFormatEnum [, ResultLanguageTag ] )
- NumberOrDateTime - Bắt buộc. Số hoặc giá trị ngày/giờ cần định dạng.
- DateTimeFormat - Bắt buộc. Một thành phần của hàm liệt kê DateTimeFormat.
- ResultLanguageTag - Không bắt buộc. Thẻ ngôn ngữ để sử dụng cho văn bản kết quả. Theo mặc định, ngôn ngữ của người dùng hiện tại được sử dụng.
Text( NumberOrDateTime, CustomFormat [, ResultLanguageTag ] )
- Number - Bắt buộc. Số hoặc giá trị ngày/giờ cần định dạng.
- CustomFormat - Bắt buộc. Một hoặc nhiều chỗ dành sẵn kèm theo dấu ngoặc kép.
- ResultLanguageTag - Không bắt buộc. Thẻ ngôn ngữ để sử dụng cho văn bản kết quả. Theo mặc định, ngôn ngữ của người dùng hiện tại được sử dụng.
Text( AnyValue )
- AnyValue - Bắt buộc. Giá trị để chuyển đổi thành một bản trình bày văn bản. Một định dạng mặc định được sử dụng.
Text ( Untyped )
- Untyped – Bắt buộc. Đối tượng chưa nhập biểu thị một chuỗi. Các giá trị được chấp nhận phụ thuộc vào nhà cung cấp chưa được nhập. Đối với JSON, nếu đối tượng chưa được gõ là số hoặc boolean thì đối tượng đó sẽ được chuyển đổi thành văn bản.
Ví dụ
Trừ khi chỉ định khác, người dùng chạy các công thức này ở tại Hoa Kỳ và đã chọn tiếng Anh làm ngôn ngữ của họ. Hàm Language đang trả về "en-US".
Số
| Công thức | Mô tả | Kết quả |
|---|---|---|
| Text( 1234.59, "####.#" ) | Định dạng số có một vị trí thập phân. | "1234.6" |
| Text( 8.9, "#.000" ) | Đệm phần thập phân của số có số 0 ở cuối, nếu cần. | "8.900" |
| Text( 0.631, "0.#" ) | Đệm phần tổng thể của số có số 0 ở cuối, nếu cần. | "0.6" |
| Text( 12, "#.0#" ) Text( 1234.568, "#.0#" ) |
Đệm phần thập phân của số có số 0 cho một vị trí thập phân và bao gồm vị trí thập phân thứ hai nếu được cung cấp. | "12.0" "1234.57" |
| Text( 12000, "$ #,###" ) Text( 1200000, "$ #,###" ) |
Cứ sau 3 chữ số lại đặt một dấu phân tách hàng ngàn và thêm ký hiệu tiền tệ. | "$ 12,000" "$ 1,200,000" |
Ngày/Giờ
- Lúc 2:37:47 PM vào Monday, November 23, 2015
- Múi giờ Hoa Kỳ Thái Bình Dương (UTC-8)
| Công thức | Mô tả | Kết quả |
|---|---|---|
| Text( Now(), DateTimeFormat.LongDate ) | Định dạng theo chuỗi ngày dài, ở ngôn ngữ và địa điểm của người dùng hiện tại. | "Monday, November 23, 2015" |
| Text( Now(), DateTimeFormat.LongDateTime ) | Định dạng theo chuỗi ngày và giờ dài, ngôn ngữ và địa điểm của người dùng hiện tại, sử dụng đồng hồ 12 giờ. | "Monday, November 23, 2015 2:37:47 PM" |
| Text( Now(), DateTimeFormat.LongTime24 ) | Định dạng theo chuỗi thời gian dài, sử dụng đồng hồ 24 giờ. | "14:37:47" |
| Text( Now(), DateTimeFormat.ShortDate ) | Định dạng theo chuỗi ngày ngắn, ở ngôn ngữ và địa điểm của người dùng hiện tại. | "11/23/2015" |
| Text( Now(), "d-mmm-yy" ) | Định dạng sử dụng các ký tự cho chỗ dành sẵn:
|
"23-Nov-15" |
| Text(1448318857*1000, "mmm. dd, yyyy (hh:mm:ss AM/PM)") | Hiển thị giá trị ngày-giờ Unix ở định dạng con người có thể đọc được nếu bạn nhân giá trị nguồn với 1.000. | "Nov. 23, 2015 (02:47:37 PM)" |
Các ứng dụng toàn cầu
| Công thức | Description | Kết quả |
|---|---|---|
| Text(1234567.89, "[$-fr-FR]# ###,## €", "fr-FR") | Hiển thị một khoảng trắng dưới dạng dấu phân tách nhóm, dấu phẩy dưới dạng dấu phân tách thập phân và € làm ký hiệu tiền tệ. | "1 234 567,89 €" |
| Text(1234567,89; "[$-fr-FR]# ###,## €") | Nếu dữ liệu nguồn tuân theo tập quán của Pháp là sử dụng dấu phẩy làm dấu phân tách thập phân, thì bạn phải thay đổi ngôn ngữ của mình thành tiếng Pháp và tách các đối số bằng dấu chấm phẩy thay vì dấu phẩy để có kết quả tương tự như trên. | "1 234 567,89 €" |
| Text( Date(2016,1,31), "dddd mmmm d" ) | Trả về ngày trong tuần, tháng và ngày trong tháng bằng ngôn ngữ của người dùng hiện tại. Vì không có chỗ dành sẵn nào phụ thuộc vào ngôn ngữ, nên không cần thẻ định dạng ngôn ngữ văn bản. | "Sunday January 31" |
| Text( Date(2016,1,31), "dddd mmmm d", "es-ES" ) | Trả về ngày trong tuần, tháng và ngày trong tháng bằng ngôn ngữ "es-ES". | "domingo enero 31" |
Chuyển đổi giá trị thành văn bản
| Công thức | Mô tả | Kết quả |
|---|---|---|
| Text( 1234567.89 ) | Chuyển đổi số thành chuỗi. Không có dấu phân tách hàng ngàn hoặc sự kiểm soát số lượng chữ số trước hoặc sau dấu phân tách thập phân. Để kiểm soát tốt hơn, hãy cung cấp chỗ dành sẵn cho số dưới dạng đối số thứ hai. | "1234567.89" |
| Text( DateTimeValue( "01/04/2003" ) ) | Chuyển đổi giá trị ngày/giờ thành chuỗi văn bản. Để kiểm soát việc chuyển đổi, hãy cung cấp một thành phần của hàm liệt kê DateTimeFormat hoặc chuỗi có định dạng tùy chỉnh. | "1/4/2003 12:00 AM" |
| Text( true ) | Chuyển đổi giá trị Boolean thành chuỗi. | "true" |
| Text( GUID() ) | Chuyển đổi giá trị GUID được tạo thành chuỗi. | "f8b10550-0f12-4f08-9aa3-bb10958bc3ff" |
| Left( Text( GUID() ), 4 ) | Trả về 4 ký tự đầu tiên của GUID được tạo. | "2d9c" |
Phản hồi
Sắp ra mắt: Trong năm 2024, chúng tôi sẽ dần gỡ bỏ Sự cố với GitHub dưới dạng cơ chế phản hồi cho nội dung và thay thế bằng hệ thống phản hồi mới. Để biết thêm thông tin, hãy xem: https://aka.ms/ContentUserFeedback.
Gửi và xem ý kiến phản hồi dành cho