日時フォーマット

Automation Workspace で利用可能な定義済みのフォーマットを使用して、日時値を文字列値に変換する場合は、カスタムフォーマットを指定します。

[文字列に変換] アクションを使用すると、日時値を文字列値に変換できます。このアクションでは、定義済みの日時形式を選択したり、カスタム形式を指定したりすることもできます。

定義済みの日時形式

日時値を文字列値に変換するときには、[形式] リスト内の定義済みの日時形式を使用できます。使用可能な定義済みの日時形式を次に示します。
  • BASIC_ISO_DATE: 日時値を yyyymmdd+offset value の文字列値に変換します。
  • ISO_LOCAL_DATE: 日時値を yyyy-mm-dd の文字列値に変換します。
  • ISO_OFFSET_DATE: 日時値を yyyy-mm-dd+offset value の文字列値に変換します。オフセット値は、現地時間と UTC の時差を時間および分単位で示します。
  • ISO_DATE: 日時値を yyyy-mm-dd+offset value または yyyy-mm-dd の文字列値に変換します。オフセット値が使用可能な場合は、その値が追加されます。
  • ISO_LOCAL_TIME: 日時値を hh:mm:ss.SSS の文字列値に変換します。
  • ISO_OFFSET_TIME: 日時値を hh:mm:ss.SSS+offset value の文字列値に変換します。オフセット値は、現地時間と UTC の時差を時間および分単位で示します。
  • ISO_TIME: 日時値を hh:mm:ss.SSS または hh:mm:ss.SSS+offset value の文字列値に変換します。オフセット値は、現地時間と UTC の時差を時間および分単位で示します。
  • ISO_LOCAL_DATE_TIME: 日時値を yyyy-mm-ddThh:mm:ss.SSS の文字列値に変換します。
  • ISO_OFFSET_DATE_TIME: 日時値を yyyy-mm-ddThh:mm:ss.SSS+offset value の文字列値に変換します。オフセット値は、現地時間と UTC の時差を時間および分単位で示します。
  • ISO_ZONED_DATE_TIME: 日時値を yyyy-mm-ddThh:mm:ss.SSS+offset value[zone id] の文字列値に変換します。オフセット値は、現地時間と UTC の時差を時間および分単位で示します。 形式内の "zone id" はタイム ゾーンを表します。
  • ISO_DATE_TIME: 日時値を yyyy-mm-ddThh:mm:ss.SSS、yyyy-mm-ddThh:mm:ss.SSS+offset value または yyyy-mm-ddThh:mm:ss.SSS+offset value[zone id] の文字列値に変換します。
  • ISO_ORDINAL_DATE: 日時値を yyyy-[day of the year] または yyyy-[day of the year]+offset value の文字列値に変換します。たとえば、日時値が "January 25, 2018" の場合は、"2018-25" として書式設定されます。"25" は年の初めからの日数を示します。
  • ISO_WEEK_DATE: 日時値を yyyy-[week of the year]-[day of the week] または yyyy-[week of the year]-[day of the week]+offset value の文字列値に変換します。たとえば、日時値が "January 25, 2018" の場合は、"2018-W4-4" として書式設定されます。"W4" はその年の 4 番目の週であることを示し、"4" はその週の曜日を示します。
  • ISO_INSTANT: 日時値を yyyy-mm-ddThh:mm:ss.SSSZ の文字列値に変換します。
  • RFC_1123_DATE_TIME: 日時値を [day of the week], [day of the month] [month in 'MMM' format] [year in 'YYYY' format] hh:mm:ss または [day of the week], [day of the month] [month in 'MMM' format] [year in 'YYYY' format] hh:mm:ss+offset value の文字列値に変換します。たとえば、日時値が "2018-01-25 10:15" の場合は、"Thu, 25 December 2018 10:15:00GMT" として書式設定されます。"GMT" は、使用可能なオフセットがないことを示します。

カスタム日時形式

