DateTimeOffset.ToString Metoda

Definice

Převede hodnotu aktuálního objektu na jeho DateTimeOffset ekvivalentní řetězcové vyjádření.

Přetížení

ToString()

Převede hodnotu aktuálního objektu na jeho DateTimeOffset ekvivalentní řetězcové vyjádření.

ToString(IFormatProvider)

Převede hodnotu aktuálního DateTimeOffset objektu na odpovídající řetězcovou reprezentaci pomocí zadaných informací o formátování specifických pro jazykovou verzi.

ToString(String)

Převede hodnotu aktuálního DateTimeOffset objektu na odpovídající řetězcovou reprezentaci pomocí zadaného formátu.

ToString(String, IFormatProvider)

Převede hodnotu aktuálního DateTimeOffset objektu na odpovídající řetězcovou reprezentaci pomocí zadaného formátu a informací o formátu specifické jazykové verze.

ToString()

Převede hodnotu aktuálního objektu na jeho DateTimeOffset ekvivalentní řetězcové vyjádření.

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

Návraty

String

Řetězcová reprezentace DateTimeOffset objektu, který obsahuje posun připojený na konec řetězce.

Výjimky

Datum a čas je mimo rozsah dat podporovaných kalendářem, který používá aktuální jazyková verze.

Příklady

Následující příklad znázorňuje volání ToString() metody a zobrazuje výstup v systému, jehož aktuální jazyková verze je 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

Poznámky

Vrácená hodnota této metody je stejná jako u metody s tím rozdílem, že obsahuje mezeru následovanou posunem připojeným na DateTime.ToString() konec řetězce. Jinými slovy formátuje výstup pomocí vzoru krátkého data, vzoru dlouhého času a vlastního formátovacího řetězce, kdy každý prvek je oddělený od předchozího prvku zzz mezerou. Pokud například vrátí hodnotu DateTime.ToString() 12.1.2008 18:15:50, vrátí hodnotu ToString() 12/12/2008 18:15:50 -08:00 pro čas, který je osm hodin za koordinovaným univerzálním časem (UTC).

Tato metoda používá informace o formátování odvozené od aktuální jazykové verze. Další informace naleznete v tématu CurrentCulture. Další přetížení ToString metody umožňují zadat jazykovou verzi, jejíž formátování má být použito, a definovat výstupní vzorek DateTimeOffset hodnoty.

Poznámky pro volající

ToString()Metoda vrátí řetězcovou reprezentaci data a času v kalendáři používaném aktuální jazykovou verzí. Pokud hodnota aktuální DateTimeOffset instance je dřívější než MinSupportedDateTime nebo novější než MaxSupportedDateTime , metoda vyvolá ArgumentOutOfRangeException . V následujícím příkladu je uvedena ukázka. Pokusí se formátovat datum, které je mimo rozsah HijriCalendar třídy, pokud je aktuální jazyková verze Arabština (Sýrie).

using System;
using System.Globalization;
using System.Threading;

public class Example
{
   public static void Main()
   {
      DateTimeOffset date1 = new DateTimeOffset(new DateTime(550, 1, 1),
                                                TimeSpan.Zero);
      CultureInfo dft;
      CultureInfo arSY = new CultureInfo("ar-SY");
      arSY.DateTimeFormat.Calendar = new HijriCalendar();

      // Change current culture to ar-SY.
      dft = Thread.CurrentThread.CurrentCulture;
      Thread.CurrentThread.CurrentCulture = arSY;

      // Display the date using the current culture's calendar.
      try {
         Console.WriteLine(date1.ToString());
      }
      catch (ArgumentOutOfRangeException) {
         Console.WriteLine("{0} is earlier than {1} or later than {2}",
                           date1.ToString("d", CultureInfo.InvariantCulture),
                           arSY.DateTimeFormat.Calendar.MinSupportedDateTime.ToString("d", CultureInfo.InvariantCulture),
                           arSY.DateTimeFormat.Calendar.MaxSupportedDateTime.ToString("d", CultureInfo.InvariantCulture));
      }

      // Restore the default culture.
      Thread.CurrentThread.CurrentCulture = dft;
   }
}
// The example displays the following output:
//    01/01/0550 is earlier than 07/18/0622 or later than 12/31/9999

