Microsoft Fabric의 Data Factory에 대한 식 및 함수

  • 아티클

이 문서에서는 Microsoft Fabric의 Data Factory에서 지원하는 식 및 함수에 대해 자세히 설명합니다.

식

정의의 식 값은 런타임에 평가되는 리터럴 또는 식일 수 있습니다. 예시:

"value"

또는

"@pipeline().parameters.password"

식은 문자열 값의 아무 곳에나 표시될 수 있으며 항상 다른 문자열 값이 생성됩니다. 값이 식이면 at-sign(@)을 제거하여 식 본문을 추출합니다. @로 시작되는 리터럴 문자열이 필요한 경우 해당 문자열은 @@를 사용하여 이스케이프 처리해야 합니다. 다음 예제는 식의 작동 방식을 보여 줍니다.

식 값 결과
"parameters" 문자 'parameters'가 반환됩니다.
"parameters[1]" 'parameters[1]' 문자가 반환됩니다.
"@@" \'\@\'를 포함하는 1개 문자열이 반환됩니다.
" @" '@'가 포함된 2자 문자열이 반환됩니다.

식이 래핑되는 문자열 보간이라는 기능을 사용하여 문자열 내부에도 식이 나타날 수 있습니다@{ ... }. 예: "First Name: @{pipeline().parameters.firstName} Last Name: @{pipeline().parameters.lastName}"

문자열 보간을 사용하면 결과는 항상 문자열입니다. myNumber를 42로 정의하고 myString을 foo로 정의했다고 가정합니다.

식 값 결과
“@pipeline().parameters.myString” 문자열로 반환합니다 foo .
"@{pipeline().parameters.myString}" 문자열로 반환합니다 foo .
“@pipeline().parameters.myNumber” 42를 숫자로 반환합니다.
"@{pipeline().parameters.myNumber}" 42를 문자열로 반환합니다.
"대답: @{pipeline().parameters.myNumber}" Answer is: 42 문자열을 반환합니다.
“@concat(‘Answer is: ’, string(pipeline().parameters.myNumber))” Answer is: 42 문자열을 반환합니다.
"Answer is: @@{pipeline().parameters.myNumber}" Answer is: @{pipeline().parameters.myNumber} 문자열을 반환합니다.

ForEach 작업과 같은 제어 흐름 작업에서 속성 항목에 대해 반복할 배열을 제공하고 @item()을 사용하여 ForEach 작업의 단일 열거를 반복할 수 있습니다. 예를 들어 항목이 배열인 경우 [1, 2, 3]은 첫 번째 반복에서 1, @item() 두 번째 반복에서는 2, 세 번째 반복에서는 3을 반환합니다. 식과 같이 9로 끝나는 0부터 10번 반복할 수도 @range(0,10) 있습니다.

@activity(‘작업 이름’)를 사용하여 작업의 출력을 캡처하고 결정을 내릴 수 있습니다. Web1이라는 웹 활동을 고려합니다. 첫 번째 작업의 출력을 두 번째 작업의 본문에 배치하는 경우 식은 일반적으로 다음과 같습니다. @activity(‘Web1’).output 또는 @activity(‘Web1’).output.data 또는 첫 번째 작업의 출력에 따라 유사하게 표시됩니다.

예제

복합 식 예제

아래 예제에서는 활동 출력의 딥 하위 필드를 참조하는 복잡한 예제를 보여 줍니다. 하위 필드로 계산되는 파이프라인 매개 변수를 참조하려면 작업 출력의 일부로 dot(.) 연산자(subfield1 및 subfield2의 경우와 같이) 대신 [] 구문을 사용합니다.

@activity('*activityName*').output.*subfield1*.*subfield2*[pipeline().parameters.*subfield3*].*subfield4*

파일을 동적으로 만들고 이름을 지정하는 것이 일반적인 패턴입니다. 몇 가지 동적 파일 명명 예제를 살펴보겠습니다.

  • 파일 이름에 날짜 추가: @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))
  • 고객 시간대에 DateTime 추가: @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))
  • 트리거 시간 추가: @concat('Test_', pipeline().TriggerTime)
  • 날짜가 있는 단일 파일에 출력할 때 매핑 데이터 흐름에서 사용자 지정 파일 이름을 출력합니다. 'Test_' + toString(currentDate()) + '.csv'

위의 경우 Test_ 시작하는 4개의 동적 파일 이름이 만들어집니다.

동적 콘텐츠 편집기

동적 콘텐츠 편집기에서는 편집을 마치면 콘텐츠의 문자를 자동으로 이스케이프합니다. 예를 들어 콘텐츠 편집기에서 다음 콘텐츠는 식 함수를 사용한 문자열 보간입니다.

"@{toUpper('myData')}"

동적 콘텐츠 편집기는 위의 콘텐츠를 식 "@{toUpper('myData')}"으로 변환합니다. 이 식의 결과는 아래에 표시된 형식이 지정된 문자열입니다.

"MYDATA"

특수 문자 바꾸기

동적 콘텐츠 편집기에서는 편집을 마치면 콘텐츠의 큰따옴표, 백슬래시 등의 문자를 자동으로 이스케이프합니다. 이렇게 하면 \n, \t in replace() 함수를 사용하여 줄 바꿈 또는 탭을 바꾸려면 문제가 발생합니다. 코드 보기에서 동적 콘텐츠를 편집하여 식에서 추가 \를 제거하거나 아래 단계에 따라 식 언어를 사용하여 특수 문자를 바꿀 수 있습니다.

  1. 원래 문자열 값에 대한 URL 인코딩
  2. 줄 바꿈(%0A), 캐리지 리턴(%0D), 가로 탭(%09)과 같이 URL로 인코딩된 문자열을 바꿉니다.
  3. URL 디코딩

예를 들어 값에 줄 바꿈 문자가 있는 variable companyName 은 줄 @uriComponentToString(replace(uriComponent(variables('companyName')), '%0A', '')) 바꿈 문자를 제거할 수 있습니다.

Contoso- Corporation

작은 따옴표 문자 이스케이프

식 함수는 문자열 값 매개 변수에 작은 따옴표를 사용합니다. 두 개의 작은 따옴표를 사용하여 문자열 함수에서 ' 문자를 이스케이프합니다. 예를 들어 식 @concat('Baba', '''s ', 'book store') 은 아래 결과를 반환합니다.

Baba's book store

파이프라인 범위 변수

이러한 시스템 변수는 파이프라인의 어디에서나 참조할 수 있습니다.

변수 이름 설명
@pipeline().DataFactory 파이프라인 실행이 진행 중인 데이터 또는 Synapse 작업 영역의 이름
@pipeline().Pipeline 파이프라인 이름입니다.
@pipeline().RunId 특정 파이프라인의 실행 ID
@pipeline().TriggerId 파이프라인을 호출한 트리거 ID
@pipeline().TriggerName 파이프라인을 호출한 트리거의 이름
@pipeline().TriggerTime 파이프라인을 호출한 트리거 실행 시간입니다. 파이프라인 실행을 호출하기 위해 트리거 가 실제로 발생한 시간이며 트리거의 예약된 시간과 약간 다를 수 있습니다.
@pipeline().GroupId 파이프라인 실행이 속한 그룹의 ID입니다.
@pipeline()?.TriggeredByPipelineName 파이프라인 실행을 트리거하는 파이프라인의 이름입니다. 파이프라인 실행이 ExecutePipeline 활동에 의해 트리거되는 경우에 적용됩니다. 다른 상황에서 사용할 경우 Null로 평가합니다. @pipeline() 뒤에 물음표가 있습니다.
@pipeline()?.TriggeredByPipelineRunId 파이프라인 실행을 트리거하는 파이프라인의 실행 ID입니다. 파이프라인 실행이 ExecutePipeline 활동에 의해 트리거되는 경우에 적용됩니다. 다른 상황에서 사용할 경우 Null로 평가합니다. @pipeline() 뒤에 물음표가 있습니다.

참고 항목

트리거 관련 날짜/시간 시스템 변수(파이프라인 및 트리거 범위 모두)는 예를 들어 2017-06-01T22:20:00.4061448ZISO 8601 형식으로 UTC 날짜를 반환합니다.

함수

식 내에서 함수를 호출할 수 있습니다. 다음 섹션에서는 식에 사용할 수 있는 함수에 대한 정보를 제공합니다.

날짜 함수

