Azure Data Factory 및 Azure Synapse Analytics의 식 및 함수

아티클
05/17/2024

적용 대상: Azure Data Factory Azure Synapse Analytics

팁

기업용 올인원 분석 솔루션인 Microsoft Fabric의 Data Factory를 사용해 보세요. Microsoft Fabric은 데이터 이동부터 데이터 과학, 실시간 분석, 비즈니스 인텔리전스 및 보고에 이르기까지 모든 것을 다룹니다. 무료로 새 평가판을 시작하는 방법을 알아봅니다!

이 문서에서는 Azure Data Factory 및 Azure Synapse Analytics에서 지원하는 식과 함수에 대한 정보를 제공합니다.

식

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

"name": "value"

또는

"name": "@pipeline().parameters.password"

식은 JSON 문자열 값에서 어느 위치에나 나타날 수 있으며 그 결과 항상 다른 JSON 값이 발생합니다. JSON 값이 식이면 앳 기호(@)를 제거하여 식의 본문을 추출합니다. @로 시작되는 리터럴 문자열이 필요한 경우 해당 문자열은 @@를 사용하여 이스케이프 처리해야 합니다. 다음 예제는 식의 작동 방식을 보여 줍니다.

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

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

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

JSON 값	결과
“@pipeline().parameters.myString”	`foo`을 문자열로 반환합니다.
"@{pipeline().parameters.myString}"	`foo`을 문자열로 반환합니다.
“@pipeline().parameters.myNumber”	`42`를 숫자로 반환합니다.
"@{pipeline().parameters.myNumber}"	`42`를 문자열로 반환합니다.
"Answer is: @{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]인 경우 @item()은 첫 번째 반복에서 1, 두 번째 반복에서 2, 세 번째 반복에서 3을 반환합니다. @range(0,10)와 같은 식을 사용하여 0부터 9까지 10회 반복할 수도 있습니다.

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

예제

복합 식 예

아래 예에서 작업 출력의 심층 하위 필드를 참조하는 복잡한 예를 보여 줍니다. 하위 필드로 계산되는 파이프라인 매개 변수를 참조하려면 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개의 동적 파일 이름이 만들어집니다.

동적 콘텐츠 편집기

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

{ 
  "type": "@{if(equals(1, 2), 'Blob', 'Table' )}",
  "name": "@{toUpper('myData')}"
}

동적 콘텐츠 편집기는 "{ \n \"type\": \"@{if(equals(1, 2), 'Blob', 'Table' )}\",\n \"name\": \"@{toUpper('myData')}\"\n}" 식으로 위의 콘텐츠를 변환합니다. 이 식의 결과는 아래에 표시된 JSON 형식 문자열입니다.

{
  "type": "Table",
  "name": "MYDATA"
}

매개 변수가 포함된 데이터 세트

다음 예제에서는 BlobDataset은 경로라는 매개 변수를 사용합니다. dataset().path 식을 사용하여 folderPath 속성에 대한 값을 설정하도록 해당 값을 사용합니다.

{
    "name": "BlobDataset",
    "properties": {
        "type": "AzureBlob",
        "typeProperties": {
            "folderPath": "@dataset().path"
        },
        "linkedServiceName": {
            "referenceName": "AzureStorageLinkedService",
            "type": "LinkedServiceReference"
        },
        "parameters": {
            "path": {
                "type": "String"
            }
        }
    }
}

매개 변수가 포함된 파이프라인

다음 예에서 파이프라인은 inputPath 및 outputPath 매개 변수를 사용합니다. 매개 변수가 있는 Blob 데이터 세트의 경로는 이러한 매개 변수의 값을 사용하여 설정됩니다. 여기에 사용된 구문은 pipeline().parameters.parametername입니다.

{
    "name": "Adfv2QuickStartPipeline",
    "properties": {
        "activities": [
            {
                "name": "CopyFromBlobToBlob",
                "type": "Copy",
                "inputs": [
                    {
                        "referenceName": "BlobDataset",
                        "parameters": {
                            "path": "@pipeline().parameters.inputPath"
                        },
                        "type": "DatasetReference"
                    }
                ],
                "outputs": [
                    {
                        "referenceName": "BlobDataset",
                        "parameters": {
                            "path": "@pipeline().parameters.outputPath"
                        },
                        "type": "DatasetReference"
                    }
                ],
                "typeProperties": {
                    "source": {
                        "type": "BlobSource"
                    },
                    "sink": {
                        "type": "BlobSink"
                    }
                }
            }
        ],
        "parameters": {
            "inputPath": {
                "type": "String"
            },
            "outputPath": {
                "type": "String"
            }
        }
    }
}

특수 문자 바꾸기

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

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

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

Contoso-
Corporation

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

