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

반환

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 메서드는을 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).

[! 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);
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.

반환

String

현재 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.

::: code language = "csharp" source = "~/samples/snippets/csharp/VS_Snippets_CLR_System/system.datetimeoffset.tostring.argumentoutofrangeexception/cs/datetimeoffset.tostring.argumentoutofrangeexception1.cs" interactive = "try...catch" id = "Snippet1":::::: code language = "vb" source = "~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.datetimeoffset.tostring.argumentoutofrangeexception/vb/datetimeoffset.tostring.argumentoutofrangeexception1.vb" id = "Snippet1"::::::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.datetimeoffset.tostring.argumentoutofrangeexception/cs/datetimeoffset.tostring.argumentoutofrangeexception1.cs" interactive="try-dotnet" id="Snippet1"::: :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.datetimeoffset.tostring.argumentoutofrangeexception/vb/datetimeoffset.tostring.argumentoutofrangeexception1.vb" id="Snippet1":::

적용 대상

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);
public string ToString (string? format);
override this.ToString : string -> string
Public Function ToString (format As String) As String

매개 변수

format
String

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

반환

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-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매개 변수는 반환 된 문자열의 형식을 정의 하는 단일 형식 지정자 문자 ( 표준 날짜 및 시간 형식 문자열참조) 또는 사용자 지정 형식 패턴 ( 사용자 지정 날짜 및 시간 형식 문자열참조) 중 하나를 포함 해야 합니다.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" 개체를 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).

::: code language = "csharp" source = "~/samples/snippets/csharp/VS_Snippets_CLR_System/system.datetimeoffset.tostring.argumentoutofrangeexception/cs/datetimeoffset.tostring.argumentoutofrangeexception3.cs" interactive = "try...catch" id = "Snippet3":::::: code language = "vb" source = "~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.datetimeoffset.tostring.argumentoutofrangeexception/vb/datetimeoffset.tostring.argumentoutofrangeexception3.vb" id = "Snippet3"::::::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.datetimeoffset.tostring.argumentoutofrangeexception/cs/datetimeoffset.tostring.argumentoutofrangeexception3.cs" interactive="try-dotnet" id="Snippet3"::: :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.datetimeoffset.tostring.argumentoutofrangeexception/vb/datetimeoffset.tostring.argumentoutofrangeexception3.vb" id="Snippet3":::

적용 대상

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

반환

String

현재 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" 개체를 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.

::: code language = "csharp" source = "~/samples/snippets/csharp/VS_Snippets_CLR_System/system.datetimeoffset.tostring.argumentoutofrangeexception/cs/datetimeoffset.tostring.argumentoutofrangeexception4.cs" id = "Snippet4":::::: code language = "vb" source = "~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.datetimeoffset.tostring.argumentoutofrangeexception/vb/datetimeoffset.tostring.argumentoutofrangeexception4.vb" id = "Snippet4"::::::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.datetimeoffset.tostring.argumentoutofrangeexception/cs/datetimeoffset.tostring.argumentoutofrangeexception4.cs" id="Snippet4"::: :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.datetimeoffset.tostring.argumentoutofrangeexception/vb/datetimeoffset.tostring.argumentoutofrangeexception4.vb" id="Snippet4":::

적용 대상