날짜 또는 시간 함수 작업
addDays 타임스탬프에 일 수를 추가합니다.
addHours 타임스탬프에 시간을 추가합니다.
addMinutes 타임스탬프에 분 수를 추가합니다.
addSeconds 타임스탬프에 초 수를 추가합니다.
addToTime 타임스탬프에 여러 시간 단위를 추가합니다. getFutureTime도 참조하세요.
convertFromUtc 타임스탬프를 UTC(Universal Time Coordinated)에서 대상 표준 시간대로 변환합니다.
convertTimeZone 원본 표준 시간대에서 대상 표준 시간대로 타임스탬프를 변환합니다.
convertToUtc 원본 표준 시간대의 타임스탬프를 UTC(Universal Time Coordinated)로 변환합니다.
dayOfMonth 타임스탬프에서 월 구성 요소의 일을 반환합니다.
Dayofweek 타임스탬프에서 요일 구성 요소를 반환합니다.
dayOfYear 타임스탬프에서 연도 구성 요소의 일을 반환합니다.
formatDateTime 타임스탬프를 선택적 형식의 문자열로 반환합니다.
getFutureTime 현재 타임스탬프와 지정된 시간 단위를 반환합니다. addToTime도 참조합니다.
getPastTime 현재 타임스탬프에서 지정된 시간 단위를 뺀 값을 반환합니다. subtractFromTime도 참조합니다.
startOfDay 타임스탬프에 대한 하루의 시작을 반환합니다.
startOfHour 타임스탬프의 시간 시작을 반환합니다.
startOfMonth 타임스탬프에 대한 월의 시작을 반환합니다.
subtractFromTime 타임스탬프에서 여러 시간 단위를 뺍니다. getPastTime도 함께 참조하세요.
ticks ticks 지정된 타임스탬프의 속성 값을 반환합니다.
utcNow 현재 타임스탬프를 문자열로 반환합니다.

문자열 함수

문자열을 사용하려면 이러한 문자열 함수와 일부 컬렉션 함수를 사용할 수 있습니다. 문자열 함수는 문자열에서만 작동합니다.

string 함수 작업
concat 둘 이상의 문자열을 결합하고 결합된 문자열을 반환합니다.
Endswith 문자열이 지정된 부분 문자열로 끝나는지 확인합니다.
guid GUID(Globally Unique Identifier)를 문자열로 생성합니다.
Indexof 부분 문자열의 시작 위치를 반환합니다.
Lastindexof 부분 문자열의 마지막 발생에 대한 시작 위치를 반환합니다.
replace 부분 문자열을 지정된 문자열로 바꾸고 업데이트된 문자열을 반환합니다.
split 원래 문자열의 지정된 구분 기호 문자를 기반으로 더 큰 문자열에서 쉼표로 구분된 부분 문자열이 포함된 배열을 반환합니다.
startsWith 문자열이 특정 부분 문자열로 시작하는지 확인합니다.
부분 지정된 위치에서 시작하여 문자열에서 문자를 반환합니다.
toLower 문자열을 소문자 형식으로 반환합니다.
Toupper 문자열을 대문자 형식으로 반환합니다.
트림 문자열에서 선행 및 후행 공백을 제거하고 업데이트된 문자열을 반환합니다.

컬렉션 기능

컬렉션, 일반적으로 배열, 문자열 및 경우에 따라 사전을 사용하려면 이러한 컬렉션 함수를 사용할 수 있습니다.

컬렉션 함수 작업
contains 컬렉션에 특정 항목이 있는지 확인합니다.
empty 컬렉션이 비어 있는지 확인합니다.
first 컬렉션에서 첫 번째 항목을 반환합니다.
교차로 지정된 컬렉션에서 공통 항목만 있는 컬렉션을 반환합니다.
join 배열의 모든 항목이 지정된 문자로 구분된 문자열을 반환합니다.
last 컬렉션에서 마지막 항목을 반환합니다.
length 문자열 또는 배열의 항목 수를 반환합니다.
건너뛸 컬렉션의 앞부분에 있는 항목을 제거하고 다른 모든 항목을 반환합니다.
take 컬렉션 앞부분에 있는 항목을 반환합니다.
union 지정한 컬렉션에서 모든 항목이 있는 컬렉션을 반환합니다.

논리 함수

이러한 함수는 조건 내에서 유용하며 모든 유형의 논리를 평가하는 데 사용할 수 있습니다.

논리 비교 함수 작업
and 모든 식이 true인지 확인합니다.
equals 두 값이 동일한지 확인합니다.
greater 첫 번째 값이 두 번째 값보다 큰지 검사합니다.
greaterOrEquals 첫 번째 값이 두 번째 값보다 크거나 같은지 확인합니다.
if 식이 true인지 또는 false인지 검사합니다. 결과에 따라 지정된 값을 반환합니다.
less 첫 번째 값이 두 번째 값보다 작은지 확인합니다.
lessOrEquals 첫 번째 값이 두 번째 값보다 작거나 같은지 검사합니다.
not 식이 false인지 검사합니다.
or 하나 이상의 식이 true인지 확인합니다.

변환 함수

이러한 함수는 언어의 각 네이티브 형식 간에 변환하는 데 사용됩니다.

  • string
  • 정수
  • float
  • 부울 값
  • 배열
  • dictionaries
변환 함수 작업
array 지정된 단일 입력에서 배열을 반환합니다. 여러 입력은 createArray를 참조 하세요.
base64 문자열에 대한 base64로 인코딩된 버전을 반환합니다.
base64ToBinary base64로 인코딩된 문자열의 이진 버전을 반환합니다.
base64ToString base64로 인코딩된 문자열의 문자열 버전을 반환합니다.
binary 입력 값에 대한 이진 버전을 반환합니다.
부울 입력 값에 대한 부울 버전을 반환합니다.
합체 하나 이상의 매개 변수에서 Null이 아닌 첫 번째 값을 반환합니다.
createArray 여러 입력에서 배열을 반환합니다.
dataUri 입력 값에 대한 데이터 URI를 반환합니다.
dataUriToBinary 데이터 URI에 대한 이진 버전을 반환합니다.
dataUriToString 데이터 URI에 대한 문자열 버전을 반환합니다.
decodeBase64 base64로 인코딩된 문자열의 문자열 버전을 반환합니다.
decodeDataUri 데이터 URI에 대한 이진 버전을 반환합니다.
decodeUriComponent 이스케이프 문자를 디코딩된 버전으로 바꾸는 문자열을 반환합니다.
encodeUriComponent URL 안전하지 않은 문자를 이스케이프 문자로 대체하는 문자열을 반환합니다.
float 입력 값에 대해 부동 소수점 숫자를 반환합니다.
int 문자열에 대한 정수 버전을 반환합니다.
string 입력 값에 대한 문자열 버전을 반환합니다.
uriComponent URL 안전하지 않은 문자를 이스케이프 문자로 바꿔 입력 값에 대해 URI로 인코딩된 버전을 반환합니다.
uriComponentToBinary URI로 인코딩된 문자열에 대한 이진 버전을 반환합니다.
uriComponentToString URI로 인코딩된 문자열에 대한 문자열 버전을 반환합니다.
xml 문자열의 XML 버전을 반환합니다.
xpath XPath(XML 경로 언어) 식과 일치하는 노드 또는 값에 대해 XML을 확인하고 일치하는 노드 또는 값을 반환합니다.

수식 함수

이러한 함수는 숫자 형식(정수 및 부동 소수점)에 사용할 수 있습니다.

수학 함수 작업
add 두 숫자를 추가하여 결과를 반환합니다.
div 두 숫자를 나눈 결과를 반환합니다.
max 숫자 집합 또는 배열에서 가장 높은 값을 반환합니다.
min 숫자 또는 배열 집합에서 가장 낮은 값을 반환합니다.
모드 두 숫자를 나눈 나머지를 반환합니다.
mul 두 숫자를 곱한 제품을 반환합니다.
rand 지정된 범위에서 임의의 정수를 반환합니다.
range 지정한 정수에서 시작하는 정수 배열을 반환합니다.
sub 첫 번째 숫자에서 두 번째 숫자를 빼서 결과를 반환합니다.

함수 참조

이 섹션에서는 사용 가능한 모든 함수를 사전순으로 나열합니다.

추가

두 숫자를 추가하여 결과를 반환합니다.

add(<summand_1>, <summand_2>)
매개 변수 필수 Type 설명
<summand_1>, <summand_2> 예 정수, 부동 소수점 또는 혼합 더할 값
반환 값 Type 설명
<result-sum> 정수 또는 부동 소수점 지정된 숫자를 추가한 결과입니다.

예제

다음은 지정된 숫자를 추가하는 예제입니다.

add(1, 1.5)

다음 결과를 반환합니다. 2.5

addDays

타임스탬프에 일 수를 추가합니다.

addDays('<timestamp>', <days>, '<format>'?)
매개 변수 필수 Type 설명
<timestamp> 예 문자열 타임스탬프를 포함하는 문자열입니다.
<일> 예 정수 추가할 양의 일 수 또는 음수입니다.
<format> 아니요 문자열 단일 형식 지정자 또는 사용자 지정 형식 패턴입니다. 타임스탬프의 기본 형식은 "o"(yyyy-MM-ddTHH:mm:ss.fffffffK)입니다. 이 형식은 ISO 8601을 준수하며 표준 시간대 정보를 보존합니다.
반환 값 Type 설명
<updated-timestamp> 문자열 타임스탬프와 지정된 일 수

