こんにちは、CX 事業本部製造ビジネステクノロジー部の若槻です。
GitHub Projects では、プロジェクト内のアイテムのフィールドを条件にしてフィルターをしたり、カスタマイズされたビューを作成することができます。
今回は、GitHub Projects の日付関連のフィールドのフィルター方法をまとめてみました。
まとめ
日付関連のフィールドには、既定の last-updated、日付、およびイテレーションの 3 つの種類があります。
last-updated
last-updated は、プロジェクト内のアイテムに既定で備わっているフィールドで、アイテムが最後に更新された日付を示します。
last-updated を使用したフィルターの構文には、以下のようなものがあります。
| 例 | 説明 |
|---|---|
last-updated:7days |
7 日以上前に更新された |
-last-updated:1day |
1 日以内に更新された |
-last-updated:7days |
7 日以内に更新された |
注意点
使える構文は day だけで、week や month は使えません。
日付フィールド
カスタムフィールドとして、フィールドタイプが Data のフィールド（日付フィールド）をプロジェクトに追加することができます。
日付フィールドを使用したフィルターの構文には、以下のようなものがあります。
| 例 | 説明 |
|---|---|
hoge-date:@today |
日付が今日 |
hoge-date:@today..@today+7 |
日付が今日から7日後まで |
hoge-date:>=@today |
日付が今日以降 |
hoge-date:<@today |
日付が昨日以前 |
no:"hoge date” |
日付が未設定 |
hoge-date:>=2024-02-01 |
日付が指定以降 |
hoge-date:2024-01-01..2024-12-31 |
日付が指定期間 |
イテレーションフィールド
カスタムフィールドとして、フィールドタイプが Iteration のフィールド（イテレーションフィールド）をプロジェクトに追加することができます。イテレーションフィールドを使うことにより、アイテムをスクラムイベントなどのイテレーションに関連付けることができます。
| 例 | 説明 |
|---|---|
hoge-iteration:@current |
現在のイテレーション |
hoge-iteration:@previous |
前のイテレーション |
hoge-iteration:@next |
次のイテレーション |
hoge-iteration:@current..@current+3 |
現在から次の3つのイテレーションまで |
hoge-iteration:"hogeIteration 1" |
「hogeIteration 1」のイテレーション |
no:"hoge iteration” |
イテレーションが未設定 |
注意点
ドキュメントには、hoge-iteration:>"hogeIteration 1" のような不等号を使用した「指定のイテレーション以前」の項目を表示する例がありましたが、実際に試してみたところ、Invalid Value というエラーが発生しました。原因は分かりませんでしたが、現時点では不等号を使用したイテレーションのフィルターはできないようです。
おわりに
GitHub Projects の日付関連のフィールドのフィルター方法のまとめでした。
調べてみると結構柔軟なフィルターが可能であることが分かりました。そもそもイテレーションフィールドについては使用可能であること自体知りませんでした。
以上
5
