メインコンテンツにスキップ
お客さまへの大切なお知らせ:膨大なサポート情報を少しでも早くお客さまにお届けするため、本コンテンツの日本語版は人間の翻訳者を介さない自動翻訳で提供されております。正確な最新情報については本コンテンツの英語版をご覧ください。

カスタム式関数

更新日時 2024年 11月 14日

以下の 製品でご利用いただけます(別途記載されている場合を除きます)。

Operations Hub   Professional , Enterprise

カスタム式を使用してワークフローのデータの形式を設定する場合、登録済みレコードのプロパティー値または以前のアクションからの出力で関数を使用して、複雑な式を作成できます。 

以下のさまざまな関数を確認して、使用する関数を決定してください。 

関数 説明
abs 数値の絶対値を取得します。この関数を使用して、正の数値を取得できるようにします。
  • 式の例:abs([数値または数値のプロパティー])
    • 例:abs(-10)
    • 出力例:10
add 1つの数値を別の数値に加算します。この関数は+演算子と同じです。次のパラメーターと使用します。
  • number:演算の最初の数値。
  • number to add:最初の数値に加算する数値。 
  • 式の例: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 文字列の最初の文字を大文字にします。最初の文字が大文字になり、その他の文字は全て小文字になります。入力に含まれる他の単語は、最初の文字が大文字になりません。
  • 式の例: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'Unicode 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:除算の対象となる数値。 
  • divisor:除算演算子で除算する数値。 
  • 式:divide(number, divisor)
    • 例:divide (8, 4)
    • 出力例:2

または、以下を使用することもできます。 

  • 式:number/divisor
    • 例:8/4
    • 出力例:2
divisible 数値が均等に分割できるかテストします。余りがない場合、この関数はtrueと評価します。余りがある場合、この関数はfalseと評価します。次のパラメーターと使用します。
  • number:除算の対象となる数値。 
  • divisor:除算演算子で除算する数値。 
  • 式:divisible(number, divisor)
    • 例:divisible (5,2)
    • 出力例:false
join 各値の間に区切り文字を使用して、2つ以上の文字列を1つの結果文字列に結合します。この関数は、カスタムモードで[データを書式設定]アクションを使用する場合のみ利用できます。

次のパラメーターを使用します。
  • delimiter:各項目間に挿入される区切り文字列。
  • items:結合する任意の数の文字列。 
  • 式: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 文字列内の全ての文字を小文字に変換します。
  • 式: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")
    • 出力例:04/11/2020
multiplier 1つの値を数値で乗算します。この関数は、*演算子の代わりになります。次のパラメーターと使用します。
  • number:乗算の対象となる数値。
  • multiplier:乗算する数値。 
  • 式: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")
    • 出力例:06/11/2020


randomNumber 範囲内の乱数を生成します。

この関数を使用すると、繰り返される可能性があるランダムな数値が生成されます。例えば、1から3の範囲を使用して3件のコンタクトを登録した場合、3つの一意の番号を取得できない可能性があります。

最小数と最大数の両方が範囲に含まれます。範囲を設定する際に、0と負の数を使用することもできます。 
  • 式:randomNumber(minimum, maximum)
    • 例:randomNumber(1, 3)
    • 出力例:1または2
replace 全ての部分文字列を別の文字列に置換します。次のパラメーターと使用します。
  • 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:端数処理する小数点。 
  • rounding method:最も近い整数に切り上げまたは切り下げます。次の丸め処理を使用できます。 
    • common
    • ceil
    • floor
  • 式:round(number, precision, rounding method)
    • 例:round(52.5, 0, 'floor')
    • 出力例:52
striptags SGML/XMLタグを除去して、隣接する空白を1つのスペースで置換します。このフィルターは、変数内の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 日時オブジェクトをUnixタイムスタンプに変換します。
  • 式:unixtimestamp([dateteime])
    • 例:unixtimesstamp([closedate])
    • 出力例:1652863824
upper 全ての文字を大文字に変更します。
  • 式:upper([string])
    • 例:upper("teatime")
    • 出力例:TEATIME
urlencode UTF-8形式を使用して文字列をエスケープおよびURLエンコードします。
  • 式:urlencode([string])
    • 例:urlencode("hi there")
    • 出力例:hi%20there
この記事はお役に立ちましたか?
こちらのフォームではドキュメントに関するご意見をご提供ください。HubSpotがご提供しているヘルプはこちらでご確認ください。