예제 1

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

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

다음 결과를 반환합니다. "2018-03-25T00:00:0000000Z"

예제 2

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

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

다음 결과를 반환합니다. "2018-03-10T00:00:0000000Z"

addHours

타임스탬프에 시간을 추가합니다.

addHours('<timestamp>', <hours>, '<format>'?)
매개 변수 필수 Type 설명
<timestamp> 예 문자열 타임스탬프를 포함하는 문자열입니다.
<시간> 예 정수 추가할 양의 시간 또는 음수입니다.
<format> 아니요 문자열 단일 형식 지정자 또는 사용자 지정 형식 패턴입니다. 타임스탬프의 기본 형식은 "o"(yyyy-MM-ddTHH:mm:ss.fffffffK)입니다. 이 형식은 ISO 8601을 준수하며 표준 시간대 정보를 보존합니다.
반환 값 Type 설명
<updated-timestamp> 문자열 타임스탬프와 지정된 시간 수

예제 1

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

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

다음 결과를 반환합니다. "2018-03-15T10:00:0000000Z"

예제 2

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

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

다음 결과를 반환합니다. "2018-03-15T10:00:0000000Z"

addMinutes

타임스탬프에 분 수를 추가합니다.

addMinutes('<timestamp>', <minutes>, '<format>'?)
매개 변수 필수 Type 설명
<timestamp> 예 문자열 타임스탬프를 포함하는 문자열입니다.
<minutes> 예 정수 추가할 양수 또는 음수(분)
<format> 아니요 문자열 단일 형식 지정자 또는 사용자 지정 형식 패턴입니다. 타임스탬프의 기본 형식은 "o"(yyyy-MM-ddTHH:mm:ss.fffffffK)입니다. 이 형식은 ISO 8601을 준수하며 표준 시간대 정보를 보존합니다.
반환 값 Type 설명
<updated-timestamp> 문자열 타임스탬프 + 지정한 분 수

예제 1

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

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

다음 결과를 반환합니다. "2018-03-15T00:20:00.0000000Z"

예제 2

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

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

다음 결과를 반환합니다. "2018-03-15T00:15:00.0000000Z"

addSeconds

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

addSeconds('<timestamp>', <seconds>, '<format>'?)
매개 변수 필수 Type 설명
<timestamp> 예 문자열 타임스탬프를 포함하는 문자열입니다.
<초> 예 정수 추가할 양수 또는 음수(초)
<format> 아니요 문자열 단일 형식 지정자 또는 사용자 지정 형식 패턴입니다. 타임스탬프의 기본 형식은 "o"(yyyy-MM-ddTHH:mm:ss.fffffffK)입니다. 이 형식은 ISO 8601을 준수하며 표준 시간대 정보를 보존합니다.
반환 값 Type 설명
<updated-timestamp> 문자열 타임스탬프와 지정된 시간(초)입니다.

예제 1

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

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

다음 결과를 반환합니다. "2018-03-15T00:00:10.0000000Z"

예제 2

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

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

다음 결과를 반환합니다. "2018-03-15T00:00:25.0000000Z"

addToTime

타임스탬프에 여러 시간 단위를 추가합니다. getFutureTime()도 함께 참조하세요.

addToTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)
매개 변수 필수 Type 설명
<timestamp> 예 문자열 타임스탬프를 포함하는 문자열입니다.
<interval> 예 정수 추가할 지정된 시간 단위의 수입니다.
<timeUnit> 예 문자열 간격에 사용할 시간 단위: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format> 아니요 문자열 단일 형식 지정자 또는 사용자 지정 형식 패턴입니다. 타임스탬프의 기본 형식은 "o"(yyyy-MM-ddTHH:mm:ss.fffffffK)입니다. 이 형식은 ISO 8601을 준수하며 표준 시간대 정보를 보존합니다.
반환 값 Type 설명
<updated-timestamp> 문자열 타임스탬프 + 지정한 시간 단위 수

예제 1

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

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

다음 결과를 반환합니다. "2018-01-02T00:00:00.0000000Z"

예제 2

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

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

그리고 선택적 "D"를 사용하여 다음 결과를 반환합니다. "Tuesday, January 2, 2018"

및

두 식이 모두 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.

배열

지정된 단일 입력에서 배열을 반환합니다. 여러 입력은 createArray()를 참조하세요.

array('<value>')
매개 변수 필수 Type 설명
<value> 예 문자열 배열을 만들기 위한 문자열입니다.
반환 값 Type 설명
[<value>] 배열 지정된 단일 입력을 포함하는 배열입니다.

예제

이 예제에서는 "hello" 문자열에서 배열을 만듭니다.

array('hello')

다음 결과를 반환합니다. ["hello"]

base64

문자열에 대한 base64로 인코딩된 버전을 반환합니다.

base64('<value>')
매개 변수 필수 Type 설명
<value> 예 문자열 입력 문자열
반환 값 Type 설명
<base64-string> 문자열 입력 문자열에 대한 base64로 인코딩된 버전

예제

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

base64('hello')

다음 결과를 반환합니다. "aGVsbG8="

base64ToBinary

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

base64ToBinary('<value>')
매개 변수 필수 Type 설명
<value> 예 문자열 변환할 base64로 인코딩된 문자열입니다.
반환 값 Type 설명
<binary-for-base64-string> 문자열 base64로 인코딩된 문자열의 이진 버전입니다.

예제

이 예제는 base64로 인코딩된 문자열 "aGVsbG8="을 이진 문자열로 변환합니다.

base64ToBinary('aGVsbG8=')

다음 결과를 반환합니다.

"0110000101000111010101100111001101100010010001110011100000111101"

base64ToString

base64로 인코딩된 문자열에 대한 문자열 버전을 반환하며, 결과적으로 base64 문자열을 디코딩합니다. DecodeBase64()가 아니라 이 함수를 사용합니다. 두 함수가 동일한 방식으로 base64ToString() 작동하지만 선호됩니다.

base64ToString('<value>')
매개 변수 필수 Type 설명
<value> 예 문자열 디코딩할 base64로 인코딩된 문자열입니다.
반환 값 Type 설명
<decoded-base64-string> 문자열 base64로 인코딩된 문자열의 문자열 버전

예제

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

base64ToString('aGVsbG8=')

다음 결과를 반환합니다. "hello"

binary

문자열에 대한 이진 버전을 반환합니다.

binary('<value>')
매개 변수 필수 Type 설명
<value> 예 문자열 변환할 문자열입니다.
반환 값 Type 설명
<binary-for-input-value> 문자열 지정된 문자열의 이진 버전입니다.

예제

다음은 "hello" 문자열을 이진 문자열로 변환하는 예제입니다.

binary('hello')

다음 결과를 반환합니다.

"0110100001100101011011000110110001101111"

부울

값에 대한 부울 버전을 반환합니다.

bool(<value>)
매개 변수 필수 Type 설명
<value> 예 모두 변환할 값입니다.
반환 값 Type 설명
true 또는 false 부울 지정된 값의 부울 버전

예제

다음 예제에서는 지정된 값을 부울 값으로 변환합니다.

bool(1)
bool(0)

다음 결과를 반환합니다.

  • 첫 번째 예제: true
  • 두 번째 예제: false

합체

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

coalesce(<object_1>, <object_2>, ...)
매개 변수 필수 Type 설명
<object_1>, <object_2>, ... 예 모든 형식을 혼합할 수 있습니다. null에 대해 검사 하나 이상의 항목
반환 값 Type 설명
<null이 아닌 첫 번째 항목> 모두 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 설명
<text1>, <text2>, ... 예 문자열 결합할 문자열이 두 개 이상
반환 값 Type 설명
<text1text2...> 문자열 결합된 입력 문자열에서 만든 문자열입니다.

예제

이 예제는 문자열 "Hello"와 "World"를 결합합니다.

concat('Hello', 'World')

다음 결과를 반환합니다. "HelloWorld"

contains

컬렉션에 특정 항목이 있는지 확인합니다. 항목이 발견되면 true를 반환하거나, 찾을 수 없는 경우 false를 반환합니다. 이 함수는 대/소문자를 구분합니다.

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

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

  • 부분 문자열을 찾을 문자열
  • 값을 찾을 배열
  • 키를 찾을 사전
매개 변수 필수 Type 설명
<컬렉션> 예 문자열, 배열 또는 사전 검사할 컬렉션
<value> 예 각각 문자열, 배열 또는 사전 찾을 항목
반환 값 Type 설명
true 또는 false 부울 항목이 발견되면 true를 반환합니다. 찾을 수 없는 경우 false를 반환합니다.

예제 1

이 예제에서는 부분 문자열 "world"에 대한 문자열 "hello world"를 검사 true를 반환합니다.

contains('hello world', 'world')

예제 2

