TimeSpan.ToString Метод

Определение

Преобразует значение текущего объекта TimeSpan в эквивалентное ему строковое представление.

Перегрузки

ToString()

Преобразует значение текущего объекта TimeSpan в эквивалентное ему строковое представление.

ToString(String)

Преобразует значение текущего объекта TimeSpan в эквивалентное ему строковое представление с использованием заданного формата.

ToString(String, IFormatProvider)

Преобразует числовое значение текущего объекта TimeSpan в эквивалентное ему строковое представление с использованием указанного формата и сведений об особенностях форматирования для данного языка и региональных параметров.

ToString()

Исходный код:
TimeSpan.cs
Исходный код:
TimeSpan.cs
Исходный код:
TimeSpan.cs

Преобразует значение текущего объекта TimeSpan в эквивалентное ему строковое представление.

C#
public override string ToString ();

Возвращаемое значение

Строковое представление значения текущего объекта TimeSpan.

Примеры

В следующем примере показаны строки, возвращаемые путем вызова ToString метода с рядом значений TimeSpan . Обратите внимание, что хотя в примере метод не вызывается ToString напрямую, он вызывается методом Console.WriteLine при попытке преобразовать TimeSpan значение в его строковое представление.

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

Комментарии

Возвращаемая строка отформатирована с помощью описателя формата "c" и имеет следующий формат:

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

Элементы в квадратных скобках ([ и ]) могут не включаться в возвращаемую строку. Двоеточие и точки (: и.) являются литеральными символами. Элементы, не являющиеся литеральными, перечислены в следующей таблице. Обратите внимание, что строка, возвращаемая методом ToString() , не учитывает язык и региональные параметры.

Элемент Описание
"-" Знак "минус", указывающий на отрицательный интервал времени. Знак для положительного интервала времени не указан.
"d" Количество дней в интервале времени. Этот элемент опущен, если интервал времени меньше одного дня.
"hh" Количество часов в интервале времени в диапазоне от 0 до 23.
"mm" Количество минут в интервале времени в диапазоне от 0 до 59.
"ss" Количество секунд в интервале времени в диапазоне от 0 до 59.
"fffffff" Доли секунд в интервале времени. Этот элемент опущен, если интервал времени не включает доли секунд. При наличии дробные секунды всегда выражаются с помощью семи десятичных цифр.

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

Добавлена поддержка форматирования TimeSpan значений в платформа .NET Framework 4. Однако перегрузка метода по-прежнему ToString() не учитывает язык и региональные параметры. Его поведение остается неизменным по сравнению с предыдущими версиями платформа .NET Framework. Чтобы управлять форматированием TimeSpan значения, вызовите перегрузку ToString(String) или ToString(String, IFormatProvider) .

См. также раздел

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

.NET 9 және басқа нұсқалар
Өнім Нұсқалар
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(String)

Исходный код:
TimeSpan.cs
Исходный код:
TimeSpan.cs
Исходный код:
TimeSpan.cs

Преобразует значение текущего объекта TimeSpan в эквивалентное ему строковое представление с использованием заданного формата.

C#
public string ToString (string format);
C#
public string ToString (string? format);

Параметры

format
String

Стандартная или пользовательская строка формата TimeSpan.

Возвращаемое значение

Строковое представление значения текущего объекта TimeSpan в формате, заданном параметром format.

Исключения

Параметр format не распознается или не поддерживается.

Примеры

В следующем примере используются стандартные и настраиваемые TimeSpan строки формата для отображения строкового представления каждого элемента в массиве значений TimeSpan .

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.

Комментарии

Параметр format может быть любым допустимым стандартным или настраиваемым описателем формата для TimeSpan значений. Если format значение равно String.Empty или равно null, возвращаемое значение текущего TimeSpan объекта форматируется с помощью общего описателя формата ("c"). Если format является любым другим значением, метод создает исключение FormatException.

Если format является строкой стандартного формата, формат возвращаемой строки определяется соглашениями о форматировании текущего языка и региональных параметров.

Маңызды

Строки настраиваемого формата для TimeSpan значений не включают разделитель даты и времени. Если вы хотите включить эти элементы в строку формата, их необходимо рассматривать как символьные литералы. Дополнительные сведения см. в примере для иллюстрации, а дополнительные сведения см. в разделе Настраиваемые строки формата TimeSpan .

.NET предоставляет обширную поддержку форматирования, которая более подробно описана в следующих разделах форматирования:

См. также раздел

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

.NET 9 және басқа нұсқалар
Өнім Нұсқалар
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(String, IFormatProvider)

Исходный код:
TimeSpan.cs
Исходный код:
TimeSpan.cs
Исходный код:
TimeSpan.cs

Преобразует числовое значение текущего объекта TimeSpan в эквивалентное ему строковое представление с использованием указанного формата и сведений об особенностях форматирования для данного языка и региональных параметров.

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

Параметры

format
String

Стандартная или пользовательская строка формата TimeSpan.

formatProvider
IFormatProvider

Объект, предоставляющий сведения о форматировании для определенного языка и региональных параметров.

Возвращаемое значение

Строковое представление текущего значения TimeSpan в виде, заданном параметрами format и formatProvider.

Реализации

Исключения

Параметр format не распознается или не поддерживается.

Примеры

В следующем примере метод вызывается для ToString(String, IFormatProvider) форматирования двух интервалов времени. В примере метод вызывается дважды для каждой строки формата, сначала для отображения с использованием соглашений языка и региональных параметров en-US, а затем для отображения с использованием соглашений языка и региональных параметров 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

Комментарии

Параметр format может быть любым допустимым стандартным или настраиваемым описателем формата для TimeSpan значений. Если format значение равно String.Empty или равно null, возвращаемое значение текущего TimeSpan объекта форматируется с помощью общего описателя формата ("c"). Если format имеет любое другое значение, метод создает исключение FormatException.

Маңызды

Строки настраиваемого формата для TimeSpan значений не включают разделитель даты и времени. Если вы хотите включить эти элементы в строку формата, их необходимо рассматривать как символьные литералы. Дополнительные сведения см. в примере для иллюстрации, а дополнительные сведения см. в разделе Настраиваемые строки формата TimeSpan .

.NET предоставляет обширную поддержку форматирования, которая более подробно описана в следующих разделах форматирования:

Параметр formatProvider представляет собой реализацию IFormatProvider , которая предоставляет сведения о формате возвращаемой строки с учетом языка и региональных параметров. Параметр formatProvider может иметь любой из следующих значений:

  • Объект CultureInfo , представляющий язык и региональные параметры, соглашения о форматировании которых должны отражаться в возвращаемой строке. Объект DateTimeFormatInfo , возвращаемый свойством CultureInfo.DateTimeFormat , определяет форматирование возвращаемой строки.

  • Объект DateTimeFormatInfo , определяющий форматирование возвращаемой строки.

  • Пользовательский объект, реализующий IFormatProvider интерфейс . Его IFormatProvider.GetFormat метод возвращает DateTimeFormatInfo объект , предоставляющий сведения о форматировании.

Если formatProvider имеет значение null, DateTimeFormatInfo используется объект , связанный с текущим языком и региональными параметрами. Если format является строкой настраиваемого формата, formatProvider параметр игнорируется.

См. также раздел

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

.NET 9 және басқа нұсқалар
Өнім Нұсқалар
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0