사용자 지정 TimeSpan 서식 문자열

아티클
03/22/2025

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: {0:%d} day(s)", duration);
      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("{0} --> {1}", 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("{0} --> {1}", 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("{0} --> {1}", 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"-"ddddddddd"	필요에 따라 앞에 오는 0으로 채워진 시간 간격의 전체 일 수입니다. 추가 정보: "dd"-"ddddd" 사용자 지정 형식 지정자가 .	`new TimeSpan(6, 14, 32, 17, 685):` `ddd` --> "006" `dd\.hh\:mm` --> "06.14:32"
"h", "%h"	일의 일부로 계산되지 않는 시간 간격의 전체 시간 수입니다. 한 자리 시간은 앞에 0이 없습니다. 추가 정보: "h" 사용자 지정 형식 지정자입니다.	`new TimeSpan(6, 14, 32, 17, 685):` `%h` --> "14" `hh\:mm` --> "14:32"
"hh"	일의 일부로 계산되지 않는 시간 간격의 전체 시간 수입니다. 한 자리 시간에는 앞에 0이 있습니다. 추가 정보: "hh" 사용자 지정 형식 지정자입니다.	`new TimeSpan(6, 14, 32, 17, 685):` `hh` --> "14" `new TimeSpan(6, 8, 32, 17, 685):` `hh` --> 08
"m", "%m"	시간 또는 일의 일부로 포함되지 않은 시간 간격의 전체 분 수입니다. 한 자리 분은 앞에 0이 없습니다. 추가 정보: "m" 사용자 지정 형식 지정자입니다.	`new TimeSpan(6, 14, 8, 17, 685):` `%m` --> "8" `h\:m` --> "14:8"
"mm"	시간 또는 일의 일부로 포함되지 않은 시간 간격의 전체 분 수입니다. 한 자리 분 앞에 0이 있습니다. 추가 정보: "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"	시간, 일 또는 분의 일부로 포함되지 않은 시간 간격의 전체 초 수입니다. 한 자리 초 앞에 0이 없습니다. 추가 정보: "s" 사용자 지정 형식 지정자입니다.	`TimeSpan.FromSeconds(12.965)`: `%s` --> 12 `s\.fff` --> 12.965
"ss"	시간, 일 또는 분의 일부로 포함되지 않은 시간 간격의 전체 초 수입니다. 한 자리 초의 앞에 0이 있습니다. 추가 정보: "ss" 사용자 지정 형식 지정자입니다.	`TimeSpan.FromSeconds(6.965)`: `ss` --> 06 `ss\.fff` --> 06.965
"f", "%f"	시간 간격의 1/10초입니다. 추가 정보: "f" 사용자 지정 형식 지정자입니다.	`TimeSpan.FromSeconds(6.895)`: `f` --> 8 `ss\.f` --> 06.8
"ff"	시간 간격의 1/100초입니다. 추가 정보: "ff" 사용자 지정 형식 지정자입니다.	`TimeSpan.FromSeconds(6.895)`: `ff` --> 89 `ss\.ff` --> 06.89
"fff"	시간 간격의 밀리초입니다. 추가 정보: "fff" 사용자 지정 형식 지정자입니다.	`TimeSpan.FromSeconds(6.895)`: `fff` --> 895 `ss\.fff` --> 06.895
"ffff"	시간 간격의 1/10000초입니다. 추가 정보: "ffff" 사용자 지정 형식 지정자입니다.	`TimeSpan.Parse("0:0:6.8954321")`: `ffff` --> 8954 `ss\.ffff` --> 06.8954
"fffff"	시간 간격의 1/10000초입니다. 추가 정보: "fffff" 사용자 지정 형식 지정자입니다.	`TimeSpan.Parse("0:0:6.8954321")`: `fffff` --> 89543 `ss\.fffff` --> 06.89543
"ffffff"	시간 간격의 100만 초입니다. 추가 정보: "ffffff" 사용자 지정 형식 지정자입니다.	`TimeSpan.Parse("0:0:6.8954321")`: `ffffff` --> 895432 `ss\.ffffff` --> 06.895432
"fffffff"	시간 간격의 1초(또는 소수 틱)의 1,000만 번째입니다. 추가 정보: "fffffff" 사용자 지정 형식 지정자입니다.	`TimeSpan.Parse("0:0:6.8954321")`: `fffffff` --> 8954321 `ss\.fffffff` --> 06.8954321
"F", "%F"	시간 간격의 1/10초입니다. 숫자가 0이면 아무 것도 표시되지 않습니다. 추가 정보: "F" 사용자 지정 형식 지정자입니다.	`TimeSpan.Parse("00:00:06.32")`: `%F`: 3 `TimeSpan.Parse("0:0:3.091")`: `ss\.F`: 03.
"FF"	시간 간격의 1/100초입니다. 모든 소수 후행 0 또는 0자리 자리는 포함되지 않습니다. 추가 정보: "FF" 사용자 지정 형식 지정자입니다.	`TimeSpan.Parse("00:00:06.329")`: `FF`: 32 `TimeSpan.Parse("0:0:3.101")`: `ss\.FF`: 03.1
"FFF"	시간 간격의 밀리초입니다. 분수 후행 0은 포함되지 않습니다. 추가 정보:	`TimeSpan.Parse("00:00:06.3291")`: `FFF`: 329 `TimeSpan.Parse("0:0:3.1009")`: `ss\.FFF`: 03.1
"FFFF"	시간 간격의 1/10000초입니다. 분수 후행 0은 포함되지 않습니다. 추가 정보: "FFFF" 사용자 지정 형식 지정자입니다.	`TimeSpan.Parse("00:00:06.32917")`: `FFFFF`: 3291 `TimeSpan.Parse("0:0:3.10009")`: `ss\.FFFF`: 03.1
"FFFFF"	시간 간격의 1/10000초입니다. 분수 후행 0은 포함되지 않습니다. 추가 정보: "FFFFF" 사용자 지정 형식 지정자입니다.	`TimeSpan.Parse("00:00:06.329179")`: `FFFFF`: 32917 `TimeSpan.Parse("0:0:3.100009")`: `ss\.FFFFF`: 03.1
"FFFFFF"	시간 간격의 100만 초입니다. 분수 후행 0은 표시되지 않습니다. 추가 정보: "FFFFFF" 사용자 지정 형식 지정자입니다.	`TimeSpan.Parse("00:00:06.3291791")`: `FFFFFF`: 329179 `TimeSpan.Parse("0:0:3.1000009")`: `ss\.FFFFFF`: 03.1
"FFFFFFF"	시간 간격으로 1초의 1000만 초입니다. 분수 후행 0 또는 7개의 0은 표시되지 않습니다. 추가 정보: "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"
\	이스케이프 문자입니다. 추가 정보: 다른 문자 .	`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이면 지정자는 "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" 사용자 지정 형식 지정자

"dd"-"dddddddd" 사용자 지정 형식 지정자

"h" 사용자 지정 형식 지정자

"hh" 사용자 지정 형식 지정자

"m" 사용자 지정 형식 지정자

"mm" 사용자 지정 형식 지정자

"s" 사용자 지정 형식 지정자

"ss" 사용자 지정 형식 지정자

"f" 사용자 지정 형식 지정자

"ff" 사용자 지정 형식 지정자

"fff" 사용자 지정 형식 지정자

"ffff" 사용자 지정 형식 지정자

"fffff" 사용자 지정 형식 지정자

"ffffff" 사용자 지정 형식 지정자

"fffffff" 사용자 지정 형식 지정자

"F" 사용자 지정 형식 지정자

"FF" 사용자 지정 형식 지정자

"FFF" 사용자 지정 형식 지정자

"FFFF" 사용자 지정 형식 지정자

"FFFFF" 사용자 지정 형식 지정자

"FFFFFF" 사용자 지정 형식 지정자

"FFFFFFF" 사용자 지정 형식 지정자

기타 문자

참고하십시오

추가 리소스