DateTimeOffset.ToString DateTimeOffset.ToString DateTimeOffset.ToString DateTimeOffset.ToString Method

定義

現在の DateTimeOffset オブジェクトの値を等価の文字列形式に変換します。Converts the value of the current DateTimeOffset object to its equivalent string representation.

オーバーロード

ToString() ToString() ToString() ToString()

現在の DateTimeOffset オブジェクトの値を等価の文字列形式に変換します。Converts the value of the current DateTimeOffset object to its equivalent string representation.

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

指定したカルチャ固有の書式情報を使用して、現在の DateTimeOffset オブジェクトの値をそれと等価な文字列形式に変換します。Converts the value of the current DateTimeOffset object to its equivalent string representation using the specified culture-specific formatting information.

ToString(String) ToString(String) ToString(String) ToString(String)

指定した書式を使用して、現在の DateTimeOffset オブジェクトの値をそれと等価な文字列形式に変換します。Converts the value of the current DateTimeOffset object to its equivalent string representation using the specified format.

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

指定した書式およびカルチャ固有の書式情報を使用して、現在の DateTimeOffset オブジェクトの値をそれと等価の文字列形式に変換します。Converts the value of the current DateTimeOffset object to its equivalent string representation using the specified format and culture-specific format information.

ToString() ToString() ToString() ToString()

現在の DateTimeOffset オブジェクトの値を等価の文字列形式に変換します。Converts the value of the current DateTimeOffset object to its equivalent string representation.

public:
 override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

戻り値

DateTimeOffset オブジェクトの文字列形式。文字列の末尾にオフセットが追加されています。A string representation of a DateTimeOffset object that includes the offset appended at the end of the string.

例外

日時が、現在のカルチャで使用されるカレンダーでサポートされている日付の範囲外です。The date and time is outside the range of dates supported by the calendar used by the current culture.

次の例では、呼び出しをToString()メソッドおよびその出力をシステムの現在のカルチャが英語で-米国。The following example illustrates calls to the ToString() method and displays its output on a system whose current culture is 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
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()ことには、スペースが含まれています。 ただし、メソッドの後に、文字列の末尾にオフセットが追加されます。The return value of this method is identical to that of the DateTime.ToString() method, except that it includes a space followed by the offset appended at the end of the string. つまり、形式の長い時刻パターンの短い日付パターンを使用して、出力、およびzzzから直前の要素をスペースで区切られた各要素のカスタム書式指定文字列。In other words, it formats output using the short date pattern, the long time pattern, and the zzz custom format string, with each element separated from the previous element by a space. たとえば場合、 DateTime.ToString() 1/12/2008 の値を返します 6時 15分: 50 PM、 ToString() 1/12/2008 の値を返します 6時 15分: 50 PM -08:00 の時間は 8 時間の世界協定時刻 (UTC) の背後にあります。For example, if DateTime.ToString() returns a value of 1/12/2008 6:15:50 PM, ToString() returns a value of 1/12/2008 6:15:50 PM -08:00 for a time that is eight hours behind Coordinated Universal Time (UTC).

このメソッドは、基に、現在のカルチャの書式情報を使用します。This method uses formatting information derived from the current culture. 詳細については、「CurrentCulture」を参照してください。For more information, see CurrentCulture. 他のオーバー ロード、ToStringメソッドを使用するカルチャを指定を使用しての出力のパターンを定義する書式、DateTimeOffset値。Other overloads of the ToString method enable you to specify the culture whose formatting to use, and to define the output pattern of the DateTimeOffset value.

注意 (呼び出し元)

ToString()メソッドは、現在のカルチャで使用される暦で日付と時刻の文字列表現を返します。The ToString() method returns the string representation of the date and time in the calendar used by the current culture. 場合、現在の値DateTimeOffsetインスタンスがよりも前かMinSupportedDateTimeかそれより遅いMaxSupportedDateTimeがスローされます、ArgumentOutOfRangeExceptionします。If the value of the current DateTimeOffset instance is earlier than MinSupportedDateTime or later than MaxSupportedDateTime, the method throws an ArgumentOutOfRangeException. 具体的な例を次に示します。The following example provides an illustration. 範囲外にある日付の書式設定しようと、HijriCalendarクラスの現在のカルチャがアラビア語 (シリア)。It attempts to format a date that is outside the range of the HijriCalendar class when the current culture is Arabic (Syria).

