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 시스템에서 출력을 표시 하 고-주세요.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() 2008 년 1 월 12의 값을 반환 오후 6시 15분: 50, ToString() 2008 년 1 월 12의 값을 반환 오후 6시 15분: 50-08:8 시간 뒤 Utc (협정 세계시) 시간을 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, 메서드가 throw는 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).

[! 코드 csharpSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#2] [! 코드 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.

반환

현재 DateTimeOffset 개체의 값을 formatProvider에 지정된 대로 나타낸 문자열 표현입니다.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 고정 문화권을 뿐만 아니라 다른 네 개 문화권을 나타내는 개체입니다.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.

이러한 세 가지 요소 형식의 정의한는 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).

호출자 참고

합니다 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, 메서드가 throw는 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.

[! 코드 csharpSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#1] [! 코드 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.

반환

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

예외

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.

예제

다음 예제에서는 표시를 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)) 

설명

합니다 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.

다음 표에서 특정 형식 지정자와 함께 사용할 때의 정확한 작업을 보여 줍니다. 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" 변환 된 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, 메서드가 throw는 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).

[! 코드 csharpSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#3] [! 코드 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.

반환

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

구현

예외

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.

예제

다음 예제에서는 합니다 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" 변환 된 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:

경우 formatProvider 됩니다 null, 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, 메서드가 throw는 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.

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

추가 정보

적용 대상