DateTimeOffset.ToString 方法

参考

定义

命名空间:: System

程序集:: System.Runtime.dll

程序集:: mscorlib.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

将当前 DateTimeOffset 对象的值转换为其等效的字符串表示形式。

重载

ToString()	将当前 DateTimeOffset 对象的值转换为其等效的字符串表示形式。
ToString(IFormatProvider)	使用指定的区域性特定格式设置信息将当前 DateTimeOffset 对象的值转换为它的等效字符串表示形式。
ToString(String)	使用指定的格式将当前 DateTimeOffset 对象的值转换为它的等效字符串表示形式。
ToString(String, IFormatProvider)	使用指定的格式和区域性特定格式信息将当前 DateTimeOffset 对象的值转换为它的等效字符串表示形式。

ToString()

将当前 DateTimeOffset 对象的值转换为其等效的字符串表示形式。

public:
 override System::String ^ ToString();

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

String

一个 DateTimeOffset 对象的字符串表示形式，并在字符串末尾追加了偏移量。

例外

ArgumentOutOfRangeException

此日期和时间超出了当前区域性所用日历支持的日期范围。

示例

以下示例演示了对方法的 ToString() 调用，并在当前区域性为 en-us 的系统上显示其输出。

DateTimeOffset thisDate;

// Show output for UTC time
thisDate = DateTimeOffset.UtcNow;
Console.WriteLine(thisDate.ToString());  // Displays 3/28/2007 7:13:50 PM +00:00

// Show output for local time
thisDate = DateTimeOffset.Now;
Console.WriteLine(thisDate.ToString());  // Displays 3/28/2007 12:13:50 PM -07:00

// Show output for arbitrary time offset
thisDate = thisDate.ToOffset(new TimeSpan(-5, 0, 0));
Console.WriteLine(thisDate.ToString());  // Displays 3/28/2007 2:13:50 PM -05:00

// Show output for UTC time
let thisDate = DateTimeOffset.UtcNow
printfn $"{thisDate.ToString()}"  // Displays 3/28/2007 7:13:50 PM +00:00

// Show output for local time
let thisDate = DateTimeOffset.Now
printfn $"{thisDate.ToString()}"  // Displays 3/28/2007 12:13:50 PM -07:00

// Show output for arbitrary time offset
let thisDate = thisDate.ToOffset(TimeSpan(-5, 0, 0))
printfn $"{thisDate.ToString()}"  // Displays 3/28/2007 2:13:50 PM -05:00

Dim thisDate As DateTimeOffset

' Show output for UTC time
thisDate = DateTimeOffset.UtcNow
Console.WriteLine(thisDate.ToString())  ' Displays 3/28/2007 7:13:50 PM +00:00

' Show output for local time 
thisDate = DateTimeOffset.Now
Console.WriteLine(thisDate.ToString())  ' Displays 3/28/2007 12:13:50 PM -07:00

' Show output for arbitrary time offset
thisDate = thisDate.ToOffset(new TimeSpan(-5, 0, 0))
Console.WriteLine(thisDate.ToString())  ' Displays 3/28/2007 2:13:50 PM -05:00

注解

此方法的返回值与方法的 DateTime.ToString() 返回值相同，只不过它包含一个空格，后跟在字符串末尾追加的偏移量。换句话说，它使用短日期模式、长时间模式和 zzz 自定义格式字符串设置输出格式，每个元素用空格分隔与上一个元素分开。例如，如果 DateTime.ToString() 返回 2008/1/12/6：15：50 PM 的值， ToString() 则返回 2008 年 1 月 12 日 6：15：50 PM -08：00 的 8 小时落后于协调世界时 (UTC) 。

此方法使用派生自当前区域性的格式设置信息。有关详细信息，请参阅 CurrentCulture。使用该方法的其他重载 ToString 可以指定要使用的格式区域性，并定义值的输出模式 DateTimeOffset 。

调用方说明

该方法 ToString() 返回当前区域性使用的日历中的日期和时间的字符串表示形式。如果当前 DateTimeOffset 实例的值早于 MinSupportedDateTime 或晚于或晚 MaxSupportedDateTime，则该方法将引发一个 ArgumentOutOfRangeException。下面的示例进行了这方面的演示。它尝试设置当前区域性为阿拉伯语 (叙利亚) 时类范围 HijriCalendar 之外的日期的格式。