[!code-csharpSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#2] [!code-vbSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#2][!code-csharpSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#2] [!code-vbSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#2]

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

指定したカルチャ固有の書式情報を使用して、現在の DateTimeOffset オブジェクトの値をそれと等価な文字列形式に変換します。Converts the value of the current DateTimeOffset object to its equivalent string representation using the specified culture-specific formatting information.

public:
 System::String ^ ToString(IFormatProvider ^ formatProvider);
public string ToString (IFormatProvider formatProvider);
override this.ToString : IFormatProvider -> string
Public Function ToString (formatProvider As IFormatProvider) As String

パラメーター

formatProvider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

カルチャ固有の書式情報を提供するオブジェクト。An object that supplies culture-specific formatting information.

戻り値

formatProvider により指定された、現在の DateTimeOffset オブジェクトの値の文字列形式。A string representation of the value of the current DateTimeOffset object, as specified by formatProvider.

例外

日時が、formatProvider で使用されるカレンダーでサポートされている日付の範囲外です。The date and time is outside the range of dates supported by the calendar used by formatProvider.

次の例では、表示、DateTimeOffsetオブジェクトを使用してCultureInfoインバリアント カルチャとその他の 4 つのカルチャを表すオブジェクト。The following example displays a DateTimeOffset object using CultureInfo objects that represent the invariant culture, as well as four other cultures.

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
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ことには、スペースが含まれています。 ただし、メソッドの後に、文字列の末尾にオフセットが追加されます。The return value of this method is identical to that of its equivalent overload of the DateTime.ToString method, except that it includes a space followed by the offset appended at the end of the string. つまり、形式の長い時刻パターンの短い日付パターンを使用して、出力、およびzzzから直前の要素をスペースで区切られた各要素のカスタム書式指定文字列。In other words, it formats output using the short date pattern, the long time pattern, and the zzz custom format string, with each element separated from the previous element by a space.

これら 3 つの要素の書式を定義して、formatProviderパラメーター。The format of these three elements is defined by the formatProvider parameter. formatProviderパラメーターは、次のいずれかを指定できます。The formatProvider parameter can be either of the following:

場合formatProvidernullDateTimeFormatInfo 、現在のカルチャに関連付けられているオブジェクトを使用して (を参照してくださいCurrentCulture)。If formatProvider is null, the DateTimeFormatInfo object associated with the current culture is used (see CurrentCulture).

注意 (呼び出し元)

ToString(IFormatProvider)メソッドは、によって表されるカルチャで使用される暦で日付と時刻の文字列表現を返します、formatProviderパラメーター。The ToString(IFormatProvider) method returns the string representation of the date and time in the calendar used by the culture represented by the formatProvider parameter. そのカレンダーがによって定義されている、Calendarプロパティ。Its calendar is defined by the Calendar property. 場合、現在の値DateTimeOffsetインスタンスがよりも前かMinSupportedDateTimeかそれより遅いMaxSupportedDateTimeがスローされます、ArgumentOutOfRangeExceptionします。If the value of the current DateTimeOffset instance is earlier than MinSupportedDateTime or later than MaxSupportedDateTime, the method throws an ArgumentOutOfRangeException. 具体的な例を次に示します。The following example provides an illustration. 範囲外にある日付の書式設定しようと、JapaneseCalendarクラス。It attempts to format a date that is outside the range of the JapaneseCalendar class.

[!code-csharpSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#1] [!code-vbSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#1][!code-csharpSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#1] [!code-vbSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#1]

ToString(String) ToString(String) ToString(String) ToString(String)

指定した書式を使用して、現在の DateTimeOffset オブジェクトの値をそれと等価な文字列形式に変換します。Converts the value of the current DateTimeOffset object to its equivalent string representation using the specified format.

public:
 System::String ^ ToString(System::String ^ format);
public string ToString (string format);
override this.ToString : string -> string
Public Function ToString (format As String) As String

パラメーター

format
String String String String

書式指定文字列。A format string.

戻り値

format により指定された、現在の DateTimeOffset オブジェクトの値の文字列形式。A string representation of the value of the current DateTimeOffset object, as specified by format.

例外

format の長さは 1 であり、DateTimeFormatInfo で定義されている標準書式指定子文字の 1 つではありません。The length of format is one, and it is not one of the standard format specifier characters defined for DateTimeFormatInfo.

または-or- format には有効なカスタム書式パターンがありません。format does not contain a valid custom format pattern.

日時が、現在のカルチャで使用されるカレンダーでサポートされている日付の範囲外です。The date and time is outside the range of dates supported by the calendar used by the current culture.

次の例では、表示、DateTimeOffsetコンソールの標準の日付と時刻の書式指定子を使用するオブジェクト。The following example displays a DateTimeOffset object to the console using each of the standard date and time format specifiers. En を使用して、出力が書式設定のカルチャを返します。The output is formatted by using the en-us culture.

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)); 
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パラメーターは、単一の書式指定子の文字を含める必要があります (を参照してくださいStandard Date and Time Format Strings) またはカスタム書式パターン (を参照してくださいカスタム Date and Time Format Strings)、返される文字列の書式を定義します。The format parameter should contain either a single format specifier character (see Standard Date and Time Format Strings) or a custom format pattern (see Custom Date and Time Format Strings) that defines the format of the returned string. 場合formatが null または空の文字列 ("")、DateTimeOffset既定形式を使用して値を出力します。If format is a null or empty string (""), the DateTimeOffset value is output using the default format.

