날짜, 시간, 숫자, 기타 형식 지정

이 도움말 페이지의 정보는 CXone StudioDesktop Studio에 모두 적용됩니다.

이 페이지에서는 Studio에서 날짜, 시간, 숫자 값의 유효한 형식 지정 옵션을 설명합니다. 형식 지정 옵션을 사용하여 특정한 정보가 스크립트의 출력에서 원하는 형식 지정을 정의할 수 있습니다. 예를 들어, 조직에서 날짜가 특정한 방식으로 표시되기를 원하는 경우에는 이 페이지에서 datefmt() 함수 및 날짜 형식 지정자를 사용하여 날짜를 기존 형식에서 원하는 형식으로 변환할 수 있습니다.

이 페이지의 여러 가지 형식 지정자 예시는 함수 스크립트 예시에서 확인할 수 있습니다. 스크립트를 다운로드하고 가져온 다음 datefmtformat Snippet 작업을 열 수 있습니다.

날짜 및 시간 형식

작업닫힘 고객 데이터 모음, 메시지 또는 음악 재생 또는 상담원에게 컨택 라우팅과 같은 Studio 스크립트 내에서 프로세스를 수행합니다. 또는 datefmt() 등의 날짜/시간 함수가 날짜 또는 시간 값을 반환할 형식을 지정하는 데 필요하면 형식 지정자 문자를 사용하십시오. 일, 월, 년, 시간, 분 등 날짜/시간 값의 각 부분에 대한 지정자 문자가 있습니다.

지정자 문자를 구분 기호 문자와 결합하여 날짜/시간 값이 표시되기를 원하는 방식을 정의할 수 있습니다. 조직에 날짜/시간 값의 표시 방식에 대한 요구사항이 있는 경우 유용합니다. 필요한 날짜/시간 형식이 무엇인지 알면 이 섹션에서 정의한 형식 지정자에 따라 스크립트 내에서 형식을 구축합니다.

다음 테이블에서는 해당 형식이 있는 날짜 및 시간의 몇 가지 예시를 확인할 수 있습니다. 지정자가 있는 형식 열에는 날짜 스타일 열에 있는 각 날짜/시간 예시를 구성하기 위해 형식 지정자 문자를 사용해야 하는 방식을 보여줍니다. M, d, h, s 등의 지정자 문자는 월, 일, 시간 등 날짜/시간 값의 일부를 의미합니다.

날짜 스타일 지정자가 있는 형식
04/04/2022 04:29:12 AM MM/dd/yyyy hh:mm:ss tt

6/29/2022 3:15:45 PM

M/d/yy h :m:s tt

Sat Apr 22 2023  ddd MMM dd yyyy
Thursday, June 15 2023 dddd, MMMM dd yyyy

Studio는 12시간제가 아닌 24시간제를 지원합니다. 스크립트에서 시간을 다룰 때 이 점을 고려하십시오.

OLE 자동화

OLE 자동화 날짜는 부동 소수점 숫자로 기재된 날짜입니다. 소수점 왼쪽은 1899년 12월 30일 자정 이후의 날짜 수입니다. 소수점 오른쪽은 해당 날짜의 시간을 24로 나눈 수치입니다. 예를 들어 1899년 12월 31일 오전 6:00시는 1.25입니다.

OLE 자동화 날짜-시간은 Studio 스크립트의 여러 위치에서 사용됩니다. 날짜와 시간을 처리하는 몇 가지 함수는 이 형식을 입력 또는 출력으로 사용합니다. 이 도움말 페이지에서 설명하는 날짜-시간 형식 중 상당수는 OLE 자동화 날짜-시간을 사용합니다.

날짜 및 시간 형식 지정자

날짜 및 시간 형식 지정자를 사용할 때는 다음과 같은 사항이 중요합니다.

  • 대문자 및 소문자: 지정자의 대문자/소문자에 따라 출력이 달라집니다. 예를 들어 f 이(가) 소문자면 (있는 경우) 후행 0이 포함된 밀리초 단위 숫자가 출력됩니다. F이(가) 대문자면 후행 0은 표시되지 않습니다. 다른 예시에서 소문자 m은(는) 분을 출력하지만, 대문자 M은(는) 월을 표시합니다.
  • 포함하는 각 문자의 숫자: 형식 지정자의 숫자가 1, 2, 또는 다른 숫자인지에 따라 출력이 달라집니다. 예를 들어 시간에 대해 하나의 h만 사용하면 앞에 0이 포함되지 않은 한자릿수 시간만 결과로 출력됩니다. hh 문자가 2개면 앞에 0이 표시된 한자릿수 시간이 표시됩니다.
  • 문자 결합 또는 하나만 사용: 다른 지정자 없이 단일 지정자 문자만 사용하려면 접두사로 퍼센트 기호(%)를 붙여야 합니다. 예를 들어 '분'만을 출력하려면 %m을(를) 사용합니다. 퍼센트 기호를 포함하지 않으면 형식 지정이 적용되지 않습니다. 다른 지정자와 함께 결합하여 단일 지정자를 사용하는 경우에는 퍼센트 기호를 포함할 필요가 없습니다. 예를 들어, hh:m처럼 형식에 시간과 단일 m이(가) 포함된 경우에는 퍼센트 기호를 사용할 필요가 없습니다.

