DATETIMEFORMAT ER 関数
DATETIMEFORMAT 関数は、指定された日付/時刻の値を、指定された形式とオプションで指定されたカルチャでテキストとして表示する文字列値を返します。 サポートされている形式の詳細については、標準 と カスタム を参照してください。
構文 1
DATETIMEFORMAT (datetime, format)
構文 2
DATETIMEFORMAT (datetime, format, culture)
引数
datetime: DateTime
書式設定する日時を表す日時値。
format: 文字列
出力文字列の形式。 サポートされている形式の詳細については、標準 と カスタム を参照してください。
メモ
書式文字列では、標準形式またはカスタム形式を使用する場合、大文字と小文字が区別されます。 たとえば、標準 "d" 書式指定子は短い日付パターンを使用して日付を返し、標準 "D" 書式指定子は長い日付パターンを使用して日付を返します。 また、カスタム "M" 書式指定子は月を 1 から 12 の値で返しますが、カスタム "m" 書式指定子は 0 から 59 の分を返します。
culture: 文字列
書式設定に使用するカルチャ。 サポートされているカルチャの詳細については、カルチャを参照してください。
戻り値
文字列
結果文字列値。
使用上の注意
呼び出された関数の引数としてカルチャが定義されていない場合、culture の値は、呼び出し元のコンテキストによって定義されます。 たとえば、ドイツのカルチャを使用するように構成された FILE 要素に対して、電子申告 (ER) 形式の構文 1 を使用して DATETIMEFORMAT 関数が呼び出された場合、変換はドイツのカルチャを使用して行われます。 既定の culture の値は EN-US です。
DATETIMEFORMAT 関数は、特定の日時値を変換するときに、関数がコンテキストで呼び出される ER 形式を実行しているアプリケーションユーザーのタイムゾーン設定を考慮します。
例 1
DATETIMEFORMAT (NOW(), "dd-MM-yyyy") は、指定されたカスタム形式に基づいて、現在のアプリケーション サーバーの日時値 2015 年 12 月 24 日を "24-12-2015" として返します。
例 2
DATETIMEFORMAT (SESSIONNOW(), "d", "DE") は、選択されたドイツのカルチャおよび指定された形式に基づいて、現在のアプリケーション セッションの日時値 2015 年 12 月 24 日を "24.12.2015" として返します。
例 3
DATETIMEFORMAT (DATETIMEVALUE( "2019-11-12T09:00:00.0000000-07:00", "O"), "O") は、言語と国/地域の基本設定 セクションでタイム ゾーン値 (GMT-08:00) 太平洋標準時 (米国 & カナダ) を持つアプリケーション ユーザーが開始したプロセス中に関数が呼び出されると、文字列値 2019-11-12T08:00:00.0000000-08:00 を返します。