DateTimeFormatter.Format 方法

定义

命名空间:

Windows.Globalization.DateTimeFormatting

重载

Format(DateTime)	返回提供的日期和时间的字符串表示形式。
Format(DateTime, String)	返回一个字符串，该字符串表示给定时区中的给定日期和时间，符合格式化程序当前使用的模板。

Format(DateTime)

返回提供的日期和时间的字符串表示形式。

public:
 virtual Platform::String ^ Format(DateTime value) = Format;

winrt::hstring Format(DateTime const& value);

public string Format(System.DateTimeOffset value);

function format(value)

Public Function Format (value As DateTimeOffset) As String

参数

value

DateTime DateTimeOffset

要设置格式的日期和时间。

返回

String

Platform::String

winrt::hstring

表示日期和时间的字符串。

注解

注意

如果应用程序支持日本日历，则应验证它是否正确处理了 2019 年 5 月日本纪元更改。 有关详细信息 ，请参阅为日本纪元更改准备应用程序 。

另请参阅

• 日期和时间格式设置示例 (Windows 10)

Format(DateTime, String)

返回一个字符串，该字符串表示给定时区中的给定日期和时间，符合格式化程序当前使用的模板。

public:
 virtual Platform::String ^ Format(DateTime datetime, Platform::String ^ timeZoneId) = Format;

/// [Windows.Foundation.Metadata.Overload("FormatUsingTimeZone")]
winrt::hstring Format(DateTime const& datetime, winrt::hstring const& timeZoneId);

[Windows.Foundation.Metadata.Overload("FormatUsingTimeZone")]
public string Format(System.DateTimeOffset datetime, string timeZoneId);

function format(datetime, timeZoneId)

Public Function Format (datetime As DateTimeOffset, timeZoneId As String) As String

参数

datetime

DateTime DateTimeOffset

要设置格式的日期、时间和时区。

timeZoneId

String

Platform::String

winrt::hstring

IANA 时区数据库中的标识符，标识要使用的时区 (例如，太平洋时间) 的“Americas/Los_Angeles”。

返回

String

Platform::String

winrt::hstring

表示日期、时间和时区的字符串。

属性

OverloadAttribute

注解

注意

如果应用程序支持日本日历，则应验证它是否正确处理了 2019 年 5 月日本纪元更改。 有关详细信息 ，请参阅为日本纪元更改准备应用程序 。

另请参阅

• 日期和时间格式设置示例 (Windows 10)