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

Возвраты

Строковое представление объекта 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)

Преобразует числовое значение текущего объекта 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

Объект, предоставляющий сведения о форматировании для определенного языка и региональных параметров.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.

Если 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, метод создает исключение 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)

Преобразует значение текущего объекта 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

Строка формата.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" Преобразует объект 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, метод создает исключение 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)

Преобразует значение текущего объекта 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

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

formatProvider
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 должен содержать один символ описателя формата (см. раздел стандартные строки формата даты и времени) или шаблон пользовательского формата (см. раздел настраиваемые строки формата даты и времени).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.
Cерверный"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:

  • Объект 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.

Если 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, метод создает исключение 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]

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

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