カスタム日時形式

カスタム日付時刻形式を使用すると、日付時刻値を文字列表現に変換するための特定のパターンを定義できます。 定義済み規則を使用して、カスタム日時形式を指定します。 これらのフォーマットを使用すると、特定のニーズに合った方法で日付と時刻を表示できます。

定義済み規則を使用して、カスタム日時形式を指定します。 こちらはカスタム日時形式の例です。
注: カスタムの日時形式を指定するために使用されるすべての定義済みの規約は、大文字と小文字が区別されます。

フォーマット \'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" 日時フォーマットは、ボット エージェントが稼働しているオペレーティング システムと、場所の設定に応じて動作します。

書式設定 \'d\'

日を "d" または "dd" として指定します。

\'D\' の書式設定

1 年のうち、ある 1 日を "D" または "DD" として指定します。

\'E\' の書式設定

曜日を "EEE" (Sun ～ Sat) または "EEEE" (Sunday ～ Saturday) として指定します。
注: "EEE" および "EEEE" 日時フォーマットは、ボット エージェントが稼働しているオペレーティング システムと、場所の設定に応じて動作します。

フォーマット \'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" などのタイム ゾーンのオフセット時間を指定します。

重要: 表示言語が簡体字中国語または繁体字中国語に設定されているコンピューターで、「dd-MMM-yyyy」のカスタム日付形式を使用して日付値を文字列値に変換すると、正しく表示されない場合があります。

例

前述の規則を使用すると、日時値の変換に使用するカスタム形式を指定できます。 前述の規則を使用した例としては、以下のようなものがあります。
注: フォーマット h.mm a は現在サポートされていません。
形式 サンプル出力
yyyy-MM-dd 2018-09-08
yyyy-M-d 2018-9-8
dd-mm-yyyy 08-09-2018
yyyy-MM-dd HH:mm:ss 2018-09-08 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-09-08 23:50:55.999
yyyy-MM-dd HH:mm:ss.SSS Z 2018-09-08 23:50:55.999 +0530
D:dd-mm-yyyy 130:08-09-2018
D \'days\', yyyy 365 日, 2019