：：：code language=“csharp” source=“~/snippets/csharp/System/DateTimeOffset/ToString/datetimeoffset.tostring.argumentoutofrangeexception2.cs” id=“Snippet2”：：：：：：：code language=“fsharp” source=“~/snippets/fsharp//VS_Snippets_CLR_System/system.datetimeoffset.tostring.argumentoutofrangeexception/fs/datetimeoffset.tostring.argumentoutofrangeexception2.fs” id=“Snippet2”：：：：：：：code language=“vb” source=“~/snippets/visualbasic/VS_Snippets_CLR_System/system.datetimeoffset.tostring.argumentoutofrangeexception/vb/datetimeoffset.tostring.argumentoutofrangeexception2.vb“ id=”Snippet2“：：

适用于

ToString(IFormatProvider)

使用指定的区域性特定格式设置信息将当前 DateTimeOffset 对象的值转换为它的等效字符串表示形式。

public:
 System::String ^ ToString(IFormatProvider ^ formatProvider);

public string ToString (IFormatProvider formatProvider);

public string ToString (IFormatProvider? formatProvider);

override this.ToString : IFormatProvider -> string

Public Function ToString (formatProvider As IFormatProvider) As String

参数

formatProvider: IFormatProvider

一个提供区域性特定的格式设置信息的对象。

String

由 formatProvider 指定的当前 DateTimeOffset 对象值的字符串表示形式。

例外

ArgumentOutOfRangeException

日期和时间超出了 formatProvider 所用日历支持的日期范围。

示例

以下示例使用CultureInfo表示固定区域性的对象以及另外四种DateTimeOffset区域性显示对象。

CultureInfo[] cultures = new CultureInfo[] {CultureInfo.InvariantCulture,
                                           new CultureInfo("en-us"),
                                           new CultureInfo("fr-fr"),
                                           new CultureInfo("de-DE"),
                                           new CultureInfo("es-ES")};

DateTimeOffset thisDate = new DateTimeOffset(2007, 5, 1, 9, 0, 0,
                                             TimeSpan.Zero);

foreach (CultureInfo culture in cultures)
{
   string cultureName;
   if (string.IsNullOrEmpty(culture.Name))
      cultureName = culture.NativeName;
   else
      cultureName = culture.Name;

   Console.WriteLine("In {0}, {1}",
                     cultureName, thisDate.ToString(culture));
}
// The example produces the following output:
//    In Invariant Language (Invariant Country), 05/01/2007 09:00:00 +00:00
//    In en-US, 5/1/2007 9:00:00 AM +00:00
//    In fr-FR, 01/05/2007 09:00:00 +00:00
//    In de-DE, 01.05.2007 09:00:00 +00:00
//    In es-ES, 01/05/2007 9:00:00 +00:00

let cultures = 
    [| CultureInfo.InvariantCulture
       CultureInfo "en-us"
       CultureInfo "fr-fr"
       CultureInfo "de-DE"
       CultureInfo "es-ES" |]

let thisDate = DateTimeOffset(2007, 5, 1, 9, 0, 0, TimeSpan.Zero)

for culture in cultures do
    let cultureName = 
        if String.IsNullOrEmpty culture.Name then
            culture.NativeName
        else
            culture.Name
    printfn $"In {cultureName}, {thisDate.ToString culture}"

