콘텐츠로 건너뛰기
주의:: 이 문서는 사용자의 편의를 위해 제공됩니다. 이 문서는 번역 소프트웨어를 사용하여 자동으로 번역되었으며 교정을 거치지 않았을 수 있습니다. 이 문서의 영어 버전이 가장 최신의 정보를 확인할 수 있는 공식 버전으로 간주해야 합니다. 여기에서 액세스할 수 있습니다..

워크플로우에서 데이터 서식을 지정할 때는 사용자 정의 수식 함수를 사용하세요

마지막 업데이트 날짜: 2026년 8월 3일

명시된 경우를 제외하고 다음 구독 중 어느 것에서나 사용할 수 있습니다.

워크플로우에서 사용자 지정 수식을 사용하여 데이터 서식을 지정하는 경우, 등록된 레코드의 속성 값이나 이전 작업의 출력값을 함수에 활용하여 복잡한 수식을 만들 수 있습니다.

이러한 함수는 계산 속성에는 적용되지 않습니다. 계산 속성에 대한 연산자, 함수 등을 확인하려면 사용자 지정 방정식 계산 속성 만들기에 대해 알아보십시오. 

 

권한 필요 워크플로 도구를 사용하려면 슈퍼 관리자 또는 워크플로 권한이 필요합니다.


아래의 다양한 함수를 검토하여 어떤 함수를 사용할지 결정하십시오: 

함수 설명 예시
abs 숫자의 절댓값을 반환합니다. 이 함수를 사용하여 숫자가 양수인지 확인할 수 있습니다.
  • 예제 수식: abs([숫자 또는 숫자 속성])
    • 예시: abs(-10) 
    • 출력 예시: 10
add 한 숫자 값에 다른 숫자 값을 더합니다. 이 함수는 + 연산자와 동일합니다. 다음과 같이 사용합니다: 
  • number: 연산의 초기 수치 값.
  • 더할 숫자: 초기 숫자 값에 더할 숫자입니다. 
  • 수식 예시: add(number, number to add)
    • 예시: add(5, 10)
    • 예제 결과: 15

또는 다음을 사용할 수도 있습니다:

  • 수식 예시: number + number to add
    • 예시: 5+10
    • 예제 출력: 15
concat 여러 문자열 값을 결합합니다. 이 함수는 사용자 정의 모드에서 ‘데이터 서식 지정’ 작업이 사용될 때만 사용할 수 있습니다. 
  • 수식 예시:concat([string 1], " ", [string 2]) 
    • 예시: concat([company name], " ", [MonthYear])
    • 출력 예시: HubSpot 2006년 6월
대문자 변환 문자열 값의 첫 글자를 대문자로 변환합니다. 첫 번째 문자는 대문자가 되고, 나머지 모든 문자는 소문자가 됩니다. 입력된 다른 단어의 첫 글자는 대문자로 변환되지 않습니다.
  • 수식 예시: capitalize([string])
    • 예시: capitalize([firstname])
    • 예시 출력: Henry
cut 값에서 문자 하나 또는 여러 개를 잘라내어 문자열을 제거합니다. 이 함수는 문자열의 특정 부분을 일치시켜 잘라내는 데 사용할 수 있습니다. 매개변수는 제거할 문자열의 부분을 지정합니다. 다음과 함께 사용하십시오: 
  • source: 문자를 제거할 원본 문자열입니다. 
  • characters_to_cut: 제거할 특정 문자입니다. 이 형식은 대소문자를 구분합니다. 
  • 수식: cut(source, characters to cut)
    • 예시: cut([phone], "-")
    • 예시 출력: 80081234567 


datetimeformat