Platí pro

ToString(IFormatProvider)

Převede hodnotu aktuálního DateTimeOffset objektu na odpovídající řetězcovou reprezentaci pomocí zadaných informací o formátování specifických pro jazykovou verzi.

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

Parametry

formatProvider
IFormatProvider

Objekt, který poskytuje informace o formátování specifické pro jazykovou verzi.

Návraty

String

Řetězcová reprezentace hodnoty aktuálního DateTimeOffset objektu, jak je určena parametrem formatProvider .

Výjimky

Datum a čas je mimo rozsah kalendářních dat, který používá kalendář formatProvider .

Příklady

Následující příklad zobrazí DateTimeOffset objekt pomocí CultureInfo objektů, které zastupují invariantní jazykovou verzi, a také čtyři jiné jazykové verze.

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

Poznámky

Návratová hodnota této metody je shodná s hodnotou odpovídající přetížení DateTime.ToString metody, s tím rozdílem, že obsahuje mezeru následovanou posunem připojeným na konci řetězce. Jinými slovy, formátuje výstup pomocí vzoru krátkého data, formátu dlouhého času a zzz řetězce vlastního formátu, s každým prvkem odděleným od předchozího prvku mezerou.

Formát těchto tří prvků je definován formatProvider parametrem. formatProviderParametr může mít jednu z následujících možností:

Pokud formatProvider je null , DateTimeFormatInfo použije se objekt přidružený k aktuální jazykové verzi (viz CurrentCulture ).

Poznámky pro volající

ToString(IFormatProvider)Metoda vrátí řetězcovou reprezentaci data a času v kalendáři používaném jazykovou verzí reprezentovanou formatProvider parametrem. Jeho kalendář je definován Calendar vlastností. Pokud hodnota aktuální DateTimeOffset instance je dřívější než MinSupportedDateTime nebo novější než MaxSupportedDateTime , metoda vyvolá ArgumentOutOfRangeException . V následujícím příkladu je uvedena ukázka. Pokusí se naformátovat datum, které je mimo rozsah JapaneseCalendar třídy.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      CultureInfo jaJP = new CultureInfo("ja-JP");
      jaJP.DateTimeFormat.Calendar = new JapaneseCalendar();
      DateTimeOffset date1 = new DateTimeOffset(new DateTime(1867, 1, 1),
                                                TimeSpan.Zero);

      try {
         Console.WriteLine(date1.ToString(jaJP));
      }
      catch (ArgumentOutOfRangeException) {
         Console.WriteLine("{0:d} is earlier than {1:d} or later than {2:d}",
                           date1,
                           jaJP.DateTimeFormat.Calendar.MinSupportedDateTime,
                           jaJP.DateTimeFormat.Calendar.MaxSupportedDateTime);
      }
   }
}
// The example displays the following output:
//    1/1/1867 is earlier than 9/8/1868 or later than 12/31/9999

Platí pro

ToString(String)

Převede hodnotu aktuálního DateTimeOffset objektu na odpovídající řetězcovou reprezentaci pomocí zadaného formátu.

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

Parametry

format
String

Formátovací řetězec

Návraty

String

Řetězcová reprezentace hodnoty aktuálního DateTimeOffset objektu, jak je určena parametrem format .

Výjimky

Délka format je jedna a není jedním ze standardních znaků specifikátoru formátu definovaných pro DateTimeFormatInfo .

-nebo-

format neobsahuje platný vlastní vzor formátu.

Datum a čas je mimo rozsah dat podporovaných kalendářem, který používá aktuální jazyková verze.

