数式の構文と関数

タイトル

prop("タイトル")prop("タイトル").length()

テキスト

テキスト

prop("テキスト")prop("テキスト").length()

テキスト

セレクト

prop("優先度") == "高"

テキスト

マルチセレクト

prop("タグ").length()prop("タグ").includes("ファイナンス")

テキスト（リスト）

チェックボックス

prop("チェックボックス")
not prop("チェックボックス")

ブール値

メールアドレス、URL、電話番号

!empty(prop("電話番号"))
!empty(prop("メール"))
link("電話する", "tel:" + prop("電話番号"))

テキスト

ユニークID

prop("タスクID").split("-").first() ← Prefix
prop("タスクID").split("-").last() ← ID

テキスト

作成者、
更新者

prop("作成者").name()
prop("作成者").email()

ユーザー

ユーザー

prop("ユーザー")
prop("ユーザー").at(0).name()
prop("ユーザー").map(current.email())

ユーザー（リスト）

日付、
作成日時、
最終更新日時

prop("対応期限") > now()
dateBetween(prop("誕生日"), now(), "days")

日付

数値

prop("数値") / 2
pi() * prop("半径範囲") ^ 2

数値

リレーション

prop("タスク").length()
prop("タスク").filter(current.prop("ステータス") !== "完了")

ページ（リスト）

ロールアップ

prop("購入品目").length()
prop("平均コスト") * 12

数値、日付、または任意の種類のリスト（ロールアップの設定内容により異なります）

数学演算子：+、-、*、%

2 * pi()"hello" + "world"

ブール値：
true、false

truefalse

比較演算子：
==、>、>=、<、<=

123 == 123 = true"Notion" == "モーション" = false

論理演算子：
and、or、not

and:true and false
true && falseand(true, false)
or:true or false
true || falseor(true, false)
not:not true
!true

三項演算子：
? :

X ? Y : Z は if(X, Y, Z) と同様

条件が真の場合は最初の値を返し、それ以外の場合は2番目の値を返します。

if(true, 1, 2) = 1if(false, 1, 2) = 2prop("チェックあり") == true ? "完了" : "未完了"

最初の真の条件に対応する値を返します。これは、入れ子になっている複数のif()文の代わりに使用できます。

ifs(true, 1, true, 2, 3) = 1ifs(false, 1, false, 2, 3) = 3

値が空の場合はtrueを返します。0、""、[]は空とみなされます。

empty(0) = trueempty([]) = true

テキストまたはリストの値の長さを返します。

length("hello") = 5length([1, 2, 3]) = 3

開始インデックス（含む）から終了インデックス（省略可能、含まない）までのテキストのサブ文字列を返します。

substring("Notion", 0, 3) = "Not"substring("Notion", 3) = "ion"

値に検索文字列が存在する場合はtrueを返します。

contains("Notion", "ot") = true

値が正規表現と一致する場合はtrueを返し、それ以外の場合はfalseを返します。

test("Notion", "Not") = truetest("Notion", "\\d") = false

正規表現に一致するすべての一致をリストとして返します。

match("Notion Notion", "Not") = ["Not", "Not"]match("Notion 123 Notion 456", "\\d+") = ["123", "456"]

正規表現の最初の一致を置換値に置き換えます。

replace("Notion Notion", "N", "M") = "Motion Notion"

正規表現のすべての一致を置換値に置き換えます。

replaceAll("Notion Notion", "N", "M") = "Motion Motion" replaceAll("Notion 123", "\\d", "") = "Notion"

テキストを小文字に変換します。

lower("NOTION") = "notion"

テキストを大文字に変換します。

upper("notion") = "NOTION"

テキストを指定された回数だけ繰り返します。

repeat("0", 4) = "0000"repeat("~=", 10) = "~=~=~=~=~=~=~=~=~=~="

ラベルテキストとURLからハイパーリンクを作成します。

link("Notion", "https://notion.so") = "Notion"

/テキストに書式や色を設定します。有効な書式設定スタイルには、"b"（太字）、"u"（下線）、"i"（斜体）、"c"（コード）、"s"（取り消し線）があります。有効な色には、"gray"、"brown"、"orange"、"yellow"、"green"、"blue"、"purple"、"pink"、"red"があります。背景色を設定するには、"_background"を色の末尾に追加します。

style("Notion", "b", "u") = "Notion" style("Notion", "blue", "gray_background")

テキストから書式スタイルを削除します。スタイルが指定されていない場合は、すべてのスタイルが削除されます。

unstyle("Text")unstyle("Text", "b")

文字列としてフォーマットされた値を返します。

format(1234) = "1234"format(now()) = "August 30, 2023 17:55"

2つの数値の和を返します。

add(5, 10) = 155 + 10 = 15

2つの数値の差を返します。

subtract(5, 10) = -55 - 10 = -5

2つの数値の積を返します。

multiply(5, 10) = 505 * 10 = 50

最初の数値を2番目の数値で割った際の余りを返します。

mod(5, 10) = 55 % 10 = 5

基数のべき乗の結果を返します。

