自動化スマート値 - 日時
スマート値のエントリでは:
‘issue’ refers to a work item. What is a work item?
‘project’ refers to a Jira space. What is a Jira space?
日付と時間の各フィールドにアクセスして形式を設定するには、次のスマート バリューを利用します。
Check out how we use smart values in our Jira automation template library.
For more examples of how these smart values can be used, see Use smart values to manipulate and format dates.
現在の日付と時刻 {now}
現在の日付と時刻を UTC+00:00 で返します。
{now} の例
現在の日時が 2020 年 8 月 18 日 2:40am UTC である場合:
{{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 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") Refer to the Java documentation for pattern syntax. | 01/11/1979 |
{[date].[dateformat]} の例
{{now.jiraDate}}
//returns
2020-08-18This issue was created on {{issue.created.format("dd/MM/yyyy")}}
//returns
This issue was created on 18/08/2020 This issue was updated at {{issue.updated.shortTime}}.
//returns
This issue was updated at 2:40 AM.日付の差分 {[date1].diff([date2]).[unit]}
指定した単位で date1 から date2 までの時間数を返します。date2 が date1 より前の場合、返される値は負になります。
このスマート バリューと一緒に使用できる単位は以下のとおりです。
millis
秒
minutes
時
days
weeks
月
年
businessDays
以下を使って出力のフォーマットを変更することもできます。
prettyPrint - 単語間の差分を表示します (例: 2 日 3 時間)。
abs - returns the value as a positive number.
{[date1].diff([date2]).[unit]} の例
4 週間前に作成された課題の場合は、次のようになります。
{{now.diff(issue.created).weeks}}
//returns
-4This issue was created {{now.diff(issue.created).weeks.abs}} weeks ago.
//returns
This issue was created 4 weeks ago.後の日付 {[date1].isAfter([date2])}
date1 が date2 より後になっている場合は true を返し、そうでない場合は false を返します。
{[date1].isAfter([date2])} の例
{{now.isAfter(issue.created)}}
//returns
true前の日付 {[date1].isBefore([date2])}
date1 が date2 より前になっている場合は true を返し、そうでない場合は false を返します。
{[date1].isBefore([date2])} の例
{{now.isBefore(issue.created)}}
//returns
false同じ日付 {[date1].isEquals[(date2)]}
date1 と date2 が同じ場合は true を返し、そうでない場合は false を返します。
{[date1].isEquals[(date2)]} の例
{{issue.updated.isEquals(issue.created)}}
//returns
false日付比較 {[date1].compareTo([date2])}
date1 と date2 を比較してどちらの日付が先かを確認します。以下を返します。
date1がdate2より前の場合は <0date2がdate1より前の場合は >02 つの日付が同じ場合は 0
{[date1].compareTo([date2])} の例
{{issue.duedate.compareTo(now)}}
//returns
<0 or >0{{now.compareTo(now)}}
//returns
0 日付プラス単位 {[date].plus[Unit]([number])}
指定された日付と時刻を取って、指定された単位の数値を追加して、結果の日付と時刻を返します。使用できる単位:
millis
秒
分
時
日
週
月
年
BusinessDays (営業日は月曜日から金曜日の 9 - 18 時とします)
{[date].plus[Unit]([number])} の例
{{sprint.startDate.plusDays(14)}}
//returns
2020-08-20T23:27:54.2+0000{{now}} の現在の値が 2020-08-20T13:12:03.1+0000 の場合:
{{now.plusHours(1).shortTime}}
//returns
2:12 PM{{now.plusWeeks(3)}}
//returns
2020-09-10T13:12:03.1+0000:"日時" カスタム フィールドでは、次の単位を使用する必要があります。
millis
秒
分
時
日付マイナス単位 {[date].minus[Unit]([number])}
指定された日付と時刻を取って、指定された単位の数値を抽出して、結果の日付と時刻を返します。使用できる単位:
millis
秒
分
時
日
週
月
年
BusinessDays (営業日は月曜日から金曜日の 9 - 18 時とします)
{[date].minus[Unit]([number])} の例
{{now.minusDays(5)}}
//returns
2020-08-20T23:27:54.2+0000{{now.minusWeeks(7)}}
//returns
2020-07-02T13:12:03.1+0000:{{now.minusHours(5).shortTime}}
//returns
8:12 AM翌営業日 {[date].toBusinessDay}
指定された日付を取って、次の営業日を返します。指定した日付が営業日の場合は、指定した日付が返されます。
{[date].toBusinessDay} の例
{{now}} の値が 2020-08-30T23:36:28.7+0000 の場合:
{{now.toBusinessDay}}
//returns
2020-08-31T23:36:28.7+0000前営業日 {[date].toBusinessDayBackwards}
指定された日付を取って、前の営業日を返します。
{[date].toBusinessDayBackwards} の例
{{now}} の値が 2020-08-30T23:36:28.7+0000 の場合:
{{now.toBusinessDayBackwards}}
//returns
2020-08-28T23:36:28.7+0000タイムゾーンの日付を設定 {[date].setTimeZone([timezone])}
Takes a given time, and sets (not converts) that time to the given time zone. i.e.: It prints that same time, but simply changes the timezone. You can find valid inputs for timezones here (see Canonical ID column).
{{now}} の値が 2020-08-30T03:17:06.2+0000 の場合:
{{now.setTimeZone("Australia/Sydney")}}
//returns
2020-08-30T03:17:06.2+1000タイムゾーンの日付を変換 {[date].convertToTimeZone([timezone])}
Takes a given time, and converts it to the time in the given time zone. You can find valid inputs for timezones here (see Canonical ID column).
{[date].convertToTimeZone([timezone])} の例
{{now}} の値が 2020-08-30T03:17:06.2+0000 の場合:
{{now.convertToTimeZone("Australia/Sydney").shortTime}}
//returns
1:17 PM日付から日時への変換
指定された日付を取って、時刻コンポーネントを使って日付に変換します。
日付と時刻の変換例
{{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 の場合:
{{now.withDayOfMonth(15)}}
// returns
2020-08-15T03:17:06.2+0000:翌日の曜日 {[date].withNextDayOfWeek(["day"])}
日付を次の当該曜日に設定します。既にその曜日である場合は、翌週の曜日を返します。使用できる値は MON、TUE、WED、THU、FRI、SAT、SUN です。
{[date].withNextDayOfWeek(["day"])} の例
{{now.withNextDayOfWeek("TUE")}} will return the next Tuesday. 属性付き日付 {[date].with[attribute](input)}
指定された日付と時刻を取って、属性に記載された形式に日付または時刻を設定します。
利用できる属性
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 の場合:
{{now.withYear(2005)}}
//returns
2005-08-30T03:17:06.2+0000{{now.withDayOfYear(355)}}
//returns
2020-12-20T03:17:06.2+0000{{now.withNextDayOfWeek("MON").withHour(14).withMinute(0)}} will return the next Monday at 2pm日付の曜日コンポーネントを設定します
指定された日付を取り、入力されたものにコンポーネントが設定された日とともに返します。
月末 {[date].endOfMonth}
月末の日時を返します。
{{now.endOfMonth}}月初 {[date].startOfMonth}
月初めの日時を返します。
{{now.startOfMonth}}年間の週番号 {[date].weekOfYear}
その年の週を西洋のトラディショナル形式で返します。
{{now.weekOfYear}}年の週を ISO の週/日付形式で返します。
{{now.weekOfYearIso}}最初の営業日 {[date].firstBusinessDayOfMonth}
その月の最初の営業日を返します。営業日は月曜日から金曜日の 9 - 18 時とします。
{{now.firstBusinessDayOfMonth}}最終の営業日 {[date].lastBusinessDayOfMonth}
当該月の最終営業日を返します。営業日は月曜日から金曜日の午前 9 時から午後 6 時までです。
{{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 月の最初の月曜日を返します。
{{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 月の最後の金曜日を返します。
{{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 月曜日を返します。
{{now.ofTheMonth(2, 1)}}
//returns
2020-09-14T03:17:06.2+0000 この内容はお役に立ちましたか?