이 예제에서는 부분 문자열 "universe"에 대한 문자열 "hello world"를 검사 false를 반환합니다.

contains('hello world', 'universe')

convertFromUtc

타임스탬프를 UTC(Universal Time Coordinated)에서 대상 표준 시간대로 변환합니다.

convertFromUtc('<timestamp>', '<destinationTimeZone>', '<format>'?)
매개 변수 필수 Type 설명
<timestamp> 예 문자열 타임스탬프를 포함하는 문자열입니다.
<destinationTimeZone> 예 문자열 대상 표준 시간대의 이름입니다. 표준 시간대 이름의 경우 Microsoft 표준 시간대 값을 참조하세요. 다만 표준 시간대 이름에서 모든 문장 부호를 제거해야 할 수도 있습니다.
<format> 아니요 문자열 단일 형식 지정자 또는 사용자 지정 형식 패턴입니다. 타임스탬프의 기본 형식은 "o"(yyyy-MM-ddTHH:mm:ss.fffffffK)입니다. 이 형식은 ISO 8601을 준수하며 표준 시간대 정보를 보존합니다.
반환 값 Type 설명
<converted-timestamp> 문자열 대상 표준 시간대로 변환된 타임스탬프

예제 1

다음은 타임스탬프를 지정된 표준 시간대로 변환하는 예제입니다.

convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time')

다음 결과를 반환합니다. "2018-01-01T00:00:00Z"

예제 2

이 예제에서는 타임스탬프를 지정된 표준 시간대 및 형식으로 변환합니다.

convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time', 'D')

다음 결과를 반환합니다. "Monday, January 1, 2018"

convertTimeZone

원본 표준 시간대에서 대상 표준 시간대로 타임스탬프를 변환합니다.

convertTimeZone('<timestamp>', '<sourceTimeZone>', '<destinationTimeZone>', '<format>'?)
매개 변수 필수 Type 설명
<timestamp> 예 문자열 타임스탬프를 포함하는 문자열입니다.
<sourceTimeZone> 예 문자열 원본 표준 시간대의 이름입니다. 표준 시간대 이름의 경우 Microsoft 표준 시간대 값을 참조하세요. 다만 표준 시간대 이름에서 모든 문장 부호를 제거해야 할 수도 있습니다.
<destinationTimeZone> 예 문자열 대상 표준 시간대의 이름입니다. 표준 시간대 이름의 경우 Microsoft 표준 시간대 값을 참조하세요. 다만 표준 시간대 이름에서 모든 문장 부호를 제거해야 할 수도 있습니다.
<format> 아니요 문자열 단일 형식 지정자 또는 사용자 지정 형식 패턴입니다. 타임스탬프의 기본 형식은 "o"(yyyy-MM-ddTHH:mm:ss.fffffffK)입니다. 이 형식은 ISO 8601을 준수하며 표준 시간대 정보를 보존합니다.
반환 값 Type 설명
<converted-timestamp> 문자열 대상 표준 시간대로 변환된 타임스탬프

예제 1

다음은 원본 표준 시간대를 대상 표준 시간대로 변환하는 예제입니다.

convertTimeZone('2018-01-01T08:00:00.0000000Z', 'UTC', 'Pacific Standard Time')

다음 결과를 반환합니다. "2018-01-01T00:00:00.0000000"

예제 2

다음은 표준 시간대를 지정된 표준 시간대 및 형식으로 변환하는 예제입니다.

convertTimeZone('2018-01-01T08:00:00.0000000Z', 'UTC', 'Pacific Standard Time', 'D')

다음 결과를 반환합니다. "Monday, January 1, 2018"

convertToUtc

원본 표준 시간대의 타임스탬프를 UTC(Universal Time Coordinated)로 변환합니다.

convertToUtc('<timestamp>', '<sourceTimeZone>', '<format>'?)
매개 변수 필수 Type 설명
<timestamp> 예 문자열 타임스탬프를 포함하는 문자열입니다.
<sourceTimeZone> 예 문자열 원본 표준 시간대의 이름입니다. 표준 시간대 이름의 경우 Microsoft 표준 시간대 값을 참조하세요. 다만 표준 시간대 이름에서 모든 문장 부호를 제거해야 할 수도 있습니다.
<format> 아니요 문자열 단일 형식 지정자 또는 사용자 지정 형식 패턴입니다. 타임스탬프의 기본 형식은 "o"(yyyy-MM-ddTHH:mm:ss.fffffffK)입니다. 이 형식은 ISO 8601을 준수하며 표준 시간대 정보를 보존합니다.
반환 값 Type 설명
<converted-timestamp> 문자열 UTC로 변환된 타임스탬프

예제 1

이 예제에서는 타임스탬프를 UTC로 변환합니다.

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

다음 결과를 반환합니다. "2018-01-01T08:00:00.0000000Z"

예제 2

이 예제에서는 타임스탬프를 UTC로 변환합니다.

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

다음 결과를 반환합니다. "Monday, January 1, 2018"

createArray

여러 입력에서 배열을 반환합니다. 단일 입력 배열은 array()를 참조하세요.

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> 예 문자열 변환할 문자열입니다.
반환 값 Type 설명
<data-uri> 문자열 입력 문자열의 데이터 URI

예제

이 예제는 "hello" 문자열에 대한 데이터 URI를 만듭니다.

dataUri('hello')

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

dataUriToBinary

데이터 URI(Uniform Resource Identifier)에 대한 이진 버전을 반환합니다. decodeDataUri()가 아닌 이 함수를 사용합니다. 두 함수가 동일한 방식으로 dataUriBinary() 작동하지만 선호됩니다.

dataUriToBinary('<value>')
매개 변수 필수 Type 설명
<value> 예 문자열 변환할 데이터 URI
반환 값 Type 설명
<binary-for-data-uri> 문자열 데이터 URI의 이진 버전

예제

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

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

다음 결과를 반환합니다.

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

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

dataUriToString('<value>')
매개 변수 필수 Type 설명
<value> 예 문자열 변환할 데이터 URI
반환 값 Type 설명
<string-for-data-uri> 문자열 데이터 URI의 문자열 버전

예제

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

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

다음 결과를 반환합니다. "hello"

dayOfMonth

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

dayOfMonth('<timestamp>')
매개 변수 필수 Type 설명
<timestamp> 예 문자열 타임스탬프를 포함하는 문자열입니다.
반환 값 Type 설명
<월의 날> 정수 지정한 타임스탬프의 월의 날짜

예제

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

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

다음 결과를 반환합니다. 15

Dayofweek

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

dayOfWeek('<timestamp>')
매개 변수 필수 Type 설명
<timestamp> 예 문자열 타임스탬프를 포함하는 문자열입니다.
반환 값 Type 설명
<요일> 정수 일요일이 0이고 월요일이 1인 지정된 타임스탬프의 요일입니다.

예제

이 예제는 이 타임스탬프에서 요일에 대한 숫자를 반환합니다.

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

다음 결과를 반환합니다. 3

dayOfYear

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

dayOfYear('<timestamp>')
매개 변수 필수 Type 설명
<timestamp> 예 문자열 타임스탬프를 포함하는 문자열입니다.
반환 값 Type 설명
<연중 일> 정수 지정된 타임스탬프의 연도 날짜입니다.

예제

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

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

다음 결과를 반환합니다. 74

decodeBase64

base64로 인코딩된 문자열에 대한 문자열 버전을 반환하며, 결과적으로 base64 문자열을 디코딩합니다. 대신 base64ToString()을 사용하는 것이 좋습니다decodeBase64(). 두 함수가 동일한 방식으로 base64ToString() 작동하지만 선호됩니다.

decodeBase64('<value>')
매개 변수 필수 Type 설명
<value> 예 문자열 디코딩할 base64로 인코딩된 문자열입니다.
반환 값 Type 설명
<decoded-base64-string> 문자열 base64로 인코딩된 문자열의 문자열 버전

예제

이 예제는 base64로 인코딩된 문자열에 대한 문자열을 만듭니다.

decodeBase64('aGVsbG8=')

다음 결과를 반환합니다. "hello"

decodeDataUri

데이터 URI(Uniform Resource Identifier)에 대한 이진 버전을 반환합니다. decodeDataUri() 대신에 dataUriToBinary()의 사용을 검토해 보세요. 두 함수가 동일한 방식으로 dataUriToBinary() 작동하지만 선호됩니다.

decodeDataUri('<value>')
매개 변수 필수 Type 설명
<value> 예 문자열 디코딩할 데이터 URI 문자열
반환 값 Type 설명
<binary-for-data-uri> 문자열 데이터 URI 문자열에 대한 이진 버전

예제

이 예제는 이 데이터 URI에 대한 이진 버전을 반환합니다.

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

다음 결과를 반환합니다.

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

decodeUriComponent

이스케이프 문자를 디코딩된 버전으로 바꾸는 문자열을 반환합니다.

