DateTime.ToText

语法

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=2180104https://go.microsoft.com/fwlink/?linkid=2180105。 省略此字段或提供 null 将导致使用由 Culture 定义的默认值设置日期的格式。

  • Culture:如果 Format 不为 null,则 Culture 会控制某些格式说明符。 例如,在使用 "en-US" 时,"MMM""Jan", "Feb", "Mar", ...,而在使用 "ru-RU" 时,"MMM""янв", "фев", "мар", ...。 当 Formatnull 时,Culture 控制要使用的默认格式。 当 Culturenull 或被省略时,将使用 Culture.Current

若要支持旧工作流,optionsculture 也可以是文本值。 这与 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"