pow(5, 10) = 97656255 ^ 10 = 9765625

2つの数値の商を返します。

divide(5, 10) = 0.55 / 10 = 0.5

引数の最小数を返します。

min(1, 2, 3) = 1min([1, 2, 3]) = 1

引数の最大数を返します。

max(1, 2, 3) = 3max([1, 2, 3]) = 3

引数の和を返します。

sum(1, 2, 3) = 6sum([1, 2, 3], 4, 5) = 15

median

引数の中央に来る値を返します。

median(1, 2, 4) = 2
median([1, 2, 3], 4) = 2.5

mean

引数の算術平均を返します。

mean(1, 2, 3) = 2
mean([1, 2, 3], 4, 5) = 3

数値の絶対値を返します。

abs(10) = 10abs(-10) = 10

数値を最も近い整数に四捨五入した値を返します。1つまたは2つの引数をサポートしています。2つの引数を指定する場合、1つ目は値、2つ目は四捨五入する小数点以下の桁数を表します。

round(0.4) = 0round(-0.6) = -1
round(1.234, 0) = 1round(1.234, 2) = 1.23round(1234, -2) = 1200

数値以上の最小の整数を返します。

ceil(0.4) = 1ceil(-0.6) = 0

数値以下の最大の整数を返します。

floor(0.4) = 0floor(-0.6) = -1

数値の正の平方根を返します。

sqrt(4) = 2sqrt(7) = 2.6457513110645907

数値の立方根を返します。

cbrt(9) = 2.080083823051904cbrt(64) = 4

e^xを返します。xは引数、eは自然対数の底であるオイラー数（2.718…）です。

exp(1) = 2.718281828459045exp(-1) = 0.36787944117144233

数値の自然対数を返します。

ln(2.718281828459045) = 1ln(10) = 2.302585092994046

数値の10を底とする対数を返します。

log10(10) = 1log10(100000) = 5

数値の2を底とする対数を返します。

log2(4) = 2log2(1024) = 10

数値が正の場合は1、負の場合は-1、0の場合は0を返します。

sign(-10) = -1sign(10) = 1

円の円周とその直径の比率を返します。

pi() = 3.141592653589793

自然対数の底を返します。

e() = 2.718281828459045

テキストから数値を解析します。

toNumber("2") = 2toNumber(now()) = 1693443300000toNumber(true) = 1

現在の日付と時刻を返します。

now() = @2023年8月30日 午後5時55分

today

現在の日付を時刻なしで返します。

today() = 2024年4月19日

日付の分（0～59）を返します。

minute(parseDate("2023-07-10T17:35Z")) = 35

日付の時間（0～23）を返します。

hour(parseDate("2023-07-10T17:35Z")) = 17

1（月曜日）から7（日曜日）までの日付を返します。

day(parseDate("2023-07-10T17:35Z")) = 1

日付（1～31）から月の日付を返します。

date(parseDate("2023-07-10T17:35Z")) = 10

日付の年のISO週番号（1～53）を返します。

week(parseDate("2023-01-02")) = 1

日付の月（1～12）を返します。

month(parseDate("2023-07-10T17:35Z")) = 7

日付の年を返します。

year(now()) = 2023

日付に時間を追加します。最後の引数は、"years"、"quarters"、"months"、"weeks"、"days"、"hours"、"minutes" のいずれかの単位を指定します。

dateAdd(now(), 1, "日") = @2023年8月31日午後5時55分dateAdd(now(), 2, "months") = @2023年10月30日
午後5時55分dateAdd(now(), 3, "年") = @2026年8月30日午後5時55分

日付から時間を引きます。最後の引数は、"years"、"quarters"、"months"、"weeks"、"days"、"hours"、"minutes" のいずれかの単位を指定します。

dateSubtract(now(), 1, "日") = @2023年8月29日午後5時55分dateSubtract(now(), 2, "月") = @2023年6月30日午後5時55分dateSubtract(now(), 3, "年") = @2020年8月30日午後5時55分

2つの日付の間の時間を返します。最後の引数は、"years"、"quarters"、"months"、"weeks"、"days"、"hours"、"minutes" のいずれかの単位を指定します。

dateBetween(now(), parseDate("2022-09-07"), "日") = 357dateBetween(parseDate("2030-01-01"), now(), "年") = 6

開始日と終了日からなる日付範囲を返します。

dateRange(prop("開始日"), prop("終了日")) = @2022年9月7日 → 2023年9月7日

日付範囲の始めを返します。

dateStart(prop("日付範囲")) = @2022年9月7日dateBetween(dateStart(prop("日付範囲")), dateEnd(prop("日付範囲")), "days") = -365

日付範囲の終わりを返します。

dateEnd(prop("日付範囲")) = @2023年9月7日dateBetween(dateEnd(prop("日付範囲")), dateStart(prop("日付範囲")), "日") = 365

1970年1月1日から経過したミリ秒数を表す、現在のUnixタイムスタンプを返します。

timestamp(now()) = 1693443300000