파이프라인의 식 함수는 작은따옴표(')를 사용하여 문자열 값 매개 변수를 묶습니다. 작은따옴표를 포함하려면 파이프라인 문자열 식 내에서 두 개의 연속된 작은따옴표 문자를 사용합니다. 예는 다음과 같습니다. 식 @concat('Here is a double quote character: ". ', 'And here is a single quote character all within the same string: ''.')은 다음 결과를 반환합니다.

Here is a double quote character: ". And here is a single quote character all within the same string: '.

그러나 데이터 흐름 식에서는 이 구문이 지원되지 않습니다. 대신 데이터 흐름 식은 작은따옴표 또는 큰따옴표로 묶을 수 있습니다. 문자열 함수 내에서 작은따옴표가 필요한 텍스트는 큰따옴표로 묶고, 큰따옴표가 필요한 텍스트는 작은따옴표로 묶습니다. 작은따옴표와 큰따옴표가 모두 포함된 문자열이 필요한 경우 concat()을 사용하여 각각 작은따옴표나 큰따옴표가 포함된 두 하위 문자열을 병합할 수 있습니다. 이전 파이프라인 식 예에 해당하는 데이터 흐름은 concat('Here is a double quote character: ". ', "And here is a single quote character all within the same string: '.")입니다. 데이터 흐름에서 해당 식은 파이프라인 식에 대한 이전 예와 동일한 결과를 반환합니다.

`Tutorial`

이 자습서에서는 매개 변수를 작업 간에 전달하는 방법뿐만 아니라 파이프라인과 작업 간에 전달하는 방법을 안내합니다. 이 자습서에서는 Synapse 작업 영역에 대한 단계가 거의 동일하지만 사용자 인터페이스가 약간 다른 경우를 제외하고 Azure Data Factory에 대한 단계를 구체적으로 보여 줍니다.

함수

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

날짜 함수

날짜 또는 시간 함수	작업
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)를 문자열로 생성합니다.
indexOf	하위 문자열에 대한 시작 위치를 반환합니다.
lastIndexOf	마지막으로 나오는 부분 문자열의 시작 위치를 반환합니다.
replace	하위 문자열을 지정된 문자열로 바꾸고 업데이트된 문자열을 반환합니다.
split	지정된 구분 기호가 나타날 때마다 문자열을 분할하여 결과 부분 문자열을 배열 요소로 반환합니다.
startsWith	문자열이 특정 하위 문자열로 시작하는지 검사합니다.
substring	지정된 위치에서 시작하여 문자열에서 문자를 반환합니다.
toLower	문자열을 소문자 형식으로 반환합니다.
toUpper	문자열을 대문자 형식으로 반환합니다.
trim	문자열에서 선행 및 후행 공백을 제거하고 업데이트된 문자열을 반환합니다.

컬렉션 기능

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

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

논리 함수

이 함수는 조건 내에서 유용하며 논리의 형식을 평가하는 데 사용할 수 있습니다.

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

변환 함수

이 함수는 언어의 각 기본 형식 간에 변환하는 데 사용됩니다.

string
정수
float
부울 값
arrays
dictionaries

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

수식 함수

이 함수는 integers 및 floats의 숫자 형식에 사용할 수 있습니다.

수식 함수	작업
add	두 숫자를 더한 결과를 반환합니다.
div	한 숫자를 다른 숫자로 나눈 결과를 반환합니다.
max	숫자 또는 배열 집합에서 가장 높은 값을 반환합니다.
min	숫자 또는 배열 집합에서 가장 낮은 값을 반환합니다.
mod	한 숫자를 다른 숫자로 나눈 나머지를 반환합니다.
mul	두 숫자를 곱한 결과를 반환합니다.
rand	지정된 범위에서 임의의 정수를 반환합니다.
range	지정한 정수에서 시작하는 정수 배열을 반환합니다.
sub	한 숫자를 다른 숫자에서 뺀 결과를 반환합니다.

함수 참조

이 섹션에서는 사용 가능한 모든 함수가 알파벳 순서로 나열됩니다.

`add`

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

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>	예	문자열	interval과 함께 사용할 시간 단위: "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"

`and`

두 식이 모두 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를 반환합니다.

`array`

단일 지정 입력에서 배열을 반환합니다. 여러 입력의 경우 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로 인코딩된 문자열에 대한 문자열 버전

예제

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

base64ToString('aGVsbG8=')

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

`binary`

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

binary('<value>')

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

반환 값	Type	설명
<binary-for-input-value>	문자열	지정한 문자열에 대한 이진 버전

예제

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

binary('hello')

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

"0110100001100101011011000110110001101111"

`bool`

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

bool(<value>)

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

반환 값	Type	설명
true 또는 false	부울	지정한 값에 대한 부울 버전

예제

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

bool(1)
bool(0)

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

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

