Text 함수

  • 아티클

적용 대상: 캔버스 앱 캔버스 앱 Dataverse 수식 열 모델 기반 앱 Power Platform CLI

모든 값을 변환하고 숫자나 날짜/시간 값을 텍스트 문자열로 형식을 지정합니다.

설명

Text 함수는 이러한 유형의 인수 중 하나를 기준으로 숫자나 날짜/시간 값의 형식을 지정합니다.

  • DateTimeFormat 열거를 사용하여 지정하는 미리 정의된 날짜/시간 형식입니다. 날짜 및 시간의 경우 각 사용자의 언어와 지역을 자동으로 조정하도록 기본 설정됩니다.
  • 예를 들어, 숫자에 소수점 구분 기호가 표시되고 날짜에 월의 전체 이름이 표시되는지, 월이 약어로 표시되는지 또는 월이 숫자로 표시되는지를 정의하는 자리 표시자 문자열로 구성된 사용자 지정 형식입니다. Power Apps는 Microsoft Excel와 마찬가지로 자리 표시자의 하위 집합을 지원합니다. 이 문자열에서 언어 자리 표시자는 다른 자리 표시자를 해석할 언어를 지정합니다. 예를 들어, 사용자 정의 형식에 마침표가 포함된 경우 언어 형식 자리 표시자는 마침표가 소수 구분 기호(ja-JP)인지 천 단위 구분 기호(es-ES)인지 지정합니다.

자세한 내용은 날짜 및 시간 작업을 참조하십시오.

Text 함수는 기본 형식을 사용하여 모든 데이터 유형을 텍스트 표현으로 변환할 수도 있습니다. 텍스트가 아닌 값을 Len, Right 및 IsMatch와 같은 텍스트 기반 함수에 전달하려면 이 함수를 사용하십시오.

미리 정의된 날짜/시간 형식

이 예제에서 사용된 날짜 및 시간은 시간대 UTC-7 시간에서 Tuesday, April 7, 2020 8:26:59.180 PM입니다.

DateTimeFormat enum 설명 예(en-US 사용)
LongDate 4자리 연도, 월 이름, 월의 일, 주의 요일. 월의 이름과 주의 요일은 약어로 표시되지 않습니다. "Tuesday, April 7, 2020"
LongDateTime 4자리 연도, 월 이름, 월의 날짜, 주의 요일에 시(12시간제), 분, 초 및 오전/오후 지정이 추가됩니다. 월의 이름과 주의 요일은 약어로 표시되지 않습니다. "Tuesday, April 7, 2020 8:26:59 PM"
LongDateTime24 4자리 연도, 월, 월의 날짜, 주의 요일에 시(24시간제), 분 및 초가 추가됩니다. 월의 이름과 주의 요일은 약어로 표시되지 않습니다. "Tuesday, April 7, 2020 20:26:59"
LongTime 시(12시간제), 분, 초 및 오전/오후를 지정합니다. "8:26:59 PM"
LongTime24 시(24시간제), 분, 초를 지정합니다. "20:26:59"
ShortDate 4자리 연도에 숫자 월과 월의 일을 사용합니다. "4/7/2020"
ShortDateTime 4자리 연도에 숫자 월과 월의 일을 사용하고, 시(12시간제), 분, 초 및 오전/오후를 지정합니다. "4/7/2020 8:26 PM"
ShortDateTime24 4자리 연도에 숫자 월과 월의 일을 사용하고, 시(24시간제)와 분이 추가됩니다. "4/7/2020 20:26"
ShortTime 시(12시간제), 분 및 오전/오후를 지정합니다. "8:26 PM"
ShortTime24 시(24시간제)와 분입니다. "20:26"
UTC 날짜/시간 값은 현재 사용자의 시간대를 기준으로 UTC로 변환되며 ISO 8601 표준에 따라 형식이 지정됩니다. "2020-04-08T03:26:59.180Z"

숫자 자리 표시자