날짜/시간 형식 지정에 포함된 지정자가 아닌 문자는 출력으로 전달되며, 날짜/시간 값에 영향을 주지 않습니다. 날짜/시간 값의 부분을 분할하는 데 사용할 수 있습니다. 일반적으로는 콜론(:)과 정방향 슬래시(/)를 날짜/시간 값의 부분을 분할하는 데 사용합니다. 하이픈(-)과 같은 일반적이지 않은 문자 등 지정하려는 형식의 구분자로 어떤 문자든 사용할 수 있습니다.

예를 들어 파이프 구분 문자로 날짜와 시간을 분할하려는 경우에는 이를 형식에 포함하면 출력에 추가됩니다. 콜론과 정방향 슬래시는 사용하는 함수에 따라 필요할 수 있습니다. 예를 들어 asdatetime() 함수에는 이러한 문자를 사용해야 합니다.

나타낼 방식 형식 지정자 세부사항
d

1~31 사이의 숫자로 날짜를 나타냅니다(27).

한 자리 요일은 접두사 0이 없는 형식입니다(3).

단독으로 사용하려면 %을(를) 접두사로 붙입니다.

dd

01~31 사이의 숫자로 날짜를 나타냅니다(27).

한 자리 요일은 접두사 0이 붙는 형식입니다(03).

ddd 요일의 약자 이름을 나타냅니다().
dddd 요일의 전체 이름을 나타냅니다(목요일).
M

월을 1~12 사이의 숫자로 나타냅니다(11).

한 자리 월은 접두사 0이 없는 형식입니다(5).

단독으로 사용하려면 %을(를) 접두사로 붙입니다.

MM

월을 01~12 사이의 숫자로 나타냅니다(11).

한 자리 월은 접두사 0이 포함된 형식입니다(05).

MMM 월을 약자 이름으로 나타냅니다(Oct).
MMMM 월을 전체 이름으로 나타냅니다(October).
y

연도를 1자리 또는 2자리 숫자로 나타냅니다(23).

연도가 2자리 이상인 경우 결과에는 하위 2자리만 나타납니다. 예를 들어 2023년이면 23이 표시됩니다.

두 자리 연도의 첫 번째 숫자가 0으로 시작하는 경우(예: 02) 숫자는 앞에 0이 없는 형식이 지정됩니다(2).

yy

연도를 2자리 숫자로 나타냅니다(23).

연도가 2자리 이상인 경우 결과에는 하위 2자리만 나타납니다. 예를 들어 2023년이면 23이 표시됩니다.

두 자리 연도의 유효 자릿수가 2자 미만인 경우, 숫자 앞에 0이 채워져 2자리가 됩니다(02).

단독으로 사용하려면 %을(를) 접두사로 붙입니다.

yyy

최소 3자리 숫자로 연도를 나타냅니다(2023).

연도에 유효 자릿수가 3자리 이상 있는 경우, 결과 문자열에 포함됩니다. 연도가 3자리 미만이면 숫자 앞에 0이 채워져 3자리가 됩니다.

참고: 5자리 연도를 포함할 수 있는 태국 불교 달력의 경우 이 형식 지정자는 5자리를 모두 표시합니다.

yyyy

연도를 4자리 숫자로 나타냅니다(2023).

연도가 4자리 이상인 경우 결과에는 하위 4자리만 나타납니다. 연도가 4자리 미만이면 숫자 앞에 0이 채워져 4자리가 됩니다.

참고: 5자리 연도를 포함할 수 있는 태국 불교 달력의 경우 이 형식 지정자는 5자리를 모두 표시합니다.

yyyyy

연도를 5자리 숫자로 나타냅니다.

연도가 5자리 이상인 경우 결과에는 하위 5자리만 나타납니다. 연도가 5자리 미만이면 숫자 앞에 0이 채워져 5자리가 됩니다(02023).

6개 이상의 y 지정자가 있는 경우, y 지정자의 숫자가 되는 데 필요한 만큼 앞에 0이 추가됩니다. 예를 들어 y 지정자가 8개면 00002023이 출력됩니다.

기간 또는 시대 g, gg(추가적인 g 지정자에 따른 숫자 추가)

A.D 등의 기간 또는 시대를 나타냅니다. 형식을 지정할 날짜에 연결된 기간 또는 시대 문자열이 없는 경우 스크립트는 이 지정자를 무시합니다.