decodeUriComponent('<value>')
매개 변수 필수 Type 설명
<value> 예 문자열 디코딩할 이스케이프 문자가 있는 문자열
반환 값 Type 설명
<decoded-uri> 문자열 디코딩된 이스케이프 문자가 있는 업데이트된 문자열

예제

이 예제에서는 이 문자열의 이스케이프 문자를 디코딩된 버전으로 바꿉니다.

decodeUriComponent('http%3A%2F%2Fcontoso.com')

다음 결과를 반환합니다. "https://contoso.com"

div

두 숫자를 나눈 정수 결과를 반환합니다. re기본der 결과를 얻으려면 mod()를 참조하세요.

div(<dividend>, <divisor>)
매개 변수 필수 Type 설명
<dividend> 예 정수 또는 부동 소수점 제수로 나눌 숫자
<divisor> 예 정수 또는 부동 소수점 배당금을 나누지만 0일 수 없는 숫자입니다.
반환 값 Type 설명
<quotient-result> 정수 첫 번째 숫자를 두 번째 숫자로 나눈 정수 결과입니다.

예제

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

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

다음 결과를 반환합니다. 2

encodeUriComponent

URL 안전하지 않은 문자를 이스케이프 문자로 바꿔 문자열에 대해 URI(Uniform Resource Identifier)로 인코딩된 버전을 반환합니다. 대신 uriComponent()를 사용하는 것이 좋습니다encodeUriComponent(). 두 함수가 동일한 방식으로 uriComponent() 작동하지만 선호됩니다.

encodeUriComponent('<value>')
매개 변수 필수 Type 설명
<value> 예 문자열 URI로 인코딩된 형식으로 변환할 문자열입니다.
반환 값 Type 설명
<encoded-uri> 문자열 이스케이프 문자가 있는 URI로 인코딩된 문자열

예제

이 예제에서는 이 문자열에 대해 URI로 인코딩된 버전을 만듭니다.

encodeUriComponent('https://contoso.com')

다음 결과를 반환합니다. "http%3A%2F%2Fcontoso.com"

empty

컬렉션이 비어 있는지 확인합니다. 컬렉션이 비어 있으면 true를 반환하거나 비어 있지 않으면 false를 반환합니다.

empty('<collection>')
empty([<collection>])
매개 변수 필수 Type 설명
<컬렉션> 예 문자열, 배열 또는 개체 검사할 컬렉션
반환 값 Type 설명
true 또는 false 부울 컬렉션이 비어 있으면 true를 반환합니다. 비어 있지 않으면 false를 반환합니다.

예제

다음 예제에서는 지정된 컬렉션이 비어 있는지 여부를 검사.

empty('')
empty('abc')

다음 결과를 반환합니다.

  • 첫 번째 예제: 빈 문자열을 전달하여 함수가 반환 true합니다.
  • 두 번째 예제: 문자열 "abc"를 전달하므로 함수는 false를 반환합니다.

endsWith

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

endsWith('<text>', '<searchText>')
매개 변수 필수 Type 설명
<text> 예 문자열 검사 문자열입니다.
<searchText> 예 문자열 찾을 끝 부분 문자열
반환 값 Type 설명
true 또는 false 부울 끝 부분 문자열이 발견되면 true를 반환합니다. 찾을 수 없는 경우 false를 반환합니다.

예제 1

이 예제에서는 "hello world" 문자열이 "world" 문자열로 끝나는지 여부를 검사.

endsWith('hello world', 'world')

다음 결과를 반환합니다. true

예제 2

이 예제에서는 "hello world" 문자열이 "universe" 문자열로 끝나는지 여부를 검사.

endsWith('hello world', 'universe')

다음 결과를 반환합니다. false

같음

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

equals('<object1>', '<object2>')
매개 변수 필수 Type 설명
<object1>, <object2> 예 다양한 비교할 값, 식 또는 개체
반환 값 Type 설명
true 또는 false 부울 둘 다 동일한 경우 true를 반환합니다. 같지 않으면 false를 반환합니다.

예제

이러한 예제는 지정된 입력이 동일한지 여부를 검사.

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

다음 결과를 반환합니다.

  • 첫 번째 예제: 두 값이 모두 같으므로 함수는 true를 반환합니다.
  • 두 번째 예제: 두 값이 모두 동일하지 않으므로 함수가 반환됩니다 false.

첫째

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

first('<collection>')
first([<collection>])
매개 변수 필수 Type 설명
<컬렉션> 예 문자열 또는 배열 첫 번째 항목을 찾을 컬렉션
반환 값 Type 설명
<first-collection-item> 모두 컬렉션의 첫 번째 항목

예제

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

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

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

  • 첫 번째 예제: "h"
  • 두 번째 예제: 0

float

부동 소수점 숫자의 문자열 버전을 실제 부동 소수점 숫자로 변환합니다.

float('<value>')
매개 변수 필수 Type 설명
<value> 예 문자열 변환할 유효한 부동 소수점 번호가 있는 문자열입니다.
반환 값 Type 설명
<float-value> Float 지정된 문자열의 부동 소수점 숫자입니다.

예제

이 예제에서는 이 부동 소수점 번호에 대한 문자열 버전을 만듭니다.

float('10.333')

다음 결과를 반환합니다. 10.333

formatDateTime

지정한 형식의 타임스탬프를 반환합니다.

formatDateTime('<timestamp>', '<format>'?)
매개 변수 필수 Type 설명
<timestamp> 예 문자열 타임스탬프를 포함하는 문자열입니다.
<format> 아니요 문자열 단일 형식 지정자 또는 사용자 지정 형식 패턴입니다. 타임스탬프의 기본 형식은 "o"(yyyy-MM-ddTHH:mm:ss.fffffffK)입니다. 이 형식은 ISO 8601을 준수하며 표준 시간대 정보를 보존합니다.
반환 값 Type 설명
<reformatted-timestamp> 문자열 지정된 형식의 업데이트된 타임스탬프

예제

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

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

다음 결과를 반환합니다. "2018-03-15T12:00:00"

getFutureTime

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

getFutureTime(<interval>, <timeUnit>, <format>?)
매개 변수 필수 Type 설명
<interval> 예 정수 추가할 지정된 시간 단위의 수입니다.
<timeUnit> 예 문자열 간격에 사용할 시간 단위: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format> 아니요 문자열 단일 형식 지정자 또는 사용자 지정 형식 패턴입니다. 타임스탬프의 기본 형식은 "o"(yyyy-MM-ddTHH:mm:ss.fffffffK)입니다. 이 형식은 ISO 8601을 준수하며 표준 시간대 정보를 보존합니다.
반환 값 Type 설명
<updated-timestamp> 문자열 현재 타임스탬프와 지정된 시간 단위 수

예제 1

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

getFutureTime(5, 'Day')

다음 결과를 반환합니다. "2018-03-06T00:00:00.0000000Z"

예제 2

현재 타임스탬프가 "2018-03-01T00:00:00.0000000Z"라고 가정합니다. 다음은 5일을 추가하고 결과를 "D" 형식으로 변환하는 예제입니다.

getFutureTime(5, 'Day', 'D')

다음 결과를 반환합니다. "Tuesday, March 6, 2018"

getPastTime

현재 타임스탬프에서 지정된 시간 단위를 뺀 값을 반환합니다.

getPastTime(<interval>, <timeUnit>, <format>?)
매개 변수 필수 Type 설명
<interval> 예 정수 뺄 지정한 시간 단위 수
<timeUnit> 예 문자열 간격에 사용할 시간 단위: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format> 아니요 문자열 단일 형식 지정자 또는 사용자 지정 형식 패턴입니다. 타임스탬프의 기본 형식은 "o"(yyyy-MM-ddTHH:mm:ss.fffffffK)입니다. 이 형식은 ISO 8601을 준수하며 표준 시간대 정보를 보존합니다.
반환 값 Type 설명
<updated-timestamp> 문자열 현재 타임스탬프에서 지정된 시간 단위 수를 뺀 값

예제 1

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

getPastTime(5, 'Day')

다음 결과를 반환합니다. "2018-01-27T00:00:00.0000000Z"

예제 2

현재 타임스탬프가 "2018-02-01T00:00:00.00000000Z"라고 가정합니다. 이 예제는 5일을 빼고 결과를 "D" 형식으로 변환합니다.

getPastTime(5, 'Day', 'D')

다음 결과를 반환합니다. "Saturday, January 27, 2018"

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

guid

"c2ecc88d-88c8-4096-912c-d6f2e2b138ce"와 같은 문자열로 GUID(Globally Unique Identifier)를 생성합니다.

guid()

또한 기본 형식인 "D"가 아닌 GUID에 다른 형식을 지정할 수 있습니다. 이 형식은 하이픈으로 구분된 32자리입니다.