// The example produces the following output:
//    In Invariant Language (Invariant Country), 05/01/2007 09:00:00 +00:00
//    In en-US, 5/1/2007 9:00:00 AM +00:00
//    In fr-FR, 01/05/2007 09:00:00 +00:00
//    In de-DE, 01.05.2007 09:00:00 +00:00
//    In es-ES, 01/05/2007 9:00:00 +00:00

     Dim cultures() As CultureInfo = {CultureInfo.InvariantCulture, _
                                      New CultureInfo("en-us"), _
                                      New CultureInfo("fr-fr"), _
                                      New CultureInfo("de-DE"), _
                                      New CultureInfo("es-ES")}

     Dim thisDate As New DateTimeOffset(#5/1/2007 9:00AM#, TimeSpan.Zero)                                            

     For Each culture As CultureInfo In cultures
        Dim cultureName As String 
        If String.IsNullOrEmpty(culture.Name) Then
           cultureName = culture.NativeName
        Else
           cultureName = culture.Name
        End If
        Console.WriteLine("In {0}, {1}", _
                          cultureName, thisDate.ToString(culture))
     Next                                            
     ' The example produces the following output:
     '    In Invariant Language (Invariant Country), 05/01/2007 09:00:00 +00:00
     '    In en-US, 5/1/2007 9:00:00 AM +00:00
     '    In fr-FR, 01/05/2007 09:00:00 +00:00
     '    In de-DE, 01.05.2007 09:00:00 +00:00
     '    In es-ES, 01/05/2007 9:00:00 +00:00

注解

此方法的返回值与方法等效重载 DateTime.ToString 的返回值相同，只不过它包含一个空格，后跟在字符串末尾追加的偏移量。换句话说，它使用短日期模式、长时间模式和 zzz 自定义格式字符串设置输出格式，每个元素用空格分隔与上一个元素分开。

这三个元素的格式由 formatProvider 参数定义。该 formatProvider 参数可以是以下任一参数：

一个 CultureInfo 对象，表示其格式约定应用于返回的字符串的区域性。属性 DateTimeFormatInfo 返回 CultureInfo.DateTimeFormat 的对象定义返回的字符串的格式。
定义 DateTimeFormatInfo 日期和时间数据格式的对象。

如果是formatProvider，DateTimeFormatInfo则使用与当前区域性关联的对象 () CurrentCulture 。null

调用方说明

该方法 ToString(IFormatProvider) 返回由参数表示 formatProvider 的区域性使用的日历中的日期和时间的字符串表示形式。其日历由 Calendar 属性定义。如果当前 DateTimeOffset 实例的值早于 MinSupportedDateTime 或晚于或晚 MaxSupportedDateTime，则该方法将引发一个 ArgumentOutOfRangeException。下面的示例进行了这方面的演示。它尝试设置超出类范围的日期的格式 JapaneseCalendar 。

：：：code language=“csharp” source=“~/snippets/csharp/System/DateTimeOffset/ToString/datetimeoffset.tostring.argumentoutofrangeexception1.cs” interactive=“try-dotnet” id=“Snippet1”：：：：：：：code language=“fsharp” source=“~/snippets//fsharp/VS_Snippets_CLR_System/system.datetimeoffset.tostring.argumentoutofrangeexception/fs/datetimeoffset.tostring.argumentoutofrangeexception1.fs” id=“Snippet1”：：：：：：code language=“vb” source=“~/snippets/visualbasic/VS_Snippets_CLR_System/system.datetimeoffset.tostring.argumentoutofrangeexception/vb/datetimeoffset.tostring.argumentoutofrangeexception1.vb“ id=”Snippet1“：：

适用于

ToString(String)

使用指定的格式将当前 DateTimeOffset 对象的值转换为它的等效字符串表示形式。

public:
 System::String ^ ToString(System::String ^ format);

public string ToString (string format);

public string ToString (string? format);

override this.ToString : string -> string

Public Function ToString (format As String) As String

参数

format: String

一个格式字符串。

String

由 format 指定的当前 DateTimeOffset 对象值的字符串表示形式。

例外

FormatException

format 的长度为 1，它不属于为 DateTimeFormatInfo 定义的标准格式说明符字符。

或 -

format 不包含有效的自定义格式模式。

ArgumentOutOfRangeException

此日期和时间超出了当前区域性所用日历支持的日期范围。

示例

以下示例使用每个标准日期和时间格式说明符向控制台显示一个 DateTimeOffset 对象。输出使用 en-us 区域性设置格式。

DateTimeOffset outputDate = new DateTimeOffset(2007, 10, 31, 21, 0, 0,
                                     new TimeSpan(-8, 0, 0));
string specifier;

// Output date using each standard date/time format specifier
specifier = "d";
// Displays   d: 10/31/2007
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier));

specifier = "D";
// Displays   D: Wednesday, October 31, 2007
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier));

specifier = "t";
// Displays   t: 9:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier));

specifier = "T";
// Displays   T: 9:00:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier));

specifier = "f";
// Displays   f: Wednesday, October 31, 2007 9:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier));

specifier = "F";
// Displays   F: Wednesday, October 31, 2007 9:00:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier));

specifier = "g";
// Displays   g: 10/31/2007 9:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier));

specifier = "G";
// Displays   G: 10/31/2007 9:00:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier));

specifier = "M";           // 'm' is identical
// Displays   M: October 31
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier));

specifier = "R";           // 'r' is identical
// Displays   R: Thu, 01 Nov 2007 05:00:00 GMT
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier));

specifier = "s";
// Displays   s: 2007-10-31T21:00:00
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier));

specifier = "u";
// Displays   u: 2007-11-01 05:00:00Z
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier));

// Specifier is not supported
specifier = "U";
try
{
   Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier));
}
catch (FormatException)
{
   Console.WriteLine("{0}: Not supported.", specifier);
}

