적응 식 미리 빌드된 함수

적용 대상: SDK v4

이 문서에서는 사용 가능한 미리 빌드된 함수를 범용 순서로 나열합니다. 미리 빌드된 함수 및 식 구문에 사용되는 연산자에 대한 자세한 내용은 연산자를 참조 하세요.

미리 빌드된 식은 다음 함수 형식으로 나뉩니다.

• String
• 컬렉션
• 논리적 비교
• 전환
• Math
• 날짜
• 타이 멕 스
• URI 구문 분석
• 개체 조작 및 생성
• 정규식
• 형식 검사

목록을 사전순으로 볼 수도 있습니다.

문자열 함수

함수	설명
length	문자열의 길이를 반환합니다.
replace	하위 문자열을 지정된 문자열로 바꾸고 업데이트된 문자열을 반환합니다. 이 함수는 대/소문자를 구분합니다.
replaceIgnoreCase	하위 문자열을 지정된 문자열로 바꾸고 업데이트된 문자열을 반환합니다. 이 함수는 대/소문자를 구분하지 않습니다.
split	지정된 구분 기호에 따라 부분 문자열이 포함된 배열을 반환합니다.
substring	문자열에서 문자를 반환합니다.
toLower	문자열을 선택적 로캘 형식으로 소문자로 반환합니다.
toUpper	선택적 로캘 형식으로 대문자로 문자열을 반환합니다.
trim	문자열에서 선행 공백과 후행 공백을 제거합니다.
addOrdinal	입력 숫자의 서수를 반환합니다.
endsWith	문자열이 특정 하위 문자열로 종료하는지 검사합니다. 부분 문자열이 발견되면 반환 true 하거나, 찾을 수 없는 경우 반환 false 합니다. 이 함수는 대/소문자를 구분하지 않습니다.
startsWith	문자열이 특정 하위 문자열로 시작하는지 검사합니다. 부분 문자열이 발견되면 반환 true 하거나, 찾을 수 없는 경우 반환 false 합니다. 이 함수는 대/소문자를 구분하지 않습니다.
countWord	지정된 문자열의 단어 수를 반환합니다.
concat	둘 이상의 문자열을 결합하고 결과 문자열을 반환합니다.
newGuid	새 Guid 문자열을 반환합니다.
indexOf	부분 문자열 의 시작 위치 또는 인덱스 값을 반환하거나 지정된 개체를 검색하고 전체 목록 내에서 처음 나타나는 인덱스(0부터 시작)를 반환합니다. 이 함수는 대/소문자를 구분하지 않으며 인덱스는 숫자 0으로 시작합니다.
lastIndexOf	마지막 부분 문자열 의 시작 위치 또는 인덱스 값을 반환하거나 지정된 개체를 검색하고 목록의 요소 범위 내에서 마지막으로 발생한 항목의 인덱스(0부터 시작)를 반환합니다. 이 함수는 대/소문자를 구분하지 않으며 인덱스는 숫자 0으로 시작합니다.
sentenceCase	문자열에서 첫 번째 단어의 첫 글자를 선택적 로컬 형식으로 대문자로 표시합니다.
titleCase	각 단어의 첫 글자를 선택적 로캘 형식으로 문자열로 대문자로 표시합니다.
reverse	문자열 또는 배열에 있는 요소의 순서를 반대로 바뀝다.

컬렉션 기능

함수	설명
contains	문자열에서 항목을 찾거나 배열에서 항목을 찾거나 복잡한 개체에서 매개 변수를 찾기 위해 작동합니다. 예: contains('hello world', 'hello') contains(createArray('1','2'), '1') contains(json("{'foo':'bar'}"), 'foo')
first	컬렉션에서 첫 번째 항목을 반환합니다.
join	배열의 모든 항목을 포함하고 각 문자가 구분 기호로 구분된 문자열을 반환합니다. 예: join(createArray('a','b'), '.') = "a.b"
last	컬렉션에서 마지막 항목을 반환합니다.
count	컬렉션의 항목 수를 반환합니다.
foreach	각 요소에서 작동하고 새 컬렉션을 반환합니다.
union	지정한 컬렉션에서 모든 항목이 있는 컬렉션을 반환합니다.
skip	컬렉션 앞의 항목을 제거하고 나머지 항목을 반환합니다.
take	컬렉션 앞에서 항목을 반환합니다.
intersection	지정한 컬렉션에서 공통 항목만 있는 컬렉션을 반환합니다.
subArray	지정된 시작 및 끝 위치에서 하위 배열을 반환합니다. 인덱스 값은 숫자 0으로 시작합니다.
select	각 요소에 대해 작동하고 변환된 요소의 새 컬렉션을 반환합니다.
where	각 요소에 대해 필터링하고 특정 조건과 일치하는 필터링된 요소의 새 컬렉션을 반환합니다.
sortBy	컬렉션의 요소를 오름차순으로 정렬하고 정렬된 컬렉션을 반환합니다.
sortByDescending	컬렉션의 요소를 내림차순으로 정렬하고 정렬된 컬렉션을 반환합니다.
indicesAndValues	인덱스 및 값 속성을 사용하여 배열 또는 개체를 개체의 배열로 변환합니다.
평면화	배열이 아닌 값이 포함된 배열로 배열을 평면화합니다.
unique	배열에서 모든 중복 항목을 제거합니다.
any	시퀀스의 요소가 조건을 충족하는지 여부를 결정합니다.
all	시퀀스의 모든 요소가 조건을 충족하는지 여부를 확인합니다.
reverse	문자열 또는 배열에 있는 요소의 순서를 반대로 바뀝다.
merge	배열의 여러 JSON 개체 또는 항목을 함께 병합합니다.

논리적 비교 기능

함수	설명
and	논리 및 지정된 모든 식이 true로 평가되면 true를 반환합니다.
equals	비교가 같습니다. 지정된 값이 같으면 true를 반환합니다.
empty	대상이 비어 있는지 확인합니다.
greater	비교가 보다 큽다. 첫 번째 값이 더 크면 true를 반환하고, 더 작으면 false를 반환합니다.
greaterOrEquals	비교가 크거나 같음 true 첫 번째 값이 크거나 같으면 반환하거나 첫 번째 값이 작으면 반환 false 합니다.
if	식이 true인지 또는 false인지 검사합니다. 결과에 기반해 지정한 값을 반환합니다.
less	연산보다 비교가 적습니다. 첫 번째 값이 더 작으면 true를 반환하고, 첫 번째 값이 더 크면 false를 반환합니다.
lessOrEquals	보다 작거나 같은 연산을 비교합니다. true 첫 번째 값이 작거나 같으면 반환하거나 첫 번째 값이 더 많은 경우 반환 false 합니다.
not	논리 not 연산자입니다. 식이 false이면 true를 반환하고 true이면 false를 반환합니다.
or	논리 또는 작업입니다. 하나 이상의 식이 true이면 반환 true 하거나 모두 false이면 반환 false 합니다.
exists	진실성에 대한 식을 평가합니다.

변환 함수

함수	설명
float	지정된 문자열의 부동 소수점 표현을 반환합니다.
int	지정된 문자열의 정수 표현을 반환합니다.
string	지정된 값의 문자열 버전을 선택적 로캘 형식으로 반환합니다.
부울	지정된 문자열의 부울 표현을 반환합니다.
createArray	여러 입력에서 배열을 만듭니다.
json	JSON(JavaScript Object Notation) 형식 값 또는 문자열 또는 XML의 개체를 반환합니다.
base64	문자열 또는 바이트 배열의 base64로 인코딩된 버전을 반환합니다.
base64ToBinary	Base64로 인코딩된 문자열에 대한 이진 버전을 반환합니다.
base64ToString	Base64로 인코딩된 문자열의 문자열 버전을 반환합니다.
binary	입력 값에 대한 이진 버전을 반환합니다.
dataUri	입력 값에 대한 URI를 반환합니다.
dataUriToBinary	데이터 URI의 이진 버전을 반환합니다.
dataUriToString	데이터 URI의 문자열 버전을 반환합니다.
uriComponent	이스케이프 문자로 URL 안전하지 않은 문자를 대체하여 입력 값에 대한 URI로 인코딩된 버전을 반환합니다.
uriComponentToString	URI로 인코딩된 문자열의 문자열 버전을 반환합니다.
xml	문자열의 XML 버전을 반환합니다.
formatNumber	지정된 소수 자릿수와 선택적으로 지정된 로캘에 가장 가까운 숫자로 값의 서식을 지정합니다.
jsonStringify	값의 JSON 문자열을 반환합니다.
stringOrValue 문자열 보간을 래핑하여 실제 값을 가져옵니다. 예를 들어 stringOrValue('${1}') 숫자 1을 반환하고 stringOrValue('${1} item') 문자열 "1 항목"을 반환합니다.

수식 함수

함수	설명
abs	지정된 숫자의 절대값을 반환합니다.
add	수학 및. 두 개의 숫자(순수 숫자 대/소문자)를 추가하거나 두 개 이상의 문자열을 연결하여 결과를 반환합니다.
div	수학 나누기. 두 숫자를 나눈 정수 결과를 반환합니다.
max	컬렉션에서 가장 큰 값을 반환합니다.
min	컬렉션에서 가장 작은 값을 반환합니다.
mod	두 숫자를 나눈 나머지를 반환합니다.
mul	수학 곱하기. 두 숫자를 곱한 결과를 반환합니다.
rand	지정된 최소값과 최대값 사이의 난수를 반환합니다.
sqrt	지정된 숫자의 제곱근을 반환합니다.
sub	수학 빼기. 첫 번째 숫자에서 두 번째 숫자를 뺀 결과를 반환합니다.
sum	배열에 있는 숫자의 합을 반환합니다.
range	지정한 정수에서 시작하는 정수 배열을 반환합니다.
exp	한 숫자의 다른 숫자에 대한 지수를 반환합니다.
평균의	숫자 배열의 평균 수를 반환합니다.
floor	지정된 숫자보다 작거나 같은 가장 큰 정수 값을 반환합니다.
ceiling	지정된 숫자보다 크거나 같은 가장 작은 정수 값을 반환합니다.
round	값을 가장 가까운 정수 또는 지정된 소수 자릿수로 반올림합니다.

날짜 및 시간 함수

함수	설명
addDays	지정된 타임스탬프에 지정된 일 수를 선택적 로캘 형식으로 추가합니다.
addHours	지정된 시간(시간)을 선택적 로캘 형식으로 지정된 타임스탬프에 추가합니다.
addMinutes	지정된 타임스탬프에 지정된 시간(분)을 선택적 로캘 형식으로 추가합니다.
addSeconds	지정된 타임스탬프에 지정된 시간(초)을 추가합니다.
dayOfMonth	지정된 타임스탬프 또는 Timex 식에 대한 월의 날짜를 반환합니다.
dayOfWeek	지정된 타임스탬프에 대한 요일을 반환합니다.
dayOfYear	지정된 타임스탬프에 대한 연도의 날을 반환합니다.
formatDateTime	선택적 로캘 형식으로 타임스탬프를 반환합니다.
formatEpoch	UNIX Epoch 시간(Unix 시간, POSIX 시간)에서 선택적 로캘 형식으로 타임스탬프를 반환합니다.
formatTicks	틱에서 선택적 로캘 형식으로 타임스탬프를 반환합니다.
subtractFromTime	선택적 로캘 형식으로 타임스탬프에서 여러 시간 단위를 뺍니다.
utcNow	현재 타임스탬프를 선택적 로캘 형식으로 문자열로 반환합니다.
dateReadBack	날짜-시간 라이브러리를 사용하여 날짜 읽기 저장을 제공합니다.
month	지정된 타임스탬프의 월을 반환합니다.
date	지정된 타임스탬프에 대한 날짜를 반환합니다.
year	지정된 타임스탬프에 대한 연도를 반환합니다.
getTimeOfDay	지정된 타임스탬프에 대한 하루 중 시간을 반환합니다.
getFutureTime	현재 타임스탬프를 선택적 로캘 형식과 지정된 시간 단위로 반환합니다.
getPastTime	현재 타임스탬프를 지정된 시간 단위를 뺀 선택적 로캘 형식으로 반환합니다.
addToTime	선택적 로캘 형식으로 타임스탬프에 여러 시간 단위를 추가합니다.
convertFromUTC	UTC(Universal Time Coordinated)에서 선택적 로캘 형식으로 타임스탬프를 변환합니다.
convertToUTC	선택적 로캘 형식의 타임스탬프를 UTC(유니버설 타임 조정)로 변환합니다.
startOfDay	타임스탬프의 날짜 시작을 선택적 로캘 형식으로 반환합니다.
startOfHour	타임스탬프의 시간 시작을 선택적 로캘 형식으로 반환합니다.
startOfMonth	선택적 로캘 형식으로 타임스탬프에 대한 월의 시작을 반환합니다.
ticks	지정된 타임스탬프의 틱 속성 값을 반환합니다.
ticksToDays	틱 속성 값을 일 수로 변환합니다.
ticksToHours	틱 속성 값을 시간 수로 변환합니다.
ticksToMinutes	틱 속성 값을 분 수로 변환합니다.
dateTimeDiff	두 타임스탬프 사이의 틱 차이를 반환합니다.
getPreviousViableDate	현재 날짜 및 선택적으로 지정된 표준 시간대를 기준으로 Timex 식의 실행 가능한 이전 날짜를 반환합니다.
getNextViableDate	현재 날짜 및 선택적으로 지정된 표준 시간대를 기준으로 Timex 식의 다음 실행 가능한 날짜를 반환합니다.
getPreviousViableTime	현재 시간 및 선택적으로 지정된 표준 시간대를 기준으로 Timex 식의 이전 실행 가능한 시간을 반환합니다.
getNextViableTime	현재 시간 및 선택적으로 지정된 표준 시간대를 기준으로 Timex 식의 다음 실행 가능한 시간을 반환합니다.

Timex 함수

함수	설명
isPresent	TimexProperty 또는 Timex 식이 현재를 참조하는 경우 true를 반환합니다.
isDuration	TimexProperty 또는 Timex 식이 기간을 참조하는 경우 true를 반환합니다.
isTime	TimexProperty 또는 Timex 식이 시간을 참조하는 경우 true를 반환합니다.
isDate	TimexProperty 또는 Timex 식이 날짜를 참조하는 경우 true를 반환합니다.
isTimeRange	TimexProperty 또는 Timex 식이 시간 범위를 참조하면 true를 반환합니다.
isDateRange	TimexProperty 또는 Timex 식이 날짜 범위를 참조하는 경우 true를 반환합니다.
isDefinite	TimexProperty 또는 Timex 식이 명확한 날을 참조하는 경우 true를 반환합니다.
해결하다	유효한 시간을 참조하는 경우 지정된 TimexProperty 또는 Timex 식의 문자열을 반환합니다. 유효한 시간에는 시간, 분 및 초가 포함됩니다.

URI 구문 분석 함수

함수	설명
uriHost	URI(Uniform Resource Identifier)의 호스트 값을 반환합니다.
uriPath	URI(Uniform Resource Identifier)의 경로 값을 반환합니다.
uriPathAndQuery	URI(Uniform Resource Identifier)에 대한 경로 및 쿼리 값을 반환합니다.
uriPort	URI(Uniform Resource Identifier)의 포트 값을 반환합니다.
uriQuery	URI(Uniform Resource Identifier)의 쿼리 값을 재구성합니다.
uriScheme	URI(Uniform Resource Identifier)의 체계 값을 반환합니다.

개체 조작 및 생성 함수

함수	설명
addProperty	JSON 개체에 속성과 해당 값 또는 이름-값 쌍을 추가하고 업데이트된 개체를 반환합니다.
removeProperty	JSON 개체에서 속성을 제거하고 업데이트된 개체를 반환합니다.
setProperty	JSON 개체의 속성 값을 설정하고 업데이트된 개체를 반환합니다.
getProperty	JSON 개체에서 지정된 속성 또는 루트 속성의 값을 반환합니다.
coalesce	하나 이상의 매개 변수에서 Null이 아닌 첫 번째 값을 반환합니다.
xPath	XPath(XML 경로 언어) 식과 일치하는 노드 또는 값에 대한 XML을 확인하고 일치하는 노드 또는 값을 반환합니다.
jPath	경로 식과 일치하는 노드 또는 값에 대한 JSON 또는 JSON 문자열을 확인하고 일치하는 노드를 반환합니다.
setPathToValue	특정 경로의 값을 설정하고 값을 반환합니다.

정규식 함수

함수	설명
isMatch	문자열이 일반적인 regex 패턴과 일치하면 true를 반환합니다.

형식 검사 함수

함수	설명
EOL	줄 끝(EOL) 시퀀스 텍스트를 반환합니다.
isInteger	지정된 입력이 정수이면 true를 반환합니다.
isFloat	지정된 입력이 부동 소수점 숫자인 경우 true를 반환합니다.
isBoolean	지정된 입력이 부울이면 true를 반환합니다.
isArray	지정된 입력이 배열이면 true를 반환합니다.
isObject	지정된 입력이 개체이면 true를 반환합니다.
isDateTime	지정된 입력이 UTC ISO 형식 타임스탬프이면 true를 반환합니다.
isString	지정된 입력이 문자열이면 true를 반환합니다.

사전 빌드된 함수는 사전순으로 정렬됩니다.

abs

지정된 숫자의 절대값을 반환합니다.

abs(<number>)

매개 변수	필수	Type	설명
<number>	예	number	의 절대값을 가져올 수 있는 숫자

반환 값	Type	Description
<result>	number	절대값을 계산한 결과입니다.

예제

다음 예제에서는 절대값을 계산합니다.

abs(3.12134)
abs(-3.12134)

그리고 둘 다 결과 3.12134를 반환합니다.

add

두 개 이상의 숫자(순수 숫자 대/소문자)를 추가하거나 두 개 이상의 문자열(다른 경우)을 연결하여 결과를 반환합니다.

add(<item1>, <item2>, ...)

매개 변수	필수	Type	설명
<item1>, <item2>,...	예	any	항목

반환 값	Type	설명
<result-sum>	숫자 또는 문자열	지정된 숫자 또는 concat 결과를 추가한 결과입니다.

예제

이 예제는 지정한 숫자들을 더합니다.

add(1, 1.5)

그리고 결과 2.5를 반환합니다.

이 예제에서는 지정된 항목을 연결합니다.

add('hello',null)
add('hello','world')

그리고 결과를 반환합니다.

• hello
• helloworld

addDays

선택적 로캘 형식으로 타임스탬프에 일 수를 추가합니다.

addDays('<timestamp>', <days>, '<format>'?, '<locale>'?)

