日付変数の算術と書式設定

さまざまな日付変数によって、日付を移動または日付の表示方法を変更できます。たとえば、{cardduedate} のような変数の値を使用する際は、値を数日または数週間シフトまたは GMT などの別のタイムゾーンで表示することをお勧めします。

この記事で説明されているすべての操作は、日付と期限付き変数、カスタム フィールド変数 ([日付] タイプのカスタム フィールド内) で使用できます。

日付変数の値への加算または減算

日付変数の次の値を加/減算できます。

日付値の一部を変更

週の日付、月の日付などを使用して日付値の部分を変更、または両方の調整操作を組み合わせられます。

週の曜日を変更する

週の曜日を変更するには、wd 値に続けて平日の日数を使用します。

例：

• {date=0wd} は今週の日曜日です。

• {date=1wd} は今週の月曜日です。

月の日付を変更する

月の日数を変更するには、d 値に続けて日数を使用します。 

例:

• {date=1d} は今月の最初の日です。

• {date=15d} は今月の 15 日目です。

• {date=31d} は月の長さにかかわらず今月の最終日です。

週と日の調整を組み合わせる

日付を調整するには、週の曜日 (wd) と月の日数 (d) の両方を変更できます。

例:  

• {date-1w=1wd} は先週の月曜日です。

• {date+3m=31d} は、今から 3 か月後の月末日です。

タイムゾーンの変更

自動化は、PST、EDT、GMT などのタイムゾーン仕様の一般的な略称をサポートしています。 

{{%Start Date}@HKT} (香港時間) のような短いタイムゾーン名、または {date@Australia/Sydney} のような完全なタイムゾーン名を指定できます。タイムゾーンのフルリストは Wikipedia 記事でご確認いただけます。

また、タイムゾーンの変更を調整操作と組み合わせられます。たとえば、{cardduedate+5wd@PST} は現在から 5 営業日後の太平洋標準時の日付です。

日付値のフォーマット

また、日付の値は ~ の後にパターンを指定してフォーマットできます。フォーマット仕様は moment.js ライブラリに従います。

例: 

パターン {date~dddd, MMMM Do YYYY, h:mm:ss a} では、日付の形式 Thursday, May 31st 2018, 12:00:00 am のようになります。

moment.js ライブラリのフォーマットは、リスト名またはカード名を生成する必要がある場合に特に役立ちます。 

例: 

when custom field "Start Date" is set by anyone, move the card to list "Week {{%Start Date}=1wd~MMM D} - {{%Start Date}=5wd~MMM D}" 

この自動化は、カスタム フィールド [開始日] の値に応じてカードをリストに自動で移動します。(存在しない場合は) リストが自動で作成されて名前は「Week May 28th - Jun 1st」のようにフォーマットされます。

ネストされたカスタム フィールド変数 (詳細)

カスタム フィールドの値によって、日付の算術演算またはフォーマット操作のパラメーターを指定できます。例: {{%Start Date}+wd@。