指定されたUnixタイムスタンプの日付を返します。タイムスタンプは、1970年1月1日から経過したミリ秒数を表します。注： 返される日付は、秒とミリ秒を保持しません。

fromTimestamp(1689024900000) = @2023年7月10日 午後2時35分

カスタムの書式設定文字列を使用して日付の書式を設定します。書式設定文字列には、日付の一部を表す次のテキストを含めることができます。"YYYY" は年、"MM" は月、"DD" は日、"h" は時、"mm" は分です。

formatDate(now(), "MMMM D, Y") = "2023年8月30日"
formatDate(now(), "MM/DD/YYYY") = "08/30/2023"
formatDate(now(), "h:mm A") = "午後5時55分"

formatNumber

"Revenue: " + formatNumber(prop("Number"), "usd", 0).style("green")

ISO8601規格に従って解析された日付を返します。

parseDate("2022-01-01") = @2022年1月1日parseDate("2022-01-01T00:00Z") = @2021年12月31日午後4時00分

ユーザーの名前を返します。

name(prop("作成者"))prop("パイオニア").map(name(current)).join(", ") = "Grace Hopper, Ada Lovelace"

ユーザーのメールアドレスを返します。

email(prop("作成者"))prop("ユーザー").map(email(current)).join(", ")

リスト内の指定したインデックス位置にある値を返します。

at([1, 2, 3], 1) = 2

リストの最初の項目を返します。

first([1, 2, 3]) = 1

リストの最後の項目を返します。

last([1, 2, 3]) = 3

指定した開始インデックス（含む）から終了インデックス（省略可能、含まない）までのリストの項目を返します。

slice([1, 2, 3], 1, 2) = [2]slice(["a", "b", "c"], 1) = ["b", "c"]

複数のリストを連結した結果を返します。

concat([1, 2], [3, 4]) = [1, 2, 3, 4]concat(["a", "b"], ["c", "d"]) = ["a", "b", "c", "d"]

リストを並べ替えられた順序で返します。

sort([3, 1, 2]) = [1, 2, 3]

逆順に並べ替えたリストを返します。

reverse(["野菜", "卵", "ハム"]) = ["ハム", "卵", "野菜"]

各値の間に結合子を配置したリストの値を返します。

join(["a", "b", "c"], ", ") = "a, b, c"join(["dog", "go"], "") = "doggo"

テキスト入力を区切り記号で分割した値のリストを返します。

split("リンゴ,梨,オレンジ", ",") = ["リンゴ", "梨", "オレンジ"]

入力リスト内の一意の値のリストを返します。

unique([1, 1, 2]) = [1, 2]

リストに指定された値が含まれている場合はtrueを返し、それ以外の場合はfalseを返します。

includes(["a", "b", "c"], "b") = trueincludes([1, 2, 3], 4) = false

条件がtrueと評価されたリスト内の最初の項目を返します。

find(["a", "b", "c"], current == "b") = "b"find([1, 2, 3], current > 100) = Empty

条件がtrueであるリスト内の最初の項目のインデックスを返します。

findIndex(["a", "b", "c"], current == "b") = 1findIndex([1, 2, 3], current > 100) = -1

条件がtrueであるリスト内の値を返します。

filter([1, 2, 3], current > 1) = [2, 3]filter(["a", "b", "c"], current == "a") = ["a"]

リスト内のいずれかの項目について、指定した条件を満たす場合はtrueを返し、それ以外の場合はfalseを返します。

some([1, 2, 3], current == 2) = truesome(["a", "b", "c"], current.length > 2) = false

リスト内のすべての項目について、指定した条件を満たす場合はtrueを返し、それ以外の場合はfalseを返します。

every([1, 2, 3], current > 0) = trueevery(["a", "b", "c"], current == "b") = false

入力リスト内のすべての項目に対して数式を実行した結果が入力されたリストを返します。

map([1, 2, 3], current + 1) = [2, 3, 4]map([1, 2, 3], current + index) = [1, 3, 5]

複数のリストのリストを、1つのリストにフラット化します。

flat([1, 2, 3]) = [1, 2, 3]flat([[1, 2], [3, 4]]) = [1, 2, 3, 4]

ページのIDを返します。ページが指定されていない場合は、数式が存在するページのIDを返します。

id()
id(prop("リレーション").first())

両方の値が等しい場合はtrueを返し、それ以外の場合はfalseを返します。

equal(1, 1) = true"a" == "b" = false

両方の値が等しい場合はfalseを返し、それ以外の場合はtrueを返します。

unequal(1, 2) = true"a" != "a" = false

変数に値を代入し、その変数を使用して数式を評価します。

let(person, "タナカさん", "こんにちは、" + person + "！") = "こんにちは、タナカさん！"let(radius, 4, round(pi() * radius ^ 2)) = 50

複数の変数に値を代入し、それらの変数を使用して数式を評価します。

lets(a, "Hello", b, "world", a + " " + b) = "Hello world"lets(底辺, 3, 高さ, 8, 底辺*高さ / 2) = 12

trim

テキストの先頭と末尾から空白を削除します。

" notion ".trim() = "notion"