매개 변수	필수	Type	설명
<timestamp>	예	string	표준 UTC ISO 형식이어야 하는 타임스탬프가 포함된 문자열입니다. YYYY-MM-DDTHH:mm:ss.fffZ
<일>	예	정수	더할 양수 또는 음수 일 수
<format>	아니요	string	사용자 지정 형식 패턴. 타임스탬프의 기본 형식은 ISO 8601을 준수하는 UTC ISO 형식인 YYYY-MM-DDTHH:mm:ss.fffZ입니다.
<로캘>	아니요	string	문화권 정보의 선택적 로캘

반환 값	Type	설명
<updated-timestamp>	string	타임스탬프 + 지정한 일 수

예제 1

다음은 지정된 타임스탬프에 10일을 추가하는 예제입니다.

addDays('2018-03-15T13:00:00.000Z', 10)

그리고 결과 2018-03-25T00:00:00.000Z를 반환합니다.

예제 2

이 예제는 지정한 타임스탬프에서 5일을 뺍니다.

addDays('2018-03-15T00:00:00.000Z', -5)

그리고 결과 2018-03-10T00:00:00.000Z를 반환합니다.

예 3

다음은 de-DE 로캘의 지정된 타임스탬프에 1일을 추가하는 예제입니다.

addDays('2018-03-15T13:00:00.000Z', 1, '', 'de-dE')

그리고 결과 16.03.18 13:00:00을 반환합니다.

addHours

선택적 로캘 형식으로 타임스탬프에 시간을 추가합니다.

addHours('<timestamp>', <hours>, '<format>'?, '<locale>'?)

매개 변수	필수	Type	설명
<timestamp>	예	string	타임스탬프를 포함하는 문자열
<시간>	예	정수	더할 양수 또는 음수 시간 수
<format>	아니요	string	사용자 지정 형식 패턴. 타임스탬프의 기본 형식은 ISO 8601을 준수하는 UTC ISO 형식인 YYYY-MM-DDTHH:mm:ss.fffZ입니다.
<로캘>	아니요	string	문화권 정보의 선택적 로캘

반환 값	Type	설명
<updated-timestamp>	string	타임스탬프 + 지정한 시간 수

예제 1

이 예제에서는 지정된 타임스탬프에 10시간을 추가합니다.

addHours('2018-03-15T00:00:00.000Z', 10)

그리고 결과 2018-03-15T10:00:00.000Z를 반환합니다.

예제 2

이 예제는 지정한 타임스탬프에서 5시간을 뺍니다.

addHours('2018-03-15T15:00:00.000Z', -5)

그리고 결과 2018-03-15T10:00:00.000Z를 반환합니다.

예 3

다음은 de-DE 로캘의 지정된 타임스탬프에 2시간을 추가하는 예제입니다.

addHours('2018-03-15T13:00:00.000Z', 2, '', 'de-DE')

그리고 결과 15.03.18 15:00:00을 반환합니다.

addMinutes

선택적 로캘 형식으로 타임스탬프에 분 수를 추가합니다.

addMinutes('<timestamp>', <minutes>, '<format>'?, '<locale>'?)

매개 변수	필수	Type	설명
<timestamp>	예	string	타임스탬프를 포함하는 문자열
<minutes>	예	정수	더할 양수 또는 음수 분 수
<format>	아니요	string	사용자 지정 형식 패턴. 타임스탬프의 기본 형식은 ISO 8601을 준수하는 UTC ISO 형식인 YYYY-MM-DDTHH:mm:ss.fffZ입니다.
<로캘>	아니요	string	문화권 정보의 선택적 로캘

반환 값	Type	설명
<updated-timestamp>	string	타임스탬프 + 지정한 분 수

예제 1

이 예제에서는 지정된 타임스탬프에 10분을 추가합니다.

addMinutes('2018-03-15T00:10:00.000Z', 10)

그리고 결과 2018-03-15T00:20:00.000Z를 반환합니다.

예제 2

이 예제는 지정한 타임스탬프에서 5분을 뺍니다.

addMinutes('2018-03-15T00:20:00.000Z', -5)

그리고 결과 2018-03-15T00:15:00.000Z를 반환합니다.

예 3

다음은 de-DE 로캘의 지정된 타임스탬프에 30분을 추가하는 예제입니다.

addMinutes('2018-03-15T00:00:00.000Z', 30, '', 'de-DE')

그리고 결과 15.03.18 13:30:00을 반환합니다.

addOrdinal

입력 숫자의 서수를 반환합니다.

addOrdinal(<number>)

매개 변수	필수	Type	설명
<number>	예	정수	서수로 변환할 숫자입니다.

반환 값	Type	Description
<result>	string	입력 번호에서 변환된 서수입니다.

예제

addOrdinal(11)
addOrdinal(12)
addOrdinal(13)
addOrdinal(21)
addOrdinal(22)
addOrdinal(23)

그리고 각각 다음 결과를 반환합니다.

• 11일
• 12일
• 13일
• 21일
• 22번째
• 23일

addProperty

JSON 개체에 속성 및 해당 값 또는 이름-값 쌍을 추가하고 업데이트된 개체를 반환합니다. 런타임에서 개체가 이미 있는 경우 함수에서 오류가 발생합니다.

addProperty('<object>', '<property>', value)

매개 변수	필수	Type	설명
<object>	예	개체	속성을 추가할 JSON 개체입니다.
<속성>	예	string	추가할 속성의 이름입니다.
<value>	예	any	속성의 값입니다.

반환 값	Type	설명
<updated-object>	개체	새 속성을 추가한 후 업데이트된 JSON 개체입니다.

예제

다음은 accountNumber 속성을 customerProfile 개체에 추가하는 예제입니다. 이 개체는 json() 함수를 사용하여 JSON으로 변환됩니다. 이 함수는 newGuid() 함수에서 생성된 값을 할당하고 업데이트된 개체를 반환합니다.

addProperty(json('customerProfile'), 'accountNumber', newGuid())

addSeconds

타임스탬프에 초 수를 더합니다.

addSeconds('<timestamp>', <seconds>, '<format>'?)

매개 변수	필수	Type	설명
<timestamp>	예	string	타임스탬프를 포함하는 문자열
<초>	예	정수	더할 양수 또는 음수 초 수
<format>	아니요	string	사용자 지정 형식 패턴. 타임스탬프의 기본 형식은 ISO 8601을 준수하는 UTC ISO 형식인 YYYY-MM-DDTHH:mm:ss.fffZ입니다.

반환 값	Type	설명
<updated-timestamp>	string	타임스탬프 + 지정한 초 수

예제 1

이 예제는 지정한 타임스탬프에 10초를 더합니다.

addSeconds('2018-03-15T00:00:00.000Z', 10)

그리고 결과 2018-03-15T00:00:10.000Z를 반환합니다.

예제 2

이 예제는 지정한 타임스탬프에서 5초를 뺍니다.

addSeconds('2018-03-15T00:00:30.000Z', -5)

그리고 결과 2018-03-15T00:00:25.000Z를 반환합니다.

addToTime

선택적 로캘 형식으로 타임스탬프에 여러 시간 단위를 추가합니다. getFutureTime()도 함께 참조하세요.

addToTime('<timestamp>', '<interval>', <timeUnit>, '<format>'?, '<locale>'?)

매개 변수	필수	Type	설명
<timestamp>	예	string	타임스탬프를 포함하는 문자열
<interval>	예	정수	더할 지정한 시간 단위 수
<timeUnit>	예	string	간격에 사용할 시간 단위입니다. 가능한 단위는 "Second", "Minute", "Hour", "Day", "Week", "Month" 및 "Year"입니다.
<format>	아니요	string	사용자 지정 형식 패턴. 타임스탬프의 기본 형식은 ISO 8601을 준수하는 UTC ISO 형식인 YYYY-MM-DDTHH:mm:ss.fffZ입니다.
<로캘>	아니요	string	문화권 정보의 선택적 로캘

반환 값	Type	설명
<updated-timestamp>	string	타임스탬프와 지정된 형식의 지정된 시간 단위 수입니다.

예제 1

다음은 지정된 타임스탬프에 1일을 추가하는 예제입니다.

addToTime('2018-01-01T00:00:00.000Z', 1, 'Day')

그리고 결과 2018-01-02T00:00:00.000Z를 반환합니다.

예제 2

다음은 지정된 타임스탬프에 2주를 추가하는 예제입니다.

addToTime('2018-01-01T00:00:00.000Z', 2, 'Week', 'MM-DD-YY')

그리고 결과를 'MM-DD-YY' 형식으로 01-15-18로 반환합니다.

all

시퀀스의 모든 요소가 조건을 충족하는지 여부를 확인합니다.

all(<sequence>, <item>, <condition>)

매개 변수	필수	Type	설명
<순서>	예	개체	평가할 시퀀스입니다.
<항목>	예	string	시퀀스에서 평가할 요소를 참조합니다.
<condition>	예	식	조건을 평가할 식입니다.

반환 값	Type	설명
true 또는 false	부울	모든 요소가 조건을 충족하는 경우 반환 true 합니다. 하나 이상 반환하지 않으면 반환 false 합니다.

예제

다음 예제는 시퀀스의 모든 요소가 조건을 충족하는지 확인합니다.

all(createArray(1, 'cool'), item, isInteger(item))
all(createArray(1, 2), item => isInteger(item))

다음과 같은 결과를 각각 반환합니다.

• 시퀀스의 두 항목이 모두 정수가 아니므로 false입니다.
• 시퀀스의 두 항목이 모두 정수이기 때문에 true입니다.

및

모든 식이 true인지 확인합니다. 모든 식이 true이면 반환 true 하거나 하나 이상의 식이 false이면 반환 false 합니다.

and(<expression1>, <expression2>, ...)

매개 변수	필수	Type	설명
<expression1>, <expression2>, ...	예	부울	검사할 식

반환 값	Type	설명
true 또는 false	부울	모든 식이 true이면 반환 true 합니다. 하나 이상의 식이 false이면 반환 false 합니다.

예제 1

다음 예제에서는 지정된 부울 값이 모두 true인지 확인합니다.

and(true, true)
and(false, true)
and(false, false)

그리고 각각 다음 결과를 반환합니다.

• 두 식 모두 true이므로 함수는 .를 반환 true합니다.
• 하나의 식이 false이므로 함수는 false를 반환합니다.
• 두 식 모두 false이므로 함수가 반환됩니다 false.

예제 2

다음 예제에서는 지정된 식이 모두 true인지 확인합니다.

and(equals(1, 1), equals(2, 2))
and(equals(1, 1), equals(1, 2))
and(equals(1, 2), equals(1, 3))

그리고 각각 다음 결과를 반환합니다.

• 두 식 모두 true이므로 함수는 .를 반환 true합니다.
• 하나의 식이 false이므로 함수는 false를 반환합니다.
• 두 식 모두 false이므로 함수는 .를 반환 false합니다.

any

시퀀스의 요소가 조건을 충족하는지 여부를 확인합니다.

all(<sequence>, <item>, <condition>)

매개 변수	필수	Type	설명
<순서>	예	개체	평가할 시퀀스입니다.
<항목>	예	string	시퀀스에서 평가할 요소를 참조합니다.
<condition>	예	식	조건을 평가할 식입니다.

반환 값	Type	설명
true 또는 false	부울	모든 요소가 조건을 충족하는 경우 반환 true 합니다. 하나 이상 반환하지 않으면 반환 false 합니다.

예제

다음 예제는 시퀀스의 모든 요소가 조건을 충족하는지 확인합니다.

any(createArray(1, 'cool'), item, isInteger(item))
any(createArray('first', 'cool'), item => isInteger(item))

다음과 같은 결과를 각각 반환합니다.

• 시퀀스에서 하나 이상의 항목이 정수이므로 true입니다.
• 시퀀스의 두 항목이 모두 정수가 아니므로 false입니다.

average

숫자 배열의 숫자 평균을 반환합니다.

average(<numericArray>)

매개 변수	필수	Type	설명
<numericArray>	예	숫자의 배열	평균을 계산할 입력 배열입니다.

반환 값	Type	설명
<average-of-array>	number	지정된 배열의 평균 값입니다.

예제

이 예제에서는 다음에서 배열의 평균을 계산합니다.createArray()

average(createArray(1,2,3))

그리고 결과 2를 반환합니다.

base64

문자열 또는 바이트 배열의 base64로 인코딩된 버전을 반환합니다.

base64('<value>')

매개 변수	필수	Type	설명
<value>	예	문자열 또는 바이트 배열	입력 문자열

반환 값	Type	설명
<base64-string>	string	입력 문자열의 base64로 인코딩된 버전

예제 1

다음은 문자열 hello 를 base64로 인코딩된 문자열로 변환하는 예제입니다.

base64('hello')

그리고 결과 "aGVsbG8="를 반환합니다.

예제 2

이 예제에서는 다음과 같은 형식을 사용합니다byteArr.new byte[] { 3, 5, 1, 12 }

base64('byteArr')

그리고 결과 "AwUBDA=="를 반환합니다.

base64ToBinary

base64로 인코딩된 문자열의 이진 배열을 반환합니다.

base64ToBinary('<value>')

매개 변수	필수	Type	설명
<value>	예	string	변환할 base64로 인코딩된 문자열

반환 값	Type	설명
<binary-for-base64-string>	바이트 배열	base64로 인코딩된 문자열의 이진 버전

예제

다음 예제에서는 base64로 인코딩된 문자열 AwUBDA==를 이진 문자열로 변환합니다.

base64ToBinary('AwUBDA==')

그리고 결과 new byte[] { 3, 5, 1, 12 }를 반환합니다.

base64ToString

base64로 인코딩된 문자열의 문자열 버전을 반환하여 base64 문자열을 효과적으로 디코딩합니다.

base64ToString('<value>')

매개 변수	필수	Type	설명
<value>	예	string	디코딩할 base64로 인코딩된 문자열

반환 값	Type	설명
<decoded-base64-string>	string	base64로 인코딩된 문자열의 문자열 버전

예제

다음은 base64로 인코딩된 문자열 aGVsbG8= 를 디코딩된 문자열로 변환하는 예제입니다.

base64ToString('aGVsbG8=')

그리고 결과 hello를 반환합니다.

binary

문자열의 이진 버전을 반환합니다.

binary('<value>')

매개 변수	필수	Type	설명
<value>	예	string	변환할 문자열

반환 값	Type	설명
<binary-for-input-value>	바이트 배열	지정된 문자열의 이진 버전입니다.

예제

다음 예제에서는 hello 문자열을 이진 문자열로 변환합니다.

binary('hello')

그리고 결과 new byte[] { 104, 101, 108, 108, 111 }을 반환합니다.

bool

값의 부울 버전을 반환합니다.

bool(<value>)

매개 변수	필수	Type	설명
<value>	예	any	변환할 값

반환 값	Type	설명
true 또는 false	부울	지정된 값의 부울 버전

예제

아래 예제는 지정한 값을 부울 값으로 변환합니다.

bool(1)
bool(0)

그리고 각각 다음 결과를 반환합니다.

• true
• false

ceiling

지정된 숫자보다 작거나 같은 가장 큰 정수 값을 반환합니다.

ceiling('<number>')

매개 변수	필수	Type	설명
<number>	예	number	입력 번호

반환 값	Type	설명
<integer-value>	정수	입력 번호보다 크거나 같은 가장 큰 정수 값

예제

이 예제에서는 숫자 10.333보다 작거나 같은 가장 큰 정수 값을 반환합니다.

ceiling(10.333)

정수 11을 반환합니다.

coalesce

하나 이상의 매개 변수에서 Null이 아닌 첫 번째 값을 반환합니다. 빈 문자열, 빈 배열 및 빈 개체는 null이 아닙니다.

coalesce(<object**1>, <object**2>, ...)

매개 변수	필수	Type	설명
<object**1>, <object**2>, ...	예	any(혼합 형식 허용)	Null인지 검사할 하나 이상의 항목

반환 값	Type	설명
<first-non-null-item>	any	Null이 아닌 첫 번째 항목 또는 값입니다. 모든 매개 변수가 Null이면 이 함수는 Null을 반환합니다.

예제

아래 예제는 지정한 값에서 Null이 아닌 첫 번째 값 또는 모든 값이 Null인 경우 Null을 반환합니다.

coalesce(null, true, false)
coalesce(null, 'hello', 'world')
coalesce(null, null, null)

그리고 각각 반환 :

• true
• hello
• null

concat

둘 이상의 개체를 결합하고 결합된 개체를 목록 또는 문자열에 반환합니다.

concat('<text1>', '<text2>', ...)

매개 변수	필수	Type	설명
<object1>, <object2>, ...	예	any	두 개 이상의 개체를 연결할 수 있습니다.

반환 값	Type	설명
<object1object2...>	문자열 또는 목록	결합된 문자열 또는 목록입니다. Null 값은 건너뜁습니다.

예상 반환 값:

• 모든 항목이 목록인 경우 목록이 반환됩니다.
• 목록이 아닌 항목이 있는 경우 문자열이 반환됩니다.
• 값이 null이면 건너뛰고 연결되지 않습니다.

예제

이 예제에서는 Hello 및 World 문자열을 결합합니다.

concat('Hello', 'World')

그리고 결과 HelloWorld를 반환합니다.

예제 2

이 예제에서는 목록 [1,2] 및 [3,4]를 결합합니다.

concat([1,2],[3,4])

그리고 결과 [1,2,3,4]를 반환합니다.

예 3

다음 예제에서는 다양한 형식의 개체를 결합합니다.

concat('a', 'b', 1, 2)
concat('a', [1,2])

다음과 같은 결과를 각각 반환합니다.

• 문자열 ab12입니다.
• 개체 aSystem.Collections.Generic.List 1[System.Object]입니다. 이것은 읽을 수 없으며 피하는 것이 가장 좋습니다.

예제 4

개체를 결합하는 예제는 다음과 같습니다 null.

concat([1,2], null)
concat('a', 1, null)

다음과 같은 결과를 각각 반환합니다.

• 목록 [1,2]입니다.
• 문자열 a1입니다.

contains

컬렉션에 특정 항목이 있는지 검사합니다. 항목을 찾은 경우 반환 true 하거나 찾을 수 없는 경우 반환 false 합니다. 이 함수는 대/소문자를 구분합니다.

contains('<collection>', '<value>')
contains([<collection>], '<value>')

이 함수는 다음 컬렉션 형식에서 작동합니다.

• 부분 문자열을 찾기 위한 문자열
• 값을 찾기 위한 배열
• 키를 찾기 위한 사전

매개 변수	필수	Type	설명
<컬렉션>	예	문자열, 배열 또는 사전	검사할 컬렉션
<value>	예	각각 문자열, 배열 또는 사전	찾을 항목

반환 값	Type	설명
true 또는 false	부울	항목을 찾은 경우 반환 true 합니다. 찾을 수 없으면 반환 false 합니다.

예제 1

이 예제에서는 부분 문자열 세계에 대한 문자열 hello world를 확인합니다.

contains('hello world', 'world')

그리고 결과를 true반환합니다.