단일 g은(는) 단독으로 사용할 수 없습니다. 시대나 기간의 이름만을 출력하려면 이중 gg을(를) 사용합니다.

시간(12시간제) h

자정 또는 정오부터 전체 시간을 세는 12시간제 시계에 따라 숫자 1~12로 시간을 나타냅니다.

자정 이후의 특정 시간은 정오 이후의 같은 시간과 구별할 수 없습니다. 예를 들어, 1:00 AM은 1:00 PM과 동일합니다.

시간은 반올림하지 않으며 한 자리 시간은 앞에 0이 없는 형식입니다.

단독으로 사용하려면 %을(를) 접두사로 붙입니다.

예를 들어 시간이 5:43인 경우 이 사용자 정의 형식 지정자는 5을(를) 표시합니다.

hh

자정 또는 정오부터 전체 시간을 세는 12시간제 시계에 따라 2자리 숫자 01~12로 시간을 나타냅니다.

자정 이후의 특정 시간은 정오 이후의 같은 시간과 구별할 수 없습니다. 예를 들어, 1:00 AM은 1:00 PM과 동일합니다.

시간은 반올림하지 않으며 한 자리 시간은 앞에 0을 포함한 형식입니다.

예를 들어 시간이 5:43인 경우 이 사용자 정의 형식 지정자는 05을(를) 표시합니다.

시간(24시간제) H

자정 또는 정오부터 전체 시간을 세는 24시간제 시계에 따라 숫자 0~23으로 시간을 나타냅니다.

한 자리 시간은 접두사 0이 없는 형식입니다.

예를 들어 시간이 5:43 PM인 경우 이 사용자 정의 형식 지정자는 17을(를) 표시합니다.

단독으로 사용하려면 %을(를) 접두사로 붙입니다.

HH

자정 또는 정오부터 전체 시간을 세는 24시간제 시계에 따라 2자리 숫자 00~23으로 시간을 나타냅니다.

한 자리 시간은 접두사 0이 포함된 형식입니다.

예를 들어 시간이 5:43 PM인 경우 이 사용자 정의 형식 지정자는 17을(를) 표시합니다.

m

분을 0~59 사이의 숫자로 나타냅니다.

분은 지난 1시간 이후 경과한 전체 분을 나타냅니다. 한 자리 분은 접두사 0이 없는 형식입니다.

예를 들어 시간이 5:43:34인 경우 이 사용자 정의 형식 지정자는 43을(를) 표시합니다.

단독으로 사용하려면 %을(를) 접두사로 붙입니다.

mm

분을 00~59 사이의 2자리 숫자로 나타냅니다.

분은 지난 1시간 이후 경과한 전체 분을 나타냅니다. 한 자리 분은 접두사 0이 포함된 형식입니다.

예를 들어 시간이 5:03:34인 경우 이 사용자 정의 형식 지정자는 03을(를) 표시합니다.

초마다 s

초를 0~59 사이의 숫자로 나타냅니다.

결과는 지난 1분 이후 경과한 전체 초를 나타냅니다. 한 자리 초는 접두사 0이 없는 형식입니다.

예를 들어 시간이 5:43:04인 경우 이 사용자 정의 형식 지정자는 4을(를) 표시합니다.

단독으로 사용하려면 %을(를) 접두사로 붙입니다.

ss

초를 00~59 사이의 2자리 숫자로 나타냅니다.

결과는 지난 1분 이후 경과한 전체 초를 나타냅니다. 한 자리 초는 접두사 0이 포함된 형식입니다.

예를 들어 시간이 5:43:04인 경우 이 사용자 정의 형식 지정자는 04을(를) 표시합니다.

소숫점 초 ff, F

1초 미만 소숫점 초의 자릿수를 나타냅니다. 소문자 f 지정자는 후행 0을 포함합니다. 대문자 F 지정자는 후행 0을 제외합니다.

이 지정자는 OLE 자동화닫힘 날짜를 부동 소수점 정수로 쓰는 방법입니다. 1899년 12월 30일 이후의 일수를 나타냅니다. 날짜/시간에만 사용합니다.

문자에 포함되는 f 또는 F의 개수에 따라 포함할 소숫점 초의 유효 자릿수가 결정됩니다.

  • F: 1/10초 즉 유효 자릿수 1개입니다. 자릿수가 0이면 아무것도 표시되지 않습니다.
  • ff 또는 FF: 1/100초, 즉 유효 자릿수 2개입니다.
  • fff 또는 FFF: 1/1000초, 즉 유효 자릿수 3개입니다. '밀리초'라는 명칭으로도 부릅니다.
  • ffff 또는 FFFF: 1/10000초, 즉 유효 자릿수 4개입니다.
  • fffff 또는 FFFFF: 1/100000초, 즉 유효 자릿수 5개입니다.
  • ffffff 또는 FFFFFF: 1/1000000초, 즉 유효 자릿수 6개입니다.
  • FFFFFFF: 1/10000000초, 즉 유효 자릿수 7개입니다.