specifier = "Y";         // 'y' is identical
// Displays   Y: October, 2007
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier));

let outputDate = DateTimeOffset(2007, 10, 31, 21, 0, 0, TimeSpan(-8, 0, 0))

// Output date using each standard date/time format specifier
let specifier = "d"
// Displays   d: 10/31/2007
printfn $"{specifier}: {outputDate.ToString specifier}"

let specifier = "D"
// Displays   D: Wednesday, October 31, 2007
printfn $"{specifier}: {outputDate.ToString specifier}"

let specifier = "t"
// Displays   t: 9:00 PM
printfn $"{specifier}: {outputDate.ToString specifier}"

let specifier = "T"
// Displays   T: 9:00:00 PM
printfn $"{specifier}: {outputDate.ToString specifier}"

let specifier = "f"
// Displays   f: Wednesday, October 31, 2007 9:00 PM
printfn $"{specifier}: {outputDate.ToString specifier}"

let specifier = "F"
// Displays   F: Wednesday, October 31, 2007 9:00:00 PM
printfn $"{specifier}: {outputDate.ToString specifier}"

let specifier = "g"
// Displays   g: 10/31/2007 9:00 PM
printfn $"{specifier}: {outputDate.ToString specifier}"

let specifier = "G"
// Displays   G: 10/31/2007 9:00:00 PM
printfn $"{specifier}: {outputDate.ToString specifier}"

let specifier = "M"           // 'm' is identical
// Displays   M: October 31
printfn $"{specifier}: {outputDate.ToString specifier}"

let specifier = "R"           // 'r' is identical
// Displays   R: Thu, 01 Nov 2007 05:00:00 GMT
printfn $"{specifier}: {outputDate.ToString specifier}"

let specifier = "s"
// Displays   s: 2007-10-31T21:00:00
printfn $"{specifier}: {outputDate.ToString specifier}"

let specifier = "u"
// Displays   u: 2007-11-01 05:00:00Z
printfn $"{specifier}: {outputDate.ToString specifier}"

// Specifier is not supported
let specifier = "U"
try
    printfn $"{specifier}: {outputDate.ToString specifier}"
with :? FormatException ->
    printfn $"{specifier}: Not supported."

let specifier = "Y"         // 'y' is identical
// Displays   Y: October, 2007
printfn $"{specifier}: {outputDate.ToString specifier}"

Dim outputDate As New DateTimeOffset(#10/31/2007 9:00PM#, _
                                     New TimeSpan(-8, 0, 0))
Dim specifier As String 
      
' Output date using each standard date/time format specifier
specifier = "d"
' Displays   d: 10/31/2007
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "D"
' Displays   D: Wednesday, October 31, 2007
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "t"
' Displays   t: 9:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "T"
' Displays   T: 9:00:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "f"
' Displays   f: Wednesday, October 31, 2007 9:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "F"
' Displays   F: Wednesday, October 31, 2007 9:00:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "g"
' Displays   g: 10/31/2007 9:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "G"
' Displays   G: 10/31/2007 9:00:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "M"           ' 'm' is identical
' Displays   M: October 31
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "R"           ' 'r' is identical
' Displays   R: Thu, 01 Nov 2007 05:00:00 GMT
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "s"
' Displays   s: 2007-10-31T21:00:00
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "u"
' Displays   u: 2007-11-01 05:00:00Z
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

' Specifier is not supported
specifier = "U"
Try
   Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 
Catch e As FormatException
   Console.WriteLine("{0}: Not supported.", specifier)   
End Try

specifier = "Y"         ' 'y' is identical
' Displays   Y: October, 2007
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier))

注解

参数 format 应包含单个格式说明符字符 (请参阅标准日期和时间格式字符串) 或自定义格式模式 (请参阅定义返回字符串格式的自定义日期和时间格式字符串) 。如果 format 为 null 或空字符串 (“”) ，则 DateTimeOffset 该值使用默认格式输出。

下表显示了使用 DateTimeOffset时特定格式说明符的确切操作，这与使用 DateTime时的行为不同。

现有格式说明符	新行为
“K”	设计为往返日期和时间。使用 DateTimeOffset时，映射到“zzz” (偏移量始终显示小时和分钟) 。请注意，“K”是自定义格式说明符;它不能显示为单个字符。`format`
“U”	不支持。
“r”	将 DateTimeOffset 对象转换为协调世界时 (UTC) 并使用自定义格式字符串 `ddd, dd MMM yyyy HH:mm:ss GMT`输出该对象。
“u”	将 DateTimeOffset 对象转换为 UTC，并使用格式 `yyyy-MM-dd HH:mm:ssZ`输出该对象。