예제 2

이 예제에서는 문자열 hello world에서 부분 문자열 우주를 확인합니다.

contains('hello world', 'universe')

그리고 결과를 false반환합니다.

count

컬렉션의 항목 수를 반환합니다.

count('<collection>')
count([<collection>])

매개 변수	필수	Type	설명
<컬렉션>	예	문자열 또는 배열	개수를 셀 항목을 포함하는 컬렉션

반환 값	Type	설명
<length-or-count>	정수	컬렉션의 항목 수입니다.

예:

아래 예제는 이러한 컬렉션의 항목 수를 셉니다.

count('abcd')
count(createArray(0, 1, 2, 3))

그리고 둘 다 결과 4를 반환합니다.

countWord

문자열의 단어 수를 반환합니다.

countWord('<text>')

매개 변수	필수	Type	설명
<text>	예	string	계산할 문자열입니다.

반환 값	Type	설명
<count>	정수	문자열의 단어 수

예제

다음 예제에서는 hello world 문자열의 단어 수를 계산합니다.

countWord("hello word")

그리고 결과 2를 반환합니다.

convertFromUTC

선택적 로캘 형식의 타임스탬프를 UTC(Universal Time Coordinated)에서 대상 표준 시간대로 변환합니다.

convertFromUTC('<timestamp>', '<destinationTimeZone>', '<format>'?, '<locale>'?)

매개 변수	필수	Type	설명
<timestamp>	예	string	타임스탬프를 포함하는 문자열
<destinationTimeZone>	예	string	대상 표준 시간대의 이름입니다. Windows 및 IANA 표준 시간대를 지원합니다.
<format>	아니요	string	사용자 지정 형식 패턴. 타임스탬프의 기본 형식은 ISO 8601을 준수하는 "o" 형식인 yyyy-MM-ddTHH:mm:ss.fffffffK입니다.
<로캘>	아니요	string	문화권 정보의 선택적 로캘

반환 값	Type	설명
<converted-timestamp>	string	대상 표준 시간대로 변환된 타임스탬프

예:

다음 예제는 UTC에서 태평양 표준시로 변환됩니다.

convertFromUTC('2018-02-02T02:00:00.000Z', 'Pacific Standard Time', 'MM-DD-YY')
convertFromUTC('2018-02-02T02:00:00.000Z', 'Pacific Standard Time')

그리고 각각 다음 결과를 반환합니다.

• 02-01-18
• 2018-01-01T18:00:00.0000000

예제 2

다음은 en-US 로캘의 타임스탬프를 UTC에서 태평양 표준시로 변환하는 예제입니다.

convertFromUTC('2018-01-02T02:00:00.000Z', 'Pacific Standard Time', 'D', 'en-US')

그리고 2018년 1월 1일 월요일 결과를 반환합니다.

convertToUTC

선택적 로캘 형식의 타임스탬프를 원본 표준 시간대에서 UTC(Universal Time Coordinated)로 변환합니다.

convertToUTC('<timestamp>', '<sourceTimeZone>', '<format>'?, '<locale>'?)

매개 변수	필수	Type	설명
<timestamp>	예	string	타임스탬프를 포함하는 문자열
<sourceTimeZone>	예	string	대상 표준 시간대의 이름입니다. Windows 및 IANA 표준 시간대를 지원합니다.
<format>	아니요	string	사용자 지정 형식 패턴. 타임스탬프의 기본 형식은 ISO 8601을 준수하는 UTC ISO 형식인 YYYY-MM-DDTHH:mm:ss.fffZ입니다.
<로캘>	아니요	string	문화권 정보의 선택적 로캘

반환 값	Type	설명
<converted-timestamp>	string	대상 표준 시간대로 변환된 타임스탬프

예제

다음은 타임스탬프를 태평양 표준시에서 UTC로 변환하는 예제입니다.

convertToUTC('01/01/2018 00:00:00', 'Pacific Standard Time')

그리고 결과 2018-01-01T08:00:00.000Z를 반환합니다.

예제 2

이 예제에서는 De-DE 로캘의 타임스탬프를 태평양 표준시에서 UTC로 변환합니다.

convertToUTC('01/01/2018 00:00:00', 'Pacific Standard Time', '', 'de-DE')

그리고 결과 01.01.18 08:00:00을 반환합니다.

createArray

여러 입력에서 배열을 반환합니다.

createArray('<object1>', '<object2>', ...)

매개 변수	필수	Type	설명
<object1>, <object2>, ...	예	없으나 혼합되지 않음	배열을 만들 적어도 두 개의 항목

반환 값	Type	설명
[<object1>, <object2>, ...]	배열	모든 입력 항목에서 만든 배열

예제

이 예제에서는 다음 입력에서 배열을 만듭니다.

createArray('h', 'e', 'l', 'l', 'o')

그리고 결과 [h,e, l, l, o]를 반환합니다.

dataUri

문자열의 데이터 URI(Uniform Resource Identifier)를 반환합니다.

dataUri('<value>')

매개 변수	필수	Type	설명
<value>	예	string	변환할 문자열

반환 값	Type	설명
[<date-uri>]	string	입력 문자열에 대한 데이터 URI

예제

dataUri('hello')

결과 data:text/plain;charset=utf-8;base64,aGVsbG8=를 반환합니다.

dataUriToBinary

데이터 URI(Uniform Resource Identifier)의 이진 버전을 반환합니다.

dataUriToBinary('<value>')

매개 변수	필수	Type	설명
<value>	예	string	변환할 데이터 URI

반환 값	Type	설명
[<binary-for-data-uri>]	바이트 배열	데이터 URI의 이진 버전

예제

이 예제에서는 다음 데이터 URI에 대한 이진 버전을 만듭니다.

dataUriToBinary('aGVsbG8=')

그리고 결과 new byte[] { 97, 71, 86, 115, 98, 71, 56, 61 }을 반환합니다.

dataUriToString

데이터 URI(Uniform Resource Identifier)의 문자열 버전을 반환합니다.

dataUriToString('<value>')

매개 변수	필수	Type	설명
<value>	예	string	변환할 데이터 URI

반환 값	Type	설명
[<string-for-data-uri>]	string	데이터 URI의 문자열 버전

예제

다음 예제에서는 다음 데이터 URI에서 문자열을 만듭니다.

dataUriToString('data:text/plain;charset=utf-8;base64,aGVsbG8=')

그리고 결과 hello를 반환합니다.

date

m/dd/yyyy 형식으로 지정된 타임스탬프의 날짜를 반환합니다.

date('<timestramp>')

매개 변수	필수	Type	설명
<timestamp>	예	string	타임스탬프를 포함하는 문자열

반환 값	Type	설명
<date>	string	지정된 타임스탬프의 날짜입니다.

date('2018-03-15T13:00:00.000Z')

결과 3-15-2018을 반환합니다.

dateReadBack

날짜-시간 라이브러리를 사용하여 날짜 리드백(readback)을 제공합니다.

dateReadBack('<currentDate>', '<targetDate>')

매개 변수	필수	Type	설명
<currentDate>	예	string	현재 날짜가 포함된 문자열입니다.
<targetDate>	예	string	대상 날짜가 포함된 문자열입니다.

반환 값	Type	설명
<date-readback>	string	현재 날짜와 대상 날짜 사이의 읽기 저장

예제 1

dateReadBack('2018-03-15T13:00:00.000Z', '2018-03-16T13:00:00.000Z')

결과 tomorrow를 반환합니다.

dateTimeDiff

두 타임스탬프 사이의 틱 차이를 반환합니다.

dateTimeDiff('<timestamp1>', '<timestamp2>')

매개 변수	필수	Type	설명
<timestamp1>	예	string	비교할 첫 번째 타임스탬프 문자열입니다.
<timestamp2>	예	string	비교할 두 번째 타임스탬프 문자열입니다.

반환 값	Type	설명
<ticks>	number	두 타임스탬프 간의 틱 차이

예제 1

이 예제에서는 두 타임스탬프 사이의 틱 차이를 반환합니다.

dateTimeDiff('2019-01-01T08:00:00.000Z','2018-01-01T08:00:00.000Z')

그리고 숫자 3153600000000000을 반환합니다.

예제 2

이 예제에서는 두 타임스탬프 사이의 틱 차이를 반환합니다.

dateTimeDiff('2018-01-01T08:00:00.000Z', '2019-01-01T08:00:00.000Z')

-315360000000000 결과를 반환합니다. 값은 음수입니다.

dayOfMonth

타임스탬프에서 월의 날짜를 반환합니다.

dayOfMonth('<timestamp>')

매개 변수	필수	Type	설명
<timestamp>	예	string	타임스탬프를 포함하는 문자열

반환 값	Type	설명
<day-of-month>	정수	지정한 타임스탬프의 월의 날짜

예제

이 예제에서는 다음 타임스탬프에서 해당 월의 일 수를 반환합니다.

dayOfMonth('2018-03-15T13:27:36Z')

그리고 결과 15를 반환합니다.

dayOfWeek

타임스탬프에서 요일을 반환합니다.

dayOfWeek('<timestamp>')

매개 변수	필수	Type	설명
<timestamp>	예	string	타임스탬프를 포함하는 문자열

반환 값	Type	설명
<day-of-week>	정수	지정된 타임스탬프의 요일입니다. 일요일은 0, 월요일은 1 등입니다.

예제

이 예제에서는 다음 타임스탬프에서 요일의 번호를 반환합니다.

dayOfWeek('2018-03-15T13:27:36Z')

그리고 결과 3을 반환합니다.

dayOfYear

타임스탬프에서 년의 날짜를 반환합니다.

dayOfYear('<timestamp>')

매개 변수	필수	Type	설명
<timestamp>	예	string	타임스탬프를 포함하는 문자열

반환 값	Type	설명
<day-of-year>	정수	지정한 타임스탬프의 년의 날짜

예제

이 예제에서는 다음 타임스탬프에서 연도의 일 수를 반환합니다.

dayOfYear('2018-03-15T13:27:36Z')

그리고 결과 74를 반환합니다.

div

두 숫자를 나눈 정수 결과를 반환합니다. 나머지를 반환하려면 mod()를 참조하세요.

div(<dividend>, <divisor>)

매개 변수	필수	Type	설명
<dividend>	예	number	제수로 나눌 숫자
<divisor>	예	number	‘피제수’를 나누는 숫자입니다. 0일 수 없습니다.

반환 값	Type	설명
<quotient-result>	number	첫 번째 숫자를 두 번째 숫자로 나눈 결과입니다.

예제

두 예제 모두 첫 번째 숫자를 두 번째 숫자로 나눕니다.

div(10, 5)
div(11, 5)

결과 2를 반환합니다.

Javascript와 .NET SDK 사이에 약간의 차이가 있습니다. 예를 들어 다음 식은 Javascript 및 .NET SDK에서 다른 결과를 반환합니다.

매개 변수 중 하나가 float이면 결과는 .NET SDK가 있는 FLOAT도 됩니다.

예제

div(11.2, 2)

결과 5.6을 반환합니다.

매개 변수 중 하나가 float이면 결과는 Javascript SDK를 사용하는 INT가 됩니다.

예제

div(11.2, 2)

결과 5를 반환합니다.

결과에 특정 수의 소수 자릿수를 유지하는 Javascript의 해결 방법은 이러한 식을 사용하는 것입니다. 예를 들어 10진수 3자리를 유지하려면 다음을 수행합니다.

float(concat(string(div(a, b)),'.',string(mod(div(a*1000, b), 1000))))

empty

인스턴스가 비어 있는지 확인합니다. 입력이 비어 있으면 true를 반환합니다. 빈 수단:

• 입력이 null이거나 정의되지 않음
• 입력이 null 또는 빈 문자열입니다.
• input이 0 크기 컬렉션입니다.
• input은 속성이 없는 개체입니다.

empty('<instance>')
empty([<instance>])

매개 변수	필수	Type	설명
<instance>	예	any	확인할 인스턴스

반환 값	Type	설명
true 또는 false	부울	인스턴스가 비어 있으면 반환 true 합니다.

예제

다음 예제에서는 지정된 인스턴스가 비어 있는지 확인합니다.

empty('')
empty('abc')
empty([1])
empty(null)

그리고 각각 다음 결과를 반환합니다.

• 함수가 반환되도록 빈 문자열을 전달합니다 true.
• 함수가 반환되도록 문자열 abc를 전달합니다 false.
• 컬렉션을 하나의 항목으로 전달하므로 함수는 false를 반환합니다.
• 함수가 반환 true되도록 null 개체를 전달합니다.

endsWith

문자열이 특정 하위 문자열로 종료하는지 검사합니다. 부분 문자열이 발견되면 반환 true 하거나, 찾을 수 없는 경우 반환 false 합니다. 이 함수는 대/소문자를 구분하지 않습니다.

endsWith('<text>', '<searchText>')

매개 변수	필수	Type	설명
<text>	예	string	검사할 문자열
<searchText>	예	string	찾을 끝나는 하위 문자열

반환 값	Type	설명
true 또는 false	부울	끝 부분 문자열이 발견되면 반환 true 합니다. 찾을 수 없는 경우 false를 반환합니다.

예제 1

이 예제에서는 hello world 문자열이 문자열 세계로 끝나는지 확인합니다.

endsWith('hello world', 'world')

그리고 결과 true를 반환합니다.

예제 2

이 예제에서는 hello world 문자열이 문자열 universe로 끝나는지 확인합니다.

endsWith('hello world', 'universe')

그리고 결과 false를 반환합니다.

EOL

줄 끝(EOL) 시퀀스 텍스트를 반환합니다.

EOL()

반환 값	Type	설명
<IsOSPlatform>	string	Windows에서 \r\n을 반환하고 Mac 및 Linux에서는 \n을 반환합니다.

예제

다음은 줄 시퀀스 텍스트의 끝을 확인하는 예제입니다.

EOL()

다음 문자열을 반환합니다.

• Windows: \r\n
• Mac 또는 Linux: \n

equals

두 값, 식 또는 개체가 모두 같은지 검사합니다. 둘 다 같은 경우 반환 true 하거나 동일하지 않은 경우 반환 false 합니다.

equals('<object1>', '<object2>')

매개 변수	필수	Type	설명
<object1>, <object2>	예	any	비교할 값, 식 또는 개체

반환 값	Type	설명
true 또는 false	부울	둘 다 동일한 경우 반환 true 합니다. 동일하지 않은 경우 반환 false 합니다.

예제

아래 예제는 지정한 입력들이 같은지 검사합니다.

equals(true, 1)
equals('abc', 'abcd')

그리고 각각 다음 결과를 반환합니다.

• 두 값이 모두 동일하므로 함수는 .를 반환합니다 true.
• 두 값이 모두 동일하지 않으므로 함수가 반환합니다 false.

예

truthiness에 대해 식을 평가합니다.

exists(expression)

매개 변수	필수	Type	설명
식	예	식	truthiness에 대해 평가할 식

반환 값	Type	설명
<true 또는 false>	부울	식 계산 결과

예제

다음 예제에서는 다음의 foo = {"bar":"value"}진리를 평가합니다.

exists(foo.bar)
exists(foo.bar2)

그리고 각각 다음 결과를 반환합니다.

• true
• false

exp

한 숫자의 다른 숫자에 대한 지수를 반환합니다.

exp(realNumber, exponentNumber)

매개 변수	필수	Type	설명
realNumber	예	number	의 계산 지수에 대한 실수
exponentNumber	예	number	지수 숫자

반환 값	Type	설명
<result-exp>	number	의 컴퓨팅 지수의 결과 realNumber

예제

이 예제에서는 지수를 계산합니다.

exp(2, 2)

그리고 결과 4를 반환합니다.

first

문자열 또는 배열에서 첫 번째 항목을 반환합니다.

first('<collection>')
first([<collection>])

매개 변수	필수	Type	설명
<컬렉션>	예	문자열 또는 배열	첫 번째 항목을 찾을 컬렉션입니다.

반환 값	Type	설명
<first-collection-item>	any	컬렉션의 첫 번째 항목

예제

다음 예제에서는 다음 컬렉션에서 첫 번째 항목을 찾습니다.

first('hello')
first(createArray(0, 1, 2))

그리고 각각 다음 결과를 반환합니다.

• 시간
• 0

평면화

배열을 배열이 아닌 값으로 평면화합니다. 필요에 따라 평면화할 최대 깊이를 설정할 수 있습니다.

flatten([<collection>], '<depth>')

매개 변수	필수	Type	설명
<컬렉션>	예	배열	평면화할 컬렉션입니다.
<depth>	아니요	number	평면화할 최대 깊이입니다. 기본값은 무한대입니다.

반환 값	Type	설명
<new-collection>	배열	요소가 지정된 깊이로 비 배열로 평면화된 새 컬렉션

예제 1

THis 예제에서는 다음 배열을 평면화합니다.