guid('<format>')
매개 변수 필수 Type 설명
<format> 아니요 문자열 반환된 GUID에 대한 단일 형식 지정자 입니다. 기본적으로 형식은 "D"이지만 "N", "D", "B", "P" 또는 "X"를 사용할 수 있습니다.
반환 값 Type 설명
<GUID-값> 문자열 임의로 생성된 GUID

예제

이 예제에서는 동일한 GUID를 생성하지만 32자리 숫자로 하이픈으로 구분하고 괄호로 묶습니다.

guid('P')

다음 결과를 반환합니다. "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"

if

식이 true인지 또는 false인지 검사합니다. 결과에 따라 지정된 값을 반환합니다.

if(<expression>, <valueIfTrue>, <valueIfFalse>)
매개 변수 필수 Type 설명
<expression> 예 부울 검사 식입니다.
<valueIfTrue> 예 모두 식이 true일 때 반환할 값입니다.
<valueIfFalse> 예 모두 식이 false일 때 반환할 값입니다.
반환 값 Type 설명
<specified-return-value> 모두 식이 true인지 아니면 false인지에 따라 반환되는 지정된 값입니다.

예제

이 예제에서는 지정된 식이 true를 반환하기 때문에 반환 "yes" 합니다. 그렇지 않으면 이 예제는 "no"를 반환합니다.

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

Indexof

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

indexOf('<text>', '<searchText>')
매개 변수 필수 Type 설명
<text> 예 문자열 찾을 하위 문자열을 가진 문자열
<searchText> 예 문자열 찾을 부분 문자열
반환 값 Type 설명
<index-value> 정수 지정한 하위 문자열에 대한 시작 위치 또는 인덱스 값
문자열을 찾을 수 없는 경우 숫자 -1을 반환합니다.

예제

이 예제는 "hello world" 문자열의 "world" 하위 문자열에 대한 시작 인덱스 값을 찾습니다.

indexOf('hello world', 'world')

다음 결과를 반환합니다. 6

int

문자열에 대한 정수 버전을 반환합니다.

int('<value>')
매개 변수 필수 Type 설명
<value> 예 문자열 변환할 문자열입니다.
반환 값 Type 설명
<integer-result> 정수 지정된 문자열의 정수 버전입니다.

예제

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

int('10')

다음 결과를 반환합니다. 10

json

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

json('<value>')
매개 변수 필수 Type 설명
<value> 예 문자열 또는 XML 변환할 문자열 또는 XML
반환 값 Type 설명
<JSON 결과> JSON 원시 형식 또는 개체 지정된 문자열 또는 XML에 대한 JSON 네이티브 형식 값 또는 개체입니다. 문자열이 null이면 함수는 빈 개체를 반환합니다.

예제 1

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

json('[1, 2, 3]')

다음 결과를 반환합니다. [1, 2, 3]

예제 2

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

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

다음 결과를 반환합니다.

{
  "fullName": "Sophia Owen"
}

예제 3

이 예제에서는 이 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"
      } ]
   }
}

교집합

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

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]

join

배열의 모든 항목을 포함하고 각 문자가 구분 기호로 구분된 문자열을 반환합니다.

join([<collection>], '<delimiter>')
매개 변수 필수 Type 설명
<컬렉션> 예 배열 조인할 항목이 있는 배열
<delimiter> 예 문자열 결과 문자열의 각 문자 사이에 나타나는 구분 기호입니다.
반환 값 Type 설명
<char1><delimiter><char2><delimiter>... 문자열 지정한 배열의 모든 항목에서 만든 결과 문자열

예제

이 예제는 지정한 문자를 구분 기호로 하여 이 배열의 모든 항목에서 문자열을 만듭니다.

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

다음 결과를 반환합니다. "a.b.c"

마지막

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

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> 예 문자열 찾을 부분 문자열
반환 값 Type 설명
<ending-index-value> 정수 지정된 부분 문자열의 마지막 발생에 대한 시작 위치 또는 인덱스 값입니다.
문자열을 찾을 수 없는 경우 숫자 -1을 반환합니다.

예제

이 예제에서는 "hello world" 문자열에서 마지막으로 나타나는 "world" 부분 문자열의 시작 인덱스 값을 찾습니다.

lastIndexOf('hello world', 'world')

다음 결과를 반환합니다. 6

length

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

length('<collection>')
length([<collection>])
매개 변수 필수 Type 설명
<컬렉션> 예 문자열 또는 배열 개수를 셀 항목을 포함하는 컬렉션
반환 값 Type 설명
<length-or-count> 정수 컬렉션의 항목 수입니다.

예제

다음 예제에서는 이러한 컬렉션의 항목 수를 계산합니다.

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

다음 결과를 반환합니다. 4

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(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])
매개 변수 필수 Type 설명
<number1>, <number2>, ... 예 정수, 부동 소수점 또는 둘 다 가장 높은 값을 원하는 숫자 집합입니다.
[<number1>, <number2>, ...] 예 배열 - 정수, 부동 소수점 또는 둘 다 가장 높은 값을 원하는 숫자의 배열입니다.
반환 값 Type 설명
<max-value> 정수 또는 부동 소수점 지정된 배열 또는 숫자 집합에서 가장 높은 값입니다.

예제

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

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

다음 결과를 반환합니다. 3

최소

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

min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])
매개 변수 필수 Type 설명
<number1>, <number2>, ... 예 정수, 부동 소수점 또는 둘 다 가장 낮은 값을 원하는 숫자 집합입니다.
[<number1>, <number2>, ...] 예 배열 - 정수, 부동 소수점 또는 둘 다 가장 낮은 값을 원하는 숫자의 배열입니다.
반환 값 Type 설명
<min-value> 정수 또는 부동 소수점 지정된 숫자 집합 또는 지정된 배열의 가장 낮은 값입니다.

예제

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

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

다음 결과를 반환합니다. 1

mod

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

mod(<dividend>, <divisor>)
매개 변수 필수 Type 설명
<dividend> 예 정수 또는 부동 소수점 제수로 나눌 숫자
<divisor> 예 정수 또는 부동 소수점 배당금을 나누지만 0일 수 없는 숫자입니다.
반환 값 Type 설명
<modulo-result> 정수 또는 부동 소수점 첫 번째 숫자를 두 번째 숫자로 나눈 re기본der

예제

다음은 첫 번째 숫자를 두 번째 숫자로 나누는 예제입니다.

mod(3, 2)

다음 결과를 반환합니다. 1

mul

두 숫자를 곱한 제품을 반환합니다.

mul(<multiplicand1>, <multiplicand2>)
매개 변수 필수 Type 설명
<multiplicand1> 예 정수 또는 부동 소수점 multiplicand2로 곱할 숫자
<multiplicand2> 예 정수 또는 부동 소수점 multiplicand1를 곱하는 숫자
반환 값 Type 설명
<product-result> 정수 또는 부동 소수점 첫 번째 숫자를 두 번째 숫자로 곱한 결과

예제

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

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

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

  • 첫 번째 예제: 2
  • 두 번째 예제 3

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)

그리고 다음 숫자 중 하나를 결과로 123반환합니다.4

range

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

range(<startIndex>, <count>)
매개 변수 필수 Type 설명
<Startindex> 예 정수 배열을 첫 번째 항목으로 시작하는 정수 값
<count> 예 정수 배열의 정수 수
반환 값 Type 설명
[<range-result>] 배열 지정된 인덱스에서 시작하는 정수가 있는 배열입니다.

예제

다음은 지정된 인덱스에서 시작하여 지정된 정수 수를 포함하는 정수 배열을 만드는 예제입니다.

range(1, 4)

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

replace

부분 문자열을 지정된 문자열로 바꾸고 결과 문자열을 반환합니다. 이 함수는 대/소문자를 구분합니다.

replace('<text>', '<oldText>', '<newText>')
매개 변수 필수 Type 설명
<text> 예 문자열 바꿀 하위 문자열을 가진 문자열
<oldText> 예 문자열 바꿀 부분 문자열
<newText> 예 문자열 대체 문자열
반환 값 Type 설명
<updated-text> 문자열 부분 문자열을 바꾼 후 업데이트된 문자열
substring이 발견되지 않으면 원래 문자열을 반환합니다.

예제

이 예제에서는 "이전 문자열"에서 "old" 부분 문자열을 찾고 "old"를 "new"로 바꿉니다.

replace('the old string', 'old', 'new')

다음 결과를 반환합니다. "the new string"

skip

컬렉션의 앞부분에 있는 항목을 제거하고 다른 모든 항목을 반환합니다.

skip([<collection>], <count>)
매개 변수 필수 Type 설명
<컬렉션> 예 배열 해당 항목을 제거할 컬렉션
<count> 예 정수 전면에서 제거할 항목 수에 대한 양의 정수입니다.
반환 값 Type 설명
[<updated-collection>] 배열 지정된 항목을 제거한 후 업데이트된 컬렉션

예제

이 예제는 지정한 배열 앞에서 항목 한 개, 숫자 0을 제거합니다.

skip(createArray(0, 1, 2, 3), 1)