剩余的标准日期和时间格式说明符与 ToString(String) 方法 ToString 的行为相同。

此方法使用派生自当前区域性的格式设置信息。有关详细信息，请参阅 CurrentCulture。

调用方说明

该方法 ToString(String) 返回当前区域性使用的日历中的日期和时间的字符串表示形式。如果当前 DateTimeOffset 实例的值早于 MinSupportedDateTime 或晚于或晚 MaxSupportedDateTime，则该方法将引发一个 ArgumentOutOfRangeException。下面的示例进行了这方面的演示。当当前区域性是希伯来语 (以色列) 时，它尝试设置类范围 HebrewCalendar 之外的日期的格式。

：：：code language=“csharp” source=“~/snippets/csharp/System/DateTimeOffset/ToString/datetimeoffset.tostring.argumentoutofrangeexception3.cs” interactive=“try-dotnet” id=“Snippet3”：：：：：：code language=“fsharp” source=“~/snippets//fsharp/VS_Snippets_CLR_System/system.datetimeoffset.tostring.argumentoutofrangeexception/fs/datetimeoffset.tostring.argumentoutofrangeexception3.fs” id=“Snippet3”：：：：：：code language=“vb” source=“~/snippets/visualbasic/VS_Snippets_CLR_System/system.datetimeoffset.tostring.argumentoutofrangeexception/vb/datetimeoffset.tostring.argumentoutofrangeexception3.vb“ id=”Snippet3“：：

另请参阅

适用于

ToString(String, IFormatProvider)

使用指定的格式和区域性特定格式信息将当前 DateTimeOffset 对象的值转换为它的等效字符串表示形式。

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ formatProvider);

public string ToString (string format, IFormatProvider formatProvider);

public string ToString (string? format, IFormatProvider? formatProvider);

override this.ToString : string * IFormatProvider -> string

Public Function ToString (format As String, formatProvider As IFormatProvider) As String

参数

format: String

一个格式字符串。

formatProvider: IFormatProvider

一个提供区域性特定的格式设置信息的对象。

String

当前 DateTimeOffset 对象的值的字符串表示形式，由 format 和 provider 指定。

实现

ToString(String, IFormatProvider)

例外

FormatException

format 的长度为 1，它不属于为 DateTimeFormatInfo 定义的标准格式说明符字符。

或 -

format 不包含有效的自定义格式模式。

ArgumentOutOfRangeException

日期和时间超出了 formatProvider 所用日历支持的日期范围。

示例

以下示例使用 ToString(String, IFormatProvider) 该方法对多个不同区域性使用自定义格式字符串显示 DateTimeOffset 对象。

DateTimeOffset outputDate = new DateTimeOffset(2007, 11, 1, 9, 0, 0,
                                     new TimeSpan(-7, 0, 0));
string format = "dddd, MMM dd yyyy HH:mm:ss zzz";

// Output date and time using custom format specification
Console.WriteLine(outputDate.ToString(format, null as DateTimeFormatInfo));
Console.WriteLine(outputDate.ToString(format, CultureInfo.InvariantCulture));
Console.WriteLine(outputDate.ToString(format,
                                      new CultureInfo("fr-FR")));
Console.WriteLine(outputDate.ToString(format,
                                      new CultureInfo("es-ES")));
// The example displays the following output to the console:
//    Thursday, Nov 01 2007 09:00:00 -07:00
//    Thursday, Nov 01 2007 09:00:00 -07:00
//    jeudi, nov. 01 2007 09:00:00 -07:00
//    jueves, nov 01 2007 09:00:00 -07:00

let outputDate = DateTimeOffset(2007, 11, 1, 9, 0, 0, TimeSpan(-7, 0, 0))
let format = "dddd, MMM dd yyyy HH:mm:ss zzz"

// Output date and time using custom format specification
printfn $"{outputDate.ToString(format, null)}"
printfn $"{outputDate.ToString(format, CultureInfo.InvariantCulture)}"
printfn $"""{outputDate.ToString(format, CultureInfo "fr-FR")}"""
printfn $"""{outputDate.ToString(format, CultureInfo "es-ES")}"""