flatten(createArray(1, createArray(2), createArray(createArray(3, 4), createArray(5, 6)))

그리고 결과 [1, 2, 3, 4, 5, 6]을 반환합니다.

예제 2

이 예제에서는 배열을 깊이 1로 평면화합니다.

flatten(createArray(1, createArray(2), createArray(createArray(3, 4), createArray(5, 6)), 1)

그리고 결과 [1, 2, [3, 4], [5, 6]]을 반환합니다.

float

부동 소수점 수에 대한 문자열 버전을 부동 소수점 수로 변환합니다. 논리 앱과 같은 앱에 사용자 지정 매개 변수를 전달할 때만 이 함수를 사용할 수 있습니다. 문자열을 float로 변환할 수 없는 경우 예외가 throw됩니다.

float('<value>')

매개 변수	필수	Type	설명
<value>	예	string	변환할 유효한 부동 소수점 번호가 있는 문자열입니다.

반환 값	Type	설명
<float-value>	float	지정된 문자열의 부동 소수점 번호

예제

이 예제에서는 문자열의 float 버전을 변환합니다.

float('10.333')

그리고 float 10.333을 반환합니다.

floor

지정된 숫자보다 작거나 같은 가장 큰 정수 값을 반환합니다.

floor('<number>')

매개 변수	필수	Type	설명
<number>	예	number	입력 번호

반환 값	Type	설명
<integer-value>	정수	입력 번호보다 작거나 같은 가장 큰 정수 값

예제

다음은 숫자 10.333의 바닥 값을 계산하는 예제입니다.

floor(10.333)

정수 10을 반환합니다.

foreach

각 요소에서 작동하고 새 컬렉션을 반환합니다.

foreach([<collection/instance>], <iteratorName>, <function>)

매개 변수	필수	Type	설명
<collection/instance>	예	배열 또는 개체	항목이 있는 컬렉션
<iteratorName>	예	반복기 이름	화살표 함수의 키 항목
<function>	예	식	포함된 함수 iteratorName

반환 값	Type	설명
<new-collection>	배열	각 요소가 함수에 의해 계산되는 새 컬렉션

예제 1

다음 예제에서는 새 컬렉션을 생성합니다.

foreach(createArray(0, 1, 2, 3), x, x + 1)

그리고 결과 [1, 2, 3, 4]를 반환합니다.

예제 2

다음 예제에서는 새 컬렉션을 생성합니다.

foreach(json("{'name': 'jack', 'age': '15'}"), x, concat(x.key, ':', x.value))
foreach(json("{'name': 'jack', 'age': '15'}"), x=> concat(x.key, ':', x.value))

그리고 결과 ['name:jack', 'age:15']를 반환합니다. 두 번째 식은 더 읽기 쉬운 람다 식입니다.

formatDateTime

선택적 로캘 형식으로 타임스탬프를 반환합니다.

formatDateTime('<timestamp>', '<format>'?, '<locale>'?)

매개 변수	필수	Type	설명
<timestamp>	예	string	타임스탬프를 포함하는 문자열
<format>	아니요	string	사용자 지정 형식 패턴. 타임스탬프의 기본 형식은 ISO 8601을 준수하는 UTC ISO 형식인 YYYY-MM-DDTHH:mm:ss.fffZ입니다.
<로캘>	아니요	string	문화권 정보의 선택적 로캘

반환 값	Type	설명
<reformatted-timestamp>	string	지정한 형식으로 업데이트된 타임스탬프

예제 1

이 예제는 타임스탬프를 지정한 형식으로 변환합니다.

formatDateTime('03/15/2018 12:00:00', 'yyyy-MM-ddTHH:mm:ss')

그리고 결과 2018-03-15T12:00:00을 반환합니다.

예제 2

이 예제에서는 de-DE 로캘의 타임스탬프를 변환합니다.

formatDateTime('2018-03-15', '', 'de-DE')

그리고 결과 15.03.18 00:00:00을 반환합니다.

formatEpoch

UNIX 시간(Epoch 시간, POSIX 시간, UNIX Epoch 시간이라고도 알려짐)에서 지정된 형식으로 선택적 로캘 형식으로 타임스탬프를 반환합니다.

formatEpoch('<epoch>', '<format>'?, '<locale>'?)

매개 변수	필수	Type	설명
<시대>	예	number	Epoch 번호
<format>	아니요	string	사용자 지정 형식 패턴. 타임스탬프의 기본 형식은 ISO 8601을 준수하는 UTC ISO 형식인 YYYY-MM-DDTHH:mm:ss.fffZ입니다.
<로캘>	아니요	string	문화권 정보의 선택적 로캘

반환 값	Type	설명
<reformatted-timestamp>	string	지정한 형식으로 업데이트된 타임스탬프

예제

다음은 Unix 타임스탬프를 지정된 형식으로 변환하는 예제입니다.

formatEpoch(1521118800, 'yyyy-MM-ddTHH:mm:ss.fffZ)'

그리고 결과 2018-03-15T12:00:00.000Z를 반환합니다.

예제

이 예제에서는 de-DE 로캘에서 Unix 타임스탬프를 변환합니다.

formatEpoch(1521118800, '', 'de-DE')

그리고 결과 15.03.18 13:00:00을 반환합니다.

formatNumber

지정된 소수 자릿수 및 선택적으로 지정된 로캘에 값의 서식을 지정합니다.

formatNumber('<number>', '<precision-digits>', '<locale>'?)

매개 변수	필수	Type	설명
<number>	예	number	입력 번호
<전체 자릿수>	예	정수	지정된 소수 자릿수
<로캘>	아니요	string	문화권 정보의 선택적 로캘

반환 값	Type	설명
<return-value>	number	지정된 수의 소수 자릿수 및 지정된 로캘에 서식이 지정된 입력의 반환 값입니다.

예제 1

이 예제에서는 숫자 10.333에서 2 소수 자릿수로 서식을 지정합니다.

formatNumber(10.333, 2)

문자열 10.33을 반환합니다.

예제 2

다음 예제에서는 en-US 로캘에서 지정된 수의 숫자로 숫자 서식을 지정합니다.

formatNumber(12.123, 2, 'en-US')
formatNumber(1.551, 2, 'en-US')
formatNumber(12.123, 4, 'en-US')

다음과 같은 결과를 각각 반환합니다.

• 12.12
• 1.55
• 12.1230

formatTicks

틱에서 지정된 형식의 선택적 로캘 형식으로 타임스탬프를 반환합니다.

formatTicks('<ticks>', '<format>'?, '<locale>'?)

매개 변수	필수	Type	설명
<시대>	예	number(또는 JavaScript의 bigint)	틱 번호
<format>	아니요	string	사용자 지정 형식 패턴. 타임스탬프의 기본 형식은 ISO 8601을 준수하는 UTC ISO 형식인 YYYY-MM-DDTHH:mm:ss.fffZ입니다.
<로캘>	아니요	string	문화권 정보의 선택적 로캘

반환 값	Type	설명
<reformatted-timestamp>	string	지정한 형식으로 업데이트된 타임스탬프

예제 1

다음은 틱을 지정된 형식으로 변환하는 예제입니다.

formatTicks(637243624200000000, 'yyyy-MM-ddTHH:mm:ss.fffZ')

그리고 2020-05-06T11:47:00.000Z 결과를 반환합니다.

예제 2

다음은 de-DE 로캘에서 틱을 지정된 형식으로 변환하는 예제입니다.

formatTicks(637243624200000000, '', 'de-DE')

그리고 결과 06.05.20 11:47:00을 반환합니다.

getFutureTime

현재 타임스탬프를 선택적 로캘 형식과 지정된 시간 단위로 반환합니다.

getFutureTime(<interval>, <timeUnit>, '<format>'?, '<locale>'?)

매개 변수	필수	Type	설명
<interval>	예	정수	추가할 특정 시간 단위의 수
<timeUnit>	예	string	간격에 사용할 시간 단위입니다. 가능한 단위는 "Second", "Minute", "Hour", "Day", "Week", "Month" 및 "Year"입니다.
<format>	아니요	string	사용자 지정 형식 패턴. 타임스탬프의 기본 형식은 ISO 8601을 준수하는 UTC ISO 형식인 YYYY-MM-DDTHH:mm:ss.fffZ입니다.
<로캘>	아니요	string	문화권 정보의 선택적 로캘

반환 값	Type	설명
<updated-timestamp>	string	현재 타임스탬프 + 지정한 시간 단위 수

예제 1

현재 타임스탬프가 2019-03-01T00:00:00.000Z라고 가정합니다. 아래 예제에서는 해당 타임스탬프에 5일을 추가합니다.

getFutureTime(2, 'Week')

그리고 결과 2019-03-15T00:00:00.000Z를 반환합니다.

예제 2

현재 타임스탬프가 2018-03-01T00:00:00.000Z라고 가정하겠습니다. 아래 예제에서는 타임스탬프에 5일을 추가하고 결과를 MM-DD-YY 형식으로 변환합니다.

getFutureTime(5, 'Day', 'MM-DD-YY')

그리고 결과 03-06-18을 반환합니다.

예 3

현재 타임스탬프가 2020-05-01T00:00:00.000Z이고 로캘이 de-DE라고 가정합니다. 아래 예제에서는 타임스탬프에 1일을 추가합니다.

getFutureTime(1,'Day', '', 'de-DE')

그리고 결과 02.05.20 00:00:00을 반환합니다.

getNextViableDate

현재 날짜 및 선택적으로 지정된 표준 시간대를 기준으로 Timex 식의 다음 실행 가능한 날짜를 반환합니다.

getNextViableDate(<timexString>, <timezone>?)

매개 변수	필수	Type	설명
<timexString>	예	string	평가할 날짜의 Timex 문자열입니다.
<표준 시간대>	아니요	string	선택적 표준 시간대입니다.

반환 값	Type	설명
<nextViableTime>	string	다음 실행 가능한 날짜입니다.

예제

날짜가 2020-06-12이고 현재 시간이 15:42:21이라고 가정합니다.

다음 예제에서는 위의 날짜 및 시간을 기준으로 다음 실행 가능한 날짜에 대한 Timex 문자열을 평가합니다.

getPreviousViableDate("XXXX-12-20", "America/Los_Angeles")
getPreviousViableDate("XXXX-02-29")

그리고 각각 다음 문자열을 반환합니다.

• 2020-12-20
• 2024-02-29

getNextViableTime

현재 시간 및 선택적으로 지정된 표준 시간대를 기준으로 Timex 식의 다음 실행 가능한 시간을 반환합니다.

getNextViableTime(<timexString>, <timezone>?)

매개 변수	필수	Type	설명
<timexString>	예	string	평가할 시간의 Timex 문자열입니다.
<표준 시간대>	아니요	string	선택적 표준 시간대입니다.

반환 값	Type	설명
<nextViableTime>	string	다음 실행 가능한 시간입니다.

예제

날짜가 2020-06-12이고 현재 시간이 15:42:21이라고 가정합니다.

다음 예제에서는 위의 날짜 및 시간에 따라 다음 실행 가능한 시간에 대한 Timex 문자열을 평가합니다.

getNextViableTime("TXX:12:14", "Asia/Tokyo")
getNextViableTime("TXX:52:14")

그리고 각각 다음 문자열을 반환합니다.

• T16:12:14
• T15:52:14

getPastTime

지정한 시간 단위를 뺀 현재 타임스탬프를 반환합니다.

getPastTime(<interval>, <timeUnit>, '<format>'?)

매개 변수	필수	Type	설명
<interval>	예	정수	뺄 특정 시간 단위 수
<timeUnit>	예	string	간격에 사용할 시간 단위입니다. 가능한 단위는 "Second", "Minute", "Hour", "Day", "Week", "Month" 및 "Year"입니다.
<format>	아니요	string	사용자 지정 형식 패턴. 타임스탬프의 기본 형식은 ISO 8601을 준수하는 UTC ISO 형식인 YYYY-MM-DDTHH:mm:ss.fffZ입니다.

반환 값	Type	설명
<updated-timestamp>	string	현재 타임스탬프 - 지정한 시간 단위 수

예제 1

현재 타임스탬프가 2018-02-01T00:00:00.000Z라고 가정하겠습니다. 이 예제는 해당 타임스탬프에서 5일을 뺍니다.

getPastTime(5, 'Day')

그리고 결과 2019-01-27T00:00:00.000Z를 반환합니다.

예제 2

현재 타임스탬프가 2018-03-01T00:00:00.000Z라고 가정하겠습니다. 이 예제에서는 MM-DD-YY 형식으로 타임스탬프까지 5일을 뺍니다.

getPastTime(5, 'Day', 'MM-DD-YY')

그리고 결과 02-26-18을 반환합니다.

예 3

현재 타임스탬프가 2020-05-01T00:00:00.000Z이고 로캘이 de-DE라고 가정합니다. 아래 예제에서는 타임스탬프에서 1일을 뺍니다.

getPastTime(1,'Day', '', 'de-DE')

그리고 결과 31.04.20 00:00:00을 반환합니다.

getPreviousViableDate

현재 날짜 및 선택적으로 지정된 표준 시간대를 기준으로 Timex 식의 실행 가능한 이전 날짜를 반환합니다.

getPreviousViableDate(<timexString>, <timezone>?)

매개 변수	필수	Type	설명
<timexString>	예	string	평가할 날짜의 Timex 문자열입니다.
<표준 시간대>	아니요	string	선택적 표준 시간대입니다.

반환 값	Type	설명
<previousViableDate>	string	이전 실행 가능한 날짜입니다.

예제

날짜가 2020-06-12이고 현재 시간이 15:42:21이라고 가정합니다.

다음 예제에서는 위의 날짜 및 시간을 기준으로 이전 실행 가능한 날짜에 대한 Timex 문자열을 평가합니다.

getPreviousViableDate("XXXX-12-20", "Eastern Standard Time")
getPreviousViableDate("XXXX-02-29")

그리고 각각 다음 문자열을 반환합니다.

• 2019-12-20
• 2020-02-29

getPreviousViableTime

현재 날짜 및 선택적으로 지정된 표준 시간대를 기준으로 Timex 식의 실행 가능한 이전 시간을 반환합니다.

getPreviousViableTime(<timexString>, <timezone>?)

매개 변수	필수	Type	설명
<timexString>	예	string	평가할 시간의 Timex 문자열입니다.
<표준 시간대>	아니요	string	선택적 표준 시간대입니다.

반환 값	Type	설명
<previousViableTime>	string	이전 실행 가능한 시간입니다.

예제

날짜가 2020-06-12이고 현재 시간이 15:42:21이라고 가정합니다.

다음 예제에서는 위의 날짜 및 시간을 기준으로 이전 실행 가능한 시간에 대한 Timex 문자열을 평가합니다.

getPreviousViableTime("TXX:52:14")
getPreviousViableTime("TXX:12:14", 'Europe/London')

그리고 각각 다음 문자열을 반환합니다.

• T14:52:14
• T15:12:14

getProperty

JSON 개체에서 지정된 속성 또는 루트 속성의 값을 반환합니다.

지정된 속성의 값을 반환합니다.

getProperty(<JSONObject>, '<propertyName>')

매개 변수	필수	Type	설명
<JSONObject>	예	개체	속성 및 값을 포함하는 JSON 개체입니다.
<propertyName>	아니요	string	값에 액세스할 선택적 속성의 이름입니다.

반환 값	Type	설명
value	string	JSON 개체의 지정된 속성 값입니다.

예제

다음 JSON 개체가 있다고 가정해 보겠습니다.

{
   "a:b" : "a:b value",
   "c":
   {
        "d": "d key"
    }
}

다음 예제에서는 위의 JSON 개체에서 지정된 속성을 검색합니다.

getProperty({"a:b": "value"}, 'a:b')
getProperty(c, 'd')

그리고 각각 다음 문자열을 반환합니다.

• a:b 값
• d 키

루트 속성 반환

getProperty('<propertyName>')

매개 변수	필수	Type	설명
<propertyName>	예	string	루트 메모리 범위의 값에 액세스할 선택적 속성의 이름입니다.

반환 값	Type	설명
value	string	JSON 개체의 루트 속성 값입니다.

예제

다음 JSON 개체가 있다고 가정해 보겠습니다.

{
   "a:b" : "a:b value",
   "c":
   {
        "d": "d key"
    }
}

다음은 위의 JSON 개체에서 루트 속성을 검색하는 예제입니다.

getProperty("a:b")

문자열 a:b 값을 반환 합니다.

getTimeOfDay

지정된 타임스탬프에 대한 하루 중 시간을 반환합니다.

getTimeOfDay('<timestamp>')

반환된 시간은 다음 문자열 중 하나입니다.

매개 변수	필수	Type	설명
<timestamp>	예	string	지정된 타임스탬프를 포함하는 문자열입니다.

반환 값	Type	설명
<하루 중 시간>	string	지정된 타임스탬프에 대한 하루 중 시간

아래에는 하루 중 시간과 연결된 문자열이 나와 있습니다.

하루 중 시간	타임스탬프
심야	오전 12시
morning	12:01AM – 11:59PM
오후	12PM
저녁	06:00PM – 10:00PM
night	오후 10:01 – 오후 11:59

예제

getTimeOfDay('2018-03-15T08:00:00.000Z')

결과 아침을 반환합니다.

greater

첫 번째 값이 두 번째 값보다 큰지 검사합니다. 첫 번째 값이 더 크면 true를 반환하고, 더 작으면 false를 반환합니다.

greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')

매개 변수	필수	Type	설명
<value>	예	정수, 부동 소수점 또는 문자열	두 번째 값보다 큰지 검사할 첫 번째 값
<compareTo>	예	각각 정수, 부동 소수점 수 또는 문자열	비교 값

반환 값	Type	설명
true 또는 false	부울	첫 번째 값이 두 번째 값보다 큰 경우 반환 true 합니다. 첫 번째 값이 두 번째 값과 같거나 작은 경우 반환 false 합니다.

예제

아래 예제는 첫 번째 값이 두 번째 값보다 큰지 검사합니다.

greater(10, 5)
greater('apple', 'banana')

다음과 같은 결과를 각각 반환합니다.

• true
• false

greaterOrEquals

첫 번째 값이 두 번째 값보다 크거나 같은지 검사합니다. true 첫 번째 값이 크거나 같으면 반환하거나 첫 번째 값이 작으면 반환 false 합니다.

greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')

매개 변수	필수	Type	설명
<value>	예	정수, 부동 소수점 또는 문자열	두 번째 값보다 크거나 같은지 검사할 첫 번째 값
<compareTo>	예	각각 정수, 부동 소수점 수 또는 문자열	비교 값

반환 값	Type	설명
true 또는 false	부울	true 첫 번째 값이 두 번째 값보다 크거나 같은 경우 반환합니다. 첫 번째 값이 두 번째 값보다 작으면 false를 반환합니다.

예제

아래 예제는 첫 번째 값이 두 번째 값보다 크거나 같은지 검사합니다.

greaterOrEquals(5, 5)
greaterOrEquals('apple', 'banana')

다음과 같은 결과를 각각 반환합니다.

• true
• false

if

식이 true인지 또는 false인지 검사합니다. 결과에 기반해 지정한 값을 반환합니다.

if(<expression>, <valueIfTrue>, <valueIfFalse>)

매개 변수	필수	Type	설명
<expression>	예	부울	검사할 식
<valueIfTrue>	예	any	식이 true이면 반환할 값입니다.
<valueIfFalse>	예	any	식이 false이면 반환할 값입니다.

반환 값	Type	설명
<specified-return-value>	any	식이 있는지 여부에 따라 반환되는 지정된 값입니다.truefalse

예제

이 예제에서는 true인지 여부를 equals(1,1) 평가합니다.

if(equals(1, 1), 'yes', 'no')

지정된 식이 반환 되므로 yes 를 반환합니다 true. 그렇지 않으면 예제에서는 아니요를 반환 합니다.

indexof

하위 문자열의 시작 위치 또는 인덱스 값을 반환합니다. 이 함수는 대/소문자를 구분하지 않으며 인덱스는 숫자 0으로 시작합니다.

indexOf('<text>', '<searchText>')

매개 변수	필수	Type	설명
<text>	예	문자열 또는 배열	찾을 하위 문자열을 가진 문자열
<searchText>	예	string	찾을 하위 문자열

반환 값	Type	설명
<index-value>	정수	지정된 부분 문자열의 시작 위치 또는 인덱스 값입니다.
문자열을 찾을 수 없는 경우 숫자 -1을 반환합니다.

예제 1

이 예제에서는 문자열 hello 세계에서 부분 문자열 세계의 시작 인덱스 값을 찾습니다.

indexOf('hello world', 'world')

그리고 결과 6을 반환합니다.

예제 2

이 예제에서는 배열 ['abc', 'def', 'ghi']에서 부분 문자열 def의 시작 인덱스 값을 찾습니다.

indexOf(createArray('abc', 'def', 'ghi'), 'def')

그리고 결과 1을 반환합니다.

indicesAndValues

배열 또는 개체를 인덱스(현재 인덱스) 및 값 속성이 있는 개체의 배열로 전환합니다. 배열의 경우 인덱스는 배열의 위치입니다. 개체의 경우 값의 키입니다.

indicesAndValues('<collection or object>')

매개 변수	필수	Type	설명
<collection or object>	예	배열 또는 개체	원래 배열 또는 개체

반환 값	Type	설명
<컬렉션>	배열	새 배열입니다. 각 항목에는 배열의 위치가 있는 인덱스 또는 개체의 키와 해당 값의 두 가지 속성이 있습니다.

예제 1

목록 { 항목이 있다고 가정해 봅시다. ["zero", "one", "two"] }. 다음 함수는 해당 목록을 사용합니다.

indicesAndValues(items)

새 목록을 반환합니다.

[
  {
    index: 0,
    value: 'zero'
  },
  {
    index: 1,
    value: 'one'
  },
  {
    index: 2,
    value: 'two'
  }
]

예제 2

목록 { 항목이 있다고 가정해 봅시다. ["zero", "one", "two"] }. 다음 함수는 해당 목록을 사용합니다.

where(indicesAndValues(items), elt, elt.index >= 1)

새 목록을 반환합니다.

[
  {
    index: 1,
    value: 'one'
  },
  {
    index: 2,
    value: 'two'
  }
]

예 3

목록 { 항목이 있다고 가정해 봅시다. ["zero", "one", "two"] }. 다음 함수는 해당 목록을 사용합니다.

join(foreach(indicesAndValues(items), item, item.value), ',')

그리고 결과 0,1,2를 반환합니다. 이 식은 join(items, ',')과 동일한 효과를 줍니다.

예제 4

{name: 'jack', age: 20} }이라는 개체가 있다고 가정해 보겠습니다. 다음 함수는 해당 개체를 취합니다.

indicesAndValues(user)

새 개체를 반환합니다.

[
  {
    index: 'name',
    value: 'jack'
  },
  {
    index: 'age',
    value: 20
  }
]

int

문자열의 정수 버전을 반환합니다. 문자열을 정수로 변환할 수 없는 경우 예외가 throw됩니다.

int('<value>')

매개 변수	필수	Type	설명
<value>	예	string	변환할 문자열

반환 값	Type	설명
<integer-result>	정수	지정된 문자열의 정수 버전입니다.

예제

이 예제에서는 문자열 10에 대한 정수 버전을 만듭니다.

int('10')

그리고 결과를 정 수 10으로 반환합니다.

intersection

지정한 컬렉션에서 공통 항목만 있는 컬렉션을 반환합니다. 결과에 나타내려면 항목이 이 함수에 전달된 모든 컬렉션에 나타나야 합니다. 같은 이름을 가진 항목이 한 개 이상이면 해당 이름의 마지막 항목이 결과에 나타납니다.

intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)

매개 변수	필수	Type	설명
<collection1>, <collection2>	예	배열 또는 개체, 그러나 둘 다는 아님	공통 항목만 원하는 컬렉션

반환 값	Type	설명
<common-items>	각각 배열 또는 개체	지정한 컬렉션에 대해 공통 항목만 있는 컬렉션

예제

이 예제에서는 다음 배열에서 공통 항목을 찾습니다.

intersection(createArray(1, 2, 3), createArray(101, 2, 1, 10), createArray(6, 8, 1, 2))

그리고 항목 [1, 2]만 있는 배열을 반환합니다.

isArray

지정된 입력이 배열인 경우 반환 true 합니다.

isArray('<input>')

매개 변수	필수	Type	설명
<input>	예	any	테스트할 입력

반환 값	Type	설명
<부울 결과>	Boolean	지정된 입력이 배열인 경우 반환 true 하거나 배열이 아닌 경우 반환 false 합니다.

예제

다음 예제에서는 입력이 배열인지 확인합니다.

isArray('hello')
isArray(createArray('hello', 'world'))

다음과 같은 결과를 각각 반환합니다.

• 입력은 문자열이므로 함수는 false를 반환합니다.
• 입력은 배열이므로 함수가 반환됩니다 true.

isBoolean

지정된 입력이 부울이면 반환 true 합니다.

isBoolean('<input>')

매개 변수	필수	Type	설명
<input>	예	any	테스트할 입력

반환 값	Type	설명
<부울 결과>	Boolean	지정된 입력이 부울이면 반환 true 하거나 부울이 아닌 경우 반환 false 합니다.

예제

다음 예제에서는 입력이 부울인지 확인합니다.

isBoolean('hello')
isBoolean(32 > 16)

다음과 같은 결과를 각각 반환합니다.

• 입력은 문자열이므로 함수는 false를 반환합니다.
• 입력은 부울이므로 함수는 true를 반환합니다.

isDate

지정된 TimexProperty 또는 Timex 식이 유효한 날짜를 참조하는 경우 반환 true 합니다. 유효한 날짜는 month 및 dayOfMonth를 포함하거나 dayOfWeek를 포함합니다.

isDate('<input>')

매개 변수	필수	Type	설명
<input>	예	개체 또는 문자열	입력 TimexProperty 개체 또는 Timex 식 문자열입니다.

반환 값	Type	설명
<부울 결과>	Boolean	입력이 유효한 날짜를 참조하면 true를 반환하고, 날짜가 잘못된 경우 false를 반환합니다.

예제

다음 예제에서는 다음 입력이 유효한 날짜인지 확인합니다.

isDate('2020-12')
isDate('xxxx-12-21')

그리고 다음 결과를 반환합니다.

• false
• true

isDateRange

지정된 TimexProperty 또는 Timex 식이 유효한 날짜 범위를 참조하는 경우 반환 true 합니다.

isDateRange('<input>')

매개 변수	필수	Type	설명
<input>	예	개체 또는 문자열	입력 TimexProperty 개체 또는 Timex 식 문자열입니다.

반환 값	Type	설명
<부울 결과>	Boolean	지정된 입력이 유효한 날짜 범위를 참조하는 경우 반환 true 하거나 유효한 날짜 범위가 아닌 경우 반환 false 합니다.

예제

다음 예제에서는 다음 입력이 유효한 날짜 범위인지 확인합니다.

isDateRange('PT30M')
isDateRange('2012-02')

그리고 다음 결과를 반환합니다.

• false
• true

isDateTime

지정된 입력이 UTC ISO 형식(YYYY-MM-DDTHH:mm:ss.fffZ) 타임스탬프 문자열인 경우 반환 true 합니다.

isDateTime('<input>')

매개 변수	필수	Type	설명
<input>	예	any	테스트할 입력

반환 값	Type	설명
<부울 결과>	Boolean	true 지정된 입력이 UTC ISO 형식 타임스탬프 문자열인 경우 반환하거나 UTC ISO 형식 타임스탬프 문자열이 아닌 경우 반환 false 합니다.

예제

다음 예제에서는 입력이 UTC ISO 형식 문자열인지 확인합니다.

isDateTime('hello world!')
isDateTime('2019-03-01T00:00:00.000Z')

다음과 같은 결과를 각각 반환합니다.

• 입력은 문자열이므로 함수는 false를 반환합니다.
• 입력은 UTC ISO 형식 문자열이므로 함수는 true를 반환합니다.

isDefinite

지정된 TimexProperty 또는 Timex 식이 유효한 날짜를 참조하는 경우 반환 true 합니다. 유효한 날짜에는 year, month 및 dayOfMonth가 포함됩니다.

isDefinite('<input>')

매개 변수	필수	Type	설명
<input>	예	개체 또는 문자열	입력 TimexProperty 개체 또는 Timex 식 문자열입니다.

반환 값	Type	설명
<부울 결과>	Boolean	true 지정된 입력이 유효한 전체 날짜를 참조하는 경우 반환하거나 유효한 전체 날짜를 참조하지 않는 경우 반환 false 합니다.

예제

TimexProperty 개체 validFullDate = new TimexProperty("2020-02-20") 가 있고 Now 속성이 로 설정되어 있다고 가정합니다 true. 다음 예제에서는 개체가 유효한 전체 날짜를 참조하는지를 확인합니다.

isDefinite('xxxx-12-21')
isDefinite(validFullDate)

다음과 같은 결과를 각각 반환합니다.

• false
• true

isDuration

지정된 TimexProperty 또는 Timex 식이 유효한 기간을 참조하면 true를 반환합니다.

isDuration('<input>')

매개 변수	필수	Type	설명
<input>	예	개체 또는 문자열	입력 TimexProperty 개체 또는 Timex 식 문자열입니다.

반환 값	Type	설명
<부울 결과>	Boolean	입력이 유효한 기간을 참조하는 경우 반환 true 하거나 입력이 유효한 기간을 참조하지 않는 경우 반환 false 합니다.

예제

아래 예제에서는 다음 입력이 유효한 기간을 참조하는지 확인합니다.

isDuration('PT30M')
isDuration('2012-02')

다음과 같은 결과를 각각 반환합니다.

• true
• false

isFloat

지정된 입력이 부동 소수점 숫자인 경우 반환 true 합니다. C#과 JavaScript 간의 맞춤으로 인해 모듈로 1의 잔여물이 0이 아닌 숫자가 부동 소수점 숫자로 처리됩니다.

isFloat('<input>')

매개 변수	필수	Type	설명
<input>	예	any	테스트할 입력

반환 값	Type	설명
<부울 결과>	Boolean	true 지정된 입력이 부동 소수점 숫자인 경우 반환하거나 입력이 부동 소수점 숫자가 아닌 경우 반환 false 합니다.

예제

다음 예제에서는 입력이 부동 소수점 숫자인지 확인합니다.

isFloat('hello world!')
isFloat(1.0)
isFloat(12.01)

다음과 같은 결과를 각각 반환합니다.

• 입력은 문자열이므로 함수는 false를 반환합니다.
• 입력에 0과 같은 modulo가 있으므로 함수는 false를 반환합니다.
• 입력이 부동 소수점 숫자이므로 함수는 true를 반환합니다.

isInteger

지정된 입력이 정수이면 true를 반환합니다. C# 및 JavaScript 간의 맞춤으로 인해 모듈로 1의 잔여물이 0인 숫자가 정수로 처리됩니다.

isInteger('<input>')

매개 변수	필수	Type	설명
<input>	예	any	테스트할 입력

반환 값	Type	설명
<부울 결과>	Boolean	입력이 정수인가요?

예제

다음 예제에서는 입력이 정수인지 확인합니다.

isInteger('hello world!')
isInteger(1.0)
isInteger(12)

다음과 같은 결과를 각각 반환합니다.

• 입력은 문자열이므로 함수는 false를 반환합니다.
• 입력에 0과 같은 modulo가 있으므로 함수는 true를 반환합니다.
• 입력은 정수이므로 함수가 반환됩니다 true.

isMatch

지정된 문자열이 지정된 정규식 패턴과 일치하는 경우 반환 true 합니다.

isMatch('<target**string>', '<pattern>')

매개 변수	필수	Type	설명
<target**string>	예	string	일치되는 문자열
<pattern>	예	string	정규식 패턴

반환 값	Type	설명
<부울 결과>	Boolean	true 지정된 문자열이 일반적인 정규식 패턴과 일치하는 경우 반환하거나 패턴과 일치하지 않는 경우 반환 false 합니다.

예제

다음 예제에서는 입력이 지정된 정규식 패턴과 일치하는지 확인합니다.

isMatch('ab', '^[a-z]{1,2}$')
isMatch('FUTURE', '(?i)fortune|future')
isMatch('12abc34', '([0-9]+)([a-z]+)([0-9]+)')
isMatch('abacaxc', 'ab.*?c')

동일한 결과를 true반환합니다.

isObject

지정된 입력이 복합 개체이면 반환 true 하거나 기본 개체인 경우 반환 false 합니다. 기본 개체에는 문자열, 숫자 및 부울이 포함됩니다. 클래스와 같은 복합 형식에는 속성이 포함됩니다.

isObject('<input>')

매개 변수	필수	Type	설명
<input>	예	any	테스트할 입력

반환 값	Type	설명
<부울 결과>	Boolean	지정된 입력이 복합 개체인 경우 반환 true 하거나 기본 개체인 경우 반환 false 합니다.

예제

다음 예제에서는 지정된 입력이 개체인지 확인합니다.

isObject('hello world!')
isObject({userName: "Sam"})

다음과 같은 결과를 각각 반환합니다.

• 입력은 문자열이므로 함수는 false를 반환합니다.
• 입력이 개체이므로 함수가 반환됩니다 true.

isPresent

지정된 TimexProperty 또는 Timex 식이 현재를 참조하는 경우 반환 true 합니다.

isPresent('<input>')

매개 변수	필수	Type	설명
<input>	예	개체 또는 문자열	Timex 식 문자열 입력 TimexProperty 개체

반환 값	Type	설명
<부울 결과>	Boolean	입력이 현재를 참조하는 경우 반환 true 하거나 현재를 참조하지 않는 경우 false를 반환합니다.

예제 TimexProperty 개체 validNow = new TimexProperty() { Now = true }가 있고 속성을 true.로 설정 Now 한다고 가정합니다. 아래 예제에서는 다음 입력이 현재를 참조하는지 확인합니다.

isPresent('PT30M')
isPresent(validNow)

다음과 같은 결과를 각각 반환합니다.

• false
• true

isString

지정된 입력이 문자열이면 반환 true 합니다.

isString('<input>')

매개 변수	필수	Type	설명
<input>	예	any	테스트할 입력

반환 값	Type	설명
<부울 결과>	Boolean	지정된 입력이 문자열이면 true를 반환하고, 문자열이 아니면 false를 반환합니다.

예제

다음 예제에서는 지정된 입력이 문자열인지 확인합니다.

isString('hello world!')
isString(3.14)

다음과 같은 결과를 각각 반환합니다.

• 입력은 문자열이므로 함수는 true를 반환합니다.
• 입력은 float이므로 함수는 .를 반환합니다 false.

isTime

지정된 TimexProperty 또는 Timex 식이 유효한 시간을 참조하는 경우 반환 true 합니다. 유효한 시간은 시간, 분 및 초를 포함합니다.

isTime('<input>')

매개 변수	필수	Type	설명
<input>	예	개체 또는 문자열	Timex 식 문자열 입력 TimexProperty 개체

반환 값	Type	설명
<부울 결과>	Boolean	입력이 유효한 시간을 참조하면 true를 반환하고, 유효한 시간을 참조하지 않는 경우 false를 반환합니다.

예제

다음 예제에서는 다음 입력이 유효한 시간을 참조하는지 확인합니다.

isTime('PT30M')
isTime('2012-02-21T12:30:45')

다음과 같은 결과를 각각 반환합니다.

• false
• true

isTimeRange

지정된 TimexProperty 또는 Timex 식이 유효한 시간 범위를 참조하는 경우에는 true를 반환합니다. 유효한 시간 범위는 partOfDay를 포함합니다.

isTime('<input>')

매개 변수	필수	Type	설명
<input>	예	개체 또는 문자열	입력 TimexProperty 개체 또는 Timex 식 문자열입니다.

반환 값	Type	설명
<부울 결과>	Boolean	입력이 유효한 시간 범위를 참조하면 true를 반환하고, 유효한 시간 범위를 참조하지 않으면 false를 반환합니다.

예제

TimexProperty 개체 validTimeRange = new TimexProperty() { PartOfDay = "morning" }이고 속성을 true.로 설정 Now 한다고 가정합니다. 다음 예제에서는 다음 입력이 유효한 시간 범위인지 확인합니다.

isTimeRange('PT30M')
isTimeRange(validTimeRange)

다음과 같은 결과를 각각 반환합니다.

• false
• true

join

각 문자를 구분 기호로 구분하여 배열의 모든 항목이 있는 문자열을 반환합니다.

join([<collection>], '<delimiter>')

매개 변수	필수	Type	설명
<컬렉션>	예	배열	조인할 항목이 있는 배열
<delimiter>	예	string	결과 문자열의 각 문자 사이에 나타나는 구분 기호

반환 값	Type	설명
<char1><delimiter><char2><delimiter>...	string	지정한 배열의 모든 항목에서 만든 결과 문자열

예제

다음은 지정된 문자를 구분 기호로 사용하여 이 배열의 모든 항목에서 문자열을 만드는 예제입니다.

join(createArray('a', 'b', 'c'), '.')

그리고 결과 a.b.c를 반환합니다.

jPath

경로 식과 일치하는 노드 또는 값에 대한 JSON 또는 JSON 문자열을 확인하고 일치하는 노드를 반환합니다.

jPath(<json>, '<path>')

매개 변수	필수	Type	설명
<json>	예	any	경로 식 값과 일치하는 노드 또는 값을 검색하기 위한 JSON 개체 또는 문자열
<path>	예	any	일치하는 JSON 노드 또는 값을 찾는 데 사용되는 경로 식입니다.

반환 값	Type	설명
[ <json-node>]	배열	지정된 경로 식과 일치하는 JSON 노드 또는 값 목록

C# 예제

다음 JSON이 있다고 가정하겠습니다.

{
    "Stores": [
        "Lambton Quay",
        "Willis Street"
    ],
    "Manufacturers": [
        {
            "Name": "Acme Co",
            "Products": [
                {
                    "Name": "Anvil",
                    "Price": 50
                }
            ]
        },
        {
            "Name": "Contoso",
            "Products": [
                {
                    "Name": "Elbow Grease",
                    "Price": 99.95
                },
                {
                    "Name": "Headlight Fluid",
                    "Price": 4
                }
            ]
        }
    ]
}

경로 식은 $.입니다 . 제품[?( @. 가격 >= 50)]. 이름

jPath(jsonStr, path)

그리고 결과 ["Anvil", "Elbow Grease"]를 반환합니다.

JavaScript 예제

다음 JSON이 있다고 가정하겠습니다.

{
    "automobiles": [
        {
            "maker": "Nissan",
            "model": "Teana",
            "year": 2011
        },
        {
            "maker": "Honda",
            "model": "Jazz",
            "year": 2010
        },
        {
            "maker": "Honda",
            "model": "Civic",
            "year": 2007
        },
        {
            "maker": "Toyota",
            "model": "Yaris",
            "year": 2008
        },
        {
            "maker": "Honda",
            "model": "Accord",
            "year": 2011
        }
    ],
    "motorcycles": [
        {
            "maker": "Honda",
            "model": "ST1300",
            "year": 2012
        }
    ]
}

경로 식은 .automobiles{.maker === "Honda" 및 .year > 2009}.model입니다.

jPath(jsonStr, path)

그리고 결과 ['Jazz', 'Accord']를 반환합니다.

json

JSON(JavaScript Object Notation) 형식 값 또는 문자열 또는 XML의 개체를 반환합니다.

json('<value>')

매개 변수	필수	Type	설명
<value>	예	문자열 또는 XML	변환할 문자열 또는 XML

반환 값	Type	설명
<JSON-result>	string	지정된 문자열 또는 XML에서 만든 결과 JSON 개체입니다.

예제 1

다음 예제에서는 문자열을 JSON으로 변환합니다.

json('{"fullName": "Sophia Owen"}')

그리고 다음 결과를 반환합니다.

{
  "fullName": "Sophia Owen"
}

예제 2

이 예제에서는 XML을 JSON으로 변환합니다.

json(xml('<?xml version="1.0"?> <root> <person id='1'> <name>Sophia Owen</name> <occupation>Engineer</occupation> </person> </root>'))

그리고 다음 결과를 반환합니다.

{
   "?xml": { "@version": "1.0" },
   "root": {
      "person": [ {
         "@id": "1",
         "name": "Sophia Owen",
         "occupation": "Engineer"
      } ]
   }
}

jsonStringify

값의 JSON 문자열을 반환합니다.

매개 변수	필수	Type	설명
<value>	예	개체	JSON 문자열로 변환할 개체입니다.

반환 값	Type	설명
<JSON-result>	string	결과 JSON 문자열입니다.

예제

다음 예제에서는 JSON 문자열로 변환된 개체를 보여 줍니다.

jsonStringify(null)
jsonStringify({a:'b'})

그리고 각각 다음 문자열 결과를 반환합니다.

• null
• {"a":"b"}

last

컬렉션에서 마지막 항목을 반환합니다.

last('<collection>')
last([<collection>])

매개 변수	필수	Type	설명
<컬렉션>	예	문자열 또는 배열	마지막 항목을 찾을 컬렉션입니다.

반환 값	Type	설명
<last-collection-item>	각각 문자열 또는 배열	컬렉션의 마지막 항목

예제

아래 예제는 이러한 컬렉션의 마지막 항목을 찾습니다.

last('abcd')
last(createArray(0, 1, 2, 3))

그리고 각각 다음 결과를 반환합니다.

• d
• 3

lastIndexOf

부분 문자열이 마지막으로 나타나는 시작 위치 또는 인덱스 값을 반환합니다. 이 함수는 대/소문자를 구분하지 않으며 인덱스는 숫자 0으로 시작합니다.

lastIndexOf('<text>', '<searchText>')

매개 변수	필수	Type	설명
<text>	예	문자열 또는 배열	찾을 하위 문자열을 가진 문자열
<searchText>	예	string	찾을 하위 문자열

반환 값	Type	설명
<ending-index-value>	정수	지정된 부분 문자열이 마지막으로 발생한 시작 위치 또는 인덱스 값입니다. 문자열을 찾을 수 없으면 숫자 -1을 반환합니다.

예제 1

이 예제에서는 hello world 문자열에서 부분 문자열 세계의 마지막 항목에 대한 시작 인덱스 값을 찾습니다.

lastIndexOf('hello world', 'world')

그리고 결과 6을 반환합니다.

예제 2

다음 예제에서는 배열['abc', 'def', 'ghi', 'def']에서 하위 문자열 def이 마지막으로 나오는 경우의 시작 인덱스 값을 찾습니다.

lastIndexOf(createArray('abc', 'def', 'ghi', 'def'), 'def')

그리고 결과 3을 반환합니다.

length

문자열의 길이를 반환합니다.

length('<str>')

매개 변수	필수	Type	설명
<str>	예	string	길이를 계산할 문자열입니다.

반환 값	Type	설명
<length>	정수	이 문자열의 길이

예제

다음 예제에서는 문자열의 길이를 가져옵니다.

length('hello')
length('hello world')

그리고 각각 다음 결과를 반환합니다.

• 5
• 11

less

첫 번째 값이 두 번째 값보다 작은지 검사합니다. 첫 번째 값이 더 작으면 true를 반환하고, 첫 번째 값이 더 크면 false를 반환합니다.

less(<value>, <compareTo>)
less('<value>', '<compareTo>')

매개 변수	필수	Type	설명
<value>	예	정수, 부동 소수점 또는 문자열	두 번째 값보다 작은지 검사할 첫 번째 값
<compareTo>	예	각각 정수, 부동 소수점 수 또는 문자열	비교 항목

반환 값	Type	설명
true 또는 false	부울	첫 번째 값이 두 번째 값보다 작으면 true를 반환합니다. 첫 번째 값이 두 번째 값과 같거나 큰 경우 반환 false 합니다.

예제

아래 예제는 첫 번째 값이 두 번째 값보다 작은지 검사합니다.

less(5, 10)
less('banana', 'apple')

다음과 같은 결과를 각각 반환합니다.

• true
• false

lessOrEquals

첫 번째 값이 두 번째 값보다 작거나 같은지 검사합니다. true 첫 번째 값이 작거나 같으면 반환하거나 첫 번째 값이 더 많은 경우 반환 false 합니다.

lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')

매개 변수	필수	Type	설명
<value>	예	정수, 부동 소수점 또는 문자열	두 번째 값보다 작거나 같은지 검사할 첫 번째 값
<compareTo>	예	각각 정수, 부동 소수점 수 또는 문자열	비교 항목

반환 값	Type	설명
true 또는 false	부울	첫 번째 값이 두 번째 값보다 작거나 같은 경우 반환 true 합니다. 첫 번째 값이 두 번째 값보다 큰 경우 반환 false 합니다.

예제

아래 예제에서는 첫 번째 값이 두 번째 값보다 작거나 같은지 검사합니다.

lessOrEquals(10, 10)
lessOrEquals('apply', 'apple')

다음과 같은 결과를 각각 반환합니다.

• true
• false

max

목록 또는 배열에서 가장 높은 값을 반환합니다. 목록 또는 배열은 양쪽 끝에 포함됩니다.

max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])

