DateTimeOffset.ToString DateTimeOffset.ToString DateTimeOffset.ToString DateTimeOffset.ToString Method

Определение

Преобразует значение текущего объекта DateTimeOffset в эквивалентное ему строковое представление.Converts the value of the current DateTimeOffset object to its equivalent string representation.

Перегрузки

ToString() ToString() ToString() ToString()

Преобразует значение текущего объекта DateTimeOffset в эквивалентное ему строковое представление.Converts the value of the current DateTimeOffset object to its equivalent string representation.

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

Преобразует значение текущего DateTimeOffset объекта в эквивалентное ему строковое представление с использованием указанного языка и региональных параметров сведения об особенностях форматирования.Converts the value of the current DateTimeOffset object to its equivalent string representation using the specified culture-specific formatting information.

ToString(String) ToString(String) ToString(String) ToString(String)

Преобразует значение текущего объекта DateTimeOffset в эквивалентное ему строковое представление с использованием заданного формата.Converts the value of the current DateTimeOffset object to its equivalent string representation using the specified format.

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

Преобразует значение текущего объекта DateTimeOffset в эквивалентное ему строковое представление с использованием указанного формата и сведений об особенностях формата для данного языка и региональных параметров.Converts the value of the current DateTimeOffset object to its equivalent string representation using the specified format and culture-specific format information.

ToString() ToString() ToString() ToString()

Преобразует значение текущего объекта DateTimeOffset в эквивалентное ему строковое представление.Converts the value of the current DateTimeOffset object to its equivalent string representation.

public:
 override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

Возвраты

Строковое представление DateTimeOffset объект, который включает смещение, добавленное в конце строки.A string representation of a DateTimeOffset object that includes the offset appended at the end of the string.

Исключения

Дата и время находятся за пределами диапазона дат, поддерживаемого календарем, принятым для текущего языка и региональных параметров.The date and time is outside the range of dates supported by the calendar used by the current culture.

Примеры

В следующем примере показано вызовы ToString() метод и отображение его выходных данных в системе, в которой текущий язык — en-us.The following example illustrates calls to the ToString() method and displays its output on a system whose current culture is en-us.

DateTimeOffset thisDate;

// Show output for UTC time
thisDate = DateTimeOffset.UtcNow;
Console.WriteLine(thisDate.ToString());  // Displays 3/28/2007 7:13:50 PM +00:00

// Show output for local time 
thisDate = DateTimeOffset.Now;
Console.WriteLine(thisDate.ToString());  // Displays 3/28/2007 12:13:50 PM -07:00

// Show output for arbitrary time offset
thisDate = thisDate.ToOffset(new TimeSpan(-5, 0, 0));
Console.WriteLine(thisDate.ToString());  // Displays 3/28/2007 2:13:50 PM -05:00
Dim thisDate As DateTimeOffset

' Show output for UTC time
thisDate = DateTimeOffset.UtcNow
Console.WriteLine(thisDate.ToString())  ' Displays 3/28/2007 7:13:50 PM +00:00

' Show output for local time 
thisDate = DateTimeOffset.Now
Console.WriteLine(thisDate.ToString())  ' Displays 3/28/2007 12:13:50 PM -07:00

' Show output for arbitrary time offset
thisDate = thisDate.ToOffset(new TimeSpan(-5, 0, 0))
Console.WriteLine(thisDate.ToString())  ' Displays 3/28/2007 2:13:50 PM -05:00

Комментарии

Возвращаемое значение этого метода идентична DateTime.ToString() за тем исключением, что он содержит пробел, следуют смещение, добавленное в конце строки.The return value of this method is identical to that of the DateTime.ToString() method, except that it includes a space followed by the offset appended at the end of the string. Другими словами, он форматирует выходные данные с помощью шаблона короткого формата даты, длинный шаблон времени и zzz строке настраиваемого формата, при этом каждый элемент отделяется от предыдущего элемента пробелом.In other words, it formats output using the short date pattern, the long time pattern, and the zzz custom format string, with each element separated from the previous element by a space. Например если DateTime.ToString() возвращает значение 1/12/2008 6:15:50 PM, ToString() возвращает значение 1/12/2008 6:15:50 PM -08:00 в течение времени, которое составляет восемь часов за временем по Гринвичу (UTC).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) 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:

  • Объект CultureInfo , представляющий язык и региональные параметры, соглашения о форматировании которых применяются к возвращаемой строки.A CultureInfo object that represents the culture whose formatting conventions are applied to the returned string. DateTimeFormatInfo Объект, возвращаемый CultureInfo.DateTimeFormat свойство определяет, форматированием возвращаемой строки.The DateTimeFormatInfo object returned by the CultureInfo.DateTimeFormat property defines the formatting of the returned string.

  • Объект DateTimeFormatInfo объект, который определяет формат данных даты и времени.A DateTimeFormatInfo object that defines the format of date and time data.

Если 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) 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-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 Параметр должен содержать либо символ описателя формата (см. в разделе Standard Date и Time Format Strings) или настраиваемый шаблон формата (см. в разделе пользовательские строки даты и времени формат ), определяющий формат возвращаемой строки.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 в формате 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, метод вызывает ArgumentOutOfRangeException.If the value of the current DateTimeOffset instance is earlier than MinSupportedDateTime or later than MaxSupportedDateTime, the method throws an ArgumentOutOfRangeException. Ниже приведен пример.The following example provides an illustration. Он выполняет попытку отформатировать дату, которая находится вне диапазона от HebrewCalendar класса, если текущий язык — иврит (Израиль).It attempts to format a date that is outside the range of the HebrewCalendar class when the current culture is Hebrew (Israel).

[!code-csharpSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#3] [!code-vbSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#3][!code-csharpSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#3] [!code-vbSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#3]

Дополнительно

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

Преобразует значение текущего объекта DateTimeOffset в эквивалентное ему строковое представление с использованием указанного формата и сведений об особенностях формата для данного языка и региональных параметров.Converts the value of the current DateTimeOffset object to its equivalent string representation using the specified format and culture-specific format information.

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ formatProvider);
public string ToString (string format, IFormatProvider formatProvider);
override this.ToString : string * IFormatProvider -> string
Public Function ToString (format As String, formatProvider As IFormatProvider) As String

Параметры

format
String String String String

Строка формата.A format string.

formatProvider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Объект, предоставляющий сведения о форматировании для определенного языка и региональных параметров.An object that supplies culture-specific formatting information.

Возвраты

Строковое представление значения текущего объекта DateTimeOffset, заданное параметрами format и provider.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 Параметр должен содержать либо символ описателя формата (см. в разделе Standard Date и Time Format Strings) или настраиваемый шаблон формата (см. в разделе пользовательские строки даты и времени формат ).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 в формате 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:

  • Объект CultureInfo , представляющий язык и региональные параметры, форматирование которого используется в input.A CultureInfo object that represents the culture whose formatting is used in input. DateTimeFormatInfo Объект, возвращаемый CultureInfo.DateTimeFormat свойство определяет, используемое в форматирование input.The DateTimeFormatInfo object returned by the CultureInfo.DateTimeFormat property defines the formatting used in input.

  • Объект DateTimeFormatInfo объект, который определяет формат данных даты и времени.A DateTimeFormatInfo object that defines the format of date and time data.

Если 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]

Дополнительно

Применяется к