以前は、 equals, after, before, on_or_after, and on_or_before などの日付のフィルタに使えたのは、時間を含まない日付だけだった。

{
    "filter": {
        "or": [
            {
                "property": "My Time Property",
                "date": {
                    "before": "2021-10-20"
                }
            }
        ]
    },
    "sorts": []
}

現在は、ISO 8601 の日付フォーマットを受け付けるようになった。

{
    "filter": {
        "or": [
            {
                "property": "My Time Property",
                "date": {
                    "before": "2021-10-15T12:00:00-07:00"
                }
            }
        ]
    },
    "sorts": []
}

<aside> 💡 日付と時間の比較方法 時刻の比較はミリ秒の精度で行われる。タイムゾーンが無指定の場合には、UTCとなる。

</aside>

<aside> 💡 日付の equal filter について 時間が指定されていない場合の equals の場合、比較は UTC 時間の開始時刻と終了時刻で行われる。時刻が設定されているときには、比較はミリ秒精度で行われる。タイムゾーンが指定されていない場合には、UTC が用いられる。

</aside>


Notion API Changelog まとめ