定義済み規則を使用して、カスタム日時形式を指定します。次の規則を使用できます。
注: カスタムの日時形式を指定するために使用されるすべての定義済みの規約は、大文字と小文字が区別されます。
  • "y" と "Y": 年は "yy" または "yyyy" として指定し、週の年は "YY" としてそれぞれ指定します。
    注: "yy" と "YY" は同じ結果をもたらしますが、カレンダーの年の最後の週または最初の週を含む日時形式を使用する場合、結果が異なります。

    たとえば、12/26/22 (2022/12/26) のような日時形式を使用し、アクションを実行して前年からファイルを削除する場合、日時形式 "yy" は正しい結果 (12/26/21) をもたらし、2021 年からのファイルが削除されます。(特定の日が現れる週の年を示す) 日時形式 "YY" を使用する場合、12/26/21 という日は 2021 年の最後の週に該当し、2022 年の最初の週にも該当するため、2022 年からのファイルが削除されます。

    サンプル カレンダー

    カレンダーの年だけを考慮し、そのカレンダーの年の、特定の週を考慮しない場合は、日時形式 "yy" を使用することをお勧めします。

  • "M": 月を "M"、"MM"、"MMM" (月の省略名、たとえば Jan、Feb)、または "MMMM" (次のフルネーム、たとえば January、February) として指定します。
    注: "MMM" および "MMMM" 日時フォーマットは、Bot エージェントが稼働しているオペレーティング システムと、場所の設定に応じて動作します。
  • "d": 日を "d" または "dd" として指定します。
  • "D": 1 年のうち、ある 1 日を "D" または "DD" として指定します。
  • "E": 曜日を "EEE" (Sun ～ Sat) または "EEEE" (Sunday ～ Saturday) として指定します。
    注: "EEE" および "EEEE" 日時フォーマットは、Bot エージェントが稼働しているオペレーティング システムと、場所の設定に応じて動作します。
  • F または FF: 月の曜日を指定します (先頭に 0 を付けるかどうかは任意)。(たとえば、yyyy-ww-F、yyyy-ww-0F)。
    注: 月の曜日を指定するには、次のように固定書式を指定することもできます: ISO_WEEK_DATE ('2012-W48-6')
  • "h" または "H": 時間を "hh" または "HH" で指定します。
    注: HH は 24 時間フォーマット、hh は 12 時間フォーマットで AM または PM を付けます。hh フォーマットを使用する場合は、日時フォーマットの末尾に a を追加してください。たとえば、システム ロケール言語が英語の場合、入力は 2018-12-25 10:50:55.999 AM となり、フォーマットは yyyy-MM-dd hh:mm:ss.SSS a となります。ここで、a は AM または PM を表します。ただし、英語以外の言語のオペレーティング システムを使用するコンピューターでは、適宜、AM または PM マーカーを使用してください。たとえば、日本語のオペレーティング システムでは、2018-12-25 10:50:55.999 午前 (午前は AM を意味する) のように、日本語の AM または PM マーカーを付け、フォーマットは yyyy-MM-dd hh:mm:ss.SSS a でなければなりません。
  • "a": 12 時間形式の AM/PM マーカーを指定します。
  • "m": 分を "mm" として指定します。
  • "s": 秒を "ss" として指定します。
  • "S": ミリ秒を ”SSS'” として指定します。
  • "z": 「太平洋標準時」、「インド標準時」などのタイムゾーンを指定します。
  • "Z": 「インド標準時」の "+0550" などのタイム ゾーンのオフセット時間を指定します。
Important: 表示言語が簡体字中国語または繁体字中国語に設定されているコンピューターで、「dd-MMM-yyyy」のカスタム日付形式を使用して日付値を文字列値に変換すると、正しく表示されない場合があります。
前述の規則を使用すると、日時値の変換に使用するカスタム形式を指定できます。前述の規則を使用した例としては、以下のようなものがあります。
形式 サンプル出力
yyyy-MM-dd 2018-09-30
yyyy-M-d 2020-09-08
dd-mm-yyyy 25-12-2018
yyyy-MM-dd HH:mm:ss 2018 年 12 月 25 日 23 時 50 分 55 秒
hh:mm:ss.SSS a 10:15:35.889 AM / 10:15:35.889 PM
yyyy-MM-dd HH:mm:ss.SSS 2018-12-25 23:50:55.999
yyyy-MM-dd HH:mm:ss.SSS Z 2018-12-25 23:50:55.999 +0530
h.mm a 4.10 PM
D 'days', yyyy 365 日, 2019