次の表に、特定の書式指定子と共に使用する場合の正確な操作DateTimeOffsetで使用する場合は、その動作が異なるDateTimeします。The following table shows the exact operation of certain format specifiers when used with DateTimeOffset, which differs from their behavior when used with DateTime.

既存の書式指定子Existing format specifier 新しい動作New behavior
"K""K" ラウンドト リップする日付と時刻。Designed to round-trip a date and time. DateTimeOffset、"Zzz"(オフセットは、時間と分で常に表示されます) にマップされます。With DateTimeOffset, maps to "zzz" (the offset is always displayed with hours and minutes). "K"カスタム書式指定子は、することに注意してください。内の 1 文字としては表示できませんformatします。Note that "K" is a custom format specifier; it cannot appear as the single character in format.
"U""U" サポートされていません。Not supported.
"r""r" 変換、DateTimeOffsetオブジェクトの世界協定時刻 (UTC) にし、カスタム書式指定文字列を使用して出力ddd, dd MMM yyyy HH:mm:ss GMTします。Converts the DateTimeOffset object to Coordinated Universal Time (UTC) and outputs it using the custom format string ddd, dd MMM yyyy HH:mm:ss GMT.
"u""u" 変換、DateTimeOffsetオブジェクトを UTC にし、出力形式を使用してyyyy-MM-dd HH:mm:ssZします。Converts the DateTimeOffset object to UTC and outputs it using the format yyyy-MM-dd HH:mm:ssZ.

残りの標準の日付と時刻の書式指定子の動作と同じで、ToString(String)メソッドを使用する場合、ToStringメソッド。The remaining standard date and time format specifiers behave the same with the ToString(String) method as they do with the ToString method.

このメソッドは、基に、現在のカルチャの書式情報を使用します。This method uses formatting information derived from the current culture. 詳細については、「CurrentCulture」を参照してください。For more information, see CurrentCulture.

注意 (呼び出し元)

ToString(String)メソッドは、現在のカルチャで使用される暦で日付と時刻の文字列表現を返します。The ToString(String) method returns the string representation of the date and time in the calendar used by the current culture. 場合、現在の値DateTimeOffsetインスタンスがよりも前かMinSupportedDateTimeかそれより遅いMaxSupportedDateTimeがスローされます、ArgumentOutOfRangeExceptionします。If the value of the current DateTimeOffset instance is earlier than MinSupportedDateTime or later than MaxSupportedDateTime, the method throws an ArgumentOutOfRangeException. 具体的な例を次に示します。The following example provides an illustration. 範囲外にある日付の書式設定しようと、HebrewCalendarクラスの現在のカルチャがヘブライ語 (イスラエル)。It attempts to format a date that is outside the range of the HebrewCalendar class when the current culture is Hebrew (Israel).

