이 문서에는 Trigger 내 앱 편집기에서 사용할 수 있는 표현식의 전체 목록이 포함되어 있습니다.
표현식을 사용하면 데이터를 다양한 방식으로 활용하거나 다른 형태로 변환할 수 있습니다.
Available expressions differ between features (e.g. App Editor, Analytics Editor, Automations/Functions Editor).
To understand where each expression is available, see the full list of expressions in Tulip.
앱 편집기의 표현식
모든 예제는 앱 '완료'를 기반으로 합니다. 따라서, 예를 들어 MAXIMUM() 또는 MINIMUM() 함수를 사용할 경우, 앱의 모든 완료 건에 걸쳐 변수의 최대값 또는 최소값을 찾게 됩니다.
**ADD_TIME()**은 지정된 값과 간격 단위를 기준으로 날짜/시간 값을 증가시킵니다.
예: ADD_TIME(datetime_variable, 2, 'years')
**SUBTRACT_TIME()**지정된 값과 간격 단위를 사용하여 날짜/시간 값을 감소시킵니다.
예: SUBTRACT_TIME(datetime_variable, 3, 'months')
형 변환 표현식
**BADGE_ID_TO_USER()**배지 ID를 User 객체로 변환합니다.
예: BADGE_ID_TO_USER(0000) = "John Doe" (사용자 객체)
DATETIMETOTEXT()
Datetime 값을 사람이 쉽게 읽을 수 있는 텍스트 값으로 변환합니다
예: DATETIMETOTEXT(datetime_variable, "MMMM DD, YYYY", 'America/New_York')
이렇게 하면 날짜/시간이 동부 표준시(EST)로 변환되어 "2019년 1월 1일"과 같은 일반적인 날짜 형식으로 표시됩니다.
참고: 마지막 매개 변수인 시간대는 여기에 나열된 tz 데이터베이스 이름 중 하나여야 합니다.
FILETOTEXT("url: File") => Text 파일을 URL의 텍스트 문자열로 변환합니다.
예: FILETOTEXT("http://www.africau.edu/images/default/sample.pdf")
HEX_TO_INT()
주어진 16진수 문자열을 숫자로 변환하여 반환합니다.
예: HEX_TO_INT('0xAB18') = '43800'
INT_TO_HEX()
주어진 숫자의 16진수 표현을 반환합니다.
예: INT_TO_HEX('43800') = '0xAB18'
INTERVAL_TO_SECONDS(interval: Interval) => Number Interval의 길이를 초 단위로 반환합니다.
예: INTERVAL_TO_SECONDS(seconds_to_interval(30.0))
LOWERCASE()
문자열을 모두 소문자로 변환합니다.
MAP_TO_BOOLEAN_LIST(a: {} 배열, b: 텍스트) => 배열 객체 배열을 주어진 키에 대한 기본 배열로 변환합니다.
예: MAP_TO_BOOLEAN_LIST([{key: value}], ‘key’) = [value]
MAP_TO_INTEGER_LIST(a: {} 배열, b: 텍스트) => 배열 객체 배열을 주어진 키에 대한 기본 배열로 변환합니다.
예: MAP_TO_INTEGER_LIST([{key: value}], ‘key’) = [value]
MAP_TO_NUMBER_LIST(a: {} array, b: text) => array 객체 배열을 주어진 키에 대한 기본 배열로 변환합니다.
예: MAP_TO_NUMBER_LIST([{key: value}], ‘key’) = [value]
MAP_TO_TEXT_LIST(a: {} array, b: text) => array: 객체 배열을 주어진 키에 대한 기본 배열로 변환합니다.
예: MAP_TO_TEXT_LIST([{key: value}], ‘key’) = [value]
**SECONDS_TO_INTERVAL()**초를 Interval로 변환합니다.
SECONDS_TO_INTERVAL(seconds: 정수 또는 숫자) => Interval
예: SECONDS_TO_INTERVAL(20) => 0:00:20
**TEXTTOBOOLEAN()**텍스트를 부울 값으로 파싱합니다.
"y", "yes", "t", "true" 및 "on"과 대문자로 표기된 모든 변형은 true로 인식되며, "n", "no", "f", "false" 및 "off"는 false로 인식됩니다.
예: TEXTTOBOOLEAN("yes")
TEXTTODATETIME()
지정된 매개 변수를 사용하여 텍스트 값을 날짜/시간 값으로 변환합니다. 텍스트 형식의 날짜/시간( Connector Function )이 있고 이를 변환해야 할 때 주로 사용됩니다.
TEXTTOIMAGEURL(url:Text) => 이미지 URL 문자열을 이미지 URL로 변환합니다.
예: TEXTTOIMAGEURL("https://example.com/photo.jpg")
**TEXTTOINTEGER()**텍스트 또는 간격(Interval)을 정수(Integer)로 파싱합니다.
예: TEXTTOINTEGER("123")
**TEXTTONUMBER()**텍스트나 타임스탬프를 숫자로 파싱합니다.
예: TEXTTONUMBER("2.4")
TOTEXT()는어떤 값이든 텍스트로 변환합니다.
예: TOTEXT(2)
UPPERCASE()
문자열을 모두 대문자로 변환합니다.
USER_ID_TO_USER(id: Text) => User 사용자 ID를 사용자 객체로 변환합니다.
예: User_id_to_user("abc") = User
잘린 표현식
CEIL()
가장 가까운 정수로 올림
FLOOR()
가장 가까운 정수로 반올림합니다.
ROUND()
숫자를 지정된 소수 자릿수까지 반올림합니다. 최대 소수 자릿수는 3자리입니다.
예 1 - ROUND(123.123456, 1)
이 경우 123.1이 반환됩니다.
예 2 - ROUND(123.12)
이 경우 123을 반환합니다
ROUNDDATETIME()
Datetime 값을 월이나 일과 같은 지정된 단위로 반올림합니다.
예: ROUNDDATETIME(datetime_variable, "Month", "America/New_York")
이 함수는 날짜/시간을 동부 표준시(EST) 기준의 월만 남도록 변환합니다.
참고: 마지막 매개변수인 시간대는 여기에 나열된 tz 데이터베이스 이름 중 하나여야 합니다.
값 반환 표현식
ABS()
숫자의 절대값을 반환합니다.
CONTAINS()
문자열에 주어진 부분 문자열이 포함되어 있는지 여부를 반환합니다.
예: CONTAINS("123ABC", "123")
이 경우 "true"를 반환합니다
COS()
주어진 입력값의 코사인을 반환합니다
ENCODE_URI(component: Text) => Text
URI를 URL 인코딩된 문자열 형태로 반환합니다.
예: ENCODE_URI("http://example.com/a=foo&b=a test") = "http://example.com/a=foo&b=a test"
ENCODE_URI_COMPONENT(component: Text) => Text
URI 구성 요소의 URL 인코딩된 문자열 버전을 반환합니다.
예: ENCODE_URI_COMPONENT("a & b") = "a%20%26%20b"
**FIND()**두 번째 인자 내에서 첫 번째 인자가 나타나는 위치를 반환합니다.
IF()
첫 번째 인수를 기준으로, 첫 번째 인수가 참이면 두 번째 인수를, 거짓이면 세 번째 인수를 반환합니다.
예: IF(true, 1, 2)
**ISNULL()**인수가 null이면 true를, 그렇지 않으면 false를 반환합니다.
**LEFT()**두 번째 인수로 지정된 위치부터 시작하는 텍스트 값의 부분 문자열을 반환합니다.
**LEN()**텍스트 값의 길이를 반환합니다. 또한 배열에 포함된 항목의 개수도 반환합니다.
LINK()
인수 중 null이 아닌 첫 번째 값을 반환합니다.
예: LINK(weight, 70)
weight 에 값이 있으면 weight의 값을 반환합니다.
MAX()
가장 큰 값을 가진 인수를 반환합니다.
예: MAX(var1, var2)
var1의 값이 var2의 값보다 크면 var1의 값을 반환합니다.
**MID()**두 번째 인수로 지정된 위치부터 시작하는 텍스트 값의 부분 문자열을 반환합니다. 세 번째 인수는 반환할 길이를 지정합니다.
**MIN()**가장 작은 값을 가진 인수를 반환합니다
예: MIN(var1, var2)
var1의 값이 var2의 값보다 작을 경우 var1의 값을 반환합니다.
POW()
첫 번째 인수를 두 번째 인수만큼 제곱한 값을 반환합니다.
예: POW(3, 2)
이 경우 9를 반환합니다.
RAND()
0과 1 사이의 임의의 소수점을 가진 숫자를 생성합니다.
RANDBETWEEN()
지정된 두 숫자 사이의 임의의 정수를 생성합니다.
예: RANDBETWEEN(5,10)
RANDOMSTRING()
17자 길이의 임의 문자열을 반환합니다. 새 테이블 레코드의 ID를 생성하는 데 사용됩니다 .
**RANDOM_COLOR()**임의의 색상을 생성합니다
예: RANDOM_COLOR() = ##c537a5
RGBA(r: 정수, g: 정수, b: 정수, a: 정수) => 색상 지정된 적색, 녹색, 청색 및 알파 성분의 색상을 반환합니다.
예: RGBA(255, 255, 0, 0.5) = ##ffff00 (불투명도 50%)
RGB(r: 정수, g: 정수, b: 정수) => Color지정된 적색, 녹색, 청색 성분의 색상을 반환합니다
예: RGB(255, 255, 0) = ##ffff00
**RIGHT()**두 번째 인자로 지정된 위치에서 끝나는 텍스트 값의 부분 문자열을 반환합니다.
SIN()
주어진 입력값의 사인 값을 반환합니다.
**SPLIT()**텍스트 값을 지정된 구분 기호로 나누어 배열로 만듭니다.
SQRT()
숫자의 제곱근을 반환합니다.
SUBSTITUTE()
첫 번째 인수로 지정된 문자열 내에서, 두 번째 인수의 모든 발생 사례를 세 번째 인수로 대체합니다.
예: SUBSTITUTE("A734", "7", "3")
이 경우 "A334"를 반환합니다
TAN()
주어진 입력값의 탄젠트를 반환합니다.
**TRIM()**첫 번째 인수의 앞뒤에서 (두 번째 인수로 지정된) 부분 문자열을 제거합니다.
배열 표현식
ARRAY_AVG()
배열에 포함된 모든 숫자의 평균을 반환합니다.
예: ARRAY_AVG([1,2,3])
이 경우 2를 반환합니다.
ARRAY_CONCAT()
인수로 지정된 배열들의 모든 요소를 포함하는 단일 배열을 반환합니다. 동일한 유형의 배열(예: 모두 텍스트 배열)에서만 작동합니다.
예: ARRAY_CONCAT([1,2],[3,4],[5,6])
이 경우 [1,2,3,4,5,6]을 반환합니다.
ARRAYCONTAINS()
값이 배열에 포함되어 있는지 확인합니다.
예: ARRAYCONTAINS([1,2,3], 1)
이 경우 "true"를 반환합니다
**ARRAY_INDEX_OF()**지정된 배열에서 주어진 값이 처음 나타나는 인덱스를 반환합니다. 해당 값이 없으면 “-1”을 반환합니다. 예: ARRAY_INDEX_OF([1,2,3], 2)이 경우 1을 반환합니다
ARRAY_MAX()
지정된 배열에서 최소값을 반환합니다
예: ARRAY_MAX([1,2,3])
이 경우 3을 반환합니다
ARRAY_MIN()
지정된 배열에서 최소값을 반환합니다
예: ARRAY_MIN([1,2,3])
이 경우 1을 반환합니다
ARRAY_STDEV_POPULATION()
주어진 숫자 배열의 모집단 표준편차를 반환합니다
예: ARRAY_STDEV_POPULATION([1,2,3])
이 경우 0.816496580927726을 반환합니다
ARRAY_STDEV_SAMPLE()
주어진 숫자 배열의 표본 표준편차를 반환합니다
예: ARRAY_STDEV_SAMPLE([1,2,3])
이 경우 1을 반환합니다
**ARRAY_VALUE_AT_INDEX()**주어진 리스트에서 지정된 인덱스에 있는 값을 반환합니다. 인덱스가 범위를 벗어날 경우 null을 반환합니다. 예: ARRAY_VALUE_AT_INDEX([1,2,3], 0)이 경우 1을 반환합니다
**REGEX_MATCH()**텍스트 값에 대한 정규 표현식 일치 결과를 배열로 반환합니다. 주어진 정규 표현식과 수정자를 기반으로 일치 여부를 확인합니다. 이 메서드는 JavaScript의 match 메서드를 기반으로 하며 2가지 "모드"를 가집니다.
이 메서드에 인수가 2개 주어지면, 다음 JavaScript 표현식과 동일합니다:text.match(new RegExp(regex))선택적 매개변수인 modifiers가 제공되면, 이 메서드는 다음 JavaScript 표현식과 동일합니다:text.match(new RegExp(regex, modifiers))modifiers는 정규식 검색의 동작을 수정하는 데 사용할 수 있는 플래그입니다.
**REGEX_REPLACE()**텍스트 값에 대한 정규식 일치 결과의 배열을 반환합니다. 지정된 정규식과 수정자를 기반으로 일치 항목을 찾습니다. 이 메서드는 JavaScript의 replace 메서드를 기반으로 합니다.
이 함수에 3개의 인자가 주어지면, 다음 JavaScript 표현식과 동일합니다:text.replace(new RegExp(regex), replacement)
선택적 매개변수인 modifiers가 제공되면, 이 메서드는 다음 JavaScript 표현식과 동일합니다:text.replace(new RegExp(regex, modifiers), replacement)수정자는 정규식 검색의 동작을 수정하는 데 사용할 수 있는 플래그입니다.
문자열 내에서 정규식을 작성할 때는 백슬래시()를 이스케이프 처리해야 합니다. JavaScript는 문자열 리터럴에서 각 백슬래시를 이스케이프 문자로 처리하기 때문입니다.
regex_replace('Hello There', '(\\w+)\\s(\\w+)', '$2 $1')이 표현식은 "There Hello"를 출력합니다.
{{snippet.원하는 정보를 찾으셨나요?}}