AMPscript の共通文字列トークン

Format() および FormatDate() 関数を使用して AMPscript の日付と時刻を書式設定するために使用できる共通文字列トークンの例を確認します。

時刻パラメーターで任意の短いトークンオプションを使用すると、指定したカルチャーコードに基づいて短い時刻 (例: 1:09 PM) が追加されます。次の例では、短いトークン「s」を使用して、指定された形式で時間値 18:30 を 12 時制の値として書式設定します。

結果: December 1 at 6:30 PM

Format() と FormatDate() の動作は異なります (短い日付の値が異なります)。

  • 「s」、「S」、または「short」を使用した場合、FormatDate() では短い日付 (例: 10/19/2017) が出力されます。

結果: 10/19/2017

  • 「sortable」を使用した場合、FormatDate() では並び替え可能な日付 (例: 2017-10-19) が出力されます。

結果: 10/19/2017

  • 「s」を使用した場合、Format() では並び替え可能な日付 (例: 2017-10-19) が出力されます。

<<<<<<< HEAD

======= %%[Output(FormatDate(@date,"sortable"))]%%

739bbde86e31134996a40e9392e4310c1a60839c

結果: 2017-10-19T13:09:34

  • 「S」を使用した場合、Format() では「L」と同じ形式 (例: 10/5/2017 1:09:34 PM) が出力されます。

<<<<<<< HEAD

======= %%[Output(Format(@date,"S"))]%%

739bbde86e31134996a40e9392e4310c1a60839c

結果: 10/19/2017 1:09:34 PM

次の例では長いトークン「l」を使用して、日付を標準のカルチャーベースの日付形式に書式設定します。

結果:

FormatDate() では、「l」トークンで異なる文字列が生成されます。FormatDate() では「long」を使用することもできます。

結果: Tuesday, September 10, 2019

長い時刻トークンを含めると、完全長の日時が表示されます。

結果: Tuesday, September 10, 2019 1:09:34 PM

このトークンでは、CST (-06:00) の ISO 8601 標準に準拠する日時が返されます。このトークンでは、指定されたロケールに基づいて出力が変更されることはありません。

「o」トークンは Format() と FormatDate() の両方で使用できます。Format() には、一秒未満の値またはタイムゾーンオフセットインジケータは含まれません。FormatDate() で日付と時刻の両方に「o」を使用すると、それぞれの完全な日時スタンプが出力されます。

「iso」トークンは FormatDate() で使用でき、FormatDate() の「o」と同じ結果を生成します。FormatDate() の時刻パラメーターでは「iso」はサポートされません。

結果: 2017-10-19T12:09:34.0000000

結果: 2017-10-19T12:09:34.5678900-06:00

「rfc」トークンでは、CST (-06:00) の RFC 1123 標準に準拠する日時が返されます。このトークンでは、指定されたロケールに基づいて出力が変更されることはありません。出力がサーバ時刻 (-06:00) であっても、GMT が出力に追加されます。

「r」トークンは Format() と FormatDate() の両方で使用できます。FormatDate() で日付と時刻の両方に「r」を使用すると、それぞれの完全な日時スタンプが出力されます。

「rfc」トークンは FormatDate() で使用でき、FormatDate() の「r」と同じ結果を生成します。FormatDate() の時刻パラメーターの値として「rfc」はサポートされません。

結果: Thu, 19 Oct 2017 07:09:34 GMT

ロケール設定を必要とする日時形式では、Format() 関数を使用することをお勧めします。