참고: 이 수식은 더 이상 사용되지 않으며, 아래의 format_datetime 함수로 대체되었습니다. 이 함수를 사용하는 작업은 계속 작동하지만, 앞으로는 새로운 함수를 사용해야 합니다.

 
format_datetime 타임스탬프를 사람이 읽기 쉬운 형식으로 변환합니다. 형식을 구성하려면 타임스탬프 또는 속성과 함께 다음 매개변수를 포함하십시오:
  • format: 사용할 형식입니다. 가능한 값은 'short', 'medium', 'long', 'full' 유니코드 LDML 패턴을 사용하여 사용자 정의 형식을 지정할 수도 있습니다.
  • timeZone: IANA TZDB 형식의 출력 데이터 시간대. 기본적으로 UTC 시간을 반환합니다.
  • locale: 로케일 인식 형식에 사용할 로케일입니다.
  • 수식: format_datetime(date, format, timeZone, locale)
    • 예시: format_datetime([closedate], 'medium', 'America/New_York, 'de-DE')
    • 예시 출력: 08.02.2024, 17:09:49
divide 숫자를 나눕니다. 이 함수는 / 연산자의 대체 기능입니다. 다음과 같이 사용합니다: 
  • number: 나눌 수입니다. 
  • 나누는: 나눗셈 연산에 사용할나눗수입니다
  • 수식: divide(number, divisor)
    • 예시: divide (8, 4)
    • 예시 출력: 2

또는 다음을 사용할 수도 있습니다: 

  • 수식: number/divisor
    • 예시: 8/4
    • 예시 결과: 2
나눗셈 가능 주어진 수가 나눗셈 시 나머지가 없는지 확인합니다. 나머지가 없을 경우 이 함수는 true를 반환합니다. 나머지가 있을 경우 이 함수는 false를 반환합니다. 다음 코드와 함께 사용하십시오: 
  • number: 나눌 수. 
  • 나누는: 나눗셈 연산에 사용할나눗수입니다
  • 수식: divisible(number, divisor)
    • 예시: divisible (5,2)
    • 예시 출력: false
join 두 개 이상의 문자열을 각 값 사이에 구분 기호를 사용하여 하나의 결과 문자열로 결합합니다. 이 함수는 ‘데이터 서식 지정’ 작업이 사용자 정의 모드에서 사용될 때만 사용할 수 있습니다. 

다음과 함께 사용합니다: 
  • 구분 기호: 각 항목 사이에 삽입할 구분 문자열.
  • 항목: 결합할 문자열의 개수는 제한이 없습니다. 
  • 수식: join(delimiter, items)
    • 예시: join("-", "A", "B", "C")
    • 예시 출력: A-B-C
left 문자열 값의 시작 부분부터 해당 문자열 값의 일부를 반환합니다. 이 함수는 사용자 정의 모드에서 ‘데이터 형식’ 작업이 사용될 때만 사용할 수 있습니다.
  • 수식: left(string, length)
    • 예시: left("Maria", "1")
    • 예시 출력: M


length 문자열에 포함된 문자 수를 반환합니다.
  • 수식: length(string)
    • 예시: left("Hello World!")
    • 예제 출력: 12
소문자 문자열의 모든 문자를 소문자로 변환합니다.
  • 함수: lower([string])
    • 예시: lower(["HELLO WORLD"])
    • 예제 출력: hello world
mid 문자열 값에서 지정된 범위의 문자열을 반환합니다. 이 함수는 '데이터 형식 지정' 작업이 사용자 정의 모드에서 사용될 때만 사용할 수 있습니다.
  • 수식: mid(string, start-index, length)
    • 예시: join("abc123", 2, 2)
    • 예제 출력: c1
minus_time 날짜/시간 객체에서 지정된 시간을 뺍니다. 다음과 함께 사용하십시오: 
  • datetime: 시간을 뺄 날짜/시간 객체.
  • diff: 뺄 시간의 양입니다. 
  • timeunit: 뺄 시간의 단위. 다음을 사용할 수 있습니다: 
    • 시간
    • 반일
    • 개월
  • 수식: minus_time(datetime, diff, timeunit)
    • 예시: minus_time([closedate], 2, "days")
    • 예시 출력: 2020년 4월 11일
곱수 값에 숫자를 곱합니다. 이 함수는 * 연산자의 대체 기능입니다. 다음과 함께 사용하십시오: 
  • number: 곱할 숫자.
  • 곱수: 곱할수입니다
  • 수식: multipler(number, multipler)
    • 예시:multiplier(5, 3) 
    • 예시 출력: 15

또는 다음을 사용할 수도 있습니다:

  • 수식: number*multipler
    • 예시: 5*3 
    • 예시 출력: 15
number 문자열을 숫자로 변환합니다.
  • 수식: number(string, default?)
    • 예시: left("36")
    • 예시 출력: 36
plus_time 날짜/시간 객체에 지정된 시간을 더합니다. 다음과 함께 사용하십시오: 
  • datetime: 시간을 더할 날짜/시간 객체.
  • diff: 추가할 시간의 양. 
  • timeunit: 추가할 시간의 단위. 
  • 수식: plus_time(datetime, diff, timeunit)
    • 예시: plus_time([closedate], 2, "days")
    • 예시 출력: 2020년 6월 11일


randomNumber 지정된 범위 내에서 난수를 생성합니다.

이 함수를 사용하면 생성된 숫자는 완전히 무작위이며, 중복될 수도 있습니다. 예를 들어, 1에서 3까지의 범위를 사용하고 3명의 연락처를 등록한 경우, 3개의 서로 다른 숫자가 나오지 않을 수도 있습니다. 

범위에는 최소값과 최대값이 모두 포함됩니다. 범위를 설정할 때 0과 음수도 사용할 수 있습니다. 
  • 수식: randomNumber(minimum, maximum)
    • 예시: randomNumber(1, 3)
    • 예시 출력: 1 또는 2
바꾸기 부분 문자열이 나타나는 모든 부분을 다른 문자열로 대체합니다. 다음 상황에서 사용하십시오: 
  • string: 검색 및 대체할 문자열. 
  • old: 치환할 부분 문자열. 
  • new: 대체할 문자열. 
  • count: 교체할 부분 문자열의 개수입니다. 지정하지 않으면 모든 부분 문자열이 교체됩니다.
  • 수식: replace(string, old, new, count)
    • 예시: replace( "Hello world!", "Hello", "Hi", 1)
    • 예시 출력: Hi world!
right 문자열 값의 끝 부분부터 시작하여 해당 문자열 값의 일부를 반환합니다. 이 함수는 ‘데이터 형식’ 작업이 사용자 정의 모드에서 사용될 때만 사용할 수 있습니다.
  • 수식: right(string, length)
    • 예시: right("abc123", 3)
    • 예제 출력: 123
regex_replace 정규식 패턴을 검색하여 제공된 문자열로 대체합니다. 다음 매개변수와 함께 사용합니다:
  • original_string:검색할 원본 문자열입니다.
  • pattern:일치시킬 정규표현식 패턴입니다. RE2 구문에 대한 정보는 여기에서 확인할 수 있습니다.
  • replacement_string: 패턴과 일치하는 문자를 대체할 문자열입니다.
  • 수식: regex_replace(original_string, pattern, replacement_string)
    • 예시: regex_replace("contact-us-2", "[^a-zA-Z]", "")
    • 예제 출력: contactus
root 숫자의 제곱근을 계산합니다. 선택적으로, 계산할 N제곱근을 지정할 수 있습니다. 다음과 같이 사용합니다:
  • number: 근을 구할 수. 숫자의 제곱근을 계산합니다. 선택적으로, 계산할 N제곱근을 지정할 수 있습니다. 
  • nthRoot: 계산할n제곱근 . 지정하지 않으면 제곱근이 계산됩니다. 
  • 수식: root(number, nthRoot)
    • 예시: root(625, 4)
    • 예시 출력: 5
round 숫자를 지정된 소수 자릿수로 반올림합니다. 다음과 함께 사용하십시오:
  • precision: 반올림할 소수 자릿수. 
  • 반올림 방법: 가장 가까운 정수로 올림 또는 내림합니다. 다음 반올림 방법을 사용할 수 있습니다: 
    • 일반
    • ceil
    • floor
  • 수식: round(number, precision, rounding method)
    • 예시: round(52.5, 0, 'floor')
    • 예제 출력: 52
striptags SGML/XML 태그를 제거하고 인접한 공백을 하나의 공백으로 대체합니다. 이 필터는 변수에서 HTML 태그를 제거하는 데 사용할 수 있습니다.
  • 수식: striptags([string])
    • 예시: striptags(<div><p>Potato</p></div>)
    • 예시 출력: Potato
title 텍스트를 제목 표기법으로 변환합니다. 결과 문자열의 각 단어는 대문자로 시작하고, 나머지 모든 문자는 소문자로 표기됩니다.
  • 수식: title([string])
    • 예시: title("cheddar CHEESE")
    • 출력 예시: Cheddar Cheese
trim 문자열의 앞뒤 공백을 제거합니다.
  • 수식: trim([string])
    • 예시: trim("peach")
    • 예시 출력: peach
unixtimestamp 날짜/시간 객체를 유닉스 타임스탬프로 변환합니다.
  • 수식: unixtimestamp([dateteime])
    • 예시: unixtimesstamp([closedate])
    • 예시 출력: 1652863824
upper 모든 문자를 대문자로 변환합니다.
  • 수식: upper([string])
    • 예시: upper("teatime")
    • 예시 출력: TEATIME
urlencode UTF-8 형식을 사용하여 문자열을 이스케이프하고 URL 인코딩합니다.
  • 함수: urlencode([string])
    • 예시: urlencode("hi there")
    • 예제 출력: hi%20there
이 문서가 도움이 되었나요?
이 양식은 문서 피드백에만 사용됩니다. HubSpot으로 도움을 받는 방법 알아보기.