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 в течение 8 часов после времени в формате 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. Объект, возвращаемый свойством, определяет форматирование возвращаемой строки. CultureInfo.DateTimeFormat DateTimeFormatInfoThe 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.

Если formatProvider имеет nullзначение, DateTimeFormatInfo то используется объект, связанный с текущим языком и региональными параметрами (см. раздел CurrentCulture).If formatProvider is null, the DateTimeFormatInfo object associated with the current culture is used (see CurrentCulture).

Примечания для тех, кто вызывает этот метод

Метод возвращает строковое представление даты и времени в календаре, используемом культурой, представленной formatProvider параметром. ToString(IFormatProvider)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 Строка.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.
Cерверный"r" Преобразует объект в формат UTC и выводит его с помощью строки ddd, dd MMM yyyy HH:mm:ss GMTнастраиваемого формата. DateTimeOffsetConverts 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" Преобразует объект в формат UTC и выводит его в формате yyyy-MM-dd HH:mm:ssZ. DateTimeOffsetConverts 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

Комментарии

Параметр должен содержать один символ описателя формата (см. строки стандартных форматов даты и времени) или шаблон пользовательского формата (см. раздел настраиваемые строки формата даты и времени). formatThe 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.
Cерверный"r" Преобразует объект в формат UTC и выводит его с помощью строки ddd, dd MMM yyyy HH:mm:ss GMTнастраиваемого формата. DateTimeOffsetConverts 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" Преобразует значение в UTC и выводит его в формате yyyy-MM-dd HH:mm:ssZ. DateTimeOffsetConverts 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:

  • Объект, представляющий язык и региональные параметры, форматирование которых используется inputв. CultureInfoA CultureInfo object that represents the culture whose formatting is used in input. Объект, возвращаемый свойством, определяет форматирование, используемое в input. CultureInfo.DateTimeFormat DateTimeFormatInfoThe 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.

Если formatProvider имеет nullзначение, DateTimeFormatInfo то используется объект, связанный с текущим языком и региональными параметрами (см. раздел CurrentCulture).If formatProvider is null, the DateTimeFormatInfo object associated with the current culture is used (see CurrentCulture).

Примечания для тех, кто вызывает этот метод

Метод возвращает строковое представление даты и времени в календаре, используемом formatProvider параметром. ToString(String, IFormatProvider)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]

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

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