[!code-csharpSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#3] [!code-vbSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#3][!code-csharpSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#3] [!code-vbSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#3]

こちらもご覧ください

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

指定した書式およびカルチャ固有の書式情報を使用して、現在の DateTimeOffset オブジェクトの値をそれと等価の文字列形式に変換します。Converts the value of the current DateTimeOffset object to its equivalent string representation using the specified format and culture-specific format information.

public:
 virtual System::String ^ ToString(System::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 String String String

書式指定文字列。A format string.

formatProvider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

カルチャ固有の書式情報を提供するオブジェクト。An object that supplies culture-specific formatting information.

戻り値

format および provider により指定された、現在の DateTimeOffset オブジェクトの値の文字列形式。A string representation of the value of the current DateTimeOffset object, as specified by format and provider.

実装

例外

format の長さは 1 であり、DateTimeFormatInfo で定義されている標準書式指定子文字の 1 つではありません。The length of format is one, and it is not one of the standard format specifier characters defined for DateTimeFormatInfo.

または-or- format には有効なカスタム書式パターンがありません。format does not contain a valid custom format pattern.

日時が、formatProvider で使用されるカレンダーでサポートされている日付の範囲外です。The date and time is outside the range of dates supported by the calendar used by formatProvider.

次の例では、ToString(String, IFormatProvider)を表示するメソッド、DateTimeOffsetいくつかの異なるカルチャのカスタム書式指定文字列を使用してオブジェクトします。The following example uses the ToString(String, IFormatProvider) method to display a DateTimeOffset object using a custom format string for several different cultures.

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
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パラメーターは、単一の書式指定子の文字を含める必要があります (を参照してくださいStandard Date and Time Format Strings) またはカスタム書式パターン (を参照してくださいカスタム Date and Time Format Strings).The format parameter should contain either a single format specifier character (see Standard Date and Time Format Strings) or a custom format pattern (see Custom Date and Time Format Strings). 場合formatが null または空の文字列 ("")、DateTimeOffset既定形式を使用してオブジェクトを出力します。If format is a null or empty string (""), the DateTimeOffset object is output using the default format.

次の表に、特定の書式指定子と共に使用する場合の正確な操作DateTimeOffsetで使用する場合は、その動作が異なるDateTimeします。The following table shows the exact operation of certain format specifiers when used with DateTimeOffset, which differs from their behavior when used with DateTime.

既存の書式指定子Existing format specifier 新しい動作New behavior
"K""K" ラウンドト リップする日付と時刻。Designed to round-trip a date and time. DateTimeOffset、"Zzz"(オフセットは、時間と分で常に表示されます) にマップされます。With DateTimeOffset, maps to "zzz" (the offset is always displayed with hours and minutes). "K"カスタム書式指定子は、することに注意してください。内の 1 文字としては表示できませんformatします。Note that "K" is a custom format specifier; it cannot appear as the single character in format.
"U""U" サポートされていません。Not supported.
"r""r" 変換、DateTimeOffsetオブジェクトの世界協定時刻 (UTC) にし、カスタム書式指定文字列を使用して出力ddd, dd MMM yyyy HH:mm:ss GMTします。Converts the DateTimeOffset object to Coordinated Universal Time (UTC) and outputs it using the custom format string ddd, dd MMM yyyy HH:mm:ss GMT.
"u""u" 変換、DateTimeOffset値を UTC にし、出力形式を使用してyyyy-MM-dd HH:mm:ssZします。Converts the DateTimeOffset value to UTC and outputs it using the format yyyy-MM-dd HH:mm:ssZ.

残りの標準の日付と時刻の書式指定子の動作と同じで、ToString(String)メソッドを使用する場合、ToStringメソッド。The remaining standard date and time format specifiers behave the same with the ToString(String) method as they do with the ToString method.

によって、標準書式指定子だけでなく、シンボルと日付と時刻のコンポーネントの名前に対応するパターンが定義されている、formatProviderパラメーター。The pattern that corresponds to standard format specifiers, as well as the symbols and names of date and time components, is defined by the formatProvider parameter. formatProviderパラメーターは、次のいずれかを指定できます。The formatProvider parameter can be either of the following:

場合formatProvidernullDateTimeFormatInfo 、現在のカルチャに関連付けられているオブジェクトを使用して (を参照してくださいCurrentCulture)。If formatProvider is null, the DateTimeFormatInfo object associated with the current culture is used (see CurrentCulture).

注意 (呼び出し元)

ToString(String, IFormatProvider)メソッドで使用する暦で日付と時刻の文字列表現を返します、formatProviderパラメーター。The ToString(String, IFormatProvider) method returns the string representation of the date and time in the calendar used by the formatProvider parameter. そのカレンダーがによって定義されている、Calendarプロパティ。Its calendar is defined by the Calendar property. 場合、現在の値DateTimeOffsetインスタンスがよりも前かMinSupportedDateTimeかそれより遅いMaxSupportedDateTimeがスローされます、ArgumentOutOfRangeExceptionします。If the value of the current DateTimeOffset instance is earlier than MinSupportedDateTime or later than MaxSupportedDateTime, the method throws an ArgumentOutOfRangeException. 具体的な例を次に示します。The following example provides an illustration. 範囲外にある日付の書式設定しようと、UmAlQuraCalendarクラス。It attempts to format a date that is outside the range of the UmAlQuraCalendar class.

[!code-csharpSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#4] [!code-vbSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#4][!code-csharpSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#4] [!code-vbSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#4]

こちらもご覧ください

適用対象