TimeSpan.ToString Metoda

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

Konwertuje wartość bieżącego TimeSpan obiektu na równoważną reprezentację ciągu.

Przeciążenia

ToString()	Konwertuje wartość bieżącego TimeSpan obiektu na równoważną reprezentację ciągu.
ToString(String)	Konwertuje wartość bieżącego TimeSpan obiektu na równoważną reprezentację ciągu przy użyciu określonego formatu.
ToString(String, IFormatProvider)	Konwertuje wartość bieżącego TimeSpan obiektu na równoważną reprezentację ciągu przy użyciu określonych formatów i informacji o formatowaniu specyficznym dla kultury.

ToString()

Źródło:

TimeSpan.cs

Konwertuje wartość bieżącego TimeSpan obiektu na równoważną reprezentację ciągu.

C#

public override string ToString ();

Zwraca

String

Reprezentacja ciągu bieżącej TimeSpan wartości.

Przykłady

Poniższy przykład przedstawia ciągi zwracane przez wywołanie ToString metody z liczbą TimeSpan wartości. Należy pamiętać, że chociaż przykład nie wywołuje ToString metody bezpośrednio, jest wywoływany przez Console.WriteLine metodę podczas próby przekonwertowania wartości na jej reprezentację TimeSpan ciągu.

C#

 TimeSpan span;
 
 // Initialize a time span to zero.
 span = TimeSpan.Zero;
 Console.WriteLine(span);

 // Initialize a time span to 14 days.
 span = new TimeSpan(-14, 0, 0, 0, 0);
 Console.WriteLine(span);

 // Initialize a time span to 1:02:03.
 span = new TimeSpan(1, 2, 3);
 Console.WriteLine(span);

 // Initialize a time span to 250 milliseconds.
 span = new TimeSpan(0, 0, 0, 0, 250);
 Console.WriteLine(span);
 
 // Initialize a time span to 99 days, 23 hours, 59 minutes, and 59.999 seconds.
 span = new TimeSpan(99, 23, 59, 59, 999);
 Console.WriteLine(span);
 
 // Initialize a time span to 3 hours.
 span = new TimeSpan(3, 0, 0);
 Console.WriteLine(span);
 
 // Initialize a timespan to 25 milliseconds.
 span = new TimeSpan(0, 0, 0, 0, 25);
 Console.WriteLine(span);

 // The example displays the following output:
 //       00:00:00
 //       -14.00:00:00
 //       01:02:03
 //       00:00:00.2500000
 //       99.23:59:59.9990000
 //       03:00:00
 //       00:00:00.0250000

Uwagi

Zwracany ciąg jest sformatowany za pomocą specyfikatora formatu "c" i ma następujący format:

[-] [d.] hh:mm:ss[.fffffff]

Elementy w nawiasach kwadratowych ([ i ]) mogą nie być uwzględnione w zwracanym ciągu. Dwukropki i kropki (: i.) to znaki literału. Elementy niesłowne są wymienione w poniższej tabeli. Należy pamiętać, że ciąg zwracany przez metodę ToString() nie jest wrażliwy na kulturę.

Element	Opis
"-"	Znak minus, który wskazuje ujemny interwał czasu. Żaden znak nie jest uwzględniany dla pozytywnego przedziału czasu.
"d"	Liczba dni w interwale czasu. Ten element jest pomijany, jeśli interwał czasu jest krótszy niż jeden dzień.
"hh"	Liczba godzin w interwale czasu, od 0 do 23.
"mm"	Liczba minut w interwale czasu, od 0 do 59.
"ss"	Liczba sekund w interwale czasu, od 0 do 59.
"fffffff"	Sekundy ułamkowe w interwale czasu. Ten element zostanie pominięty, jeśli interwał czasu nie zawiera sekund ułamkowych. Jeśli istnieje, sekundy ułamkowe są zawsze wyrażane przy użyciu siedmiu cyfr dziesiętnych.

Uwagi dotyczące wywoływania

Obsługa formatowania TimeSpan wartości została dodana w .NET Framework 4. ToString() Jednak przeciążenie metody pozostaje niewrażliwe na kulturę. Jego zachowanie pozostaje niezmienione z poprzednich wersji .NET Framework. Aby kontrolować formatowanie TimeSpan wartości, wywołaj przeciążenie ToString(String) lub ToString(String, IFormatProvider) .

Zobacz też

• String
• Parse(String)
• TryParse(String, TimeSpan)

ToString(String)

Źródło:

TimeSpan.cs

Konwertuje wartość bieżącego TimeSpan obiektu na równoważną reprezentację ciągu przy użyciu określonego formatu.

C#

public string ToString (string? format);