지정하는 단위의 정밀도가 높아질수록 신뢰성 의미가 줄어들 수 있습니다. 시간 값의 정밀도는 컴퓨터 시스템 시계의 해상도에 따라 다릅니다.

AM/PM t

AM/PM 지정자의 첫 문자를 나타냅니다. AM 지정자는 형식 지정된 시간이 12보다 작은 경우 사용됩니다. 그렇지 않으면 PM 지정자가 사용됩니다.

첫 문자가 동일하고 두 번째 문자가 변경되는 AM/PM 지정자를 사용하는 언어의 경우에는 tt 지정자를 사용합니다.

단독으로 사용하려면 %을(를) 접두사로 붙입니다.

tt

AM/PM 지정자를 나타냅니다. AM 지정자는 형식 지정된 시간이 12보다 작은 경우 사용됩니다. 그렇지 않으면 PM 지정자가 사용됩니다.

일본어처럼 첫 문자가 동일하고 두 번째 문자가 변경되는 AM/PM 지정자를 사용하는 언어의 경우에는 tt 지정자를 사용합니다.

UTC 기준 지역 오프셋 z

협정 세계시(UTC)를 기준으로 지역 운영 체제 시간대의 서명된 오프셋을 나타냅니다. z 문자 개수에 따라 표시할 오프셋의 정도가 정의됩니다.

  • z, zz: 오프셋을 시간 단위로 측정합니다.
  • zzz: 오프셋을 시간 및 분 단위로 측정합니다.

오프셋은 항상 앞에 기호가 함께 표시됩니다. 더하기 기호(+)는 UTC보다 빠른 시간을 나타내고 빼기 기호(-)는 UTC보다 빠른 시간을 나타냅니다. 오프셋 범위는 -12 ~ +13입니다. 한 자리 오프셋은 접두사 0이 포함된 형식입니다.

단독으로 사용하려면 %을(를) 접두사로 붙입니다.

숫자 형식

작업닫힘 고객 데이터 모음, 메시지 또는 음악 재생 또는 상담원에게 컨택 라우팅과 같은 Studio 스크립트 내에서 프로세스를 수행합니다. 또는 format() 등의 함수가 숫자 값을 반환할 형식을 정의하는 데 필요한 경우 다음과 같은 형식 지정자 문자를 사용하십시오. 화폐, 백분율, 고정 소수점 숫자 등 다양한 용도를 위한 지정자 문자가 있습니다.

정밀도 지정자

이 섹션에서 설명하는 형식 지정자 중 상당수는 정밀도 지정자를 수락합니다. 정밀도 지정자를 사용하면 출력되는 숫자에 포함할 소수점 뒤의 자릿수를 정의할 수 있습니다.

정밀도 지정자는 형식 지정자 다음에 포함하는 숫자입니다. 다음 예시에서 C은(는) 형식 지정자고 3은(는) 정밀도 지정자입니다. 출력되는 숫자가 소수점 다음에 세 자리 숫자를 표시할 것임을 나타냅니다.

ASSIGN CurrencyResultBigC = "{StringVal.format('C3')}"

시작 숫자가 0013001.93912837면 이 예시에서 출력되는 숫자는 $13,001.939입니다.

숫자 지정자

숫자 유형 형식 지정자 세부 사항 설명Details Description
통화 C 또는 c

숫자는 통화 금액을 나타내는 문자열로 변환됩니다. 숫자가 가지기를 원하는 소수점의 개수를 나타내는 형식 지정자가 있는 번호를 포함합니다. 형식 지정자의 대소문자는 결과에 영향을 주지 않습니다.

ASSIGN StringVal = "0013001.93912837"
ASSIGN CurrencyResult = "{StringVal.format('C')}"
ASSIGN CurrencyResult3 = "{StringVal.format('C3')}"

결과:

CURRENCYRESULT=$13,001.94

CURRENCYRESULT3=$13,001.939

지수 표기법(과학) E 또는 e

E0

E-0

e0

e+0

e-0

숫자는 -d.ddd…E+ddd 또는 -d.ddd…e+ddd 형태의 문자열로 변환되며, 여기서 각 d은(는) 숫자(0~9)를 나타냅니다. 숫자가 음수이면 문자열은 빼기 기호로 시작합니다. 소수점 앞에는 항상 한 자리 숫자가 옵니다.

소수점 뒤에 표시되기를 원하는 자릿수를 나타내는 형식 지정자가 있는 숫자를 포함합니다. 정밀도 지정자를 포함하지 않으면 스크립트의 기본값은 6자리 소수점 아래 숫자입니다.