`coalesce`

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

coalesce(<object_1>, <object_2>, ...)

매개 변수	필수	Type	설명
<object_1>, <object_2>, ...	예	Any, 형식을 혼합할 수 있음	Null인지 검사할 하나 이상의 항목

반환 값	Type	설명
<first-non-null-item>	모두	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	설명
<day-of-month>	정수	지정한 타임스탬프의 월의 날짜

예제

이 예제는 이 타임스탬프에서 월의 날짜에 대한 숫자를 반환합니다.

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

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

`dayOfWeek`

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

dayOfWeek('<timestamp>')

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

반환 값	Type	설명
<day-of-week>	정수	일요일이 0, 월요일이 1이라는 식으로 지정한 타임스탬프의 요일

예제

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

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

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

`dayOfYear`

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

dayOfYear('<timestamp>')

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

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

예제

이 예제는 이 타임스탬프에서 년의 날짜인 숫자를 반환합니다.

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

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

decodeBase64

base64로 인코딩된 문자열에 대한 문자열 버전을 반환하며, 결과적으로 base64 문자열을 디코딩합니다. decodeBase64() 대신에 base64ToString()의 사용을 검토해 보세요. 두 함수 모두 같은 방법으로 작동하지만 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=')

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

`decodeUriComponent`

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

decodeUriComponent('<value>')

매개 변수	필수	Type	설명
<value>	예	문자열	디코딩할 이스케이프 문자를 포함한 문자열

반환 값	Type	설명
<decoded-uri>	문자열	디코딩된 이스케이프 문자로 업데이트된 문자열

예제

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

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

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

`div`

한 숫자를 다른 숫자로 나눈 결과를 반환합니다.

div(<dividend>, <divisor>)

함수의 정확한 반환 형식은 매개 변수 형식에 따라 다릅니다. 자세한 내용은 예를 참조하세요.

매개 변수	필수	Type	설명
<dividend>	예	정수 또는 부동 소수점 수	제수로 나눌 숫자
<divisor>	예	정수 또는 부동 소수점 수	‘피제수’를 나누는 숫자입니다. 제수 값이 0이면 런타임 시 오류가 발생합니다.

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

예제 1

다음 예에서는 숫자 9를 2로 나눕니다.

div(9, 2.0)
div(9.0, 2)
div(9.0, 2.0)

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

예제 2

이 예에서는 숫자 9를 2로 나누지만 두 매개 변수가 모두 정수이므로 나머지는 버려집니다(정수 나누기).

div(9, 2)

이 식은 결과 4를 반환합니다. 나머지 값을 가져오려면 mod() 함수를 사용합니다.

`encodeUriComponent`

URL 안전하지 않은 문자를 이스케이프 문자로 바꾸어 문자열에 대한 URI(Uniform Resource Identifier) 인코딩된 버전을 반환합니다. encodeUriComponent() 대신에 uriComponent()의 사용을 검토해 보세요. 두 함수 모두 같은 방법으로 작동하지만 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

이 예제는 "hellow world" 문자열이 "world" 문자열로 끝나는지 검사합니다.

endsWith('hello world', 'world')

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

예제 2

이 예제는 "hellow world" 문자열이 "universe" 문자열로 끝나는지 검사합니다.

endsWith('hello world', 'universe')

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

`equals`

두 값, 식 또는 개체가 모두 같은지 검사합니다. 둘이 다 같으면 true를 반환하거나 같지 않으면 false를 반환합니다.

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

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

반환 값	Type	설명
true 또는 false	부울	둘이 같으면 true를 반환합니다. 같지 않으면 false를 반환합니다.

예제

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

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

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

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

`first`

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

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>	예	문자열	interval과 함께 사용할 시간 단위: "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>	예	문자열	interval과 함께 사용할 시간 단위: "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.0000000Z"라고 가정합니다. 이 예제는 해당 타임스탬프에서 5일을 뺍니다.

getPastTime(5, 'Day')

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

예제 2

현재 타임스탬프가 "2018-02-01T00:00:00.0000000Z"라고 가정합니다. 이 예제는 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`

GUID(전역적으로 고유한 식별자)를 문자열로 생성합니다. 예, "c2ecc88d-88c8-4096-912c-d6f2e2b138ce":

guid()

또한 GUID에 대해 하이픈으로 구분된 32자리인 기본 형식 "D" 이외의 다른 형식을 지정할 수 있습니다.

guid('<format>')

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

반환 값	Type	설명
<GUID-value>	문자열	임의로 생성된 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`

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

json('<value>')

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

반환 값	Type	설명
<JSON-result>	JSON 원시 형식 또는 개체	JSON 고유 형식 값 또는 지정한 문자열이나 XML에 대한 개체입니다. 문자열이 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`

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

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`

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

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`

양끝이 포함된 숫자를 가진 목록 또는 배열에서 가장 높은 값을 반환합니다.

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`

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

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>	정수 또는 부동 소수점 수	첫 번째 숫자를 두 번째 숫자로 나눈 나머지

