Jira スマート バリュー - 日時

日付と時間の各フィールドにアクセスして形式を設定するには、次のスマート バリューを利用します。 

Jira Automation テンプレート ライブラリでスマート バリューを使用する方法をご確認ください。

これらのスマート バリューの他の使用例については、「スマート バリューを使用した日付の操作とフォーマット」を参照してください。

現在の日付と時刻 {now}

現在の日付と時刻を UTC+00:00 で返します。

{{now}} の例

現在の日時が 2020 年 8 月 18 日 2:40am UTC である場合:

1 2 3 4 5 {{now}} // returns 2020-08-18T02:40:37.0+0000

日付形式 {[date].[dateformat]}

提示した日時をユーザーが選択した形式で返します。日付の初期設定出力 (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 EST

fullDate

Thursday, November 1, 1979

fullTime

6:23:12 AM EST

fullDateTime

1979 年 11 月 1 日 6:23:12 AM EST

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].diff([date2]).[unit]}

指定した単位で date1 から date2 までの時間数を返します。date2date1 より前の場合、返される値は負になります。

このスマート バリューと一緒に使用できる単位は以下のとおりです。

  • 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].isAfter([date2])}

date1date2 より後になっている場合は true を返し、そうでない場合は false を返します。

{{[date1].isAfter([date2])}} の例

1 2 3 4 5 {{now.isAfter(issue.created)}} //returns true

前の日付 {[date1].isBefore([date2])}

date1date2 より前になっている場合は true を返し、そうでない場合は false を返します。

{{[date1].isBefore([date2])}} の例

1 2 3 4 5 {{now.isBefore(issue.created)}} //returns false

同じ日付 {[date1].isEquals[(date2)]}

date1date2 が同じ場合は true を返し、そうでない場合は false を返します。

{{[date1].isEquals[(date2)]}} の例

1 2 3 4 5 {{issue.updated.isEquals(issue.created)}} //returns false

日付比較 {[date1].compareTo([date2])}

date1date2 を比較してどちらの日付が先かを確認します。以下を返します。 

  • date1date2 より前の場合は <0

  • date2date1 より前の場合は >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

日付プラス単位 {[date].plus[Unit]([number])}

指定された日付と時刻を取って、指定された単位の数値を追加して、結果の日付と時刻を返します。使用できる単位:

  • 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


日付マイナス単位 {[date].minus[Unit]([number])}

指定された日付と時刻を取って、指定された単位の数値を抽出して、結果の日付と時刻を返します。使用できる単位:

  • 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}

指定された日付を取って、次の営業日を返します。指定した日付が営業日の場合は、指定した日付が返されます。

{{[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}

指定された日付を取って、前の営業日を返します。

{{[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

タイムゾーンの日付を設定 {[date].setTimeZone([timezone])}

指定された時刻を取って、その時刻を指定されたタイム ゾーンに(変換ではなく) 設定します。つまり、同じ時間が表示されますが、タイムゾーンだけが変わります。タイムゾーンに利用できる入力はこちらで確認できます (「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

タイムゾーンの日付を変換 {[date].convertToTimeZone([timezone])}

指定された時刻を取って、指定されたタイム ゾーンでその時刻を変換します。タイムゾーンに利用できる入力はこちらで確認できます (「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])}

指定された日付と時刻を取って、同じ日付と時刻を返しますが、日付は入力された日付に設定されます。

{{[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:

翌日の曜日 {[date].withNextDayOfWeek(["day"])}

日付を次の当該曜日に設定します。既にその曜日である場合は、翌週の曜日を返します。使用できる値は MON、TUE、WED、THU、FRI、SAT、SUN です。

{{[date].withNextDayOfWeek(["day"])}} の例

1 {{now.withNextDayOfWeek("TUE")}} will return the next Tuesday.

属性付き日付 {[date].with[attribute](input)}

指定された日付と時刻を取って、属性に記載された形式に日付または時刻を設定します。

利用できる属性

  • millis

  • second

  • 時間

  • monthOfYear

  • dayOfYear

  • dayOfWeek

  • dayOfWeekName

  • dayOfWeekShortName

  • weekOfYear

  • 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

日付の曜日コンポーネントを設定します

指定された日付を取り、入力されたものにコンポーネントが設定された日とともに返します。

月末 {[date].endOfMonth}

月末の日時を返します。

1 {{now.endOfMonth}}

月初 {[date].startOfMonth}

月初めの日時を返します。

1 {{now.startOfMonth}}

最初の営業日 {[date].firstBusinessDayOfMonth}

その月の最初の営業日を返します。営業日は月曜日から金曜日の 9 - 18 時とします。

1 {{now.firstBusinessDayOfMonth}}

最終の営業日 {[date].lastBusinessDayOfMonth}

当該月の最終営業日を返します。営業日は月曜日から金曜日の午前 9 時から午後 6 時までです。

1 {{now.lastBusinessDayOfMonth}}

月の最初の日 {[date].firstOfTheMonth(input)}

指定された日付を取り、その月で最初に指定された曜日を返します。次の入力は次の曜日に対応します。

  • 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

月の最期の日 {[date].lastOfTheMonth(input)}

指定された日付を取り、その月の最後の曜日を返します。次の入力は次の曜日に対応します。

  • 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 番目の日 {[date].OfTheMonth(n, day)}

指定された日付を取り、その月の 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

その他のヘルプ