DateTimeOffset.ToString Method

Definition

현재 DateTimeOffset 개체의 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the current DateTimeOffset object to its equivalent string representation.

Overloads

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

Returns

String

문자열 끝에 추가되는 오프셋을 포함하는 DateTimeOffset 개체의 문자열 표현입니다.A string representation of a DateTimeOffset object that includes the offset appended at the end of the string.

Exceptions

날짜 및 시간이 현재 문화권에서 사용되는 달력에서 지원하는 날짜 범위를 벗어납니다.The date and time is outside the range of dates supported by the calendar used by the current culture.

Examples

다음 예제에서는 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

Remarks

이 메서드의 반환 값은 문자열의 끝에 공백을 추가 하 고 그 뒤에 오프셋을 추가 한다는 점을 제외 하 고 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.

Notes to Callers

ToString() 메서드는 현재 문화권에서 사용 하는 달력의 날짜 및 시간에 대 한 문자열 표현을 반환 합니다.The ToString() method returns the string representation of the date and time in the calendar used by the current culture. 현재 DateTimeOffset 인스턴스의 값이 MaxSupportedDateTime보다 이전 이거나 MinSupportedDateTime 보다 이전인 경우 메서드는 ArgumentOutOfRangeException을 throw 합니다.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-csharpArgumentOutOfRangeException # 2] [! code-vbArgumentOutOfRangeException # 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

Parameters

formatProvider
IFormatProvider

문화권별 형식 정보를 제공하는 개체입니다.An object that supplies culture-specific formatting information.

Returns

String

현재 DateTimeOffset 개체의 값을 formatProvider에 지정된 대로 나타낸 문자열 표현입니다.A string representation of the value of the current DateTimeOffset object, as specified by formatProvider.

Exceptions

날짜 및 시간이 formatProvider에서 사용되는 달력에서 지원하는 날짜 범위를 벗어납니다.The date and time is outside the range of dates supported by the calendar used by formatProvider.

Examples

다음 예제에서는 고정 문화권을 나타내는 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

Remarks

이 메서드의 반환 값은 문자열의 끝에 공백을 추가 하 고 그 뒤에 오프셋을 추가 한다는 점을 제외 하 고는 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.

이러한 세 요소의 형식은 formatProvider 매개 변수에 의해 정의 됩니다.The format of these three elements is defined by the formatProvider parameter. formatProvider 매개 변수는 다음 중 하나일 수 있습니다.The formatProvider parameter can be either of the following:

formatProvider null되 면 현재 문화권과 연결 된 DateTimeFormatInfo 개체가 사용 됩니다 (CurrentCulture참조).If formatProvider is null, the DateTimeFormatInfo object associated with the current culture is used (see CurrentCulture).

Notes to Callers

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 인스턴스의 값이 MaxSupportedDateTime보다 이전 이거나 MinSupportedDateTime 보다 이전인 경우 메서드는 ArgumentOutOfRangeException을 throw 합니다.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-csharpArgumentOutOfRangeException # 1] [! code-vbArgumentOutOfRangeException # 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

Parameters

format
String

서식 문자열입니다.A format string.

Returns

String

현재 DateTimeOffset 개체의 값을 format에 지정된 대로 나타낸 문자열 표현입니다.A string representation of the value of the current DateTimeOffset object, as specified by format.

Exceptions

format의 길이가 1이고 DateTimeFormatInfo에 대해 정의된 표준 형식 지정자 문자 중 하나가 아닙니다.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.

Examples

다음 예에서는 표준 날짜 및 시간 형식 지정자를 사용 하 여 콘솔에 DateTimeOffset 개체를 표시 합니다.The following example displays a DateTimeOffset object to the console using each of the standard date and time format specifiers. 출력은 en를 사용 하 여 형식이-culture입니다.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)) 

Remarks

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

다음 표에서는 DateTime와 함께 사용 될 때의 동작과 다른 DateTimeOffset와 함께 사용 될 때 특정 형식 지정자의 정확한 연산을 보여 줍니다.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" 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.

Notes to Callers

ToString(String) 메서드는 현재 문화권에서 사용 하는 달력의 날짜 및 시간에 대 한 문자열 표현을 반환 합니다.The ToString(String) method returns the string representation of the date and time in the calendar used by the current culture. 현재 DateTimeOffset 인스턴스의 값이 MaxSupportedDateTime보다 이전 이거나 MinSupportedDateTime 보다 이전인 경우 메서드는 ArgumentOutOfRangeException을 throw 합니다.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-csharpArgumentOutOfRangeException # 3] [! code-vbArgumentOutOfRangeException # 3][!code-csharpSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#3] [!code-vbSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#3]

See also

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

Parameters

format
String

서식 문자열입니다.A format string.

formatProvider
IFormatProvider

문화권별 형식 정보를 제공하는 개체입니다.An object that supplies culture-specific formatting information.

Returns

String

현재 DateTimeOffset 개체의 값을 formatprovider에 지정된 대로 나타낸 문자열 표현입니다.A string representation of the value of the current DateTimeOffset object, as specified by format and provider.

Implements

Exceptions

format의 길이가 1이고 DateTimeFormatInfo에 대해 정의된 표준 형식 지정자 문자 중 하나가 아닙니다.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.

Examples

다음 예제에서는 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

Remarks

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.

다음 표에서는 DateTime와 함께 사용 될 때의 동작과 다른 DateTimeOffset와 함께 사용 될 때 특정 형식 지정자의 정확한 연산을 보여 줍니다.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" 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:

formatProvider null되 면 현재 문화권과 연결 된 DateTimeFormatInfo 개체가 사용 됩니다 (CurrentCulture참조).If formatProvider is null, the DateTimeFormatInfo object associated with the current culture is used (see CurrentCulture).

Notes to Callers

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 인스턴스의 값이 MaxSupportedDateTime보다 이전 이거나 MinSupportedDateTime 보다 이전인 경우 메서드는 ArgumentOutOfRangeException을 throw 합니다.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-csharpArgumentOutOfRangeException # 4] [! code-vbArgumentOutOfRangeException # 4][!code-csharpSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#4] [!code-vbSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#4]

See also

Applies to