Строки настраиваемого формата TimeSpan

2025-03-22

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

Это важно

Настраиваемые описатели формата TimeSpan не включают символы разделителя заполнителей, такие как символы, которые отделяют дни от часов, часов от минут или секунд от дробных секунд. Вместо этого эти символы должны быть включены в строку настраиваемого формата как строковые литералы. Например, "dd\.hh\:mm" определяет период (.) в качестве разделителя между днями и часами, а двоеточие (:) в качестве разделителя между часами и минутами.

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

Строковые представления значений TimeSpan создаются вызовами перегрузки метода TimeSpan.ToString и методами, поддерживающими составное форматирование, например String.Format. Дополнительные сведения см. в типах форматирования и составныхформатирования. В следующем примере показано использование настраиваемых строк форматирования в операциях форматирования.

using System;

public class Example
{
   public static void Main()
   {
      TimeSpan duration = new TimeSpan(1, 12, 23, 62);

      string output = null;
      output = "Time of Travel: " + duration.ToString("%d") + " days";
      Console.WriteLine(output);
      output = "Time of Travel: " + duration.ToString(@"dd\.hh\:mm\:ss");
      Console.WriteLine(output);

      Console.WriteLine($"Time of Travel: {duration:%d} day(s)");
      Console.WriteLine($"Time of Travel: {duration:dd\\.hh\\:mm\\:ss} days");
   }
}
// The example displays the following output:
//       Time of Travel: 1 days
//       Time of Travel: 01.12:24:02
//       Time of Travel: 1 day(s)
//       Time of Travel: 01.12:24:02 days

Module Example
    Public Sub Main()
        Dim duration As New TimeSpan(1, 12, 23, 62)

        Dim output As String = Nothing
        output = "Time of Travel: " + duration.ToString("%d") + " days"
        Console.WriteLine(output)
        output = "Time of Travel: " + duration.ToString("dd\.hh\:mm\:ss")
        Console.WriteLine(output)

        Console.WriteLine("Time of Travel: {0:%d} day(s)", duration)
        Console.WriteLine("Time of Travel: {0:dd\.hh\:mm\:ss} days", duration)
    End Sub
End Module
' The example displays the following output:
'       Time of Travel: 1 days
'       Time of Travel: 01.12:24:02
'       Time of Travel: 1 day(s)
'       Time of Travel: 01.12:24:02 days

Пользовательские строки формата TimeSpan также используются методами TimeSpan.ParseExact и TimeSpan.TryParseExact для определения требуемого формата входных строк для операций синтаксического анализа. (Синтаксический анализ преобразует строковое представление значения в это значение.) В следующем примере показано использование стандартных строк форматирования в операциях синтаксического анализа.

using System;

public class Example
{
   public static void Main()
   {
      string value = null;
      TimeSpan interval;

      value = "6";
      if (TimeSpan.TryParseExact(value, "%d", null, out interval))
         Console.WriteLine($"{value} --> {interval.ToString("c")}");
      else
         Console.WriteLine($"Unable to parse '{value}'");

      value = "16:32.05";
      if (TimeSpan.TryParseExact(value, @"mm\:ss\.ff", null, out interval))
         Console.WriteLine($"{value} --> {interval.ToString("c")}");
      else
         Console.WriteLine($"Unable to parse '{value}'");

      value= "12.035";
      if (TimeSpan.TryParseExact(value, "ss\\.fff", null, out interval))
         Console.WriteLine($"{value} --> {interval.ToString("c")}");
      else
         Console.WriteLine($"Unable to parse '{value}'");
   }
}
// The example displays the following output:
//       6 --> 6.00:00:00
//       16:32.05 --> 00:16:32.0500000
//       12.035 --> 00:00:12.0350000

Module Example
    Public Sub Main()
        Dim value As String = Nothing
        Dim interval As TimeSpan

        value = "6"
        If TimeSpan.TryParseExact(value, "%d", Nothing, interval) Then
            Console.WriteLine("{0} --> {1}", value, interval.ToString("c"))
        Else
            Console.WriteLine("Unable to parse '{0}'", value)
        End If

        value = "16:32.05"
        If TimeSpan.TryParseExact(value, "mm\:ss\.ff", Nothing, interval) Then
            Console.WriteLine("{0} --> {1}", value, interval.ToString("c"))
        Else
            Console.WriteLine("Unable to parse '{0}'", value)
        End If

        value = "12.035"
        If TimeSpan.TryParseExact(value, "ss\.fff", Nothing, interval) Then
            Console.WriteLine("{0} --> {1}", value, interval.ToString("c"))
        Else
            Console.WriteLine("Unable to parse '{0}'", value)
        End If
    End Sub
End Module
' The example displays the following output:
'       6 --> 6.00:00:00
'       16:32.05 --> 00:16:32.0500000
'       12.035 --> 00:00:12.0350000

В следующей таблице описаны настраиваемые описатели формата даты и времени.