// The example displays the following output to the console:
//    Thursday, Nov 01 2007 09:00:00 -07:00
//    Thursday, Nov 01 2007 09:00:00 -07:00
//    jeudi, nov. 01 2007 09:00:00 -07:00
//    jueves, nov 01 2007 09:00:00 -07:00

Dim outputDate As New DateTimeOffset(#11/1/2007 9:00AM#, _
                                     New TimeSpan(-7, 0, 0)) 
Dim format As String = "dddd, MMM dd yyyy HH:mm:ss zzz"

' Output date and time using custom format specification
Console.WriteLine(outputDate.ToString(format, Nothing))
Console.WriteLine(outputDate.ToString(format, CultureInfo.InvariantCulture))
Console.WriteLine(outputDate.ToString(format, _
                                      New CultureInfo("fr-FR")))
Console.WriteLine(outputDate.ToString(format, _
                                      New CultureInfo("es-ES")))
' The example displays the following output to the console:
'    Thursday, Nov 01 2007 09:00:00 -07:00
'    Thursday, Nov 01 2007 09:00:00 -07:00
'    jeudi, nov. 01 2007 09:00:00 -07:00
'    jueves, nov 01 2007 09:00:00 -07:00

注解

参数 format 应包含单个格式说明符字符 (请参阅标准日期和时间格式字符串) ，或者自定义格式模式 (请参阅自定义日期和时间格式字符串) 。如果 format 为 null 或空字符串 (“”) ，则 DateTimeOffset 使用默认格式输出对象。

下表显示了使用 DateTimeOffset时特定格式说明符的确切操作，这与使用 DateTime时的行为不同。

现有格式说明符	新行为
“K”	设计为往返日期和时间。使用 DateTimeOffset时，映射到“zzz” (偏移量始终显示小时和分钟) 。请注意，“K”是自定义格式说明符;它不能显示为单个字符。`format`
“U”	不支持。
“r”	将 DateTimeOffset 对象转换为协调世界时 (UTC) 并使用自定义格式字符串 `ddd, dd MMM yyyy HH:mm:ss GMT`输出该对象。
“u”	将 DateTimeOffset 值转换为 UTC，并使用格式 `yyyy-MM-dd HH:mm:ssZ`输出该值。

剩余的标准日期和时间格式说明符与 ToString(String) 方法 ToString 的行为相同。

与标准格式说明符对应的模式以及日期和时间组件的符号和名称由 formatProvider 参数定义。该 formatProvider 参数可以是以下任一参数：

一个 CultureInfo 对象，表示其格式设置用于其格式 input的区域性的对象。属性 DateTimeFormatInfo 返回 CultureInfo.DateTimeFormat 的对象定义在 . 中使用的 input格式设置。
定义 DateTimeFormatInfo 日期和时间数据格式的对象。

如果是formatProvider，DateTimeFormatInfo则使用与当前区域性关联的对象 () CurrentCulture 。null

调用方说明

该方法 ToString(String, IFormatProvider) 返回参数使用的日历中的日期和时间的 formatProvider 字符串表示形式。其日历由 Calendar 属性定义。如果当前 DateTimeOffset 实例的值早于 MinSupportedDateTime 或晚于或晚 MaxSupportedDateTime，则该方法将引发一个 ArgumentOutOfRangeException。下面的示例进行了这方面的演示。它尝试设置超出类范围的日期的格式 UmAlQuraCalendar 。

：：：code language=“csharp” source=“~/snippets/csharp/System/DateTimeOffset/ToString/datetimeoffset.tostring.argumentoutofrangeexception4.cs” id=“Snippet4”：：：：：：：code language=“fsharp” source=“~/snippets/fsharp/VS_Snippets_CLR_System/system.datetimeoffset.tostring.argumentoutofrangeexception/fs/datetimeoffset.tostring.argumentoutofrangeexception4.fs” id=“Snippet4”：：：：：code language=“vb” source=“~/snippets/visualbasic/VS_Snippets_CLR_System/system.datetimeoffset.tostring.argumentoutofrangeexception/vb/datetimeoffset.tostring.argumentoutofrangeexception4.vb“ id=”Snippet4“：：

另请参阅

适用于

DateTimeOffset.ToString 方法

定义

重载

ToString()

返回

例外

示例

注解

调用方说明

适用于

ToString(IFormatProvider)

参数

返回

例外

示例

注解

调用方说明

适用于

ToString(String)

参数

返回

例外

示例

注解

调用方说明

另请参阅

适用于

ToString(String, IFormatProvider)

参数

返回

实现

例外

示例

注解

调用方说明

另请参阅

适用于

其他资源