自動化の基本
Atlassian Cloud 製品における自動化の一般的なコンセプトとベスト プラクティスを説明します。
日付と時間の各フィールドにアクセスして形式を設定するには、次のスマート バリューを利用します。
Jira Automation テンプレート ライブラリでスマート バリューを使用する方法をご確認ください。
これらのスマート バリューの他の使用例については、「スマート バリューを使用した日付の操作とフォーマット」を参照してください。
現在の日付と時刻を UTC+00:00 で返します。
{{now}} の例
現在の日時が 2020 年 8 月 18 日 2:40am UTC である場合:
1
2
3
4
5
{{now}}
// returns
2020-08-18T02:40:37.0+0000
提示した日時をユーザーが選択した形式で返します。日付の初期設定出力 (jiraDateTime) を読みやすいフォーマットに変換するのに便利です。このページに掲載されているすべての日付スマート バリューの末尾に日付フォーマットを追加できます。
以下はフォーマットの一覧です。
形式 | 1979 年 11 月 1 日木曜日 6:23:12 AM UTC |
---|---|
初期設定 (指定なし) | 1979-11-01T11:23:12.0+0000 |
jiraDate | 1979-11-01 |
jiraDateTime | 1979-11-01T06:23:12.0-0500 |
jqlDate | 1979-11-01 |
jqlDateTime | 1979-11-01 06:23 |
shortDate | 11/1/79 |
shortTime | 6:23 AM |
shortDateTime | 11/1/79 6:23 AM |
mediumDate | Nov 1, 1979 |
mediumTime | 6:23:12 AM |
mediumDateTime | Nov 1, 1979 6:23:12 AM |
longDate | November 1, 1979 |
longTime | 6:23:12 AM EST |
longDateTime | 1979 年 11 月 1 日 6:23:12 AM UTC |
fullDate | Thursday, November 1, 1979 |
fullTime | 6:23:12 AM EST |
fullDateTime | 1979 年 11 月 1 日 (木) 6:23:12 AM 世界協定時刻 |
format("<パターン>") 例: format("dd/MM/yyyy") パターンの構文については、「Java ドキュメント」を参照してください。 | 01/11/1979 |
{{[date].[dateformat]}} の例
1
2
3
4
5
{{now.jiraDate}}
//returns
2020-08-18
1
2
3
4
5
This issue was created on {{issue.created.format("dd/MM/yyyy")}}
//returns
This issue was created on 18/08/2020
1
2
3
4
5
This issue was updated at {{issue.updated.shortTime}}.
//returns
This issue was updated at 2:40 AM.
指定した単位で date1 から date2 までの時間数を返します。date2 が date1 より前の場合、返される値は負になります。
このスマート バリューと一緒に使用できる単位は以下のとおりです。
millis
秒
minutes
時
days
weeks
月
年
businessDays
以下を使って出力のフォーマットを変更することもできます。
prettyPrint - 単語間の差分を表示します (例: 2 日 3 時間)。
abs - 正の数字で値を返します。
{{[date1].diff([date2]).[unit]}} の例
4 週間前に作成された課題の場合は、次のようになります。
1
2
3
4
5
{{now.diff(issue.created).weeks}}
//returns
-4
1
2
3
4
5
This issue was created {{now.diff(issue.created).weeks.abs}} weeks ago.
//returns
This issue was created 4 weeks ago.
date1 が date2 より後になっている場合は true を返し、そうでない場合は false を返します。
{{[date1].isAfter([date2])}} の例
1
2
3
4
5
{{now.isAfter(issue.created)}}
//returns
true
date1 が date2 より前になっている場合は true を返し、そうでない場合は false を返します。
{{[date1].isBefore([date2])}} の例
1
2
3
4
5
{{now.isBefore(issue.created)}}
//returns
false
date1 と date2 が同じ場合は true を返し、そうでない場合は false を返します。
{{[date1].isEquals[(date2)]}} の例
1
2
3
4
5
{{issue.updated.isEquals(issue.created)}}
//returns
false
date1 と date2 を比較してどちらの日付が先かを確認します。以下を返します。
date1 が date2 より前の場合は <0
date2 が date1 より前の場合は >0
2 つの日付が同じ場合は 0
{{[date1].compareTo([date2])}} の例
1
2
3
4
5
{{issue.duedate.compareTo(now)}}
//returns
<0 or >0
1
2
3
4
5
{{now.compareTo(now)}}
//returns
0
指定された日付と時刻を取って、指定された単位の数値を追加して、結果の日付と時刻を返します。使用できる単位:
millis
秒
分
時
日
週
月
年
BusinessDays (営業日は月曜日から金曜日の 9 - 18 時とします)
{{[date].plus[Unit]([number])}} の例
1
2
3
4
5
{{sprint.startDate.plusDays(14)}}
//returns
2020-08-20T23:27:54.2+0000
{{now}} の現在の値が 2020-08-20T13:12:03.1+0000 の場合:
1
2
3
4
5
{{now.plusHours(1).shortTime}}
//returns
2:12 PM
1
2
3
4
5
{{now.plusWeeks(3)}}
//returns
2020-09-10T13:12:03.1+0000:
"日時" カスタム フィールドでは、次の単位を使用する必要があります。
millis
秒
分
時
指定された日付と時刻を取って、指定された単位の数値を抽出して、結果の日付と時刻を返します。使用できる単位:
millis
秒
分
時
日
週
月
年
BusinessDays (営業日は月曜日から金曜日の 9 - 18 時とします)
{{[date].minus[Unit]([number])}} の例
1
2
3
4
5
{{now.minusDays(5)}}
//returns
2020-08-20T23:27:54.2+0000
1
2
3
4
5
{{now.minusWeeks(7)}}
//returns
2020-07-02T13:12:03.1+0000:
1
2
3
4
5
{{now.minusHours(5).shortTime}}
//returns
8:12 AM
指定された日付を取って、次の営業日を返します。指定した日付が営業日の場合は、指定した日付が返されます。
{{[date].toBusinessDay}} の例
{{now}} の値が 2020-08-30T23:36:28.7+0000 の場合:
1
2
3
4
5
{{now.toBusinessDay}}
//returns
2020-08-31T23:36:28.7+0000
指定された日付を取って、前の営業日を返します。
{{[date].toBusinessDayBackwards}} の例
{{now}} の値が 2020-08-30T23:36:28.7+0000 の場合:
1
2
3
4
5
{{now.toBusinessDayBackwards}}
//returns
2020-08-28T23:36:28.7+0000
指定された時刻を取って、その時刻を指定されたタイム ゾーンに(変換ではなく) 設定します。つまり、同じ時間が表示されますが、タイムゾーンだけが変わります。タイムゾーンに利用できる入力はこちらで確認できます (「Canonical ID」列を参照)。
{{now}} の値が 2020-08-30T03:17:06.2+0000 の場合:
1
2
3
4
5
{{now.setTimeZone("Australia/Sydney")}}
//returns
2020-08-30T03:17:06.2+1000
指定された時刻を取って、指定されたタイム ゾーンでその時刻を変換します。タイムゾーンに利用できる入力はこちらで確認できます (「Canonical ID」列を参照)。
{{[date].convertToTimeZone([timezone])}} の例
{{now}} の値が 2020-08-30T03:17:06.2+0000 の場合:
1
2
3
4
5
{{now.convertToTimeZone("Australia/Sydney").shortTime}}
//returns
1:17 PM
指定された日付を取って、時刻コンポーネントを使って日付に変換します。
日付と時刻の変換例
1
2
3
4
5
6
{{now.toStartOfDay}}
{{now.toCurrentTime}}
{{now.toDateTimeAtStartOfDay}}
{{now.toDateTimeAtStartOfDay(timezone)}}
{{now.toDateTimeAtCurrentTime}}
{{now.toDateTimeAtCurrentTime(timezone)}}
指定された日付と時刻を取って、同じ日付と時刻を返しますが、日付は入力された日付に設定されます。
{{[date].withDayOfMonth([date])}} の例
{{now}} の値が 2020-08-30T03:17:06.2+0000 の場合:
1
2
3
4
5
{{now.withDayOfMonth(15)}}
// returns
2020-08-15T03:17:06.2+0000:
日付を次の当該曜日に設定します。既にその曜日である場合は、翌週の曜日を返します。使用できる値は MON、TUE、WED、THU、FRI、SAT、SUN です。
{{[date].withNextDayOfWeek(["day"])}} の例
1
{{now.withNextDayOfWeek("TUE")}} will return the next Tuesday.
指定された日付と時刻を取って、属性に記載された形式に日付または時刻を設定します。
millis
second
分
時間
日
monthOfYear
年
dayOfYear
dayOfWeek
dayOfWeekName
dayOfWeekShortName
weekOfYear
weekOfYearISO
zoneId
toDays
isLeapYear
lengthOfMonth
lengthOfYear
timeZoneShort
timeZoneFull
timeZoneNarrow
offsetShort
offsetFull
offsetNarrow
{{[date].with[attribute](input)}} の例
{{now}} の値が 2020-08-30T03:17:06.2+0000 の場合:
1
2
3
4
5
{{now.withYear(2005)}}
//returns
2005-08-30T03:17:06.2+0000
1
2
3
4
5
{{now.withDayOfYear(355)}}
//returns
2020-12-20T03:17:06.2+0000
1
{{now.withNextDayOfWeek("MON").withHour(14).withMinute(0)}} will return the next Monday at 2pm
指定された日付を取り、入力されたものにコンポーネントが設定された日とともに返します。
月末の日時を返します。
1
{{now.endOfMonth}}
月初めの日時を返します。
1
{{now.startOfMonth}}
その年の週を西洋のトラディショナル形式で返します。
1
{{now.weekOfYear}}
年の週を ISO の週/日付形式で返します。
1
{{now.weekOfYearIso}}
その月の最初の営業日を返します。営業日は月曜日から金曜日の 9 - 18 時とします。
1
{{now.firstBusinessDayOfMonth}}
当該月の最終営業日を返します。営業日は月曜日から金曜日の午前 9 時から午後 6 時までです。
1
{{now.lastBusinessDayOfMonth}}
指定された日付を取り、その月で最初に指定された曜日を返します。次の入力は次の曜日に対応します。
1 - 月曜日
2 - 火曜日
3 - 水曜日
4 - 木曜日
5 - 金曜日
6 - 土曜日
7 - 日曜日
{{now}} の値が 2020-09-01T03:17:06.2+0000 の場合、{{now.firstOfTheMonth(1)}} は 2020 年 9 月の最初の月曜日を返します。
1
2
3
4
5
{{now.firstOfTheMonth(1)}}
//returns
2020-09-07T03:17:06.2+0000
指定された日付を取り、その月の最後の曜日を返します。次の入力は次の曜日に対応します。
1 - 月曜日
2 - 火曜日
3 - 水曜日
4 - 木曜日
5 - 金曜日
6 - 土曜日
7 - 日曜日
{{now}} の値が 2020-09-01T03:17:06.2+0000 の場合、{{now.lastOfTheMonth(5)}} は 2020 年 9 月の最後の金曜日を返します。
1
2
3
4
5
{{now.lastOfTheMonth(5)}}
//returns
2020-09-25T03:17:06.2+0000
指定された日付を取り、その月の n 番目の曜日であるかを返します。{{now}} の値が 2020-09-01T03:17:06.2+0000 の場合、{{now.OfTheMonth(2, 1)}} は 2020 年 9 月の第 2 月曜日を返します。
1
2
3
4
5
{{now.ofTheMonth(2, 1)}}
//returns
2020-09-14T03:17:06.2+0000
この内容はお役に立ちましたか?