예제

이 예에서는 첫 번째 숫자를 두 번째 숫자로 나눈 나머지를 계산합니다.

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를 반환합니다.

`or`

최소 하나의 식이 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()`를 호출할 때마다 고유한 결과가 생성됩니다. 즉, 출력 모니터링에서 관찰한 값이 실제 런타임에 동일하지 않을 수 있습니다.

예제

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

rand(1, 5)

그리고 다음 숫자 중 하나를 결과로 반환합니다. 1, 2, 3 또는 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>	문자열	하위 문자열을 바꾼 후 업데이트된 문자열 하위 문자열이 발견되지 않으면 원래 문자열을 반환합니다.

예제

이 예제는 "the old string"의 "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>,...]	배열	원래 문자열의 하위 문자열을 포함하는 배열

예제

이 예에서는 구분 기호 "_"를 기반으로 문자열 "a_b_c"의 하위 문자열을 포함하는 배열을 반환합니다.

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`

한 숫자를 다른 숫자에서 뺀 결과를 반환합니다.

sub(<minuend>, <subtrahend>)

매개 변수	필수	Type	설명
<minuend>	예	정수 또는 부동 소수점 수	감수를 뺄 수
<subtrahend>	예	정수 또는 부동 소수점 수	피감수에서 뺄 수

반환 값	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>	예	문자열	interval과 함께 사용할 시간 단위: "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	설명
<lowercase-text>	문자열	소문자 형식의 원래 문자열

예제

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

toLower('Hello World')

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

`toUpper`

문자열을 대문자 형식으로 반환합니다. 문자열의 문자에 대문자 버전이 없으면 반환된 문자열에 해당 문자가 변경되지 않고 포함됩니다.

toUpper('<text>')

매개 변수	필수	Type	설명
<text>	예	문자열	대문자 형식으로 반환할 문자열

반환 값	Type	설명
<uppercase-text>	문자열	대문자 형식의 원래 문자열

예제

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

toUpper('Hello World')

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

`trim`

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

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"

참고 항목

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

식에 사용할 수 있는 시스템 변수 목록은 시스템 변수를 참조하세요.

다음을 통해 공유

Azure Data Factory 및 Azure Synapse Analytics의 식 및 함수

식

예제

복합 식 예

동적 콘텐츠 편집기

매개 변수가 포함된 데이터 세트

매개 변수가 포함된 파이프라인

특수 문자 바꾸기

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

Tutorial

함수

날짜 함수

문자열 함수

컬렉션 기능

논리 함수

변환 함수

수식 함수

함수 참조

add

addDays

addHours

addMinutes

addSeconds

addToTime

and

array

base64

base64ToBinary

base64ToString

binary

bool

coalesce

concat

contains

convertFromUtc

convertTimeZone

convertToUtc

createArray

dataUri

dataUriToBinary

dataUriToString

dayOfMonth

dayOfWeek

dayOfYear

decodeBase64

decodeDataUri

decodeUriComponent

div

encodeUriComponent

empty

endsWith

equals

first

float

formatDateTime

getFutureTime

getPastTime

greater

greaterOrEquals

guid

if

indexOf

int

json

intersection

join

last

lastIndexOf

length

less

lessOrEquals

max

min

mod

mul

not

or

rand

range

`Tutorial`

`add`

`addDays`

`addHours`

`addMinutes`

`addSeconds`

`addToTime`

`and`

`array`

`binary`

`bool`

`coalesce`

`concat`

`contains`

`convertFromUtc`

`convertTimeZone`

`convertToUtc`

`createArray`

`dataUri`

`dataUriToBinary`

`dataUriToString`

`dayOfMonth`

`dayOfWeek`

`dayOfYear`

`decodeDataUri`

`decodeUriComponent`

`div`

`encodeUriComponent`

`empty`

`endsWith`

`equals`

`first`

`float`

`formatDateTime`

`getFutureTime`

`getPastTime`

`greater`

`greaterOrEquals`

`guid`

`if`

`indexOf`

`int`

`json`

`intersection`

`join`

`last`

`lastIndexOf`

`length`

`less`

`lessOrEquals`

`max`

`min`

`mod`

`mul`

`not`

`or`

`rand`

`range`

`replace`

`skip`

`split`

`startOfDay`

`startOfHour`

`startOfMonth`

`startsWith`

`string`

`sub`

`substring`

`subtractFromTime`

`take`

`ticks`

`toLower`

`toUpper`

`trim`

`union`

`uriComponent`

`uriComponentToBinary`

`uriComponentToString`

`utcNow`

`xml`