매개 변수	필수	Type	설명
<number1>, <number2>, ...	예	number	가장 높은 값을 원하는 숫자의 집합
[<number1>, <number2>, ...]	예	숫자의 배열	가장 높은 값을 원하는 숫자의 배열

반환 값	Type	설명
<max-value>	number	지정한 배열 또는 숫자 집합의 가장 높은 값

예제

아래 예제는 숫자 집합 및 배열에서 가장 높은 값을 가져옵니다.

max(1, 2, 3)
max(createArray(1, 2, 3))

그리고 결과 3을 반환합니다.

merge

여러 JSON 개체 또는 개체 배열을 함께 병합합니다.

merge(<json1>, <json2>, ...)

매개 변수	필수	Type	설명
<json1>, <json2>, ...	예	개체 또는 배열	병합할 JSON 개체 또는 배열 집합입니다.

반환 값	Type	Description
<result>	개체	결합된 JSON 개체 또는 결합된 배열 개체입니다.

예제

다음과 같은 JSON 개체가 있다고 가정합니다.

json1 = @"{
            'FirstName': 'John',
            'LastName': 'Smith',
            'Enabled': false,
            'Roles': [ 'User' ]
          }"
json2 =@"{
            'Enabled': true,
            'Roles': [ 'User', 'Admin' ]
          }"

