语法
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
值,指示要使用的格式。 有关详细信息,请转到 https://go.microsoft.com/fwlink/?linkid=2180104 和 https://go.microsoft.com/fwlink/?linkid=2180105。 省略此字段或提供null
将导致使用由Culture
定义的默认值设置日期的格式。Culture
:如果Format
不为 null,则Culture
会控制某些格式说明符。 例如,in"en-US"
是,而 in"MMM"
"ru-RU"
是"янв", "фев", "мар", ...
。"Jan", "Feb", "Mar", ...
"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"