형식 지정자의 대소문자는 출력의 지수에 E 또는 e이(가) 접두사로 붙는지 여부를 나타냅니다. 지수는 항상 더하기 또는 빼기 기호와 최소 3자리 숫자로 구성됩니다. 지수는 필요한 경우 이 최소값을 충족하기 위해 0이 채워집니다.

문자열 E, E+, E-, e, e+, 또는 e-이(가0 형식 문자열에 있고 바로 뒤에 하나 이상의 0 문자가 오는 경우, 숫자와 지수 사이에 E 또는 e(이)가 삽입된 과학적 표기법을 사용하여 숫자 형식이 지정됩니다.

과학 표기법 표시기 뒤에 오는 0 문자의 수는 지수에 대해 출력할 최소 자릿수를 결정합니다. E+e+ 형식은 부호 문자(더하기 또는 빼기)가 항상 지수 앞에 와야 함을 나타냅니다. E, E-, e, 또는 e- 형식은 기호 문자는 음수 지수 앞에만 붙어야 함을 나타냅니다.

 ASSIGN StringVal = "0013001.93912837"
ASSIGN ScientificResult = "{StringVal.format('e')}"		
ASSIGN ScientificResult = "{StringVal.format('E2')}"	

결과:

SCIENTIFICRESULT=1.300194e+004

SCIENTIFICRESULT2=1.300194E+004

고정 소수점 F 또는 f

숫자는 -ddd.ddd… 형식의 문자열로 변환되며, 여기서 각 d은(는) 숫자(0~9)를 나타냅니다. 숫자가 음수이면 문자열은 빼기 기호로 시작합니다.

결과에 표시되기를 원하는 소수점 아래 자릿수를 나타내는 형식 지정자가 있는 숫자를 포함합니다. 정밀도 지정자가 없으면 스크립트의 기본값은 소수점 아래 2자리입니다.

ASSIGN StringVal = "0013001.93912837"
ASSIGN FixedPointResult = "{StringVal.format('F3')}"
ASSIGN FixedPointResult2 = "{StringVal.format('f')}"

결과:

FIXEDPOINTRESULT=13001.939

FIXEDPOINTRESULT2=13001.94

일반 G 또는 g

숫자는 숫자 형식과 정밀도 지정자의 포함 여부에 따라 가장 간단한 고정 소수점 또는 과학적 표기법으로 변환됩니다. 정밀도 지정자를 생략하거나 0인 경우, 다음 목록에 표시된 대로 숫자 형식에 따라 기본 정밀도가 결정됩니다.

  • Byte 또는 SByte: 3
  • Int16 또는 UInt16: 5
  • Int32 또는 UInt32: 10
  • Int64 또는 UInt64: 19
  • Single: 7
  • Double: 15
  • Decimal: 29

과학 표기법으로 숫자를 표현한 결과 지수가 -5보다 크고 정밀도 지정자보다 작은 경우, 고정 소수점 표기법이 사용됩니다. 그렇지 않으면 과학적 표기법이 사용됩니다. 필요한 경우 결과에 소수점이 포함되며, 후행 0은 생략됩니다.

정밀도 지정자가 있고 결과의 유효 자릿수가 지정된 정밀도를 초과하는 경우 초과되는 후행 자릿수는 반올림하여 제거됩니다. 앞의 규칙에 대한 예외는 숫자가 소수점이고 정밀도 지정자가 생략된 경우입니다. 이 경우 고정 소수점 표기법이 항상 사용되며 후행 0을 유지합니다.

과학적 표기법을 사용하는 경우 형식 지정자가 G이면 결과의 지수에 E 접두사가 붙고 형식 지정자가 g이면 e이(가) 접두사로 붙습니다.

ASSIGN StringVal = "0013001.93912837"
ASSIGN GeneralResult1 = "{StringVal.format('G')}"
ASSIGN StringVal2 = 6002348902348890234.234432234
ASSIGN GeneralResult2 = "{StringVal2.format('G')}"

결과:

GENERALRESULT1=13001.93912837

GENERALRESULT2=6.00234890234889E+18

16진수 X 또는 x

이 형식은 정수 형식에만 지원됩니다. 숫자는 16진수 문자열로 변환됩니다. 형식 지정자의 대소문자는 9보다 큰 16진수에 대문자 또는 소문자를 사용할지 여부를 나타냅니다. 예를 들면 ABCDEF을(를) 생성하려면 X을(를) 사용하고 abcdef을(를) 생성하려면 x을(를) 사용합니다.

정밀도 지정자는 결과 문자열에서 원하는 최소 자릿수를 나타냅니다. 필요한 경우 숫자 왼쪽에 0이 채워져 정밀도 지정자가 지정한 자릿수가 생성됩니다.

번호 N 또는 n

숫자는 -d,ddd,ddd.ddd… 형식의 문자열로 변환됩니다.

  • 빼기 기호(-)는 필요할 때 붙는 음수 기호를 나타냅니다.
  • 각각의 d은(는) 숫자(0~9)를 나타내고
  • 쉼표(,)는 숫자 그룹 사이의 천 단위 구분 기호를 나타내며
  • 마침표(.)는 소수점 기호를 나타냅니다.

결과가 가지기를 원하는 소수점 자릿수의 개수를 나타내는 정밀도 지정자를 포함합니다. 정밀도 지정자가 포함되면 기본값은 소수점 아래 2자리입니다. 숫자에 소수점이 포함되어 있지 않으면 출력 숫자에 .00이(가) 추가됩니다.

ASSIGN StringVal = "0013001.93912837"
ASSIGN NumberResult = StringVal.format('N')
ASSIGN NumberResult2 = "{StringVal.format('n2')}"

결과:

NUMBERRESULT=13,001.94

NUMBERRESULT2=13,001.9391

퍼센트 P 또는 p

숫자는 백분율(퍼센트)을 나타내는 문자열로 변환됩니다. 변환된 숫자에 100을 곱하여 백분율로 표시합니다.

결과가 가지기를 원하는 소수점 자릿수의 개수를 나타내는 정밀도 지정자를 포함합니다. 정밀도 지정자가 포함되면 기본값은 소수점 아래 2자리입니다. 숫자에 소수점이 포함되어 있지 않으면 출력 숫자에 .00이(가) 추가됩니다.

ASSIGN StringVal = "0013001.93912837"
ASSIGN PercentResult = "{StringVal.format('P')}"
ASSIGN PercentResult2 = StringVal.format('P2')	

결과:

PERCENTRESULT=1,300,193.91%

PERCENTRESULT2=1,300,193.91%

라운드 트립 R 또는 r

이 형식은 Single 및 Double 형식에만 지원됩니다. 라운드 트립(round-trip) 지정자의 경우, 문자열로 변환된 숫자 값이 동일한 숫자 값으로 다시 구문 분석됩니다. 숫자 값이 이 지정자를 사용하여 형식이 지정되면, Double의 경우 15자리 정밀도, Single의 경우 7자리의 정밀도가 있는 일반 형식을 사용하여 먼저 테스트됩니다. 값이 동일한 숫자 값으로 구문 분석되면 일반 형식 지정자를 사용하여 형식이 지정됩니다. 그러나 값이 동일한 숫자 값으로 다시 구문 분석되지 않으면 Double의 경우 17자리 정밀도, Single의 경우 9자리 정밀도를 사용하여 값의 형식이 지정됩니다.

정밀도 지정자가 있을 수 있지만 무시됩니다. 이 지정자를 사용할 때 라운드 트립이 정밀도보다 우선합니다.

ASSIGN StringVal = "0013001.93912837"
ASSIGN RoundTripResult = "{StringVal.format('R')}"	

결과:

ROUNDTRIPRESULT=13001.93912837

0 자리 표시자 0

하나 이상의 0 자리 표시자를 사용하여 출력되는 숫자의 형식을 정의합니다. 이 자리 표시자를 이 테이블에서 정의하는 다른 자리 표시자와 결합할 수 있습니다.

형식을 지정하는 값의 형식 문자열에 0이 표시되는 위치에 숫자가 있는 경우에는 그 숫자가 출력 문자열에 표시됩니다. 형식 문자열에 0이 표시되는 위치에 아무 숫자도 표시되지 않는 경우에는 출력 문자열에 대신 0이 표시됩니다. 앞에 0이 표시되어야 하지만 없는 숫자에 0을 추가할 때 유용할 수 있습니다.

소수점 앞의 맨 왼쪽 ‘0’과 소수점 뒤의 맨 오른쪽 ‘0’의 위치에 따라 출력 문자열에 항상 표시되는 자릿수 개수가 결정됩니다.

00 지정자를 사용하면 값이 소수점 앞의 가장 가까운 숫자로 반올림됩니다.

ASSIGN number = "2343456.2343"
ASSIGN zeroPlaceholders = "number.format(000,000.00)
ASSIGN number = "456.47"
ASSIGN doubleZeroSpecifier = number.format('00')

예시의 결과입니다

zeroPlaceholders = 2,343,456.23

doubleZeroSpecifier = 456

숫자 자리 표시자 #

하나 이상의 자릿수 자리 표시자를 사용하여 출력되는 숫자의 형식을 정의합니다. 이 자리 표시자를 이 테이블에서 정의하는 다른 자리 표시자와 결합할 수 있습니다.

형식을 지정하는 값의 형식 문자열에 # 기호가 표시되는 위치에 숫자가 있는 경우에는 그 숫자가 출력 문자열에 표시됩니다. 형식 문자열에 # 기호가 표시되는 위치에 아무 숫자도 표시되지 않는 경우에는 출력 문자열에서 해당 위치가 비어 있습니다.

형식이 지정되는 숫자에 유효 자릿수로 0이 포함되어 있으면 출력 문자열에 0이 표시됩니다. 0이 유효 자릿수가 아니면 0이 문자열에서 형식을 지정할 유일한 숫자여도 출력 문자열에 표시되지 않습니다.

## 형식 문자열을 사용하면 값이 가장 가까운 정수로 반올림됩니다.

ASSIGN number = "2343456.2043"
ASSIGN digitPlaceholders = "number.format(###,###.##)
ASSIGN number = "456.47"
ASSIGN doubleDigitSpecifier = number.format('##')

예시의 결과입니다

digitPlaceholders = 2,343,456.2

doubleDigitSpecifier = 456

소수점 .

형식 문자열 내의 첫 번째 마침표(.) 문자는 형식이 지정된 값의 소숫점 구분자 위치를 결정합니다. 추가적인 모든 마침표 문자는 무시됩니다.

천 단위 구분 기호 및 숫자 크기 조정 ,

쉼표(,) 문자는 천 단위 구분 기호 지정자 및 숫자 크기 조정 지정자 역할을 합니다.

천 단위 구분 기호 지정자: 숫자의 정수를 형식화하는 2자리 자리 표시자(0 또는 #) 사이에 하나 이상의 쉼표(,) 문자가 지정된 경우 출력의 정수 부분에 있는 각 숫자 그룹 사이에 그룹 구분 문자가 삽입됩니다. 예를 들어 문자열 #,# 및 고정 문화권을 사용하여 숫자 1000의 형식을 지정하는 경우 출력은 1,000입니다.

숫자 크기 조정 지정자: 명시적 또는 암시적 소수점 바로 왼쪽에 하나 이상의 쉼표(,) 문자가 지정되면 각각의 숫자 크기 조정 지정자에 대해 서식을 지정할 숫자를 1000으로 나눕니다. 예를 들어, 문자열 0,,을(를) 사용하여 숫자 1억의 형식을 지정하는 경우 출력은 100입니다.

동일한 형식 문자열에서 천 단위 구분 기호 및 숫자 크기 조정 지정자를 사용할 수 있습니다. 예를 들어 문자열 #,0,, 및 고정 문화권을 사용하여 숫자 10억의 형식을 지정하는 경우 출력은 1,000입니다.

섹션 구분 기호 ;

숫자를 위한 2~3개의 가능한 형식 지정 옵션을 정의할 수 있습니다. 숫자가 양수, 음수, 또는 0인지의 여부에 따라 형식 지정이 적용됩니다.

형식 지정 옵션은 단일 문자열에서 정의됩니다. 각 옵션은 세미콜론(;) 문자에 의해 구분됩니다. 아래 예시처럼 0, 자릿수, 1천, 소수 자리 표시자를 사용하여 형식 지정을 정의합니다. 이러한 자리 표시자는 이 테이블에서 설명합니다.

사용자 지정 형식 문자열에 섹션이 2개 있는 경우:

  • 왼쪽 섹션에서는 양수와 0 숫자의 형식 지정을 정의합니다.
  • 오른쪽 섹션에서는 음수의 형식 지정을 정의합니다.

예:

ASSIGN number9 = 928374
ASSIGN sectionSeparator4 = number9.format('000,000.##;00.##')

ASSIGN number10 = -998822.25
ASSIGN sectionSeparator5 = number10.format('000,000.##;00.##')

ASSIGN number11 = 0
ASSIGN sectionSeparator6 = number11.format('000,000.##;00.##')	

예시의 결과입니다

sectionSeparator4 = 928,374

sectionSeparator5 = 998822.25

sectionSeparator6 = 000,000

섹션이 3개 있는 경우:

  • 왼쪽 섹션에서는 양수의 형식 지정을 정의합니다.
  • 중간 섹션에서는 음수의 형식 지정을 정의합니다.
  • 오른쪽 섹션에서는 0의 형식 지정을 정의합니다.

예:

ASSIGN number1 = 1789789
ASSIGN sectionSeparator1 = number1.format('000,000.##;00.##;000.0000')

ASSIGN number2 = 0
ASSIGN sectionSeparator2 = number2.format('000,000.##;00.##;000.0000')

ASSIGN number3 = -4321
ASSIGN sectionSeparator3 = number3.format('000,000.##;00.##;000.0000')

예시의 결과입니다

sectionSeparator1 = 1,789,789

sectionSeparator2 = 000.0000

sectionSeparator3 = 4321

기타 모든 문자 기타

기타 모든 문자

기타 모든 문자는 결과 문자열에 복사되며 형식에 영향을 주지 않습니다.

이스케이프 시퀀스

Studio은(는) 문자열 상수 내에서 이스케이프 시퀀스를 지원합니다. 이스케이프 시퀀스를 사용하면 문자열에 특정한 특수 문자를 포함할 수 있습니다. 큰따옴표 또는 열림 중괄호 등의 문자는 코드로 인식됩니다. 문자열에 포함되면 컴파일러가 리터럴 값 대신 비 리터럴 코드 의미로 이를 해석합니다. 이스케이프 시퀀스를 사용하면 문자열에 이러한 문자를 포함할 수 있습니다. 이스케이프 시퀀스 없이 이러한 문자를 문자열에 포함하면, 예상과 다른 결과가 출력되며, 오류가 발생할 수 있습니다.

변환된 XML 또는 JSON이 포함된 문자열에 이스케이프 시퀀스를 추가할 필요가 없습니다. 이스케이프 시퀀스는 이를 필요로 하는 문자에 자동으로 추가됩니다.

이스케이프 시퀀스를 사용하는 모든 문자열의 접두사로 달러 기호($)를 사용하십시오: $"...". 큰따옴표 안에 다음과 같은 이스케이프 시퀀스 중 아무것이나 사용할 수 있습니다.

시퀀스 세부사항
\" 큰따옴표를 포함합니다.
\' 작은따옴표를 포함합니다.
\t 탭을 포함합니다(ASCII 9).
\r 캐리지 리턴을 포함합니다(ASCII 13).
\n 줄 바꿈을 포함합니다(ASCII 10).
\b 백스페이스를 포함합니다(ASCII 8).
\{ 열린 중괄호를 포함합니다. 앞의 텍스트에 이스케이프된 열림 중괄호가 없는 경우에는 닫힘 중괄호를 이스케이프할 필요가 없습니다. 닫힘 중괄호를 이스케이프해야 하는 경우에는 '\}'과(와) 같습니다.
\0 null을 포함합니다(0은 영입니다).

다음 예시에서는 \n 이스케이프를 사용하여 문자열에 라인 피드를 추가합니다. 줄의 시작 부분으로 돌아갈 필요 없이 다음 줄로 커서를 이동합니다.

x = $"A phrase\nAnd a new line"

문자열이 출력되면 출력 결과는 다음과 같습니다.

A phrase

And a new line ]

앞의 예시에서 닫힘 대괄호는 커서를 의미합니다.

다음 예시에서는 \" 이스케이프 시퀀스를 사용하여 문자열에 큰따옴표를 추가합니다.

y = $"Embedding \"double quotes\" in a string."

문자열이 출력되면 출력 결과는 다음과 같습니다: Embedding "double quotes" in a string. 이스케이프 시퀀스가 없으면 스크립트는 단어 double 앞에 있는 따옴표까지의 문자열만을 인식합니다.

다음 예시에서는 \{ 이스케이프 시퀀스를 사용하여 문자열 내의 리터럴 중괄호를 포함합니다.

z = $"Using \{curly} braces."

문자열이 출력되면 출력 결과는 다음과 같습니다: Using {curly} braces. 이스케이프 시퀀스가 없으면 스크립트는 {curly}을(를) 변수로 해석합니다. 변수 중괄호에 대한 값을 찾지 못하면 스크립트는 이를 아무것으로도 대체하지 않으며, 따라서 변수의 값은 Using braces.입니다.

기타 문자

문자 설명
" 따옴표 붙은 문자열(큰따옴표)을 나타냅니다. 두 개의 큰따옴표(”) 사이에 있는 문자열의 리터럴(literal) 값을 표시합니다. 리터럴 따옴표로 표시해야 하는 스크립트 내의 아무 위치에나 이스케이프 문자(\)를 사용합니다.
' 따옴표 붙은 문자열(아포스트로피)을 나타냅니다. 두 개의 아포스트로피(’) 사이에 있는 문자열의 리터럴(literal) 값을 표시합니다. 리터럴 아포스트로피(') 문자를 사용해야 하는 스크립트 내의 아무 위치에나 이스케이프 문자(\)를 사용합니다.
$

이스케이프 시퀀스를 포함한 문자열에 접두사를 붙이는 데 사용합니다. $ 문자는 큰따옴표 외부에 있어야 합니다. 예:

z = $"Use the \{myVar} variable."

#

값 앞에 접두사를 붙여서 날짜/시간 유형으로 선언합니다. # 문자는 큰따옴표 외부에 있어야 합니다. 예:

ASSIGN var = #"02/09/2023"

% 단일 지정자만을 사용할 때 날짜/시간 형식 지정 지정자에 사용합니다. % 문자는 지정자 문자의 형식을 지정하기 전에 직접 적용됩니다. 예를 들어 '분'만을 출력하려면 %m을(를) 사용합니다.