Formula 2.0 の変更点

1. フォーミュラエディタが改良され、執筆と編集が簡単になりました。

プロパティはこれまで prop("日付") のように記述していましたが、エディタ内での選択制になり図のように 日付 のように灰色背景で表示されるようになりました。

キーボードの矢印キー(↑↓)はこのプロパティなどの選択を切り替える機能に割り当たっています。エディタ内で上下移動する場合には、Option/Alt キーを押しながら矢印キー(↑↓)を押してください。

より多くのユースケースをフォーミュラでサポートするために、製品の改良が行われています。

型	内容	対応するプロパティ
Text	テキスト	Title, Text, Select, Email, URL, Phone number, ID
Number	数値	Number, Rollup (Number)
Date	日付・日付範囲	Date, Created Time, Last Edited Time, Rollup (Date)
People	人	Created by, Last Edited by
Boolean	true か false	Checkbox
Page	ページ	ㅤ
List (array)	上のものの配列 (異なる型は同居できない)	Multi-Select (List of Text), Person (List of People), Relation (List of Page), Rollup (List of any type)

例: relation.map(currentValue.number_property).sum(): リレーション relation に登録されるているページ群を number_property の値に変換した上で合計します。

例: unc(obj, arg1, arg2) → obj.func(arg1, arg2)

これによりこれまでのような括弧の対応を探す作業がなくなります。

Formula 2.0 の関数一覧は以下の通りです。ページ内に具体的な使い方も書いてあります。

現在わかっている Formula 1.0 との非互換部分は以下のとおりです。ただし、多くのものは自動的に変換されます。

プロパティは prop("プロパティ名") のように記述していましたが、リストからの選択制になりました。内部的にはプロパティ ID などが記録されていると思われます。テキストなどにコピーすると以前のように prop("プロパティ名") のように書き出され、逆にペーストするとプロパティが選択された状態になります(これはアンバサダーからの強い要望で入りました)。

month 関数はこれまで 0-11 の値が返ってきましたが、わかりにくかったので Formula 2.0 では 1-12 の値が返ってくるようになりました。これまでのスクリプトは自動的に month(xxx) - 1 に書き変わります。

day 関数も 0-6 の値が返ってきましたが、1-7 に変更になっています。こちらは日曜日が 0 から 7 に変更になっています。これまでのスクリプトは自動的に day(xxx) % 7 に置き換わります。

slice 関数は文字列の部分文字列を取得する関数でしたが、Formula 2.0 ではリストの部分リストを取得する関数になりました。これまでの slice の機能は substring となります。これまで作成した Formula は自動的に substring に書き変わります。

e や pi は定数ではなく関数になりました。e() や pi() のように書く必要があります。これまで作成した Formula は自動的に e() やpi() に書き変わります。

上記変換で変わるものをまとめてみました。当初、add, sub などの演算子のある関数は削除されていたのですが、アンバサダーの要望により後方互換性のために復活しました。Notion としては演算子の方に移行してほしいようで、変換は残ったままです。

Formula 2.0 で追加された便利な関数は以下のとおりです。

📓
parseDate : 文字列から日付を作成できます。これまで dateAdd や dateSubtract 関数で無理やり作成していた日付関係の作成系の小細工は必要なくなりました。

📓
let,
📓
lets : 計算した値を変数として一時保持できます。以下のフォーミュラは values で与えられた数値リストを並び替えて、最大値と最小値を取り除いたものを mid という変数に一時保存しています。その後、そのリストの合計と個数を計算して割り算することで、最大・最小を取り除いた平均 (オリンピックなどの採点競技などでよく使われる中央だけの平均値)を計算できます。