通过

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=2180104 和 https://go.microsoft.com/fwlink/?linkid=2180105。 省略此字段或提供 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"