Parametry

format

String

Ciąg formatu standardowego lub niestandardowego TimeSpan .

Zwraca

String

Reprezentacja ciągu bieżącej TimeSpan wartości w formacie określonym przez format parametr .

Wyjątki

FormatException

Parametr format nie jest rozpoznawany lub nie jest obsługiwany.

Przykłady

W poniższym przykładzie użyto ciągów formatu standardowego i niestandardowego TimeSpan , aby wyświetlić reprezentację ciągu każdego elementu w tablicy TimeSpan wartości

C#

TimeSpan[] spans = { 
   TimeSpan.Zero, 
   new TimeSpan(-14, 0, 0, 0, 0), 
   new TimeSpan(1, 2, 3), 
   new TimeSpan(0, 0, 0, 0, 250), 
   new TimeSpan(99, 23, 59, 59, 999),
   new TimeSpan(3, 0, 0), 
   new TimeSpan(0, 0, 0, 0, 25) 
};

string[] fmts = { "c", "g", "G", @"hh\:mm\:ss", "%m' min.'" };
foreach (TimeSpan span in spans)
{
   foreach (string fmt in fmts)
      Console.WriteLine("{0}: {1}", fmt, span.ToString(fmt));

   Console.WriteLine();
}
// The example displays the following output:
//       c: 00:00:00
//       g: 0:00:00
//       G: 0:00:00:00.0000000
//       hh\:mm\:ss: 00:00:00
//       %m' min.': 0 min.
//       
//       c: -14.00:00:00
//       g: -14:0:00:00
//       G: -14:00:00:00.0000000
//       hh\:mm\:ss: 00:00:00
//       %m' min.': 0 min.
//       
//       c: 01:02:03
//       g: 1:02:03
//       G: 0:01:02:03.0000000
//       hh\:mm\:ss: 01:02:03
//       %m' min.': 2 min.
//       
//       c: 00:00:00.2500000
//       g: 0:00:00.25
//       G: 0:00:00:00.2500000
//       hh\:mm\:ss: 00:00:00
//       %m' min.': 0 min.
//       
//       c: 99.23:59:59.9990000
//       g: 99:23:59:59.999
//       G: 99:23:59:59.9990000
//       hh\:mm\:ss: 23:59:59
//       %m' min.': 59 min.
//       
//       c: 03:00:00
//       g: 3:00:00
//       G: 0:03:00:00.0000000
//       hh\:mm\:ss: 03:00:00
//       %m' min.': 0 min.
//       
//       c: 00:00:00.0250000
//       g: 0:00:00.025
//       G: 0:00:00:00.0250000
//       hh\:mm\:ss: 00:00:00
//       %m' min.': 0 min.

Uwagi

Parametr format może być dowolnym prawidłowym specyfikatorem formatu standardowego lub niestandardowego dla TimeSpan wartości. Jeśli format jest równa String.Empty lub jest null, zwracana wartość bieżącego TimeSpan obiektu jest sformatowana za pomocą specyfikatora formatu wspólnego ("c"). Jeśli format jest inną wartością, metoda zgłasza wartość FormatException.

Jeśli format jest standardowym ciągiem formatu, format zwracanego ciągu jest definiowany przez konwencje formatowania bieżącej kultury.

Ważne

Niestandardowe ciągi formatu dla TimeSpan wartości nie zawierają separatora daty lub godziny. Jeśli chcesz dołączyć te elementy do ciągu formatu, musisz traktować je jako literały znaków. Zobacz przykład ilustracji i zobacz temat Niestandardowe ciągi formatu timeSpan , aby uzyskać więcej informacji.

Platforma .NET zapewnia rozbudowaną obsługę formatowania, która została opisana bardziej szczegółowo w następujących tematach formatowania:

• Aby uzyskać więcej informacji na temat ciągów formatu dla wartości, zobacz Ciągi formatu czasowego standardowego i niestandardowe ciągi formatu TimeSpan.TimeSpan

• Aby uzyskać więcej informacji na temat obsługi formatowania na platformie .NET, zobacz Typy formatowania.

Zobacz też

• Ciągi formatu Standard TimeSpan
• Niestandardowe ciągi formatu TimeSpan

ToString(String, IFormatProvider)

Źródło:

TimeSpan.cs

Konwertuje wartość bieżącego TimeSpan obiektu na równoważną reprezentację ciągu przy użyciu określonych formatów i informacji o formatowaniu specyficznym dla kultury.

C#

public string ToString (string? format, IFormatProvider? formatProvider);

Parametry

format

String

Ciąg formatu standardowego lub niestandardowego TimeSpan .

formatProvider

IFormatProvider

