関数の基本

Notionの関数は、既存のデータベースプロパティに対して計算を実行し、データの理解を深めるのに役立ちます。

関数を作成するには、まずNotionデータベースに関数プロパティを追加します。

• データベースの ••• メニューをクリックします。

• プロパティ を選択して ＋新しいプロパティ をクリックします。

• 関数 を選択します。

• 編集 をクリックして関数の作成を開始します。

基本的なプログラミングの経験がある方には、Notionの関数エディタと構文は馴染み深く感じられるでしょう。関数（実行する操作）と 入力値（操作するデータのプロパティ）を選択すると、関数プロパティに 出力（結果）として表示され、新しい行を作成するたびに自動で計算されます。

関数の一例として、dateSubtract(prop("Date"), 14, "days") を解説します。

• 関数はdateSubtract()です。

• dateSubtract() には、日付、数値、および "days"、"hours" などの単位を表す文字列を引数として設定します。

• 入力値は、Date（日付形式のプロパティ）、14（数値）、"days"（時間の単位）です。

• こうすると、 Date プロパティに入力された値の14日前を表す日付が出力されます。

Notionの数式エディタには、数式の作成を支援するための補助機能があります。

• エディタは数式の内容に基づいて、関数機能またはプロパティの提案を自動的にサジェストします。

  • サジェストのパネルは矢印キーの 上/下 でナビゲートし、 Enter で項目を選択できます。

• 長い関数はエディターの幅上限に達すると折り返されますが、Shift + Enter で改行することもできます。

  • 行を移動するには、 alt/option +上/下を使用します。

• データベース行でエディタを開くと、その行の関数の出力結果がライブプレビューで表示されます。

  • 結果のプレビューに改行を適用するには、数式で改行したい位置に "\n" と記載します。（例： "Hello" + "\n" + "World"）

• エディタにはエラーが表示され、問題のあるコードが強調表示されるため、問題の原因をより適切に特定できます。

関数は、さまざまなデータ型を操作して返すことができます。他のプロパティ型もサポートされていますが、データ型は変換されます。

• テキスト

  • 例："Hello world"

• 数値

  • 例： 1、-2.5

  • 関数プロパティの書式設定オプションを使用した表示ができます。（例：パーセンテージや通貨として表示、またリングやバーを追加して表示するなど）

• 日付

  • 時刻付きの日付（2023年8月29日 午後1時33分など）として表示され、 dateFormat() 関数を使用してテキストに再フォーマットできます。

  • 日付は日付範囲にすることができ、 dateRange() 関数を使用して構築できます。

  • 日付には秒またはミリ秒の情報を含むことができません。

• ユーザー

  • name() または email() を使用すると、任意のユーザープロパティからデータを取得できます。

  • ユーザー名と画像が表示されます。

• ブーリアン

  • true または false となります。

  • チェックがオンまたはオフになったチェックボックスとして表示されます。

• ページ

  • リレーションのようなNotionのページを表します。

  • ページ名に . を組み合わせ、特定の Notion ページのプロパティを取得できます。

  • ページのアイコンを含むページリンクとして表示されます。

• リスト（配列、アレイ）

  • リストには、リストを含む任意の種類のアイテムを保持できます。

  • at()、filter()、map() などのリスト関数を使用してリストを操作できます。

  • リストアイテムは、テキスト、数値、および日付の場合はコンマで区切って表示されます。ユーザー、チェックボックス、およびページの場合は、スペースで区切って表示されます。