DateTimeOffset.ToString メソッド

定義

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

オーバーロード

ToString()

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

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)

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

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()

現在の 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. たとえば、DateTime.ToString() が 1/12/2008 6:15:50 PM の値を返す場合、ToString() は世界協定時刻 (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 インスタンスの値が 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)

指定したカルチャ固有の書式情報を使用して、現在の 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

カルチャ固有の書式情報を提供するオブジェクト。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.

次の例では、インバリアントカルチャを表す CultureInfo オブジェクト、およびその他4つのカルチャを使用して、DateTimeOffset オブジェクトを表示します。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:

formatProvidernull場合は、現在のカルチャに関連付けられている DateTimeFormatInfo オブジェクトが使用されます (「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)

指定した書式を使用して、現在の 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

書式指定文字列。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に1つの文字として表示することはできません。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 メソッドと同様に、ToString(String) メソッドでも同じように動作します。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)

指定した書式およびカルチャ固有の書式情報を使用して、現在の 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

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

formatProvider
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 パラメーターには、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). 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に1つの文字として表示することはできません。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 メソッドと同様に、ToString(String) メソッドでも同じように動作します。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:

formatProvidernull場合は、現在のカルチャに関連付けられている DateTimeFormatInfo オブジェクトが使用されます (「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]

こちらもご覧ください

適用対象