Obiekt, który dostarcza informacje o formatowaniu specyficzne dla kultury.

Zwraca

String

Reprezentacja ciągu bieżącej TimeSpan wartości zgodnie z parametrami format i formatProvider.

Implementuje

ToString(String, IFormatProvider)

Wyjątki

FormatException

Parametr format nie jest rozpoznawany lub nie jest obsługiwany.

Przykłady

Poniższy przykład wywołuje metodę ToString(String, IFormatProvider) w celu formatowania dwóch interwałów czasowych. Przykład wywołuje metodę dwa razy dla każdego ciągu formatu, najpierw, aby wyświetlić ją przy użyciu konwencji kultury en-US, a następnie wyświetlić ją przy użyciu konwencji kultury fr-FR.

C#

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      TimeSpan[] intervals = { new TimeSpan(38, 30, 15), 
                               new TimeSpan(16, 14, 30) }; 
      CultureInfo[] cultures = { new CultureInfo("en-US"), 
                                 new CultureInfo("fr-FR") };
      string[] formats = {"c", "g", "G", @"hh\:mm\:ss" };
      Console.WriteLine("{0,12}      Format  {1,22}  {2,22}\n", 
                        "Interval", cultures[0].Name, cultures[1].Name);

      foreach (var interval in intervals) {
         foreach (var fmt in formats)
            Console.WriteLine("{0,12}  {1,10}  {2,22}  {3,22}", 
                              interval, fmt, 
                              interval.ToString(fmt, cultures[0]), 
                              interval.ToString(fmt, cultures[1]));
         Console.WriteLine();
      }  
   }
}
// The example displays the following output:
//        Interval      Format                   en-US                   fr-FR
//    
//      1.14:30:15           c              1.14:30:15              1.14:30:15
//      1.14:30:15           g              1:14:30:15              1:14:30:15
//      1.14:30:15           G      1:14:30:15.0000000      1:14:30:15,0000000
//      1.14:30:15  hh\:mm\:ss                14:30:15                14:30:15
//    
//        16:14:30           c                16:14:30                16:14:30
//        16:14:30           g                16:14:30                16:14:30
//        16:14:30           G      0:16:14:30.0000000      0:16:14:30,0000000
//        16:14:30  hh\:mm\:ss                16:14:30                16:14:30

Uwagi

Parametr format może być dowolnym prawidłowym specyfikatorem formatu standardowego lub niestandardowego dla TimeSpan wartości. Jeśli format jest równa String.Empty lub jest null, zwracana wartość bieżącego TimeSpan obiektu jest sformatowana za pomocą specyfikatora formatu wspólnego ("c"). Jeśli format jest inną wartością, metoda zgłasza wartość FormatException.

Ważne

Niestandardowe ciągi formatu dla TimeSpan wartości nie zawierają separatora daty lub godziny. Jeśli chcesz dołączyć te elementy do ciągu formatu, musisz traktować je jako literały znaków. Zobacz przykład ilustracji i zobacz temat Niestandardowe ciągi formatu timeSpan , aby uzyskać więcej informacji.

Platforma .NET zapewnia rozbudowaną obsługę formatowania, która została opisana bardziej szczegółowo w następujących tematach formatowania:

• Aby uzyskać więcej informacji na temat ciągów formatu dla wartości, zobacz Ciągi formatu czasowego standardowego i niestandardowe ciągi formatu TimeSpan.TimeSpan

• Aby uzyskać więcej informacji na temat obsługi formatowania na platformie .NET, zobacz Typy formatowania.

Parametr formatProvider jest implementacją IFormatProvider , która dostarcza informacje specyficzne dla kultury dotyczące formatu zwracanego ciągu. Parametr formatProvider może być dowolny z następujących:

• CultureInfo Obiekt reprezentujący kulturę, której konwencje formatowania mają zostać odzwierciedlone w zwracanym ciągu. DateTimeFormatInfo Obiekt zwrócony przez CultureInfo.DateTimeFormat właściwość definiuje formatowanie zwracanego ciągu.

• DateTimeFormatInfo Obiekt, który definiuje formatowanie zwracanego ciągu.

• Obiekt niestandardowy, który implementuje IFormatProvider interfejs. Metoda IFormatProvider.GetFormat zwraca DateTimeFormatInfo obiekt, który udostępnia informacje o formatowaniu.

Jeśli formatProvider jest to null, DateTimeFormatInfo używany jest obiekt skojarzony z bieżącą kulturą. Jeśli format jest ciągiem formatu niestandardowego, formatProvider parametr jest ignorowany.

Zobacz też

• Ciągi formatu Standard TimeSpan
• Niestandardowe ciągi formatu TimeSpan