Příklady

Následující příklad zobrazí DateTimeOffset objekt pro konzolu pomocí každého specifikátoru standardního formátu data a času. Výstup je naformátován pomocí jazykové verze en-US.

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

Poznámky

formatParametr by měl obsahovat buď jeden znak specifikátoru formátu (viz Standardní řetězce formátu data a času), nebo vlastní vzorek formátu (viz vlastní formátovací řetězce data a času), které definují formát vráceného řetězce. Pokud format je řetězec s hodnotou null nebo prázdný řetězec (""), DateTimeOffset je hodnota výstup ve výchozím formátu.

Následující tabulka ukazuje přesné operace určitých specifikátorů formátu při použití s DateTimeOffset , což se liší od jejich chování při použití s nástrojem DateTime .

Existující specifikátor formátu Nové chování
"K" Slouží k přenosu data a času. S se DateTimeOffset mapuje na "ZZZ" (posun se vždycky zobrazuje v hodinách a minutách). Všimněte si, že "K" je specifikátor vlastního formátu; nemůže být použit jako jeden znak v format .
"U" Nepodporováno
í Převede DateTimeOffset objekt na koordinovaný světový čas (UTC) a vytvoří výstup pomocí vlastního formátovacího řetězce ddd, dd MMM yyyy HH:mm:ss GMT .
"u" Převede DateTimeOffset objekt na čas UTC a vytvoří výstup ve formátu yyyy-MM-dd HH:mm:ssZ .

Zbývající specifikátory standardního formátu data a času se chovají stejně ToString(String) jako metoda s metodou ToString .

Tato metoda používá informace o formátování odvozené od aktuální jazykové verze. Další informace naleznete v tématu CurrentCulture.

Poznámky pro volající

ToString(String)Metoda vrátí řetězcovou reprezentaci data a času v kalendáři používaném aktuální jazykovou verzí. Pokud hodnota aktuální DateTimeOffset instance je dřívější než MinSupportedDateTime nebo novější než MaxSupportedDateTime , metoda vyvolá ArgumentOutOfRangeException . V následujícím příkladu je uvedena ukázka. Pokusí se formátovat datum, které je mimo rozsah HebrewCalendar třídy, pokud je aktuální jazyková verze Hebrejština (Izrael).

using System;
using System.Globalization;
using System.Threading;

public class Example
{
   public static void Main()
   {
      DateTimeOffset date1 = new DateTimeOffset(new DateTime(1550, 7, 21),
                                                TimeSpan.Zero);
      CultureInfo dft;
      CultureInfo heIL = new CultureInfo("he-IL");
      heIL.DateTimeFormat.Calendar = new HebrewCalendar();

      // Change current culture to he-IL.
      dft = Thread.CurrentThread.CurrentCulture;
      Thread.CurrentThread.CurrentCulture = heIL;

      // Display the date using the current culture's calendar.
      try {
         Console.WriteLine(date1.ToString("G"));
      }
      catch (ArgumentOutOfRangeException) {
         Console.WriteLine("{0} is earlier than {1} or later than {2}",
                           date1.ToString("d", CultureInfo.InvariantCulture),
                           heIL.DateTimeFormat.Calendar.MinSupportedDateTime.ToString("d", CultureInfo.InvariantCulture),
                           heIL.DateTimeFormat.Calendar.MaxSupportedDateTime.ToString("d", CultureInfo.InvariantCulture));
      }

      // Restore the default culture.
      Thread.CurrentThread.CurrentCulture = dft;
   }
}
// The example displays the following output:
//    07/21/1550 is earlier than 01/01/1583 or later than 09/29/2239

Viz také

Platí pro

ToString(String, IFormatProvider)

Převede hodnotu aktuálního DateTimeOffset objektu na odpovídající řetězcovou reprezentaci pomocí zadaného formátu a informací o formátu specifické jazykové verze.

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