Описатель формата	Описание	Пример
"d", "%d"	Количество целых дней в интервале времени. Дополнительные сведения: описатель настраиваемого формата "d".	`new TimeSpan(6, 14, 32, 17, 685):` `%d` -> "6" `d\.hh\:mm` -> "6.14:32"
"dd"-"ddddd"	Количество целых дней в интервале времени, заполненное начальными нулями по мере необходимости. Дополнительные сведения: настраиваемые описатели формата dddddddddd.	`new TimeSpan(6, 14, 32, 17, 685):` `ddd` -> "006" `dd\.hh\:mm` -> "06.14:32"
"h", "%h"	Количество целых часов в интервале времени, которое не считается частью дней. Однозначные часы не имеют начального нуля. Дополнительные сведения: описатель пользовательского формата h.	`new TimeSpan(6, 14, 32, 17, 685):` `%h` -> "14" `hh\:mm` --> "14:32"
"чч"	Количество целых часов в интервале времени, которое не считается частью дней. Однозначные часы имеют начальный ноль. Дополнительные сведения: описатель пользовательского формата hh.	`new TimeSpan(6, 14, 32, 17, 685):` `hh` -> "14" `new TimeSpan(6, 8, 32, 17, 685):` `hh` -> 08
"м", "%m"	Количество целых минут в интервале времени, который не входит в состав часов или дней. Минуты с одной цифрой не имеют начального нуля. Дополнительные сведения: описатель пользовательского формата "m".	`new TimeSpan(6, 14, 8, 17, 685):` `%m` -> "8" `h\:m` -> "14:8"
"mm"	Количество целых минут в интервале времени, который не входит в состав часов или дней. Минуты с одной цифрой имеют начальный ноль. Дополнительные сведения: описатель настраиваемого формата mm.	`new TimeSpan(6, 14, 8, 17, 685):` `mm` -> "08" `new TimeSpan(6, 8, 5, 17, 685):` `d\.hh\:mm\:ss` -> 6.08:05:17
"s", "%s"	Количество целых секунд в интервале времени, который не входит в состав часов, дней или минут. Однозначные секунды не имеют начальных нулей. Дополнительные сведения: описатель пользовательского формата "s".	`TimeSpan.FromSeconds(12.965)`: `%s` -> 12 `s\.fff` -> 12.965
"сс"	Количество целых секунд в интервале времени, который не входит в состав часов, дней или минут. Однозначные секунды имеют начальный ноль. Дополнительные сведения: описатель пользовательского формата "ss".	`TimeSpan.FromSeconds(6.965)`: `ss` -> 06 `ss\.fff` -> 06.965
"f", "%f"	Десятые секунды в интервале времени. Дополнительные сведения: описатель настраиваемого формата f.	`TimeSpan.FromSeconds(6.895)`: `f` -> 8 `ss\.f` -> 06.8
ff	Сотые секунды в интервале времени. Дополнительные сведения: описатель пользовательского формата "ff".	`TimeSpan.FromSeconds(6.895)`: `ff` -> 89 `ss\.ff` -> 06.89
"fff"	Миллисекунда в интервале времени. Дополнительные сведения: описатель пользовательского формата fff.	`TimeSpan.FromSeconds(6.895)`: `fff` -> 895 `ss\.fff` -> 06.895
"ffff"	Десять тысяч секунд в интервале времени. Дополнительные сведения: описатель пользовательского формата "ffff".	`TimeSpan.Parse("0:0:6.8954321")`: `ffff` -> 8954 `ss\.ffff` -> 06.8954
Fffff	Сотни тысяч секунд в интервале времени. Дополнительные сведения: описатель пользовательского формата fffff.	`TimeSpan.Parse("0:0:6.8954321")`: `fffff` -> 89543 `ss\.fffff` -> 06.89543
ffffff	Миллионы секунд в интервале времени. Дополнительные сведения: описатель пользовательского формата ffffff.	`TimeSpan.Parse("0:0:6.8954321")`: `ffffff` -> 895432 `ss\.ffffff` -> 06.895432
Fffffff	Десять миллионов секунд (или дробные клещи) в интервале времени. Дополнительные сведения: описатель пользовательского формата fff.	`TimeSpan.Parse("0:0:6.8954321")`: `fffffff` -> 8954321 `ss\.fffffff` -> 06.8954321
"F", "%F"	Десятые секунды в интервале времени. Значение не отображается, если цифра равна нулю. Дополнительные сведения: описатель настраиваемого формата F.	`TimeSpan.Parse("00:00:06.32")`: `%F`: 3 `TimeSpan.Parse("0:0:3.091")`: `ss\.F`: 03.
"ФФ"	Сотые секунды в интервале времени. Любые дробные конечные нули или две нулевые цифры не включаются. Дополнительные сведения: описатель настраиваемого формата FF.	`TimeSpan.Parse("00:00:06.329")`: `FF`: 32 `TimeSpan.Parse("0:0:3.101")`: `ss\.FF`: 03.1
FFF	Миллисекунда в интервале времени. Любые дробные конечные нули не включаются. Подробнее:	`TimeSpan.Parse("00:00:06.3291")`: `FFF`: 329 `TimeSpan.Parse("0:0:3.1009")`: `ss\.FFF`: 03.1
"ФФФФ"	Десять тысяч секунд в интервале времени. Любые дробные конечные нули не включаются. Дополнительные сведения: описатель пользовательского формата FFFF.	`TimeSpan.Parse("00:00:06.32917")`: `FFFFF`: 3291 `TimeSpan.Parse("0:0:3.10009")`: `ss\.FFFF`: 03.1
FFFFF	Сотни тысяч секунд в интервале времени. Любые дробные конечные нули не включаются. Дополнительные сведения: описатель пользовательского формата FFFFF.	`TimeSpan.Parse("00:00:06.329179")`: `FFFFF`: 32917 `TimeSpan.Parse("0:0:3.100009")`: `ss\.FFFFF`: 03.1
FFFFFF	Миллионы секунд в интервале времени. Не отображаются все конечные нули дробного пути. Дополнительные сведения: описатель пользовательского формата FFFFFF.	`TimeSpan.Parse("00:00:06.3291791")`: `FFFFFF`: 329179 `TimeSpan.Parse("0:0:3.1000009")`: `ss\.FFFFFF`: 03.1
FFFFFFF	Десять миллионов секунд в интервале времени. Никакие дробные конечные нули или семь нулей не отображаются. Дополнительные сведения: описатель пользовательского формата FFFFFFF.	`TimeSpan.Parse("00:00:06.3291791")`: `FFFFFF`: 3291791 `TimeSpan.Parse("0:0:3.1900000")`: `ss\.FFFFFF`: 03.19
"string"	Буквенный разделитель строк. Дополнительные сведения: другие символы.	`new TimeSpan(14, 32, 17):` `hh':'mm':'ss` --> "14:32:17"
\	Escape-символ. Дополнительные сведения: другие символы.	`new TimeSpan(14, 32, 17):` `hh\:mm\:ss` --> "14:32:17"
Любой другой знак	Любой другой неискаченный символ интерпретируется как настраиваемый описатель формата. Дополнительные сведения: другие символы.	`new TimeSpan(14, 32, 17):` `hh\:mm\:ss` --> "14:32:17"

