DateTimeOffset.ToString 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,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
返回
一个 DateTimeOffset 对象的字符串表示形式,并在字符串末尾追加了偏移量。
例外
此日期和时间超出了当前区域性所用日历支持的日期范围。
示例
以下示例演示了对方法的 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
一个提供区域性特定的格式设置信息的对象。
返回
由 formatProvider
指定的当前 DateTimeOffset 对象值的字符串表示形式。
例外
日期和时间超出了 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
一个格式字符串。
返回
由 format
指定的当前 DateTimeOffset 对象值的字符串表示形式。
例外
此日期和时间超出了当前区域性所用日历支持的日期范围。
示例
以下示例使用每个标准日期和时间格式说明符向控制台显示一个 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
一个提供区域性特定的格式设置信息的对象。
返回
当前 DateTimeOffset 对象的值的字符串表示形式,由 format
和 provider
指定。
实现
例外
日期和时间超出了 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“::
另请参阅
- 标准日期和时间格式字符串
- 自定义日期和时间格式字符串
- 示例:.NET Core WinForms 格式设置实用工具 (C#)
- 示例:.NET Core WinForms 格式设置实用工具 (Visual Basic)