다시 기본 항목을 사용하여 이 배열을 반환합니다.[1,2,3]

split

원래 문자열의 지정된 구분 기호 문자를 기반으로 쉼표로 구분된 부분 문자열이 포함된 배열을 반환합니다.

split('<text>', '<delimiter>')
매개 변수 필수 Type 설명
<text> 예 문자열 원래 문자열의 지정된 구분 기호에 따라 부분 문자열로 구분할 문자열입니다.
<delimiter> 예 문자열 구분 기호로 사용할 원래 문자열의 문자입니다.
반환 값 Type 설명
[<substring1>,<substring2>,...] 배열 쉼표로 구분된 원래 문자열의 부분 문자열을 포함하는 배열입니다.

예제

이 예제에서는 지정된 문자(구분 기호)를 기준으로 하여 지정한 문자열의 하위 문자열이 포함된 배열을 만듭니다.

split('a_b_c', '_')

그리고 결과로 이 배열을 반환합니다. ["a","b","c"]

startOfDay

타임스탬프에 대한 하루의 시작을 반환합니다.

startOfDay('<timestamp>', '<format>'?)
매개 변수 필수 Type 설명
<timestamp> 예 문자열 타임스탬프를 포함하는 문자열입니다.
<format> 아니요 문자열 단일 형식 지정자 또는 사용자 지정 형식 패턴입니다. 타임스탬프의 기본 형식은 "o"(yyyy-MM-ddTHH:mm:ss.fffffffK)입니다. 이 형식은 ISO 8601을 준수하며 표준 시간대 정보를 보존합니다.
반환 값 Type 설명
<updated-timestamp> 문자열 지정된 타임스탬프이지만 해당 날짜의 0시간 표시에서 시작합니다.

예제

이 예제는 이 타임스탬프에 대한 날의 시작을 찾습니다.

startOfDay('2018-03-15T13:30:30Z')

다음 결과를 반환합니다. "2018-03-15T00:00:00.0000000Z"

startOfHour

타임스탬프의 시간 시작을 반환합니다.

startOfHour('<timestamp>', '<format>'?)
매개 변수 필수 Type 설명
<timestamp> 예 문자열 타임스탬프를 포함하는 문자열입니다.
<format> 아니요 문자열 단일 형식 지정자 또는 사용자 지정 형식 패턴입니다. 타임스탬프의 기본 형식은 "o"(yyyy-MM-ddTHH:mm:ss.fffffffK)입니다. 이 형식은 ISO 8601을 준수하며 표준 시간대 정보를 보존합니다.
반환 값 Type 설명
<updated-timestamp> 문자열 지정된 타임스탬프이지만 시간의 0분 표시에서 시작

예제

이 예제에서는 이 타임스탬프에 대한 시간의 시작을 찾습니다.

startOfHour('2018-03-15T13:30:30Z')

다음 결과를 반환합니다. "2018-03-15T13:00:00.0000000Z"

startOfMonth

타임스탬프에 대한 월의 시작을 반환합니다.

startOfMonth('<timestamp>', '<format>'?)
매개 변수 필수 Type 설명
<timestamp> 예 문자열 타임스탬프를 포함하는 문자열입니다.
<format> 아니요 문자열 단일 형식 지정자 또는 사용자 지정 형식 패턴입니다. 타임스탬프의 기본 형식은 "o"(yyyy-MM-ddTHH:mm:ss.fffffffK)입니다. 이 형식은 ISO 8601을 준수하며 표준 시간대 정보를 보존합니다.
반환 값 Type 설명
<updated-timestamp> 문자열 지정된 타임스탬프이지만 0시간 표시에서 해당 월의 첫째 날에 시작

예제

이 예제에서는 이 타임스탬프에 대한 월의 시작을 반환합니다.

startOfMonth('2018-03-15T13:30:30Z')

다음 결과를 반환합니다. "2018-03-01T00:00:00.0000000Z"

startswith

문자열이 특정 부분 문자열로 시작하는지 확인합니다. 하위 문자열이 발견되면 true를 반환하거나 발견되지 않으면 false를 반환합니다. 이 함수는 대/소문자를 구분하지 않습니다.

startsWith('<text>', '<searchText>')
매개 변수 필수 Type 설명
<text> 예 문자열 검사 문자열입니다.
<searchText> 예 문자열 찾을 시작 문자열
반환 값 Type 설명
true 또는 false 부울 시작 부분 문자열이 발견되면 true를 반환합니다. 찾을 수 없는 경우 false를 반환합니다.

예제 1

이 예제에서는 "hello world" 문자열이 "hello" 부분 문자열로 시작하는지 여부를 검사.

startsWith('hello world', 'hello')

다음 결과를 반환합니다. true

예제 2

이 예제에서는 "hello world" 문자열이 "greetings" 부분 문자열로 시작하는지 여부를 검사.

startsWith('hello world', 'greetings')

다음 결과를 반환합니다. false

string

값에 대한 문자열 버전을 반환합니다.

string(<value>)
매개 변수 필수 Type 설명
<value> 예 모두 변환할 값입니다.
반환 값 Type 설명
<string-value> 문자열 지정된 값의 문자열 버전입니다.

예제 1

이 예제는 이 숫자에 대한 문자열 버전을 만듭니다.

string(10)

다음 결과를 반환합니다. "10"

예제 2

이 예제는 지정한 JSON 개체에 대한 문자열을 만들고 백슬래시 문자(\)를 따옴표(")에 대한 이스케이프 문자로 사용합니다.

string( { "name": "Sophie Owen" } )

다음 결과를 반환합니다. "{ \\"name\\": \\"Sophie Owen\\" }"

하위

첫 번째 숫자에서 두 번째 숫자를 빼서 결과를 반환합니다.

sub(<minuend>, <subtrahend>)
매개 변수 필수 Type 설명
<minuend> 예 정수 또는 부동 소수점 감수를 뺄 수
<감수> 예 정수 또는 부동 소수점 피감수에서 뺄 수
반환 값 Type Description
<result> 정수 또는 부동 소수점 첫 번째 숫자에서 두 번째 숫자를 뺀 결과입니다.

예제

다음은 첫 번째 숫자에서 두 번째 숫자를 빼는 예제입니다.

sub(10.3, .3)

다음 결과를 반환합니다. 10

substring

지정한 위치 또는 인덱스에서 시작하여 문자열에서 문자를 반환합니다. 인덱스 값은 숫자 0으로 시작합니다.

substring('<text>', <startIndex>, <length>)
매개 변수 필수 Type 설명
<text> 예 문자열 해당 문자를 원하는 문자열
<Startindex> 예 정수 시작 위치 또는 인덱스 값으로 사용하려는 0보다 크거나 같은 양수입니다.
<length> 예 정수 부분 문자열에 원하는 양수 문자 수
반환 값 Type 설명
<substring-result> 문자열 원본 문자열의 지정한 인덱스 위치에서 시작하는 지정한 수의 문자를 포함하는 하위 문자열

예제

이 예제에서는 인덱스 값 6부터 시작하여 지정된 문자열에서 5자 부분 문자열을 만듭니다.

substring('hello world', 6, 5)

다음 결과를 반환합니다. "world"

subtractFromTime

타임스탬프에서 여러 시간 단위를 뺍니다. getPastTime도 함께 참조하세요.

subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)
매개 변수 필수 Type 설명
<timestamp> 예 문자열 타임스탬프를 포함하는 문자열입니다.
<interval> 예 정수 뺄 지정한 시간 단위 수
<timeUnit> 예 문자열 간격에 사용할 시간 단위: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format> 아니요 문자열 단일 형식 지정자 또는 사용자 지정 형식 패턴입니다. 타임스탬프의 기본 형식은 "o"(yyyy-MM-ddTHH:mm:ss.fffffffK)입니다. 이 형식은 ISO 8601을 준수하며 표준 시간대 정보를 보존합니다.
반환 값 Type 설명
<updated-timestamp> 문자열 타임스탬프에서 지정된 시간 단위 수를 뺀 값

예제 1

이 예제에서는 이 타임스탬프에서 1일을 뺍니다.

subtractFromTime('2018-01-02T00:00:00Z', 1, 'Day')

다음 결과를 반환합니다. "2018-01-01T00:00:00:0000000Z"

예제 2

이 예제에서는 이 타임스탬프에서 1일을 뺍니다.

subtractFromTime('2018-01-02T00:00:00Z', 1, 'Day', 'D')

선택적 "D" 형식을 사용하여 이 결과를 반환합니다. "Monday, January, 1, 2018"

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

ticks 지정된 타임스탬프의 속성 값을 반환합니다. tick은 100나노초 간격입니다.

ticks('<timestamp>')
매개 변수 필수 Type 설명
<timestamp> 예 문자열 타임스탬프에 대한 문자열
반환 값 Type 설명
<ticks-number> 정수 입력 타임스탬프 이후 양력 0001년 1월 1일 자정 12:00:00 이후 경과된 틱 수