Parametry

format
String

Formátovací řetězec

formatProvider
IFormatProvider

Objekt, který poskytuje informace o formátování specifické pro jazykovou verzi.

Návraty

String

Řetězcová reprezentace hodnoty aktuálního DateTimeOffset objektu, jak je určena hodnotou format a provider .

Implementuje

Výjimky

Délka format je jedna a není jedním ze standardních znaků specifikátoru formátu definovaných pro DateTimeFormatInfo .

-nebo-

format neobsahuje platný vlastní vzor formátu.

Datum a čas je mimo rozsah kalendářních dat, který používá kalendář formatProvider .

Příklady

Následující příklad používá ToString(String, IFormatProvider) metodu k zobrazení DateTimeOffset objektu pomocí vlastního formátovacího řetězce pro několik různých kultur.

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

Poznámky

formatParametr by měl obsahovat buď jeden znak specifikátoru formátu (viz Standardní řetězce formátu data a času), nebo vlastní vzorek formátu (viz Vlastní řetězce formátu data a času). Pokud format je hodnota null nebo prázdný řetězec (""), DateTimeOffset objekt je výstup ve výchozím formátu.

Následující tabulka ukazuje přesné operace určitých specifikátorů formátu při použití s DateTimeOffset , což se liší od jejich chování při použití s nástrojem DateTime .

Existující specifikátor formátu Nové chování
"K" Slouží k přenosu data a času. S se DateTimeOffset mapuje na "ZZZ" (posun se vždycky zobrazuje v hodinách a minutách). Všimněte si, že "K" je specifikátor vlastního formátu; nemůže být použit jako jeden znak v format .
"U" Nepodporováno
í Převede DateTimeOffset objekt na koordinovaný světový čas (UTC) a vytvoří výstup pomocí vlastního formátovacího řetězce ddd, dd MMM yyyy HH:mm:ss GMT .
"u" Převede DateTimeOffset hodnotu na UTC a vytvoří výstup ve formátu yyyy-MM-dd HH:mm:ssZ .

Zbývající specifikátory standardního formátu data a času se chovají stejně ToString(String) jako metoda s metodou ToString .

Vzor, který odpovídá specifikátorům standardního formátu a také symboly a názvy komponent data a času, je definován formatProvider parametrem. formatProviderParametr může mít jednu z následujících možností:

Pokud formatProvider je null , DateTimeFormatInfo použije se objekt přidružený k aktuální jazykové verzi (viz CurrentCulture ).

Poznámky pro volající

ToString(String, IFormatProvider)Metoda vrátí řetězcovou reprezentaci data a času v kalendáři používaném formatProvider parametrem. Jeho kalendář je definován Calendar vlastností. Pokud hodnota aktuální DateTimeOffset instance je dřívější než MinSupportedDateTime nebo novější než MaxSupportedDateTime , metoda vyvolá ArgumentOutOfRangeException . V následujícím příkladu je uvedena ukázka. Pokusí se naformátovat datum, které je mimo rozsah UmAlQuraCalendar třídy.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      CultureInfo arSA = new CultureInfo("ar-SA");
      arSA.DateTimeFormat.Calendar = new UmAlQuraCalendar();
      DateTimeOffset date1 = new DateTimeOffset(new DateTime(1890, 9, 10),
                                                TimeSpan.Zero);

      try {
         Console.WriteLine(date1.ToString("d", arSA));
      }
      catch (ArgumentOutOfRangeException) {
         Console.WriteLine("{0:d} is earlier than {1:d} or later than {2:d}",
                           date1,
                           arSA.DateTimeFormat.Calendar.MinSupportedDateTime,
                           arSA.DateTimeFormat.Calendar.MaxSupportedDateTime);
      }
   }
}
// The example displays the following output:
//    9/10/1890 is earlier than 4/30/1900 or later than 5/13/2029

Viz také

Platí pro