構文
DateTime.ToText(dateTime as nullable datetime, optional options as any, optional culture as nullable text) as nullable text
バージョン情報
dateTime
のテキスト表現を返します。 省略可能な record
パラメーターの options
を指定すると、プロパティを追加指定できます。 culture
はレガシ ワークフローでのみ使用されます。 record
には、次のフィールドを含めることができます。
Format
: 使用する形式を示すtext
値。 詳細については、「標準の日時書式指定文字列」と「カスタム日時書式指定文字列」を参照してください。 このフィールドを省略するか、null
を指定すると、日付はCulture
で定義した既定値を使用して書式設定されます。Culture
:Format
が null でない場合、書式指定子の一部はCulture
によって制御されます。 たとえば、"en-US"
"MMM"
では"Jan", "Feb", "Mar", ...
、"ru-RU"
"MMM"
では"янв", "фев", "мар", ...
。Format
がnull
の場合、使用する既定の書式はCulture
によって制御されます。Culture
をnull
または省略すると、Culture.Current が使用されます。
レガシ ワークフローをサポートするために、options
と culture
をテキスト値にすることもできます。 これは options = [Format = options, Culture = culture]
と同じ動作をします。
例 1
#datetime(2010, 12, 31, 01, 30, 25)
を text
値に変換します。 結果の出力は、現在のカルチャによって異なります。
使用方法
DateTime.ToText(#datetime(2010, 12, 31, 01, 30, 25))
出力
"12/31/2010 1:30:25 AM"
例 2
カスタム形式とドイツ語のカルチャを使用して変換します。
使用方法
DateTime.ToText(#datetime(2010, 12, 30, 2, 4, 50.36973), [Format="dd MMM yyyy HH:mm:ss.ffffff", Culture="de-DE"])
出力
"30 Dez 2010 02:04:50.369730"
例 3
ISO 8601 のパターンを使用して変換します。
使用方法
DateTime.ToText(#datetime(2000, 2, 8, 3, 45, 12),[Format="yyyy-MM-dd'T'HH:mm:ss'Z'", Culture="en-US"])
出力
"2000-02-08T03:45:12Z"