Placeholder 설명
0(영) 숫자의 자릿수가 형식의 0보다 적은 경우 유효하지 않은 0으로 표시됩니다. 예를 들어, 8.9를 8.90으로 표시하려면 #.00 형식을 사용하십시오.
# 0(영)과 동일한 규칙을 따릅니다. 그러나 Text는 소수의 어느 쪽이든 숫자의 자릿수가 형식의 # 기호보다 적은 경우 추가 0을 반환하지 않습니다. 예를 들어, 사용자 지정 형식이 #.##이고 형식을 지정할 숫자가 8.9인 경우 8.9로 표시됩니다.
페이지를 참조하세요. (마침표) 숫자에서 소수점을 표시합니다. 사용자 지정 형식의 언어에 따라 다릅니다. 자세한 내용은 global apps를 참조하십시오.
,(쉼표) 천 단위에 자주 사용되는 숫자에서 그룹화 구분 기호를 표시합니다. Text는 형식에 숫자 기호(#)나 0으로 묶인 쉼표가 포함된 경우 쉼표로 그룹을 분리합니다. 사용자 지정 형식의 언어에 따라 다릅니다. 자세한 내용은 global apps를 참조하십시오.

소수점 오른쪽의 숫자의 자릿수가 형식의 자리 표시자보다 많은 경우 숫자는 자리 표시자 만큼의 소수점 자리로 반올림됩니다. 소수점 왼쪽의 자릿수가 자리 표시자보다 많은 경우 초과 자릿수가 표시됩니다. 형식에 소수점 왼쪽의 숫자 기호(#)만 포함된 경우 1 이하의 숫자는 소수점으로 시작합니다(예: .47).

날짜 및 시간 자리 표시자

Placeholder 설명
m 앞에 0을 붙이지 않고 월을 숫자로 표시합니다.
mm 해당하는 경우 앞에 0을 붙여 월을 숫자로 표시합니다.
mmm 월을 약어로 표시합니다(Jan~Dec).
mmmm 월을 전체 이름으로 표시합니다(January~December).
일 앞에 0을 붙이지 않고 일을 숫자로 표시합니다.
dd 해당하는 경우 앞에 0을 붙여 일을 숫자로 표시합니다.
ddd 요일을 약어로 표시합니다(Sun~Sat).
dddd 요일을 전체 이름으로 표시합니다(Sunday~Saturday).
yy 연도를 2자리 숫자로 표시합니다.
yyyy 연도를 4자리 숫자로 표시합니다.
시간 앞에 0을 붙이지 않고 시를 숫자로 표시합니다.
hh 해당하는 경우 앞에 0을 붙여 시를 숫자로 표시합니다. AM 또는 PM이 형식에 포함되는 경우 시는 12시간제로 표시됩니다. 그렇지 않은 경우 24시간제로 표시됩니다.
m 앞에 0을 붙이지 않고 분을 숫자로 표시합니다.

이 자리 표시자는 h 또는 hh 코드 바로 뒤에 또는 ss 코드 바로 앞에 나타나야 합니다. 그렇지 않으면 Text는 분 대신 월을 반환합니다.
mm 해당하는 경우 앞에 0을 붙여 분을 숫자로 표시합니다.

이 자리 표시자는 h 또는 hh 자리 표시자 바로 뒤에 또는 ss 자리 표시자 바로 앞에 나타나야 합니다. 그렇지 않으면 Text는 분 대신 월을 반환합니다.
s 앞에 0을 붙이지 않고 초를 숫자로 표시합니다.
ss 해당하는 경우 앞에 0을 붙여 초를 숫자로 표시합니다.
f 초를 분수로 표시합니다.
AM/PM, a/p 시를 12시간제로 표시합니다. Text는 자정부터 정오까지의 시간을 "AM" 또는 "a"로, 정오부터 자정까지의 시간을 “PM” 또는 "p"로 반환합니다.

문자 자리 표시자

형식 문자열에 이러한 문자를 포함할 수 있습니다. 문자가 Text 결과에 그대로 표시됩니다. 추가 문자는 향후 자리 표시자로 예약되어 있기 때문에 사용하지 말아야 합니다.

문자 설명
모든 통화 기호 달러 기호, 센트 기호, 유로 기호 등
+ 더하기 기호
( 왼쪽 괄호
: 콜론
^ 곡절 악센트(캐럿)
' 아포스트로피
{ 왼쪽 중괄호
< 부등호(보다 작은)
= 등호
- 빼기 기호
/ 슬래시 표시
) 오른쪽 괄호
& 앰퍼샌드
~ 물결표
} 오른쪽 중괄호
> 부등호(보다 큰)
  공백 문자

Global apps

Text 함수는 전 세계에서 인식됩니다. 날짜, 시간, 통화 및 숫자를 다양한 언어로 올바르게 작성하는 방법을 알려줍니다. 이 작업을 수행하려면 다음 두 가지 정보가 필요합니다.

  • 사용자 지정 형식의 언어: 제작자의 경우 사용자 지정 형식을 어떻게 해석해야 합니까? 구분 문자(. 및 ,)는 다른 언어에서 다른 의미를 갖습니다. 사용자 정의 형식을 지정하면 언어 자리 표시자를 포함하거나 기본값을 사용하여 장치에 설정된 언어를 반영합니다. 더 쉽게 말하면, 언어와 관계없이 미리 정의된 날짜/시간 형식 중 하나를 사용할 수 있습니다.
  • 결과의 언어: 사용자의 경우 함수 결과에 어떤 언어를 사용해야 합니까? 월과 평일의 이름은 앱 사용자에게 적합한 언어로 되어 있어야 합니다. Text 함수에 에 세 번째 선택적 인수를 추가하여 지정할 수 있습니다.

둘 다의 경우 언어 태그를 사용하여 언어를 지정합니다. 지원되는 언어 목록을 보려면 수식 입력줄 또는 오른쪽 창의 Advanced 탭에 Text( 1234, "", )를 입력한 다음 세 번째 인수에 제안된 로캘 목록 전체를 스크롤하십시오.

언어 자리 표시자

사용자 지정 형식의 언어를 지정하려면 다음을 사용하십시오.

Placeholder 설명
[$-LanguageTag] LanguageTag는 Language 함수에서 반환되는 언어 태그입니다. 언어만 지정할 수 있거나(영어의 경우 [$-en]) 지역을 지정할 수도 있습니다(영국 영어를 추가 지정할 경우 [$-en-GB]).

언어 자리 표시자는 사용자 지정 형식으로 어디서든 한 번만 나타날 수 있습니다.

언어 자리 표시자 없이 사용자 지정 형식을 지정하고 형식이 글로벌 관점에서 모호한 경우 현재 언어의 언어 태그가 자동으로 삽입됩니다.

[$-en-US]는 앱이 실행될 때 이 자리 표시자가 없는 것으로 가정합니다.

노트

이후 버전에서 이 자리 표시자의 구문은 Excel에서 지원하는 구문과 비슷하지만 다른 자리 표시자로 인한 혼동을 피하기 위해 변경될 수 있습니다.

결과 언어 태그

Text 결과에는 적절한 그룹 및 소수 구분 기호뿐만 아니라 월, 평일 및 오전/오후 지정을 위해 번역된 문자열이 포함됩니다.

기본적으로 Text는 앱을 실행하는 사용자의 언어를 사용합니다. Language 함수는 현재 사용자에 대한 언어 태그를 반환합니다. 세 번째 인수에 대한 언어 태그를 Text에 제공하여 이 기본값을 재정의할 수 있습니다.

구문

Text( NumberOrDateTime, DateTimeFormatEnum [, ResultLanguageTag ] )

  • NumberOrDateTime - 필수 항목입니다. 형식을 지정할 숫자 또는 날짜/시간 값입니다.
  • DateTimeFormat - 필수 항목입니다. DateTimeFormat 열거의 구성 항목입니다.
  • ResultLanguageTag - 선택 항목입니다. 결과 텍스트로 사용할 언어 태그입니다. 기본적으로 현재 사용자의 언어를 사용합니다.

Text( NumberOrDateTime, CustomFormat [, ResultLanguageTag ] )

  • Number - 필수 항목입니다. 형식을 지정할 숫자 또는 날짜/시간 값입니다.
  • CustomFormat - 필수 항목입니다. 큰따옴표로 묶인 하나 이상의 자리 표시자입니다.
  • ResultLanguageTag - 선택 항목입니다. 결과 텍스트로 사용할 언어 태그입니다. 기본적으로 현재 사용자의 언어를 사용합니다.

Text( AnyValue )

  • AnyValue - 필수 항목입니다. 텍스트 표현으로 변환할 값입니다. 기본 형식이 사용됩니다.

텍스트 ( 무형식 )

  • Untyped - 필수 항목입니다. 문자열을 나타내는 무형식 개체입니다. 허용되는 값은 무형식 공급자에 따라 다릅니다. JSON의 경우, 형식화되지 않은 개체가 숫자 또는 부울이면 텍스트로 변환됩니다.

예

지정되지 않는 경우 이러한 수식을 실행하는 사용자는 미국에 있으며 영어를 자신의 언어로 선택했습니다. Language 함수가 "en-US"를 반환하는 중입니다.

번호

수식 설명 결과
Text( 1234.59, "####.#" ) 소수 첫째 자리 형식을 숫자로 지정합니다. "1234.6"
Text( 8.9, "#.000" ) 필요한 경우 뒤에 0을 붙여 숫자의 소수 부분을 채웁니다. "8.900"
Text( 0.631, "0.#" ) 필요한 경우 앞에 0을 붙여 숫자의 정수 부분을 채웁니다. "0.6"
Text( 12, "#.0#" )
Text( 1234.568, "#.0#" )		 소수 첫째 자리 숫자로 0을 사용하여 숫자의 소수 부분을 채우고, 제공되는 경우 소수 둘째 소수 자리 숫자를 포함합니다. "12.0"
"1234.57"
Text( 12000, "$ #,###" )
Text( 1200000, "$ #,###" )		 천 단위 구분 기호를 세 자리마다 놓고 통화 기호를 포함합니다. "$ 12,000"
"$ 1,200,000"

날짜/시간

  • At 2:37:47 PM on Monday, November 23, 2015
  • 미국 태평양 시간대(UTC-8)
수식 설명 결과
Text( Now(), DateTimeFormat.LongDate ) 현재 사용자의 언어와 지역에 맞는 자세한 날짜 문자열로 서식을 지정합니다. "Monday, November 23, 2015"
Text( Now(), DateTimeFormat.LongDateTime ) 현재 사용자의 언어와 지역에 맞는 자세한 날짜와 시간 문자열로 12시간제를 사용하여 서식을 지정합니다. "Monday, November 23, 2015 2:37:47 PM"
Text( Now(), DateTimeFormat.LongTime24 ) 24시간제를 사용하여 자세한 시간 문자열로 서식을 지정합니다. "14:37:47"
Text( Now(), DateTimeFormat.ShortDate ) 현재 사용자의 언어와 지역에 맞는 간단한 날짜 문자열로 서식을 지정합니다. "11/23/2015"
Text( Now(), "d-mmm-yy" ) 자리 표시자 문자를 사용한 형식:
  • 월의 한 자리 또는 두 자리의 일을 나타낸 d
  • 결과에 복사한 리터럴 문자로서의 -
  • 월을 3자 약어로 나타낸 mmm
  • 결과에 복사한 또다른 리터럴 문자로서의 -
  • 연도를 2자리 약어로 나타낸 yy
 "23-Nov-15"
Text(1448318857*1000, "mmm. dd, yyyy (hh:mm:ss AM/PM)") 원본 값에 1,000을 곱하면 Unix 날짜-시간 값을 사람이 읽을 수있는 형식으로 표시합니다. "Nov. 23, 2015 (02:47:37 PM)"

Global apps

수식 Description Result
Text(1234567.89, "[$-fr-FR]# ###,## €", "fr-FR") 공백을 그룹화 구분 기호로, 쉼표를 소수 구분 기호로, €를 통화 기호로 표시합니다. "1 234 567,89 €"
Text(1234567,89; "[$-fr-FR]# ###,## €") 원본 데이터가 쉼표를 소수 구분 기호로 사용하는 프랑스어 사용자 정의를 따르는 경우 위와 동일한 결과를 얻으려면 지역을 프랑스어로 변경하고 쉼표 대신 세미콜론으로 인수를 분리해야 합니다. "1 234 567,89 €"
Text( Date(2016,1,31), "dddd mmmm d" ) 평일, 월 및 월의 일을 현재 사용자의 언어로 반환합니다. 언어에 종속되는 자리 표시자가 없기 때문에 형식 텍스트 언어 태그가 필요하지 않습니다. "Sunday January 31"
Text( Date(2016,1,31), "dddd mmmm d", "es-ES" ) 평일, 월 및 월의 일을 "es-ES" 언어로 반환합니다. "domingo enero 31"

값을 텍스트로 변환

수식 설명 결과
Text( 1234567.89 ) 숫자를 문자열로 변환합니다. 천 단위 구분 기호가 없거나 소수 구분 기호 앞이나 뒤에 있는 자릿수에 대한 제어 기능이 없습니다. 더 많은 제어를 위해 두 번째 인수로 번호 자리 표시자를 제공하십시오. "1234567.89"
Text( DateTimeValue( "01/04/2003" ) ) 날짜/시간 값을 텍스트 문자열로 변환합니다. 변환을 제어하려면 DateTimeFormat 열거 구성 항목이나 사용자 지정 형식 문자열을 제공하십시오. "1/4/2003 12:00 AM"
Text( true ) 부울 값을 문자열로 변환합니다. "true"
Text( GUID() ) 생성된 GUID 값을 문자열로 변환합니다. "f8b10550-0f12-4f08-9aa3-bb10958bc3ff"
Left( Text( GUID() ), 4 ) 생성된 GUID의 처음 4자를 반환합니다. "2d9c"