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()の呼び出しを示し、現在のカルチャが en-us であるシステムでその出力を表示します。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. たとえば、が 1/12/2008 6:15:50 DateTime.ToString() ToString() pm という値を返した場合、は世界協定時刻 (UTC) の8時間後に 1/12/2008 6:15:50 pm-08:00 の値を返します。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のインスタンスの値がよりMaxSupportedDateTimeMinSupportedDateTime前か後である場合、メソッドはを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:

formatProvider DateTimeFormatInfo CurrentCultureの場合は、現在のカルチャに関連付けられているオブジェクトが使用されます (「」を参照してください)。 nullIf 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のインスタンスの値がよりMaxSupportedDateTimeMinSupportedDateTime前か後である場合、メソッドはを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-us カルチャを使用して書式設定されます。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には、返されるの形式を定義する1つの書式指定子文字 (標準の日付と時刻の書式指定文字列を参照) またはカスタム書式パターン (「カスタム日時書式指定文字列」を参照) のいずれかを含める必要があります。文字列.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" はカスタム書式指定子であることに注意してください。でformatは、これを単一の文字として表示することはできません。Note that "K" is a custom format specifier; it cannot appear as the single character in format.
"U""U" サポートされていません。Not supported.
"r""r" オブジェクトを世界協定時刻 (UTC) に変換し、カスタム書式指定文字列ddd, dd MMM yyyy HH:mm:ss GMTを使用して出力します。 DateTimeOffsetConverts 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のインスタンスの値がよりMaxSupportedDateTimeMinSupportedDateTime前か後である場合、メソッドはを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には、単一の書式指定子文字 (「標準の日付と時刻の書式指定文字列」を参照) またはカスタム書式パターン (「カスタム日時書式指定文字列」を参照) のいずれかを含める必要があります。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" はカスタム書式指定子であることに注意してください。でformatは、これを単一の文字として表示することはできません。Note that "K" is a custom format specifier; it cannot appear as the single character in format.
"U""U" サポートされていません。Not supported.
"r""r" オブジェクトを世界協定時刻 (UTC) に変換し、カスタム書式指定文字列ddd, dd MMM yyyy HH:mm:ss GMTを使用して出力します。 DateTimeOffsetConverts 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" 値を UTC に変換し、形式yyyy-MM-dd HH:mm:ssZを使用して出力します。 DateTimeOffsetConverts 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:

formatProvider DateTimeFormatInfo CurrentCultureの場合は、現在のカルチャに関連付けられているオブジェクトが使用されます (「」を参照してください)。 nullIf 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のインスタンスの値がよりMaxSupportedDateTimeMinSupportedDateTime前か後である場合、メソッドはを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]

こちらもご覧ください

適用対象