다음은 JSON 개체를 병합하는 예제입니다.

string(merge(json(json1), json(json2)))

그리고 결과 개체 {"FirstName":"John","LastName":"Smith","Enabled":true,"Roles":["User","Admin"]}을 반환합니다.

개체와 개체 목록을 함께 결합하려는 경우를 가정해 보겠습니다. 다음 예제에서는 JSON 개체와 개체 배열을 결합합니다.

merge({k1:'v1'}, [{k2:'v2'}, {k3: 'v3'}], {k4:'v4'})

개체 { "k1": "v1", "k2": "v2", "k3": "v3", "k4": "v4" }를 반환합니다.

min

숫자 또는 배열 집합에서 가장 낮은 값을 반환합니다.

min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])

매개 변수	필수	Type	설명
<number1>, <number2>, ...	예	number	가장 낮은 값을 원하는 숫자의 집합
[<number1>, <number2>, ...]	예	숫자의 배열	가장 낮은 값을 원하는 숫자의 배열

반환 값	Type	설명
<min-value>	number	지정한 배열 또는 숫자 세트의 가장 낮은 값

예제

아래 예제는 숫자 집합 및 배열에서 가장 낮은 값을 가져옵니다.

min(1, 2, 3)
min(createArray(1, 2, 3))

그리고 결과 1을 반환합니다.

mod

두 숫자를 나눈 나머지를 반환합니다. 정수 결과를 가져오는 방법은 div()를 참조하세요.

mod(<dividend>, <divisor>)

매개 변수	필수	Type	설명
<dividend>	예	number	제수로 나눌 숫자
<divisor>	예	number	‘피제수’를 나누는 숫자입니다. 0일 수 없습니다.

반환 값	Type	설명
<modulo-result>	number	첫 번째 숫자를 두 번째 숫자로 나눈 나머지

예제

이 예제는 첫 번째 숫자를 두 번째 숫자로 나눕니다.

mod(3, 2)

그리고 결과 1을 반환합니다.

month

지정된 타임스탬프의 월을 반환합니다.

month('<timestamp>')

매개 변수	필수	Type	설명
<timestamp>	예	string	타임스탬프를 포함하는 문자열

반환 값	Type	설명
<월 수>	정수	지정된 타임스탬프의 월 숫자

예제

month('2018-03-15T13:01:00.000Z')

그리고 결과 3을 반환합니다.

mul

두 숫자를 곱한 결과를 반환합니다.

mul(<multiplicand1>, <multiplicand2>)

매개 변수	필수	Type	설명
<multiplicand1>	예	정수 또는 부동 소수점	multiplicand2로 곱할 숫자
<multiplicand2>	예	정수 또는 부동 소수점	multiplicand1를 곱하는 숫자

반환 값	Type	설명
<product-result>	정수 또는 부동 소수점	첫 번째 숫자를 두 번째 숫자로 곱한 결과

예제

아래 예제는 첫 번째 숫자를 두 번째 숫자로 곱합니다.

mul(1, 2)
mul(1.5, 2)

다음과 같은 결과를 각각 반환합니다.

• 2
• 3

newGuid

새 Guid 문자열을 반환합니다.

newGuid()

반환 값	Type	설명
<Guid 문자열>	string	새 GUID 문자열이고, 길이는 is 36이며 xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx와 같음

예제

newGuid()

그리고 xxxxxxxx-xxxx-4xxx-yxxx-xx 형식을 따르는 결과를 반환합니다.

not

식이 false인지 검사합니다. 식이 false이면 true를 반환하고 true이면 false를 반환합니다.

not(<expression>)

매개 변수	필수	Type	설명
<expression>	예	부울	검사할 식

반환 값	Type	설명
true 또는 false	부울	식이 false이면 반환 true 합니다. 식이 true이면 반환 false 합니다.

예제 1

아래 예제는 지정한 식이 모두 false인지 검사합니다.

not(false)
not(true)

다음과 같은 결과를 각각 반환합니다.

• 식이 false이므로 함수는 true를 반환합니다.
• 식이 true이므로 함수는 .를 반환합니다 false.

예제 2

아래 예제는 지정한 식이 모두 false인지 검사합니다.

not(equals(1, 2))
not(equals(1, 1))

다음과 같은 결과를 각각 반환합니다.

• 식이 false이므로 함수는 true를 반환합니다.
• 식이 true이므로 함수는 .를 반환합니다 false.

또는

최소 하나의 식이 true인지 검사합니다. 하나 이상의 식이 true이면 반환 true 하거나 모두 false이면 반환 false 합니다.

or(<expression1>, <expression2>, ...)

매개 변수	필수	Type	설명
<expression1>, <expression2>, ...	예	부울	검사할 식

반환 값	Type	설명
true 또는 false	부울	하나 이상의 식이 true이면 true를 반환합니다. 모든 식이 false이면 반환 false 합니다.

예제 1

아래 예제는 최소 하나의 식이 true인지 검사합니다.

or(true, false)
or(false, false)

다음과 같은 결과를 각각 반환합니다.

• 하나 이상의 식이 true이므로 함수는 .를 반환합니다 true.
• 두 식 모두 false이므로 함수가 반환됩니다 false.

예제 2

아래 예제는 최소 하나의 식이 true인지 검사합니다.

or(equals(1, 1), equals(1, 2))
or(equals(1, 2), equals(1, 3))

다음과 같은 결과를 각각 반환합니다.

• 하나 이상의 식이 true이므로 함수는 .를 반환합니다 true.
• 두 식 모두 false이므로 함수가 반환됩니다 false.

rand

시작 끝만 포함하는 지정한 범위에서 임의의 정수를 반환합니다.

rand(<minValue>, <maxValue>)

매개 변수	필수	Type	설명
<minValue>	예	정수	범위의 가장 작은 정수
<maxValue>	예	정수	함수가 반환할 수 있는 범위에서 가장 높은 정수 다음에 오는 정수

반환 값	Type	설명
<random-result>	정수	지정된 범위에서 반환된 임의 정수입니다.

예제

이 예제는 최댓값을 제외하고 지정한 범위에서 임의의 정수를 가져옵니다.

rand(1, 5)

그리고 결과로 1, 2, 3 또는 4를 반환합니다.

range

지정한 정수에서 시작하는 정수 배열을 반환합니다.

range(<startIndex>, <count>)

매개 변수	필수	Type	설명
<startIndex>	예	정수	배열을 첫 번째 항목으로 시작하는 정수 값
<count>	예	정수	배열에 있는 정수의 숫자

반환 값	Type	설명
<range-result>	정수	지정한 인덱스에서 시작하는 정수를 포함하는 배열

예제

다음 예제에서는 지정한 인덱스 1에서 시작하고 지정한 수의 정수 4를 가진 정수 배열을 만듭니다.

range(1, 4)

그리고 결과 [1, 2, 3, 4]를 반환합니다.

removeProperty

개체에서 속성을 제거하고 업데이트된 개체를 반환합니다.

removeProperty(<object>, '<property>')

매개 변수	필수	Type	설명
<object>	예	개체	속성을 제거할 JSON 개체입니다.
<속성>	예	string	제거할 속성의 이름입니다.

반환 값	Type	설명
<updated-object>	개체	지정된 속성이 없는 업데이트된 JSON 개체

예제

다음은 json() 함수를 사용하여 customerProfile JSON으로 변환되는 개체에서 속성을 제거하고 accountLocation 업데이트된 개체를 반환하는 예제입니다.

removeProperty(json('customerProfile'), 'accountLocation')

replace

하위 문자열을 지정한 문자열로 바꾸고 결과 문자열을 반환합니다. 이 함수는 대/소문자를 구분합니다.

replace('<text>', '<oldText>', '<newText>')

매개 변수	필수	Type	설명
<text>	예	string	바꿀 하위 문자열을 가진 문자열
<oldText>	예	string	바꿀 하위 문자열
<newText>	예	string	대체 문자열

반환 값	Type	설명
<updated-text>	string	부분 문자열을 바꾼 후 업데이트된 문자열입니다. 부분 문자열을 찾을 수 없으면 함수는 원래 문자열을 반환합니다.

예제 1

이 예제에서는 이전 문자열에서 이전 부분 문자열을 찾고 이전 문자열을 new로 바꿉니다.

replace('the old string', 'old', 'new')

결과는 새 문자열 문자열입니다.

예제 2

이스케이프 문자를 처리할 때 식 엔진은 사용자에 대한 비스케이프를 처리합니다. 이 함수는 문자열을 이스케이프 문자로 대체합니다.

replace('hello\"', '\"', '\n')
replace('hello\n', '\n', '\\\\')
@"replace('hello\\', '\\', '\\\\')"
@"replace('hello\n', '\n', '\\\\')"

그리고 각각 다음 결과를 반환합니다.

• hello\n
• 안녕하세요\\
• @"hello\\"
• @"hello\\"

replaceIgnoreCase

하위 문자열을 지정한 문자열로 바꾸고 결과 문자열을 반환합니다. 이 함수는 대/소문자를 구분하지 않습니다.

replaceIgnoreCase('<text>', '<oldText>', '<newText>')

매개 변수	필수	Type	설명
<text>	예	string	바꿀 하위 문자열을 가진 문자열
<oldText>	예	string	바꿀 하위 문자열
<newText>	예	string	대체 문자열

반환 값	Type	설명
<updated-text>	string	부분 문자열을 바꾼 후 업데이트된 문자열입니다. substring이 발견되지 않으면 원래 문자열을 반환합니다.

예제

이 예제에서는 문자열에서 이전 문자열의 부분 문자열을 찾고 이전 문자열을 new로 바꿉니다.

replace('the old string', 'old', 'new')

그리고 결과 the new string을 반환합니다.

resolve

유효한 시간을 참조하는 경우 지정된 TimexProperty 또는 Timex 식의 문자열을 반환합니다. 유효한 시간에는 시간, 분 및 초가 포함됩니다.

resolve('<timestamp')

매개 변수	필수	Type	설명
<timestamp>	예	string	타임스탬프를 포함하는 문자열입니다.

반환 값	Type	설명
<return>	string	평가된 TimexProperty 또는 Timex 식의 문자열입니다.

예제

다음 예제에서는 지정된 문자열이 유효한 시간을 참조하는지를 보여 줍니다.

resolve(T14)
resolve(2020-12-20)
resolve(2020-12-20T14:20)

그리고 각각 다음 결과를 반환합니다.

• 14:00:00
• 2020-12-20
• 2020-12-20 14:20:00

reverse

문자열 또는 배열에 있는 요소의 순서를 반대로 바뀝다.

reverse(<value>)

매개 변수	필수	Type	설명
<value>	예	문자열 또는 배열	역방향 배열할 문자열입니다.

반환 값	Type	설명
<return>	문자열 또는 배열	문자열 또는 배열의 역방향 요소입니다.

예제

다음 예제에서는 문자열 또는 배열의 요소를 반대로 바꿉니다.

reverse(hello)
reverse(concat(hello,world))

그리고 각각 다음 값을 반환합니다.

-문자열 olleh입니다. -문자열 dlrowolleh입니다.

round

값을 가장 가까운 정수 또는 지정된 소수 자릿수로 반올림합니다.

round('<number>', '<precision-digits>')

매개 변수	필수	Type	설명
<number>	예	number	입력 번호
<전체 자릿수>	아니요	정수	지정된 소수 자릿수입니다. 기본값은 0입니다.

반환 값	Type	설명
<return-value>	number	지정된 소수 자릿수로 반올림된 입력의 반환 값입니다.

예제 1

다음은 숫자 10.333을 반올림하는 예제입니다.

round(10.333)

그리고 숫자 10을 반환합니다.

예제 2

다음은 숫자 10.3313을 소수 자릿수 2로 반올림하는 예제입니다.

round(10.3313, 2)

그리고 숫자 10.33을 반환합니다.

선택