Настраиваемый описатель формата "d"

Описатель пользовательского формата "d" выводит значение свойства TimeSpan.Days, которое представляет количество целых дней в интервале времени. Он выводит полное количество дней в значении TimeSpan, даже если значение имеет более одной цифры. Если значение свойства TimeSpan.Days равно нулю, описатель выводит значение "0".

Если описатель пользовательского формата "d" используется отдельно, укажите "%d", чтобы он не был неправильно интерпретирован как строка стандартного формата. Это показывается в следующем примере.

TimeSpan ts1 = new TimeSpan(16, 4, 3, 17, 250);
Console.WriteLine(ts1.ToString("%d"));
// Displays 16

Dim ts As New TimeSpan(16, 4, 3, 17, 250)
Console.WriteLine(ts.ToString("%d"))
' Displays 16

В следующем примере показано использование пользовательского описателя формата "d".

TimeSpan ts2 = new TimeSpan(4, 3, 17);
Console.WriteLine(ts2.ToString(@"d\.hh\:mm\:ss"));

TimeSpan ts3 = new TimeSpan(3, 4, 3, 17);
Console.WriteLine(ts3.ToString(@"d\.hh\:mm\:ss"));
// The example displays the following output:
//       0.04:03:17
//       3.04:03:17

Dim ts2 As New TimeSpan(4, 3, 17)
Console.WriteLine(ts2.ToString("d\.hh\:mm\:ss"))

Dim ts3 As New TimeSpan(3, 4, 3, 17)
Console.WriteLine(ts3.ToString("d\.hh\:mm\:ss"))
' The example displays the following output:
'       0.04:03:17
'       3.04:03:17

Поделиться через

Строки настраиваемого формата TimeSpan

Настраиваемый описатель формата "d"

Настраиваемые описатели формата dddd-ddd

Настраиваемый описатель формата "h"

Настраиваемый описатель формата "hh"

Настраиваемый описатель формата "m"

Настраиваемый описатель формата "mm"

Настраиваемый описатель формата "s"

Настраиваемый описатель формата "ss"

Настраиваемый описатель формата "f"

Настраиваемый описатель формата "ff"

Настраиваемый описатель формата "fff"

Настраиваемый описатель формата "ffff"

Настраиваемый описатель формата "fffff"

Настраиваемый описатель формата "ffffff"

Настраиваемый описатель формата "fffffff"

Настраиваемый описатель формата "F"

Настраиваемый описатель формата "FF"

Настраиваемый описатель формата "FFF"

Настраиваемый описатель формата "FFFF"

Настраиваемый описатель формата "FFFFF"

Настраиваемый описатель формата "FFFFFF"

Настраиваемый описатель формата "FFFFFFF"

Другие символы

См. также

Обратная связь

Дополнительные ресурсы