toLower

문자열을 소문자 형식으로 반환합니다. 문자열의 문자에 소문자 버전이 없는 경우 해당 문자는 반환된 문자열에서 변경되지 않은 상태로 유지됩니다.

toLower('<text>')
매개 변수 필수 Type 설명
<text> 예 문자열 소문자 형식으로 반환할 문자열입니다.
반환 값 Type 설명
<소문자 텍스트> 문자열 소문자 형식의 원래 문자열

예제

이 예제는 이 문자열을 소문자로 변환합니다.

toLower('Hello World')

다음 결과를 반환합니다. "hello world"

toUpper

문자열을 대문자 형식으로 반환합니다. 문자열의 문자에 대문자 버전이 없는 경우 해당 문자는 반환된 문자열에서 변경되지 않은 상태로 유지됩니다.

toUpper('<text>')
매개 변수 필수 Type 설명
<text> 예 문자열 대문자 형식으로 반환할 문자열
반환 값 Type 설명
<대문자 텍스트> 문자열 대문자 형식의 원래 문자열

예제

다음은 이 문자열을 대문자로 변환하는 예제입니다.

toUpper('Hello World')

다음 결과를 반환합니다. "HELLO WORLD"

트림

문자열에서 선행 및 후행 공백을 제거하고 업데이트된 문자열을 반환합니다.

trim('<text>')
매개 변수 필수 Type 설명
<text> 예 문자열 제거할 선행 및 후행 공백이 있는 문자열
반환 값 Type 설명
<updatedText> 문자열 선행 또는 후행 공백이 없는 원래 문자열의 업데이트된 버전

예제

다음 예제에서는 문자열 ‘ Hello World ’에서 선행/후행 공백을 제거합니다.

trim(' Hello World  ')

다음 결과를 반환합니다. "Hello 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]

uriComponent

URL 안전하지 않은 문자를 이스케이프 문자로 바꿔 문자열에 대해 URI(Uniform Resource Identifier)로 인코딩된 버전을 반환합니다. EncodeUriComponent()가 아닌 이 함수를 사용합니다. 두 함수가 동일한 방식으로 uriComponent() 작동하지만 선호됩니다.

uriComponent('<value>')
매개 변수 필수 Type 설명
<value> 예 문자열 URI로 인코딩된 형식으로 변환할 문자열입니다.
반환 값 Type 설명
<encoded-uri> 문자열 이스케이프 문자가 있는 URI로 인코딩된 문자열

예제

이 예제에서는 이 문자열에 대해 URI로 인코딩된 버전을 만듭니다.

uriComponent('https://contoso.com')

다음 결과를 반환합니다. "http%3A%2F%2Fcontoso.com"

uriComponentToBinary

URI(Uniform Resource Identifier) 구성 요소에 대한 이진 버전을 반환합니다.

uriComponentToBinary('<value>')
매개 변수 필수 Type 설명
<value> 예 문자열 변환할 URI로 인코딩된 문자열
반환 값 Type 설명
<binary-for-encoded-uri> 문자열 URI 인코딩된 문자열에 대한 이진 버전 이진 콘텐츠는 base64로 인코딩되고 $content.

예제

이 예제에서는 이 URI로 인코딩된 문자열에 대한 이진 버전을 만듭니다.

uriComponentToBinary('http%3A%2F%2Fcontoso.com')

다음 결과를 반환합니다.

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

uriComponentToString

URI(Uniform Resource Identifier) 인코딩된 문자열의 문자열 버전을 반환하여 URI로 인코딩된 문자열을 효과적으로 디코딩합니다.

uriComponentToString('<value>')
매개 변수 필수 Type 설명
<value> 예 문자열 디코딩할 URI로 인코딩된 문자열
반환 값 Type 설명
<decoded-uri> 문자열 URI로 인코딩된 문자열의 디코딩된 버전

예제

이 예제에서는 이 URI로 인코딩된 문자열에 대해 디코딩된 문자열 버전을 만듭니다.

uriComponentToString('http%3A%2F%2Fcontoso.com')

다음 결과를 반환합니다. "https://contoso.com"

utcNow

현재 타임스탬프를 반환합니다.

utcNow('<format>')

선택적으로 <format> 매개 변수를 사용하여 다른 형식을 지정할 수 있습니다.

매개 변수 필수 Type 설명
<format> 아니요 문자열 단일 형식 지정자 또는 사용자 지정 형식 패턴입니다. 타임스탬프의 기본 형식은 "o"(yyyy-MM-ddTHH:mm:ss.fffffffK)입니다. 이 형식은 ISO 8601을 준수하며 표준 시간대 정보를 보존합니다.
반환 값 Type 설명
<current-timestamp> 문자열 현재 날짜 및 시간

예제 1

오늘이 2018년 4월 15일 오후 1:00:00에 있다고 가정해 보겠습니다. 이 예제에서는 현재 타임스탬프를 가져옵니다.

utcNow()

다음 결과를 반환합니다. "2018-04-15T13:00:00.0000000Z"

예제 2

오늘이 2018년 4월 15일 오후 1:00:00에 있다고 가정해 보겠습니다. 이 예제에서는 선택적 "D" 형식을 사용하여 현재 타임스탬프를 가져옵니다.

utcNow('D')

다음 결과를 반환합니다. "Sunday, April 15, 2018"

xml

JSON 개체가 포함된 문자열의 XML 버전을 반환합니다.

xml('<value>')
매개 변수 필수 Type 설명
<value> 예 문자열 변환할 JSON 개체가 있는 문자열입니다.
JSON 개체에는 배열이 될 수 없는 루트 속성이 하나만 있어야 합니다.
백슬래시 문자(\)를 따옴표(")에 대한 이스케이프 문자로 사용합니다.
반환 값 Type 설명
<xml-version> Object 지정된 문자열 또는 JSON 개체의 인코딩된 XML

예제 1

이 예제는 이 문자열에 대한 XML 버전을 만들며, 이 문자열은 JSON 개체를 포함합니다.

xml(json('{ \"name\": \"Sophia Owen\" }'))

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

<name>Sophia Owen</name>

예제 2

이 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> 예 모두 XPath 식 값과 일치하는 노드 또는 값을 검색할 XML 문자열입니다.
<xpath> 예 모두 일치하는 XML 노드 또는 값을 찾는 데 사용되는 XPath 식
반환 값 Type 설명
<xml-node> XML 단일 노드만 지정된 XPath 식과 일치하는 경우 XML 노드
<value> 모두 단일 값만이 지정한 XPath 식과 일치하는 경우 XML 노드의 값
[<xml-node1>, <xml-node2>, ...]
-or-
[<value1>, <value2>, ...]		 배열 지정된 XPath 식과 일치하는 XML 노드 또는 값이 있는 배열

예제 1

예제 1에 이어 이 예제에서는 노드와 일치하는 노드를 <count></count> 찾고 해당 노드 값을 함수에 sum() 추가합니다.

xpath(xml(parameters('items')), 'sum(/produce/item/count)')

다음 결과를 반환합니다. 30

예제 2

이 예제의 경우 두 식은 모두 지정한 인수의 <location></location> 노드와 일치하는 노드를 찾으며, 이 인수는 네임스페이스와 함께 XML을 포함합니다. 이 식은 백슬래시 문자(\)를 따옴표(")에 대한 이스케이프 문자로 사용합니다.

  • 식 1

    xpath(xml(body('Http')), '/*[name()=\"file\"]/*[name()=\"location\"]')

  • Expression 2

    xpath(xml(body('Http')), '/*[local-name()=\"file\" and namespace-uri()=\"http://contoso.com\"]/*[local-name()=\"location\"]')

인수는 다음과 같습니다.

  • XML 문서 네임스페이스를 포함하는 이 XML은 다음과 같습니다 xmlns="http://contoso.com".

    <?xml version="1.0"?> <file xmlns="http://contoso.com"> <location>Paris</location> </file>

  • 여기서 XPath 식 중 하나:

    • /*[name()=\"file\"]/*[name()=\"location\"]

    • /*[local-name()=\"file\" and namespace-uri()=\"http://contoso.com\"]/*[local-name()=\"location\"]

<location></location> 노드와 일치하는 결과 노드는 다음과 같습니다.

<location xmlns="https://contoso.com">Paris</location>

예제 3

예제 3에 이어 이 예제에서는 노드에서 값을 찾습니다 <location></location> .

xpath(xml(body('Http')), 'string(/*[name()=\"file\"]/*[name()=\"location\"])')

다음 결과를 반환합니다. "Paris"

참고 항목

하나는 데이터 흐름 식에 주석을 추가할 수 있지만 파이프라인 식에는 추가할 수 없습니다.

관련 콘텐츠

일반적인 매개 변수 사용에 대한 지침은 Fabric의 Data Factory에 대한 매개 변수를 참조하세요.