각 요소에 대해 작동하고 변환된 요소의 새 컬렉션을 반환합니다.

select([<collection/instance>], <iteratorName>, <function>)

매개 변수	필수	Type	설명
<collection/instance>	예	배열	항목이 있는 컬렉션
<iteratorName>	예	반복기 이름	키 항목
<function>	예	식	포함할 수 있는 Th 함수 iteratorName

반환 값	Type	설명
<new-collection>	배열	각 요소가 함수를 사용하여 평가된 새 컬렉션

예제 1

다음 예제에서는 새 컬렉션을 생성합니다.

select(createArray(0, 1, 2, 3), x, x + 1)

그리고 결과 [1, 2, 3, 4]를 반환합니다.

예제 2

다음 예제에서는 새 컬렉션을 생성합니다.

select(json("{'name': 'jack', 'age': '15'}"), x, concat(x.key, ':', x.value))
select(json("{'name': 'jack', 'age': '15'}"), x=> concat(x.key, ':', x.value))

그리고 결과 ['name:jack', 'age:15']를 반환합니다. 두 번째 식은 더 읽기 쉬운 람다 식입니다.

sentenceCase

첫 번째 단어의 첫 글자를 선택적 로캘 형식으로 문자열로 대문자로 표시합니다.

sentenceCase('<text>', '<locale>'?)

매개 변수	필수	Type	설명
<text>	예	string	원래 문자열
<로캘>	아니요	string	문화권 정보의 선택적 로캘

반환 값	Type	설명
결과 문자열	string	문장 대/소문자 결과를 반환합니다.

예제 1

다음 예제에서는 문자열의 첫 번째 문자를 대문자로 표시합니다.

sentenceCase('a')
sentenceCase('abc def')
sentenceCase('aBC dEF')

다음과 같은 결과를 각각 반환합니다.

• A
• Abc def
• Abc def

예제 2

다음 예제에서는 문자열의 첫 번째 문자를 지정된 로캘 형식으로 대문자로 표시합니다.

sentenceCase('a', 'fr-FR')
sentenceCase('abc', 'en-US')
sentenceCase('aBC', 'fr-FR')

다음과 같은 결과를 각각 반환합니다.

• A
• Abc (미국)
• Abc (미국)

setPathToValue

JSON 개체에서 지정된 속성의 값을 검색합니다.

setPathToValue(<path>, <value>)

매개 변수	필수	Type	설명
<Path>	예	개체	설정할 경로입니다.
<value>	예	개체	경로에 설정하려는 값

반환 값	Type	설명
value	개체	설정할 값입니다.

예제 1

아래 예제에서는 값 1 을 경로로 설정합니다.

setPathToValue(path.x, 1)

그리고 결과 1을 반환합니다. path.x가 1로 설정됩니다.

예제 2

아래 예제에서는 값을 설정합니다.

setPathToValue(path.array[0], 7) + path.array[0]

그리고 결과 14를 반환합니다.

setProperty

개체의 속성 값을 설정하고 업데이트된 개체를 반환합니다. 새 속성을 추가하려면 이 함수 또는 addProperty() 함수를 사용합니다.

setProperty(<object>, '<property>', <value>)

매개 변수	필수	Type	설명
<object>	예	개체	속성을 설정할 JSON 개체입니다.
<속성>	예	string	설정할 속성의 이름입니다.
<value>	예	any	지정된 속성에 대해 설정할 값입니다.

반환 값	Type	설명
<updated-object>	개체	설정한 속성이 있는 업데이트된 JSON 개체

예제

다음은 json() 함수를 사용하여 customerProfile JSON으로 변환되는 개체의 속성을 설정하는 accountNumber 예제입니다. 이 함수는 newGuid() 함수에서 생성된 값을 할당하고 업데이트된 JSON 개체를 반환합니다.

setProperty(json('customerProfile'), 'accountNumber', newGuid())

skip

컬렉션 앞의 항목을 제거하고 다른 모든 항목을 반환합니다.

skip([<collection>], <count>)

매개 변수	필수	Type	설명
<컬렉션>	예	배열	해당 항목을 제거할 컬렉션
<count>	예	정수	앞에서 제거할 항목 수에 대한 양수 정수

반환 값	Type	설명
<updatedCollection>	배열	지정한 항목을 제거한 후 업데이트된 컬렉션

예제

다음 예제에서는 지정한 배열 앞에서 항목 한 개, 숫자 1을 제거합니다.

skip(createArray(0, 1, 2, 3), 1)

나머지 항목 이 있는 배열을 반환합니다. [1,2,3].

sortBy

컬렉션의 요소를 오름차순으로 정렬하고 정렬된 컬렉션을 반환합니다.

sortBy([<collection>], '<property>')

매개 변수	필수	Type	설명
<컬렉션>	예	문자열 또는 배열	정렬할 컬렉션
<속성>	아니요	string	설정된 경우 컬렉션에 있는 개체 요소의 이 특정 속성을 기준으로 정렬합니다.

반환 값	Type	설명
<new-collection>	배열	요소가 정렬된 새 컬렉션

예제 1

이 예제에서는 다음 컬렉션을 정렬합니다.

sortBy(createArray(1, 2, 0, 3))

그리고 결과 [0, 1, 2, 3]을 반환합니다.

예제 2

다음 컬렉션이 있다고 가정합니다.

{
  'nestedItems': [
    {'x': 2},
    {'x': 1},
    {'x': 3}
  ]
}

이 예제에서는 x 개체 속성을 기반으로 정렬된 새 컬렉션을 생성합니다.

sortBy(nestedItems, 'x')

그리고 다음 결과를 반환합니다.

{
  'nestedItems': [
    {'x': 1},
    {'x': 2},
    {'x': 3}
  ]
}

sortByDescending

컬렉션의 요소를 내림차순으로 정렬하고 정렬된 컬렉션을 반환합니다.

sortBy([<collection>], '<property>')

매개 변수	필수	Type	설명
<컬렉션>	예	문자열 또는 배열	정렬할 컬렉션
<속성>	아니요	string	설정된 경우 컬렉션에 있는 개체 요소의 이 특정 속성을 기준으로 정렬합니다.

반환 값	Type	설명
<new-collection>	배열	요소가 정렬된 새 컬렉션

예제 1

다음 예제에서는 새로 정렬된 컬렉션을 생성합니다.

sortByDescending(createArray(1, 2, 0, 3))

그리고 결과 [3, 2, 1, 0]을 반환합니다.

예제 2

다음 컬렉션이 있다고 가정합니다.

{
  'nestedItems': [
    {'x': 2},
    {'x': 1},
    {'x': 3}
  ]
}

이 예제에서는 x 개체 속성을 기반으로 정렬된 새 컬렉션을 생성합니다.

sortByDescending(nestedItems, 'x')

그리고 다음 결과를 반환합니다.

{
  'nestedItems': [
    {'x': 3},
    {'x': 2},
    {'x': 1}
  ]
}

split

원래 문자열의 지정된 구분 기호 문자를 기반으로 쉼표로 구분된 부분 문자열이 포함된 배열을 반환합니다.

split('<text>', '<delimiter>'?)

매개 변수	필수	Type	설명
<text>	예	string	원래 문자열의 지정된 구분 기호에 따라 부분 문자열로 구분할 문자열입니다. 텍스트가 null 값이면 빈 문자열로 가져옵니다.
<delimiter>	아니요	string	구분 기호로 사용할 원래 문자열의 문자입니다. 구분 기호가 제공되지 않거나 구분 기호가 null 값이면 기본값은 빈 문자열이 됩니다.

반환 값	Type	설명
[<substring1>,<substring2>,...]	배열	쉼표로 구분된 원래 문자열의 부분 문자열을 포함하는 배열입니다.

예제

다음 예제에서는 지정된 구분 기호 문자를 기준으로 하여 지정한 문자열의 하위 문자열이 포함된 배열을 만듭니다.

split('a**b**c', '**')
split('hello', '')
split('', 'e')
split('', '')
split('hello')

그리고 다음과 같은 배열을 각각 결과로 반환합니다.

• ["a", "b", "c"]
• ["h", "e", "l", "l", "o"]
• [""], [ ]
• ["h", "e", "l", "l", "o"]

sqrt

지정된 숫자의 제곱근을 반환합니다.

sqrt(<number>)

매개 변수	필수	Type	설명
<number>	예	number	의 제곱근을 가져올 수

반환 값	Type	Description
<result>	number	제곱근을 계산한 결과입니다.

예제

다음 예제에서는 지정된 숫자의 제곱근을 계산합니다.

sqrt(9)
sqrt(0)

다음과 같은 결과를 각각 반환합니다.

• 3
• 0

startOfDay

타임스탬프의 날짜 시작을 선택적 로캘 형식으로 반환합니다.

startOfDay('<timestamp>', '<format>'?, '<locale>'?)

매개 변수	필수	Type	설명
<timestamp>	예	string	타임스탬프를 포함하는 문자열
<format>	아니요	string	사용자 지정 형식 패턴. 타임스탬프의 기본 형식은 ISO 8601을 준수하는 UTC ISO 형식인 YYYY-MM-DDTHH:mm:ss.fffZ입니다.
<로캘>	아니요	string	문화권 정보의 선택적 로캘

반환 값	Type	설명
'<updated-timestamp>'	string	해당 날짜의 0시 마크에서 시작하는 지정한 타임스탬프

예제 1

이 예제에서는 하루의 시작을 찾습니다.

startOfDay('2018-03-15T13:30:30.000Z')

그리고 결과 2018-03-15T00:00:00.000Z를 반환합니다.

예제 2

이 예제에서는 로캘 fr-FR을 사용하여 하루의 시작을 찾습니다.

startOfDay('2018-03-15T13:30:30.000Z', '', 'fr-FR')

그리고 2018년 15월 3일 00:00:00 결과를 반환합니다.

startOfHour

타임스탬프의 시간 시작을 선택적 로캘 형식으로 반환합니다.

startOfHour('<timestamp>', '<format>'?, '<locale>'?)

매개 변수	필수	Type	설명
<timestamp>	예	string	타임스탬프를 포함하는 문자열
<format>	아니요	string	사용자 지정 형식 패턴. 타임스탬프의 기본 형식은 ISO 8601을 준수하는 UTC ISO 형식인 YYYY-MM-DDTHH:mm:ss.fffZ입니다.
<로캘>	아니요	string	문화권 정보의 선택적 로캘

반환 값	Type	설명
'<updated-timestamp>'	string	날짜의 0분 표시에서 시작하는 지정된 타임스탬프입니다.

예제 1

이 예제에서는 시간의 시작을 찾습니다.

startOfHour('2018-03-15T13:30:30.000Z')

그리고 결과 2018-03-15T13:00:00.000Z를 반환합니다.

예제 2

이 예제에서는 로캘 fr-FR을 사용하여 시간의 시작을 찾습니다.

startOfHour('2018-03-15T13:30:30.000Z', '', 'fr-FR')

그리고 2018/15/03 13:00:00 결과를 반환합니다.

startOfMonth

선택적 로캘 형식으로 타임스탬프에 대한 월의 시작을 반환합니다.

startOfMonth('<timestamp>', '<format>'?, '<locale>'?)

매개 변수	필수	Type	설명
<timestamp>	예	string	타임스탬프를 포함하는 문자열
<format>	아니요	string	사용자 지정 형식 패턴. 타임스탬프의 기본 형식은 ISO 8601을 준수하는 UTC ISO 형식인 YYYY-MM-DDTHH:mm:ss.fffZ입니다.
<로캘>	아니요	string	문화권 정보의 선택적 로캘

반환 값	Type	설명
'<updated-timestamp>'	string	매월 첫째 날부터 0시간 표시로 시작하는 지정된 타임스탬프입니다.

예제 1

이 예제에서는 월의 시작을 찾습니다.

startOfMonth('2018-03-15T13:30:30.000Z')

그리고 결과 2018-03-01T00:00:00.000Z를 반환합니다.

예제 2

이 예제에서는 로캘 fr-FR을 사용하여 월의 시작을 찾습니다.

startOfMonth('2018-03-15T13:30:30.000Z', '', 'fr-FR')

그리고 2018/01/03 00:00 결과를 반환합니다.

startsWith

문자열이 특정 하위 문자열로 시작하는지 검사합니다. 부분 문자열이 발견되면 반환 true 하거나, 찾을 수 없는 경우 반환 false 합니다. 이 함수는 대/소문자를 구분하지 않습니다.

startsWith('<text>', '<searchText>')

매개 변수	필수	Type	설명
<text>	예	string	검사할 문자열
<searchText>	예	string	찾을 시작 부분 문자열

반환 값	Type	설명
true 또는 false	부울	시작 부분 문자열이 발견되는 경우 true를 반환합니다. 찾을 수 없는 경우 false를 반환합니다.

예제 1

다음 예제에서는 문자열 hello world가 문자열 hello로 사작하는지 검사합니다.

startsWith('hello world', 'hello')

그리고 결과를 true반환합니다.

예제 2

다음 예제에서는 문자열 hello world가 문자열 greeting으로 사작하는지 검사합니다.

startsWith('hello world', 'greeting')

그리고 결과를 false반환합니다.

string

값의 문자열 버전을 선택적 로캘 형식으로 반환합니다.

string(<value>, '<locale>'?)

매개 변수	필수	Type	설명
<value>	예	any	변환할 값
<로캘>	아니요	string	문화권 정보의 선택적 로캘

반환 값	Type	설명
<string-value>	string	지정된 값의 문자열 버전입니다.

예제 1

이 예제에서는 숫자 10의 문자열 버전을 만듭니다.

string(10)

문자열 결과 10을 반환합니다.

예제 2

다음 예제에서는 지정한 JSON 개체에 대한 문자열을 만들고 백슬래시 문자, \\를 따옴표 문자 "에 대한 이스케이프 문자로 사용합니다.

string( { "name": "Sophie Owen" } )

그리고 결과 { "name": "Sophie Owen" }을 반환합니다.

예 3

다음 예제에서는 특정 로캘에 숫자 10 의 문자열 버전을 만듭니다.

string(100.1, 'fr-FR')
string(100.1, 'en-US')

그리고 각각 다음 문자열을 반환합니다.

• 100,1
• 100.1

stringOrValue

문자열 보간을 래핑하여 실제 값을 가져옵니다. 예를 들어 stringOrValue('${1}') 숫자 1을 반환하고 stringOrValue('${1} item') 문자열 "1 항목"을 반환합니다.

stringOrValue(<string>)

매개 변수	필수	Type	설명
<string>	예	string	실제 값을 가져올 문자열입니다.

반환 값	Type	Description
<result>	any	지정된 문자열의 실제 값을 얻은 결과입니다.

예제

다음 예제는 문자열에서 실제 값을 가져옵니다.

stringOrValue('${one}')
stringOrValue('${one} item')

다음과 같은 결과를 각각 반환합니다.

• 숫자 1.0입니다.
• 문자열 1 항목입니다.

sub

첫 번째 숫자에서 두 번째 숫자를 뺀 결과를 반환합니다.

sub(<minuend>, <subtrahend>)

매개 변수	필수	Type	설명
<minuend>	예	number	감수를 뺄 수
<subtrahend>	예	number	피감수에서 뺄 수

반환 값	Type	Description
<result>	number	첫 번째 숫자에서 두 번째 숫자를 뺀 결과

예제

이 예제는 첫 번째 숫자에서 두 번째 숫자를 뺍니다.

sub(10.3, .3)

그리고 결과 10을 반환합니다.

subArray

지정된 시작 및 끝 위치에서 하위 배열을 반환합니다. 인덱스 값은 숫자 0으로 시작합니다.

subArray(<Array>, <startIndex>, <endIndex>)

매개 변수	필수	Type	설명
<array>	예	배열	하위 배열을 만들 배열입니다.
<startIndex>	예	정수	시작 위치 또는 인덱스 값으로 사용할 0보다 크거나 같은 양수
<endIndex>	예	정수	끝 위치 또는 인덱스 값으로 사용할 0보다 크거나 같은 양수

반환 값	Type	설명
<subarray-result>	배열	원본 문자열의 지정한 인덱스 위치에서 시작하는 지정한 수의 항목을 포함하는 하위 배열

예제

이 예제에서는 지정된 배열에서 하위 배열을 만듭니다.

subArray(createArray('H','e','l','l','o'), 2, 5)

그리고 결과 ["l", "l", "o"]를 반환합니다.

substring

지정된 위치 또는 인덱스에서 시작하여 문자열에서 문자를 반환합니다. 인덱스 값은 숫자 0으로 시작합니다.

substring('<text>', <startIndex>, <length>)

매개 변수	필수	Type	설명
<text>	예	string	하위 문자열을 만들 문자열입니다.
<startIndex>	예	정수	시작 위치 또는 인덱스 값으로 사용할 0보다 크거나 같은 양수
<length>	예	정수	부분 문자열의 양수 문자 하위 배열

반환 값	Type	설명
<substring-result>	string	원본 문자열의 지정한 인덱스 위치에서 시작하는 지정한 수의 문자를 포함하는 하위 문자열

예제

이 예제는 인덱스 값 6에서 시작하여 지정한 문자열에서 문자 하위 문자열 5개를 만듭니다.

substring('hello world', 6, 5)

그리고 결과 세계를 반환합니다.

subtractFromTime

선택적 로캘 형식으로 타임스탬프에서 여러 시간 단위를 뺍니다. getPastTime()도 참조하세요.

subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?, '<locale>'?)

매개 변수	필수	Type	설명
<timestamp>	예	string	타임스탬프를 포함하는 문자열
<interval>	예	정수	뺄 지정한 시간 단위 수
<timeUnit>	예	string	간격에 사용할 시간 단위입니다. 가능한 단위는 "Second", "Minute", "Hour", "Day", "Week", "Month" 및 "Year"입니다.
<format>	아니요	string	사용자 지정 형식 패턴. 타임스탬프의 기본 형식은 ISO 8601을 준수하는 UTC ISO 형식인 YYYY-MM-DDTHH:mm:ss.fffZ입니다.
<로캘>	아니요	string	문화권 정보의 선택적 로캘

반환 값	Type	설명
<updated-timestamp>	string	타임스탬프 - 지정한 시간 단위 수

예제 1

이 예제에서는 다음 타임스탬프에서 1일을 뺍니다.

subtractFromTime('2018-01-02T00:00.000Z', 1, 'Day')

그리고 결과 2018-01-01T00:00:00.000Z를 반환합니다.

예제 2

이 예제에서는 D 형식을 사용하여 타임스탬프에서 1일을 뺍니다.

subtractFromTime('2018-01-02T00:00.000Z', 1, 'Day', 'D')

그리고 2018년 1월 1일 월요일 결과를 반환합니다.

예 3

이 예제에서는 de-DE 로캘의 타임스탬프에서 1시간을 뺍니다.

subtractFromTime('2018-03-15T13:00:00.000Z', 1, 'Hour', '', 'de-DE')

그리고 결과 15.03.18 12:00:00을 반환합니다.

sum

목록에 숫자를 추가하여 결과를 반환합니다.

sum([<list of numbers>])

매개 변수	필수	Type	설명
[<list of numbers>]	예	숫자의 배열	더할 값

반환 값	Type	설명
<result-sum>	number	지정한 숫자들을 더한 결과

예제

이 예제는 지정한 숫자들을 더합니다.

sum(createArray(1, 1.5))

그리고 결과 2.5를 반환합니다.

take

컬렉션 앞에서 항목을 반환합니다.

take('<collection>', <count>)
take([<collection>], <count>)

매개 변수	필수	Type	설명
<컬렉션>	예	문자열 또는 배열	해당 항목을 원하는 컬렉션
<count>	예	정수	앞에서 원하는 항목 수에 대한 양의 정수입니다.

반환 값	Type	설명
<subset> 또는 [<subset>]	각각 문자열 또는 배열	원본 컬렉션의 앞에서 가져온 지정한 수의 항목을 포함하는 문자열 또는 배열

예제

아래 예제는 이 컬렉션의 앞에서 지정한 수의 항목을 가져옵니다.

take('abcde', 3)
take(createArray(0, 1, 2, 3, 4), 3)

다음과 같은 결과를 각각 반환합니다.

• abc
• [0, 1, 2]

ticks

지정된 타임스탬프의 틱 속성 값을 반환합니다. 틱은 100나노초 간격입니다.

ticks('<timestamp>')

매개 변수	필수	Type	설명
<timestamp>	예	string	타임스탬프에 대한 문자열

반환 값	Type	설명
<ticks-number>	정수(JavaScript의 bigint)	지정한 타임스탬프 이후 틱 수

예제

다음은 타임스탬프를 틱 속성으로 변환하는 예제입니다.

ticks('2018-01-01T08:00:00.000Z')

그리고 결과 636503904000000000 반환합니다.

ticksToDays

틱 속성 값을 일 수로 변환합니다.

ticksToDays('ticks')

매개 변수	필수	Type	설명
<ticks>	예	정수	변환할 ticks 속성 값입니다.

반환 값	Type	설명
<일 수>	number	틱 속성 값에서 변환된 일 수입니다.

예제

다음은 틱 속성 값을 일 수로 변환하는 예제입니다.

ticksToDays(2193385800000000)

그리고 숫자 2538.64097222를 반환합니다.

ticksToHours

틱 속성 값을 시간 수로 변환합니다.

ticksToHours('ticks')

매개 변수	필수	Type	설명
<ticks>	예	정수	변환할 ticks 속성 값입니다.

반환 값	Type	설명
<시간 수>	number	틱 속성 값에서 변환된 시간 수

예제

다음은 틱 속성 값을 몇 시간 단위로 변환하는 예제입니다.

ticksToHours(2193385800000000)

그리고 숫자 60927.383333333331을 반환합니다.

ticksToMinutes

틱 속성 값을 분 수로 변환합니다.

ticksToMinutes('ticks')

매개 변수	필수	Type	설명
<ticks>	예	정수	변환할 ticks 속성 값입니다.

반환 값	Type	설명
<분 수>	number	틱 속성 값에서 변환된 시간(분)

예제

다음은 틱 속성 값을 분 단위로 변환하는 예제입니다.

ticksToMinutes(2193385800000000)

그리고 숫자 3655643.0185를 반환합니다.

titleCase

각 단어의 첫 글자를 선택적 로컬 형식으로 문자열로 대문자로 표시합니다.

titleCase('<text>', '<locale>'?)

매개 변수	필수	Type	설명
<text>	예	string	원래 문자열
<로캘>	아니요	string	문화권 정보의 선택적 로캘

반환 값	Type	설명
결과 문자열	string	타이틀 사례 결과

예제 1

다음 예제에서는 문자열에서 각 단어의 첫 글자를 대문자로 표시합니다.

titleCase('a')
titleCase('abc def')
titleCase('aBC dEF')

다음과 같은 결과를 각각 반환합니다.

• A
• Abc Def
• Abc Def

예제 2

다음 예제에서는 첫 번째 문자를 en-US 형식의 문자열로 대문자로 표시합니다.

titleCase('a', 'en-US')
titleCase('aBC dEF', 'en-US')

다음과 같은 결과를 각각 반환합니다.

• A
• Abc Def

toLower

문자열을 선택적 로캘 형식으로 소문자로 반환합니다. 문자열의 문자에 소문자 버전이 없으면 반환된 문자열에 해당 문자가 변경되지 않고 포함됩니다.

toLower('<text>', '<locale>'?)

매개 변수	필수	Type	설명
<text>	예	string	소문자 형식으로 반환할 문자열
<로캘>	아니요	string	문화권 정보의 선택적 로캘

반환 값	Type	설명
<lowercase-text>	string	소문자 형식의 원래 문자열

예제 1

다음은 문자열을 소문자로 변환하는 예제입니다.

toLower('Hello World')

그리고 결과 hello를 반환합니다.

예제 2

다음은 fr-FR 형식으로 문자열을 소문자로 변환하는 예제입니다.

toUpper('Hello World', 'fr-FR')

그리고 결과 hello를 반환합니다.

toUpper

선택적 로캘 형식으로 대문자로 문자열을 반환합니다. 문자열의 문자에 대문자 버전이 없으면 반환된 문자열에 해당 문자가 변경되지 않고 포함됩니다.

toUpper('<text>', '<locale>'?)

매개 변수	필수	Type	설명
<text>	예	string	대문자 형식으로 반환할 문자열
<로캘>	아니요	string	문화권 정보의 선택적 로캘

반환 값	Type	설명
<uppercase-text>	string	대문자 형식의 원래 문자열

예제 1

다음은 문자열을 대문자로 변환하는 예제입니다.

toUpper('Hello World')

그리고 결과 HELLO WORLD를 반환합니다.

예제 2

다음은 fr-FR 형식으로 문자열을 대문자로 변환하는 예제입니다.

toUpper('Hello World', 'fr-FR')

그리고 결과 HELLO WORLD를 반환합니다.

trim

문자열에서 선행 및 후행 공백을 제거하고 업데이트된 문자열을 반환합니다.

trim('<text>')

매개 변수	필수	Type	설명
<text>	예	string	제거할 선행 및 후행 공백이 있는 문자열

반환 값	Type	설명
<updatedText>	string	선행 또는 후행 공백이 없는 원래 문자열에 대한 업데이트된 버전

예제

이 예제에서는 문자열 " 헬로 월드 "에서 선행 및 후행 공백을 제거합니다.

trim(' Hello World  ')

그리고 트리밍된 결과 Hellow World를 반환합니다.

union

지정한 컬렉션에서 모든 항목이 있는 컬렉션을 반환합니다. 결과에 나타내기 위해 항목이 이 함수에 전달된 모든 컬렉션에 나타날 수 있습니다. 같은 이름을 가진 항목이 한 개 이상이면 해당 이름의 마지막 항목이 결과에 나타납니다.

union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)

매개 변수	필수	Type	설명
<collection1>, <collection2>, ...	예	배열 또는 개체, 그러나 둘 다는 아님	모든 항목을 원하는 컬렉션

반환 값	Type	설명
<updatedCollection>	각각 배열 또는 개체	지정된 컬렉션의 모든 항목이 있는 컬렉션입니다. 중복 항목이 추가되지 않았습니다.

예제

이 예제에서는 다음 컬렉션에서 모든 항목을 가져옵니다.

union(createArray(1, 2, 3), createArray(1, 2, 10, 101))

그리고 결과 [1, 2, 3, 10, 101]을 반환합니다.

unique

배열에서 모든 중복 항목을 제거합니다.

unique([<collection>])

매개 변수	필수	Type	설명
<컬렉션>	예	배열	수정할 컬렉션

반환 값	Type	설명
<new-collection>	배열	중복 요소가 제거된 새 컬렉션

예제 1

이 예제에서는 다음 배열에서 중복 요소를 제거합니다.

unique(createArray(1, 2, 1))

그리고 결과 [1, 2]를 반환합니다.

uriComponent

URI(Uniform Resource Identifier) 구성 요소의 이진 버전을 반환합니다.

uriComponent('<value>')

매개 변수	필수	Type	설명
<value>	예	string	URI 인코딩된 형식으로 변환할 문자열

반환 값	Type	설명
<encoded-uri>	string	이스케이프 문자로 URI 인코딩된 문자열

예제

이 예제에서는 URI로 인코딩된 문자열 버전을 만듭니다.

uriComponent('https://contoso.com')

그리고 결과 http%3A%2F%2Fcontoso.com 반환합니다.

uriComponentToString

URI(Uniform Resource Identifier) 인코딩된 문자열의 문자열 버전을 반환하여 URI로 인코딩된 문자열을 효과적으로 디코딩합니다.

uriComponentToString('<value>')

매개 변수	필수	Type	설명
<value>	예	string	디코딩할 URI 인코딩된 문자열

반환 값	Type	설명
<binary-for-encoded-uri>	string	URI 인코딩된 문자열에 대한 디코딩된 버전

예제

이 예제에서는 URI로 인코딩된 문자열의 디코딩된 문자열 버전을 만듭니다.

uriComponentToString('http%3A%2F%2Fcontoso.com')

그리고 결과를 https://contoso.com반환합니다.

uriHost

URI(Uniform Resource Identifier)의 호스트 값을 반환합니다.

uriHost('<uri>')

매개 변수	필수	Type	설명
<uri>	예	string	호스트 값을 원하는 URI

반환 값	Type	설명
<host-value>	string	지정된 URI의 호스트 값입니다.

예제

다음 예제에서는 다음 URI의 호스트 값을 찾습니다.

uriHost('https://www.localhost.com:8080')

그리고 결과를 www.localhost.com반환합니다.

uriPath

URI(통합 리소스 식별자)의 경로 값을 반환합니다.

uriPath('<uri>')

매개 변수	필수	Type	설명
<uri>	예	string	경로 값이 원하는 URI

반환 값	Type	설명
<path-value>	string	지정된 URI의 경로 값입니다.

예제

이 예제에서는 다음 URI의 경로 값을 찾습니다.

uriPath('http://www.contoso.com/catalog/shownew.htm?date=today')

그리고 결과 /catalog/shownew.htm 반환합니다.

uriPathAndQuery

URI(통합 리소스 식별자)의 경로 및 쿼리 값을 반환합니다.

uriPathAndQuery('<uri>')

매개 변수	필수	Type	설명
<uri>	예	string	경로 및 쿼리 값을 원하는 URI

반환 값	Type	설명
<path-query-value>	string	지정된 URI의 경로 및 쿼리 값

예제

이 예제에서는 다음 URI의 경로 및 쿼리 값을 찾습니다.

uriPathAndQuery('http://www.contoso.com/catalog/shownew.htm?date=today')

그리고 결과 /catalog/shownew.htm?date=today를 반환합니다.

uriPort

URI(통합 리소스 식별자)의 포트 값을 반환합니다.

uriPort('<uri>')

매개 변수	필수	Type	설명
<uri>	예	string	경로 값이 원하는 URI

반환 값	Type	설명
<port-value>	string	지정된 URI의 포트 값입니다.

예제

다음 예제에서는 다음 URI의 포트 값을 찾습니다.

uriPort('http://www.localhost:8080')

그리고 결과 8080을 반환합니다.

uriQuery

URI(통합 리소스 식별자)의 쿼리 값을 반환합니다.

uriQuery('<uri>')

매개 변수	필수	Type	설명
<uri>	예	string	쿼리 값을 원하는 URI

반환 값	Type	설명
<query-value>	string	지정된 URI의 쿼리 값

예제

이 예제에서는 다음 URI의 쿼리 값을 찾습니다.

uriQuery('http://www.contoso.com/catalog/shownew.htm?date=today')

그리고 오늘 ?date=결과를 반환합니다.

uriScheme

URI(Uniform Resource Identifier)의 체계 값을 반환합니다.

uriScheme('<uri>')

매개 변수	필수	Type	설명
<uri>	예	string	쿼리 값을 원하는 URI

반환 값	Type	설명
<scheme-value>	string	지정된 URI의 체계 값

예제

다음 예제에서는 다음 URI의 체계 값을 찾습니다.

uriQuery('http://www.contoso.com/catalog/shownew.htm?date=today')

그리고 결과 http를 반환합니다.

utcNow

현재 타임스탬프를 선택적 로캘 형식으로 문자열로 반환합니다.

utcNow('<format>', '<locale>'?)

선택적으로 <format> 매개 변수를 사용하여 다른 형식을 지정할 수 있습니다.

매개 변수	필수	Type	설명
<format>	아니요	string	사용자 지정 형식 패턴. 타임스탬프의 기본 형식은 ISO 8601을 준수하는 UTC ISO 형식인 YYYY-MM-DDTHH:mm:ss.fffZ입니다.
<로캘>	아니요	string	문화권 정보의 선택적 로캘

반환 값	Type	설명
<current-timestamp>	string	현재 날짜 및 시간

예제 1

날짜가 April 15, 2018, 1:00:00 PM이라고 가정하겠습니다. 이 예제에서는 타임스탬프를 가져옵니다.

utcNow()

그리고 결과 2018-04-15T13:00:00.000Z를 반환합니다.

예제 2

날짜가 April 15, 2018, 1:00:00 PM이라고 가정하겠습니다. 다음 예제에서는 선택적 D 형식을 사용하여 현재 타임스탬프를 가져옵니다.

utcNow('D')

그리고 2018년 4월 15일 일요일 결과를 반환합니다.

예 3

날짜가 April 15, 2018, 1:00:00 PM이라고 가정하겠습니다. 이 예제에서는 de-DE 로캘을 사용하여 현재 타임스탬프를 가져옵니다.

utcNow('', 'de-DE')

그리고 결과 15.04.18 13:00:00을 반환합니다.

라는 설치 관리자 실행 파일에 포함됩니다. 여기서

각 요소에 대해 필터링하고 특정 조건과 일치하는 필터링된 요소의 새 컬렉션을 반환합니다.

where([<collection/instance>], <iteratorName>, <function>)

매개 변수	필수	Type	설명
<collection/instance>	예	배열	항목이 있는 컬렉션
<iteratorName>	예	반복기 이름	키 항목
<function>	예	식	항목을 필터링하는 데 사용되는 조건 함수

반환 값	Type	설명
<new-collection/new-object>	array/object	각 요소가 함수를 사용하여 필터링되는 새 컬렉션

예제 1

다음 예제에서는 새 컬렉션을 생성합니다.

where(createArray(0, 1, 2, 3), x, x > 1)

그리고 결과 [2, 3]을 반환합니다.

예제 2

다음 예제에서는 새 컬렉션을 생성합니다.

where(json("{'name': 'jack', 'age': '15'}"), x, x.value == 'jack')
where(json("{'name': 'jack', 'age': '15'}"), x=> x.value == 'jack')

그리고 결과 ['name:jack', 'age:15']를 반환합니다. 두 번째 식은 더 읽기 쉬운 람다 식입니다.

xml

JSON 개체를 포함하는 문자열의 XML 버전을 반환합니다.

xml('<value>')

매개 변수	필수	Type	설명
<value>	예	string	변환할 JSON 개체가 있는 문자열입니다. JSON 개체는 배열일 수 없는 루트 속성 한 개만 가져야 합니다. 큰따옴표(")에 이스케이프 문자로 사용합니다 \ .

반환 값	Type	설명
<xml-version>	개체	지정한 문자열 또는 JSON 개체에 대한 인코딩된 XML

예제 1

이 예제에서는 JSON 개체를 포함하는 문자열에 대한 XML 버전을 만듭니다.

xml(json('{ \"name\": \"Sophia Owen\" }'))

그리고 결과 XML을 반환합니다.

<name>Sophia Owen</name>

예제 2

아래와 같은 person JSON 개체가 있다고 가정하겠습니다.

{
  "person": {
    "name": "Sophia Owen",
    "city": "Seattle"
  }
}

이 예제에서는 이 JSON 개체를 포함하는 문자열의 XML을 만듭니다.

xml(json('{\"person\": {\"name\": \"Sophia Owen\", \"city\": \"Seattle\"}}'))

그리고 결과 XML을 반환합니다.

<person>
  <name>Sophia Owen</name>
  <city>Seattle</city>
<person

xPath

XPath(XML 경로 언어) 식과 일치하는 노드 또는 값에 대한 XML을 확인하고 일치하는 노드 또는 값을 반환합니다. XPath 식(XPath라고 함)을 사용하면 XML 콘텐츠에서 노드 또는 컴퓨팅 값을 선택할 수 있도록 XML 문서 구조를 탐색할 수 있습니다.

xPath('<xml>', '<xpath>')

매개 변수	필수	Type	설명
<xml>	예	any	XPath 식 값과 일치하는 노드 또는 값을 검색하기 위한 XML 문자열
<xPath>	예	any	일치하는 XML 노드 또는 값을 찾는 데 사용한 XPath 식

반환 값	Type	설명
<xml-node>	XML	단일 노드만이 지정한 XPath 식과 일치하는 경우 XML 노드
<value>	any	단일 값만이 지정한 XPath 식과 일치하는 경우 XML 노드의 값
<[<xml-node1>, <xml-node2>, ...] -or- [<value1>, <value2>, ...]>	배열	지정한 XPath 식과 일치하는 XML 노드 또는 값을 가진 배열

예제 1

이 예제는 지정한 인수의 <name></name> 노드와 일치하는 노드를 찾고 해당 노드 값을 가진 배열을 반환합니다.

xPath(items, '/produce/item/name')

인수에는 다음 XML을 포함하는 항목 문자열이 포함됩니다.

"<?xml version="1.0"?> <produce> <item> <name>Gala</name> <type>apple</type> <count>20</count> </item> <item> <name>Honeycrisp</name> <type>apple</type> <count>10</count> </item> </produce>"

일치하는 노드가 있는 결과 배열은 다음과 같습니다.<name></name>

[ <name>Gala</name>, <name>Honeycrisp</name> ]

예제 2

예제 1 다음에 이 예제는 <count></count> 노드와 일치하는 노드를 찾고 sum() 함수를 사용하여 해당 노드 값을 더합니다.

xPath(xml(parameters('items')), 'sum(/produce/item/count)')

그리고 결과 30을 반환합니다.

연도

지정된 타임스탬프의 연도를 반환합니다.

year('<timestamp>')

매개 변수	필수	Type	설명
<timestamp>	예	string	타임스탬프를 포함하는 문자열

반환 값	Type	설명
<year>	정수	지정된 타임스탬프의 연도

예제

이 예제에서는 연도의 타임스탬프를 평가합니다.

year('2018-03-15T00:00:00.000Z')

그리고 2018년 결과를 반환합니다.