# TimeSpan 구조체

## 정의

시간 간격을 나타냅니다.Represents a time interval.

``public value class TimeSpan : IComparable, IComparable<TimeSpan>, IEquatable<TimeSpan>, IFormattable``
``````[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public struct TimeSpan : IComparable, IComparable<TimeSpan>, IEquatable<TimeSpan>, IFormattable``````
``````type TimeSpan = struct
interface IFormattable``````
``````Public Structure TimeSpan
Implements IComparable, IComparable(Of TimeSpan), IEquatable(Of TimeSpan), IFormattable``````
상속
TimeSpan
특성
구현

## 예제

다음 예제에서는 TimeSpan 두 날짜 간의 차이 나타내는 개체입니다.The following example instantiates a TimeSpan object that represents the difference between two dates. 그런 다음 표시는 TimeSpan 개체의 속성입니다.It then displays the TimeSpan object's properties.

``````// Define two dates.
DateTime date1 = new DateTime(2010, 1, 1, 8, 0, 15);
DateTime date2 = new DateTime(2010, 8, 18, 13, 30, 30);

// Calculate the interval between the two dates.
TimeSpan interval = date2 - date1;
Console.WriteLine("{0} - {1} = {2}", date2, date1, interval.ToString());

// Display individual properties of the resulting TimeSpan object.
Console.WriteLine("   {0,-35} {1,20}", "Value of Days Component:", interval.Days);
Console.WriteLine("   {0,-35} {1,20}", "Total Number of Days:", interval.TotalDays);
Console.WriteLine("   {0,-35} {1,20}", "Value of Hours Component:", interval.Hours);
Console.WriteLine("   {0,-35} {1,20}", "Total Number of Hours:", interval.TotalHours);
Console.WriteLine("   {0,-35} {1,20}", "Value of Minutes Component:", interval.Minutes);
Console.WriteLine("   {0,-35} {1,20}", "Total Number of Minutes:", interval.TotalMinutes);
Console.WriteLine("   {0,-35} {1,20:N0}", "Value of Seconds Component:", interval.Seconds);
Console.WriteLine("   {0,-35} {1,20:N0}", "Total Number of Seconds:", interval.TotalSeconds);
Console.WriteLine("   {0,-35} {1,20:N0}", "Value of Milliseconds Component:", interval.Milliseconds);
Console.WriteLine("   {0,-35} {1,20:N0}", "Total Number of Milliseconds:", interval.TotalMilliseconds);
Console.WriteLine("   {0,-35} {1,20:N0}", "Ticks:", interval.Ticks);

// This example displays the following output:
//       8/18/2010 1:30:30 PM - 1/1/2010 8:00:15 AM = 229.05:30:15
//          Value of Days Component:                             229
//          Total Number of Days:                   229.229340277778
//          Value of Hours Component:                              5
//          Total Number of Hours:                  5501.50416666667
//          Value of Minutes Component:                           30
//          Total Number of Minutes:                       330090.25
//          Value of Seconds Component:                           15
//          Total Number of Seconds:                      19,805,415
//          Value of Milliseconds Component:                       0
//          Total Number of Milliseconds:             19,805,415,000
//          Ticks:                               198,054,150,000,000
``````
``````' Define two dates.
Dim date1 As Date = #1/1/2010 8:00:15AM#
Dim date2 As Date = #8/18/2010 1:30:30PM#
' Calculate the interval between the two dates.
Dim interval As TimeSpan = date2 - date1
Console.WriteLine("{0} - {1} = {2}", date2, date1, interval.ToString())
' Display individual properties of the resulting TimeSpan object.
Console.WriteLine("   {0,-35} {1,20}", "Value of Days Component:", interval.Days)
Console.WriteLine("   {0,-35} {1,20}", "Total Number of Days:", interval.TotalDays)
Console.WriteLine("   {0,-35} {1,20}", "Value of Hours Component:", interval.Hours)
Console.WriteLine("   {0,-35} {1,20}", "Total Number of Hours:", interval.TotalHours)
Console.WriteLine("   {0,-35} {1,20}", "Value of Minutes Component:", interval.Minutes)
Console.WriteLine("   {0,-35} {1,20}", "Total Number of Minutes:", interval.TotalMinutes)
Console.WriteLine("   {0,-35} {1,20:N0}", "Value of Seconds Component:", interval.Seconds)
Console.WriteLine("   {0,-35} {1,20:N0}", "Total Number of Seconds:", interval.TotalSeconds)
Console.WriteLine("   {0,-35} {1,20:N0}", "Value of Milliseconds Component:", interval.Milliseconds)
Console.WriteLine("   {0,-35} {1,20:N0}", "Total Number of Milliseconds:", interval.TotalMilliseconds)
Console.WriteLine("   {0,-35} {1,20:N0}", "Ticks:", interval.Ticks)
' The example displays the following output:
'       8/18/2010 1:30:30 PM - 1/1/2010 8:00:15 AM = 229.05:30:15
'          Value of Days Component:                             229
'          Total Number of Days:                   229.229340277778
'          Value of Hours Component:                              5
'          Total Number of Hours:                  5501.50416666667
'          Value of Minutes Component:                           30
'          Total Number of Minutes:                       330090.25
'          Value of Seconds Component:                           15
'          Total Number of Seconds:                      19,805,415
'          Value of Milliseconds Component:                       0
'          Total Number of Milliseconds:             19,805,415,000
'          Ticks:                               198,054,150,000,000
``````
``````# Define two dates.
\$Date2 = Get-Date -Date '2010/8/18' -Hour 13 -Minute 30 -Second 30
\$Date1 = Get-Date -Date '2010/1/1'  -Hour 8  -Minute 0  -Second 15

# Calculate the interval between the two dates.
\$Interval = \$Date2 - \$Date1
"{0} - {1} = {2}" -f \$Date2, \$Date1, (\$Interval.ToString())

#  Display individual properties of the resulting TimeSpan object.
"   {0,-35} {1,20}"    -f "Value of Days Component:", \$Interval.Days
"   {0,-35} {1,20}"    -f "Total Number of Days:", \$Interval.TotalDays
"   {0,-35} {1,20}"    -f "Value of Hours Component:", \$Interval.Hours
"   {0,-35} {1,20}"    -f "Total Number of Hours:", \$Interval.TotalHours
"   {0,-35} {1,20}"    -f "Value of Minutes Component:", \$Interval.Minutes
"   {0,-35} {1,20}"    -f "Total Number of Minutes:", \$Interval.TotalMinutes
"   {0,-35} {1,20:N0}" -f "Value of Seconds Component:", \$Interval.Seconds
"   {0,-35} {1,20:N0}" -f "Total Number of Seconds:", \$Interval.TotalSeconds
"   {0,-35} {1,20:N0}" -f "Value of Milliseconds Component:", \$Interval.Milliseconds
"   {0,-35} {1,20:N0}" -f "Total Number of Milliseconds:", \$Interval.TotalMilliseconds
"   {0,-35} {1,20:N0}" -f "Ticks:", \$Interval.Ticks

<# This sample produces the following output:

18/08/2010 13:30:30 - 01/01/2010 08:00:15 = 229.05:30:15
Value of Days Component:                             229
Total Number of Days:                   229.229340277778
Value of Hours Component:                              5
Total Number of Hours:                  5501.50416666667
Value of Minutes Component:                           30
Total Number of Minutes:                       330090.25
Value of Seconds Component:                           15
Total Number of Seconds:                      19,805,415
Value of Milliseconds Component:                       0
Total Number of Milliseconds:             19,805,415,000
Ticks:                               198,054,150,000,000
#>
``````

## 설명

TimeSpan 개체 일, 시간, 분, 초 및 초의 소수부 양수 또는 음수일 수로 측정 되는 시간 간격 (시간 또는 경과 된 시간 기간)를 나타냅니다.A TimeSpan object represents a time interval (duration of time or elapsed time) that is measured as a positive or negative number of days, hours, minutes, seconds, and fractions of a second. TimeSpan 구조에 특정 날짜와 관련이 없는 경우만, 하루 중 시간을 나타내는 데 사용할 수도 있습니다.The TimeSpan structure can also be used to represent the time of day, but only if the time is unrelated to a particular date. 그렇지 않으면 합니다 DateTime 또는 DateTimeOffset 구조를 대신 사용 해야 합니다.Otherwise, the DateTime or DateTimeOffset structure should be used instead. (사용에 대 한 자세한 내용은 합니다 TimeSpan 하루 중 시간을 반영 하 여 참조를 구조 Choosing Between DateTime, DateTimeOffset, TimeSpan 및 TimeZoneInfo.)(For more information about using the TimeSpan structure to reflect the time of day, see Choosing Between DateTime, DateTimeOffset, TimeSpan, and TimeZoneInfo.)

참고

TimeSpan 값 시간 간격을 나타내고 일, 시간, 분, 초 및 밀리초의 거리로 표현 될 수 있습니다.A TimeSpan value represents a time interval and can be expressed as a particular number of days, hours, minutes, seconds, and milliseconds. 특정 시작 또는 끝 지점에 대 한 참조 없이 일반 간격을 나타내므로 연 및 월 단위로 모두 변수 기간 (일) 기준으로 표현할 수 없습니다.Because it represents a general interval without reference to a particular start or end point, it cannot be expressed in terms of years and months, both of which have a variable number of days. 다른를 DateTime 특정 표준 시간대에 대 한 참조 없이 시간과 날짜를 나타내는 값 또는 DateTimeOffset 시간의 특정 순간을 나타내는 값입니다.It differs from a DateTime value, which represents a date and time without reference to a particular time zone, or a DateTimeOffset value, which represents a specific moment of time.

가장 큰 단위에는 TimeSpan 일인지 구조 사용 기간을 측정 합니다.The largest unit of time that the TimeSpan structure uses to measure duration is a day. 시간 간격이 월과 년 등의 더 큰 단위 일 수가 달라 지므로 일관성을 위해 일 단위로 측정 됩니다.Time intervals are measured in days for consistency, because the number of days in larger units of time, such as months and years, varies.

값을 TimeSpan 개체 표시 된 시간 간격과 같은 틱 수입니다.The value of a TimeSpan object is the number of ticks that equal the represented time interval. 틱은 100 나노초 또는 하나의 1 초의 같습니다.A tick is equal to 100 nanoseconds, or one ten-millionth of a second. 값을 TimeSpan 개체에서 까지입니다 TimeSpan.MinValueTimeSpan.MaxValue합니다.The value of a TimeSpan object can range from TimeSpan.MinValue to TimeSpan.MaxValue.

### 인스턴스화하는 TimeSpan 값Instantiating a TimeSpan Value

인스턴스화할 수 있습니다는 TimeSpan 다양 한 방법에에서 대 한 값:You can instantiate a TimeSpan value in a number of ways:

• 매개 변수가 없는 암시적 생성자를 호출 합니다.By calling its implicit parameterless constructor. 이 값이 개체를 만듭니다 TimeSpan.Zero다음 예제와 같이 합니다.This creates an object whose value is TimeSpan.Zero, as the following example shows.

``````TimeSpan interval = new TimeSpan();
Console.WriteLine(interval.Equals(TimeSpan.Zero));    // Displays "True".
``````
``````Dim interval As New TimeSpan()
Console.WriteLine(interval.Equals(TimeSpan.Zero))     ' Displays "True".
``````
• 명시적 생성자 중 하나를 호출 합니다.By calling one of its explicit constructors. 다음 예제에서는 초기화를 TimeSpan 값을 지정 된 시간, 분 및 초입니다.The following example initializes a TimeSpan value to a specified number of hours, minutes, and seconds.

``````TimeSpan interval = new TimeSpan(2, 14, 18);
Console.WriteLine(interval.ToString());

// Displays "02:14:18".
``````
``````Dim interval As New TimeSpan(2, 14, 18)
Console.WriteLine(interval.ToString())                ' Displays "02:14:18".
``````
• 메서드를 호출 하거나 반환 하는 작업을 수행 하 여는 TimeSpan 값입니다.By calling a method or performing an operation that returns a TimeSpan value. 예를 들어 인스턴스화할 수 있습니다는 TimeSpan 다음 예제와 같이 두 개의 날짜 및 시간 값에 간격을 나타내는 값입니다.For example, you can instantiate a TimeSpan value that represents the interval between two date and time values, as the following example shows.

``````DateTime departure = new DateTime(2010, 6, 12, 18, 32, 0);
DateTime arrival = new DateTime(2010, 6, 13, 22, 47, 0);
TimeSpan travelTime = arrival - departure;
Console.WriteLine("{0} - {1} = {2}", arrival, departure, travelTime);

// The example displays the following output:
//       6/13/2010 10:47:00 PM - 6/12/2010 6:32:00 PM = 1.04:15:00
``````
``````Dim departure As DateTime = #06/12/2010 6:32PM#
Dim arrival As DateTime = #06/13/2010 10:47PM#
Dim travelTime As TimeSpan = arrival - departure
Console.WriteLine("{0} - {1} = {2}", arrival, departure, travelTime)
' The example displays the following output:
'       6/13/2010 10:47:00 PM - 6/12/2010 6:32:00 PM = 1.04:15:00
``````

초기화할 수도 있습니다는 TimeSpan 개체를 이러한 방식으로 다음 예와 같이 0 시간 값입니다.You can also initialize a TimeSpan object to a zero time value in this way, as the following example shows.

``````   Random rnd = new Random();

TimeSpan timeSpent = TimeSpan.Zero;

timeSpent += GetTimeBeforeLunch();
timeSpent += GetTimeAfterLunch();

Console.WriteLine("Total time: {0}", timeSpent);

TimeSpan GetTimeBeforeLunch()
{
return new TimeSpan(rnd.Next(3, 6), 0, 0);
}

TimeSpan GetTimeAfterLunch()
{
return new TimeSpan(rnd.Next(3, 6), 0, 0);
}

// The example displays output like the following:
//        Total time: 08:00:00
``````
``````Module Example
Dim rnd As New Random()

Public Sub Main()
Dim timeSpent As TimeSpan = TimeSpan.Zero

timeSpent += GetTimeBeforeLunch()
timeSpent += GetTimeAfterLunch()

Console.WriteLine("Total time: {0}", timeSpent)
End Sub

Private Function GetTimeBeforeLunch() As TimeSpan
Return New TimeSpan(rnd.Next(3, 6), 0, 0)
End Function

Private Function GetTimeAfterLunch() As TimeSpan
Return New TimeSpan(rnd.Next(3, 6), 0, 0)
End Function
End Module
' The example displays output like the following:
'       Total time: 08:00:00
``````

TimeSpan 메서드와 산술 연산자에서 반환 값을 DateTime, DateTimeOffset, 및 TimeSpan 구조입니다.TimeSpan values are returned by arithmetic operators and methods of the DateTime, DateTimeOffset, and TimeSpan structures.

• 문자열 표현을 구문 분석을 TimeSpan 값입니다.By parsing the string representation of a TimeSpan value. 사용할 수는 Parse 하 고 TryParse 시간 간격을 포함 하는 문자열을 변환 하는 메서드 TimeSpan 값입니다.You can use the Parse and TryParse methods to convert strings that contain time intervals to TimeSpan values. 다음 예제에서는 합니다 Parse 문자열의 배열로 변환 하는 메서드 TimeSpan 값입니다.The following example uses the Parse method to convert an array of strings to TimeSpan values.

``````string[] values = { "12", "31.", "5.8:32:16", "12:12:15.95", ".12"};
foreach (string value in values)
{
try {
TimeSpan ts = TimeSpan.Parse(value);
Console.WriteLine("'{0}' --> {1}", value, ts);
}
catch (FormatException) {
Console.WriteLine("Unable to parse '{0}'", value);
}
catch (OverflowException) {
Console.WriteLine("'{0}' is outside the range of a TimeSpan.", value);
}
}

// The example displays the following output:
//       '12' --> 12.00:00:00
//       Unable to parse '31.'
//       '5.8:32:16' --> 5.08:32:16
//       '12:12:15.95' --> 12:12:15.9500000
//       Unable to parse '.12'
``````
``````Dim values() As String = { "12", "31.", "5.8:32:16", "12:12:15.95", ".12"}
For Each value As String In values
Try
Dim ts As TimeSpan = TimeSpan.Parse(value)
Console.WriteLine("'{0}' --> {1}", value, ts)
Catch e As FormatException
Console.WriteLine("Unable to parse '{0}'", value)
Catch e As OverflowException
Console.WriteLine("'{0}' is outside the range of a TimeSpan.", value)
End Try
Next
' The example displays the following output:
'       '12' --> 12.00:00:00
'       Unable to parse '31.'
'       '5.8:32:16' --> 5.08:32:16
'       '12:12:15.95' --> 12:12:15.9500000
'       Unable to parse '.12'
``````

또한 구문 분석 하 고 변환할 입력된 문자열의 정확한 형식을 정의할 수 있습니다는 TimeSpan 를 호출 하 여 값을 ParseExact 또는 TryParseExact 메서드.In addition, you can define the precise format of the input string to be parsed and converted to a TimeSpan value by calling the ParseExact or TryParseExact method.

### TimeSpan 값에 대 한 작업을 수행합니다.Performing Operations on TimeSpan Values

추가 하 고 사용 하 여 기간을 뺄 수는 AdditionSubtraction 연산자를 호출 하 여는 AddSubtract 메서드.You can add and subtract time durations either by using the Addition and Subtraction operators, or by calling the Add and Subtract methods. 호출 하 여 두 시간 기간을 비교할 수도 있습니다는 Compare, CompareTo, 및 Equals 메서드.You can also compare two time durations by calling the Compare, CompareTo, and Equals methods. TimeSpan 구조에도 포함 됩니다 합니다 DurationNegate 간격 양수 및 음수 값으로 변환 하는 메서드The TimeSpan structure also includes the Duration and Negate methods, which convert time intervals to positive and negative values,

범위의 TimeSpan 값은 MinValueMaxValue입니다.The range of TimeSpan values is MinValue to MaxValue.

### TimeSpan 값 서식 지정Formatting a TimeSpan Value

A TimeSpan 값으로 나타낼 수 있습니다 [-]d. hh:mm:ss. ff선택적 빼기 기호를 나타내는 음수 시간 간격, 여기서는 d 구성 요소는 ' 일 hh 는 24 시간 시계를 기준으로 시간 mm 분입니다 ss 초 이며, 및 ff 소수 단위 초를 됩니다.A TimeSpan value can be represented as [-]d.hh:mm:ss.ff, where the optional minus sign indicates a negative time interval, the d component is days, hh is hours as measured on a 24-hour clock, mm is minutes, ss is seconds, and ff is fractions of a second. 즉, 시간 간격을 일, 하루 중 시간을 제외한 양수 또는 음수일 수 또는 일, 하루 중 시간 또는 시간을 사용 하 여 숫자로 구성 됩니다.That is, a time interval consists of a positive or negative number of days without a time of day, or a number of days with a time of day, or only a time of day.

부터 .NET Framework 4.NET Framework 4, TimeSpan 구조는 오버 로드를 통해 문화권 구분 서식 지정을 지원 해당 ToString 변환 하는 메서드를 TimeSpan 값을 해당 문자열 표현입니다.Beginning with the .NET Framework 4.NET Framework 4, the TimeSpan structure supports culture-sensitive formatting through the overloads of its ToString method, which converts a TimeSpan value to its string representation. 기본 TimeSpan.ToString() 메서드 고정 되는 형식으로 이전 버전의.NET Framework의 해당 반환 값과 동일한을 사용 하 여 시간 간격을 반환 합니다.The default TimeSpan.ToString() method returns a time interval by using an invariant format that is identical to its return value in previous versions of the .NET Framework. TimeSpan.ToString(String) 오버 로드를 사용 하면 시간 간격의 문자열 표현을 정의 하는 서식 문자열을 지정 합니다.The TimeSpan.ToString(String) overload lets you specify a format string that defines the string representation of the time interval. TimeSpan.ToString(String, IFormatProvider) 오버 로드를 사용 하면 형식 문자열 및 해당 형식 지정 규칙 시간 간격의 문자열 표현을 만드는 데 사용 되는 문화권을 지정 합니다.The TimeSpan.ToString(String, IFormatProvider) overload lets you specify a format string and the culture whose formatting conventions are used to create the string representation of the time interval. TimeSpan 두 표준 및 사용자 지정 형식 문자열을 지원합니다.TimeSpan supports both standard and custom format strings. 자세한 내용은 표준 Timespan 형식 문자열사용자 지정 TimeSpan 서식 문자열을 참조 하세요. 그러나 표준 형식 문자열만 문화권을 구분 합니다.(For more information, see Standard TimeSpan Format Strings and Custom TimeSpan Format Strings.) However, only standard format strings are culture-sensitive.

### 복원 중인 레거시 TimeSpan 서식 지정Restoring Legacy TimeSpan Formatting

경우에 따라 코드는 성공적으로 형식 TimeSpan 에 값 .NET Framework 3.5.NET Framework 3.5 이전 버전에서는 실패 .NET Framework 4.NET Framework 4합니다.In some cases, code that successfully formats TimeSpan values in .NET Framework 3.5.NET Framework 3.5 and earlier versions fails in .NET Framework 4.NET Framework 4. 이 호출 하는 코드에서 가장 일반적을 < TimeSpan_LegacyFormatMode > 요소 서식을 지정 하는 방법을 TimeSpan 서식 문자열을 사용 하 여 값입니다.This is most common in code that calls a <TimeSpan_LegacyFormatMode> element method to format a TimeSpan value with a format string. 다음 예제에서는 성공적으로 서식을 지정는 TimeSpan 에 값 .NET Framework 3.5.NET Framework 3.5 및 이전 버전에서 예외를 throw 하지만 .NET Framework 4.NET Framework 4 이상 버전.The following example successfully formats a TimeSpan value in .NET Framework 3.5.NET Framework 3.5 and earlier versions, but throws an exception in .NET Framework 4.NET Framework 4 and later versions. 포맷 하려고 시도 하는 한 TimeSpan 에서 무시 된은 지원 되지 않는 형식 지정자를 사용 하 여 값 .NET Framework 3.5.NET Framework 3.5 및 이전 버전입니다.Note that it attempts to format a TimeSpan value by using an unsupported format specifier, which is ignored in .NET Framework 3.5.NET Framework 3.5 and earlier versions.

``````ShowFormattingCode();
// Output from .NET Framework 3.5 and earlier versions:
//       12:30:45
// Output from .NET Framework 4:
//       Invalid Format

Console.WriteLine("---");

ShowParsingCode();
// Output:
//       000000006 --> 6.00:00:00

void ShowFormattingCode()
{
TimeSpan interval = new TimeSpan(12, 30, 45);
string output;
try {
output = String.Format("{0:r}", interval);
}
catch (FormatException) {
output = "Invalid Format";
}
Console.WriteLine(output);
}

void ShowParsingCode()
{
string value = "000000006";
try {
TimeSpan interval = TimeSpan.Parse(value);
Console.WriteLine("{0} --> {1}", value, interval);
}
catch (FormatException) {
}
catch (OverflowException) {
Console.WriteLine("{0}: Overflow", value);
}
}
``````
``````Dim interval As New TimeSpan(12, 30, 45)
Dim output As String
Try
output = String.Format("{0:r}", interval)
Catch e As FormatException
output = "Invalid Format"
End Try
Console.WriteLine(output)
' Output from .NET Framework 3.5 and earlier versions:
'       12:30:45
' Output from .NET Framework 4:
'       Invalid Format
``````

코드를 수정할 수 없는 경우 레거시 형식을 복원할 수 있습니다 TimeSpan 다음 방법 중 하나에 값:If you cannot modify the code, you can restore the legacy formatting of TimeSpan values in one of the following ways:

• 포함 하는 구성 파일을 만듭니다는 < TimeSpan_LegacyFormatMode > 요소합니다.By creating a configuration file that contains the <TimeSpan_LegacyFormatMode> element. 이 요소를 설정 `enabled` 특성을 `true` 레거시 복원 TimeSpan 응용 프로그램별 기준 서식 지정 합니다.Setting this element's `enabled` attribute to `true` restores legacy TimeSpan formatting on a per-application basis.

• "NetFx40_TimeSpanLegacyFormatMode" 호환성을 설정 하 여 애플리케이션 도메인을 만들 때를 전환 합니다.By setting the "NetFx40_TimeSpanLegacyFormatMode" compatibility switch when you create an application domain. 이렇게 하면 레거시 TimeSpan 응용 프로그램 도메인 별로 서식 지정 합니다.This enables legacy TimeSpan formatting on a per-application-domain basis. 다음 예제에서는 사용 하는 애플리케이션 도메인에 레거시 TimeSpan 서식 지정 합니다.The following example creates an application domain that uses legacy TimeSpan formatting.

``````using System;

public class Example
{
public static void Main()
{
AppDomainSetup appSetup = new AppDomainSetup();
appSetup.SetCompatibilitySwitches( new string[] { "NetFx40_TimeSpanLegacyFormatMode" } );
AppDomain legacyDomain = AppDomain.CreateDomain("legacyDomain",
null, appSetup);
legacyDomain.ExecuteAssembly("ShowTimeSpan.exe");
}
}
``````
``````Module Example
Public Sub Main()
Dim appSetup As New AppDomainSetup()
appSetup.SetCompatibilitySwitches( { "NetFx40_TimeSpanLegacyFormatMode" } )
Dim legacyDomain As AppDomain = AppDomain.CreateDomain("legacyDomain",
Nothing, appSetup)
legacyDomain.ExecuteAssembly("ShowTimeSpan.exe")
End Sub
End Module
``````

레거시 돌아갑니다 다음 코드는 새 애플리케이션 도메인에서 실행 되 면 TimeSpan 서식 지정 동작입니다.When the following code executes in the new application domain, it reverts to legacy TimeSpan formatting behavior.

``````using System;

public class Example
{
public static void Main()
{
TimeSpan interval = DateTime.Now - DateTime.Now.Date;
string msg = String.Format("Elapsed Time Today: {0:d} hours.",
interval);
Console.WriteLine(msg);
}
}
// The example displays the following output:
//       Elapsed Time Today: 01:40:52.2524662 hours.
``````
``````Module Example
Public Sub Main()
Dim interval As TimeSpan = Date.Now - Date.Now.Date
Dim msg As String = String.Format("Elapsed Time Today: {0:d} hours.",
interval)
Console.WriteLine(msg)
End Sub
End Module
' The example displays output like the following:
'       Elapsed Time Today: 01:40:52.2524662 hours.
``````

## 생성자

 TimeSpan 구조체의 새 인스턴스를 지정된 시간, 분, 초의 수로 초기화합니다.Initializes a new instance of the TimeSpan structure to a specified number of hours, minutes, and seconds. TimeSpan 구조체의 새 인스턴스를 지정된 일, 시간, 분, 초의 수로 초기화합니다.Initializes a new instance of the TimeSpan structure to a specified number of days, hours, minutes, and seconds. TimeSpan 구조체의 새 인스턴스를 지정된 일, 시간, 분, 초, 밀리초의 수로 초기화합니다.Initializes a new instance of the TimeSpan structure to a specified number of days, hours, minutes, seconds, and milliseconds. TimeSpan 구조체의 새 인스턴스를 지정된 틱 수로 초기화합니다.Initializes a new instance of the TimeSpan structure to the specified number of ticks.

## 필드

 최대 TimeSpan 값을 나타냅니다.Represents the maximum TimeSpan value. 이 필드는 읽기 전용입니다.This field is read-only. 최소 TimeSpan 값을 나타냅니다.Represents the minimum TimeSpan value. 이 필드는 읽기 전용입니다.This field is read-only. 1일 동안의 틱 수를 나타냅니다.Represents the number of ticks in 1 day. 이 필드는 상수입니다.This field is constant. 1시간 동안의 틱 수를 나타냅니다.Represents the number of ticks in 1 hour. 이 필드는 상수입니다.This field is constant. 1밀리초 동안의 틱 수를 나타냅니다.Represents the number of ticks in 1 millisecond. 이 필드는 상수입니다.This field is constant. 1분 동안의 틱 수를 나타냅니다.Represents the number of ticks in 1 minute. 이 필드는 상수입니다.This field is constant. 1초 동안의 틱 수를 나타냅니다.Represents the number of ticks in 1 second. 0 TimeSpan 값을 나타냅니다.Represents the zero TimeSpan value. 이 필드는 읽기 전용입니다.This field is read-only.

## 속성

 현재의 TimeSpan 구조체가 나타내는 시간 간격의 일 구성 요소를 가져옵니다.Gets the days component of the time interval represented by the current TimeSpan structure. 현재 TimeSpan 구조체가 나타내는 시간 간격의 시 구성 요소를 가져옵니다.Gets the hours component of the time interval represented by the current TimeSpan structure. 현재 TimeSpan 구조가 나타내는 시간 간격의 밀리초 구성 요소를 가져옵니다.Gets the milliseconds component of the time interval represented by the current TimeSpan structure. 현재 TimeSpan 구조가 나타내는 시간 간격의 분 구성 요소를 가져옵니다.Gets the minutes component of the time interval represented by the current TimeSpan structure. 현재 TimeSpan 구조가 나타내는 시간 간격의 초 구성 요소를 가져옵니다.Gets the seconds component of the time interval represented by the current TimeSpan structure. 현재 TimeSpan 구조체의 값을 나타내는 틱 수를 가져옵니다.Gets the number of ticks that represent the value of the current TimeSpan structure. 일의 정수 부분과 소수 부분으로 표시된 현재 TimeSpan 구조체의 값을 가져옵니다.Gets the value of the current TimeSpan structure expressed in whole and fractional days. 시간의 정수 부분과 소수 부분으로 표시된 현재 TimeSpan 구조체의 값을 가져옵니다.Gets the value of the current TimeSpan structure expressed in whole and fractional hours. 밀리초의 정수 부분과 소수 부분으로 표시된 현재 TimeSpan 구조체의 값을 가져옵니다.Gets the value of the current TimeSpan structure expressed in whole and fractional milliseconds. 분의 정수 부분과 소수 부분으로 표시된 현재 TimeSpan 구조체의 값을 가져옵니다.Gets the value of the current TimeSpan structure expressed in whole and fractional minutes. 초의 정수 부분과 소수 부분으로 표시된 현재 TimeSpan 구조체의 값을 가져옵니다.Gets the value of the current TimeSpan structure expressed in whole and fractional seconds.

## 메서드

 지정된 TimeSpan 개체와 이 인스턴스의 합을 값으로 갖는 새 TimeSpan 개체를 반환합니다.Returns a new TimeSpan object whose value is the sum of the specified TimeSpan object and this instance. 두 개의 TimeSpan 값을 비교하고 첫 번째 값이 두 번째 값보다 짧은지, 같은지, 혹은 긴지를 나타내는 정수를 반환합니다.Compares two TimeSpan values and returns an integer that indicates whether the first value is shorter than, equal to, or longer than the second value. 이 인스턴스를 지정된 개체와 비교하고, 이 인스턴스가 지정된 개체보다 짧은지, 같은지, 혹은 긴지를 나타내는 정수를 반환합니다.Compares this instance to a specified object and returns an integer that indicates whether this instance is shorter than, equal to, or longer than the specified object. 이 인스턴스를 지정된 TimeSpan 개체와 비교하고, 이 인스턴스가 TimeSpan 개체보다 짧은지, 같은지, 혹은 긴지를 나타내는 정수를 반환합니다.Compares this instance to a specified TimeSpan object and returns an integer that indicates whether this instance is shorter than, equal to, or longer than the TimeSpan object. 지정된 `divisor` 및 이 인스턴스의 나누기 결과를 값으로 갖는 새 TimeSpan 개체를 반환합니다.Returns a new TimeSpan object which value is the result of division of this instance and the specified `divisor`. 지정된 `ts` 및 이 인스턴스의 나누기 결과를 나타내는 새 Double 값을 반환합니다.Returns a new Double value which is the result of division of this instance and the specified `ts`. 현재 TimeSpan 개체의 절대 값과 같은 값의 새 TimeSpan 개체를 반환합니다.Returns a new TimeSpan object whose value is the absolute value of the current TimeSpan object. 이 인스턴스가 지정된 개체와 같은지를 표시하는 값을 반환합니다.Returns a value indicating whether this instance is equal to a specified object. 이 인스턴스가 지정된 TimeSpan 개체와 같은지 표시하는 값을 반환합니다.Returns a value indicating whether this instance is equal to a specified TimeSpan object. 지정된 TimeSpan의 두 인스턴스가 같은지 여부를 나타내는 값을 반환합니다.Returns a value that indicates whether two specified instances of TimeSpan are equal. 지정된 일 수를 나타내는 TimeSpan을 반환합니다. 여기에서 지정된 값은 밀리초 단위로 반올림됩니다.지정된 값은 밀리초 단위로 반올림됩니다.Returns a TimeSpan that represents a specified number of days, where the specification is accurate to the nearest millisecond. 지정된 시간의 수를 나타내는 TimeSpan을 반환합니다. 여기에서 지정된 값은 밀리초 단위로 반올림됩니다.Returns a TimeSpan that represents a specified number of hours, where the specification is accurate to the nearest millisecond. 지정된 밀리초의 수를 나타내는 TimeSpan을 반환합니다.Returns a TimeSpan that represents a specified number of milliseconds. 지정된 분의 수를 나타내는 TimeSpan을 반환합니다. 여기에서 지정된 값은 밀리초 단위로 반올림됩니다.Returns a TimeSpan that represents a specified number of minutes, where the specification is accurate to the nearest millisecond. 지정된 초의 수를 나타내는 TimeSpan을 반환합니다. 여기에서 지정된 값은 밀리초 단위로 반올림됩니다.Returns a TimeSpan that represents a specified number of seconds, where the specification is accurate to the nearest millisecond. 지정된 시간을 나타내는 TimeSpan을 반환합니다. 여기에서 시간은 틱 단위로 지정됩니다.Returns a TimeSpan that represents a specified time, where the specification is in units of ticks. 이 인스턴스의 해시 코드를 반환합니다.Returns a hash code for this instance. 지정된 `factor` 및 이 인스턴스의 곱하기 결과를 값으로 가지는 새 TimeSpan 개체를 반환합니다.Returns a new TimeSpan object which value is the result of multiplication of this instance and the specified `factor`. 이 인스턴스의 부정 값과 같은 값의 새 TimeSpan 개체를 반환합니다.Returns a new TimeSpan object whose value is the negated value of this instance. 지정된 문화권별 형식 정보를 사용하여 시간 간격에 대한 범위 표현을 해당 TimeSpan으로 변환합니다.Converts the span representation of a time interval to its TimeSpan equivalent by using the specified culture-specific format information. 시간 간격에 대한 문자열 표현을 해당 TimeSpan으로 변환합니다.Converts the string representation of a time interval to its TimeSpan equivalent. 지정된 문화권별 형식 정보를 사용하여 시간 간격에 대한 문자열 표현을 해당 TimeSpan으로 변환합니다.Converts the string representation of a time interval to its TimeSpan equivalent by using the specified culture-specific format information. 지정된 형식 및 문화권별 형식 정보를 사용하여 시간 간격의 문자 범위를 해당 TimeSpan으로 변환합니다.Converts the char span of a time interval to its TimeSpan equivalent by using the specified format and culture-specific format information. 문자열 표현의 형식이 지정된 형식과 정확하게 일치해야 합니다.The format of the string representation must match the specified format exactly. 지정된 형식, 문화권별 형식 정보 및 스타일을 사용하여 시간 간격에 대한 문자열 표현을 해당 TimeSpan으로 변환합니다.Converts the string representation of a time interval to its TimeSpan equivalent by using the specified formats, culture-specific format information, and styles. 문자열 표시의 형식은 지정된 형식 중 하나와 정확히 일치해야 합니다.The format of the string representation must match one of the specified formats exactly. 지정된 형식 및 문화권별 형식 정보를 사용하여 시간 간격에 대한 문자열 표현을 해당 TimeSpan으로 변환합니다.Converts the string representation of a time interval to its TimeSpan equivalent by using the specified format and culture-specific format information. 문자열 표현의 형식이 지정된 형식과 정확하게 일치해야 합니다.The format of the string representation must match the specified format exactly. 지정된 형식, 문화권별 형식 정보 및 스타일을 사용하여 시간 간격에 대한 문자열 표현을 해당 TimeSpan으로 변환합니다.Converts the string representation of a time interval to its TimeSpan equivalent by using the specified format, culture-specific format information, and styles. 문자열 표현의 형식이 지정된 형식과 정확하게 일치해야 합니다.The format of the string representation must match the specified format exactly. 지정된 형식 문자열 배열 및 문화권별 형식 정보를 사용하여 시간 간격에 대한 문자열 표현을 해당 TimeSpan으로 변환합니다.Converts the string representation of a time interval to its TimeSpan equivalent by using the specified array of format strings and culture-specific format information. 문자열 표시의 형식은 지정된 형식 중 하나와 정확히 일치해야 합니다.The format of the string representation must match one of the specified formats exactly. 지정된 형식, 문화권별 형식 정보 및 스타일을 사용하여 시간 간격에 대한 문자열 표현을 해당 TimeSpan으로 변환합니다.Converts the string representation of a time interval to its TimeSpan equivalent by using the specified formats, culture-specific format information, and styles. 문자열 표시의 형식은 지정된 형식 중 하나와 정확히 일치해야 합니다.The format of the string representation must match one of the specified formats exactly. 지정된 TimeSpan 개체와 이 인스턴스의 차를 값으로 가지는 새 TimeSpan 개체를 반환합니다.Returns a new TimeSpan object whose value is the difference between the specified TimeSpan object and this instance. 현재 TimeSpan 개체의 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the current TimeSpan object to its equivalent string representation. 지정된 형식을 사용하여 현재 TimeSpan 개체의 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the current TimeSpan object to its equivalent string representation by using the specified format. 지정된 형식과 문화권별 형식 정보를 사용하여 현재 TimeSpan 개체의 값을 해당 문자열 표현으로 변환합니다.Converts the value of the current TimeSpan object to its equivalent string representation by using the specified format and culture-specific formatting information. 현재 시간 범위 숫자 인스턴스 값을 제공된 문자 범위의 형식으로 지정하려고 시도합니다.Tries to format the value of the current timespan number instance into the provided span of characters. 지정된 문화권별 형식 정보를 사용하여 시간 간격에 대한 범위 표현을 해당 TimeSpan으로 변환하고, 변환에 성공했는지 나타내는 값을 반환합니다.Converts the span representation of a time interval to its TimeSpan equivalent by using the specified culture-specific formatting information, and returns a value that indicates whether the conversion succeeded. 시간 간격에 대한 범위 표현을 해당 TimeSpan으로 변환하고, 변환에 성공했는지 나타내는 값을 반환합니다.Converts the span representation of a time interval to its TimeSpan equivalent and returns a value that indicates whether the conversion succeeded. 지정된 문화권별 형식 정보를 사용하여 시간 간격에 대한 문자열 표현을 해당 TimeSpan으로 변환하고, 변환에 성공했는지 여부를 나타내는 값을 반환합니다.Converts the string representation of a time interval to its TimeSpan equivalent by using the specified culture-specific formatting information, and returns a value that indicates whether the conversion succeeded. 시간 간격에 대한 문자열 표현을 해당 TimeSpan으로 변환하고, 변환에 성공했는지 여부를 나타내는 값을 반환합니다.Converts the string representation of a time interval to its TimeSpan equivalent and returns a value that indicates whether the conversion succeeded. 지정된 형식, 문화권별 형식 정보를 사용하여 시간 간격에 대한 지정된 범위 표현을 해당 TimeSpan으로 변환하고, 변환에 성공했는지 여부를 나타내는 값을 반환합니다.Converts the specified span representation of a time interval to its TimeSpan equivalent by using the specified format and culture-specific format information, and returns a value that indicates whether the conversion succeeded. 문자열 표현의 형식이 지정된 형식과 정확하게 일치해야 합니다.The format of the string representation must match the specified format exactly. 지정된 형식, 문화권별 형식 정보 및 스타일을 사용하여 시간 간격에 대한 지정된 범위 표현을 해당 TimeSpan으로 변환하고, 변환에 성공했는지 나타내는 값을 반환합니다.Converts the specified span representation of a time interval to its TimeSpan equivalent by using the specified format, culture-specific format information, and styles, and returns a value that indicates whether the conversion succeeded. 문자열 표현의 형식이 지정된 형식과 정확하게 일치해야 합니다.The format of the string representation must match the specified format exactly. 지정된 형식, 문화권별 형식 정보를 사용하여 시간 간격에 대한 지정된 범위 표현을 해당 TimeSpan으로 변환하고, 변환에 성공했는지 여부를 나타내는 값을 반환합니다.Converts the specified span representation of a time interval to its TimeSpan equivalent by using the specified formats and culture-specific format information, and returns a value that indicates whether the conversion succeeded. 문자열 표시의 형식은 지정된 형식 중 하나와 정확히 일치해야 합니다.The format of the string representation must match one of the specified formats exactly. 지정된 형식, 문화권별 형식 정보 및 스타일을 사용하여 시간 간격에 대한 지정된 범위 표현을 해당 TimeSpan으로 변환하고, 변환에 성공했는지를 나타내는 값을 반환합니다.Converts the specified span representation of a time interval to its TimeSpan equivalent by using the specified formats, culture-specific format information, and styles, and returns a value that indicates whether the conversion succeeded. 문자열 표시의 형식은 지정된 형식 중 하나와 정확히 일치해야 합니다.The format of the string representation must match one of the specified formats exactly. 지정된 형식, 문화권별 형식 정보를 사용하여 시간 간격에 대한 지정된 범위 표현을 해당 TimeSpan으로 변환하고, 변환에 성공했는지 여부를 나타내는 값을 반환합니다.Converts the string representation of a time interval to its TimeSpan equivalent by using the specified format and culture-specific format information, and returns a value that indicates whether the conversion succeeded. 문자열 표현의 형식이 지정된 형식과 정확하게 일치해야 합니다.The format of the string representation must match the specified format exactly. 지정된 형식, 문화권별 형식 정보 및 스타일을 사용하여 시간 간격에 대한 문자열 표현을 해당 TimeSpan으로 변환하고, 변환에 성공했는지를 나타내는 값을 반환합니다.Converts the string representation of a time interval to its TimeSpan equivalent by using the specified format, culture-specific format information, and styles, and returns a value that indicates whether the conversion succeeded. 문자열 표현의 형식이 지정된 형식과 정확하게 일치해야 합니다.The format of the string representation must match the specified format exactly. 지정된 형식, 문화권별 형식 정보를 사용하여 시간 간격에 대한 지정된 문자열 표현을 해당 TimeSpan으로 변환하고, 변환에 성공했는지 나타내는 값을 반환합니다.Converts the specified string representation of a time interval to its TimeSpan equivalent by using the specified formats and culture-specific format information, and returns a value that indicates whether the conversion succeeded. 문자열 표시의 형식은 지정된 형식 중 하나와 정확히 일치해야 합니다.The format of the string representation must match one of the specified formats exactly. 지정된 형식, 문화권별 형식 정보 및 스타일을 사용하여 시간 간격에 대한 지정된 문자열 표현을 해당 TimeSpan으로 변환하고, 변환에 성공했는지를 나타내는 값을 반환합니다.Converts the specified string representation of a time interval to its TimeSpan equivalent by using the specified formats, culture-specific format information, and styles, and returns a value that indicates whether the conversion succeeded. 문자열 표시의 형식은 지정된 형식 중 하나와 정확히 일치해야 합니다.The format of the string representation must match one of the specified formats exactly.

## 연산자

 두 개의 지정된 TimeSpan 인스턴스를 추가합니다.Adds two specified TimeSpan instances. 지정된 `divisor` 및 `timeSpan` 인스턴스의 나누기 결과를 값으로 가지는 새 TimeSpan 개체를 반환합니다.Returns a new TimeSpan object which value is the result of division of `timeSpan` instance and the specified `divisor`. 지정된 `t2` 및 `t1` 인스턴스의 나누기 결과를 나타내는 새 Double 값을 반환합니다.Returns a new Double value which is the result of division of `t1` instance and the specified `t2`. 두 개의 TimeSpan 인스턴스가 같은지를 표시합니다.Indicates whether two TimeSpan instances are equal. 지정된 TimeSpan이 지정된 다른 TimeSpan보다 큰지를 표시합니다.Indicates whether a specified TimeSpan is greater than another specified TimeSpan. 지정된 TimeSpan이 지정된 다른 TimeSpan보다 크거나 같은지를 표시합니다.Indicates whether a specified TimeSpan is greater than or equal to another specified TimeSpan. 두 개의 TimeSpan 인스턴스가 같지 않은를 표시합니다.Indicates whether two TimeSpan instances are not equal. 지정된 TimeSpan이 지정된 다른 TimeSpan보다 작은지를 표시합니다.Indicates whether a specified TimeSpan is less than another specified TimeSpan. 지정된 TimeSpan이 지정된 다른 TimeSpan보다 작거나 같은를 표시합니다.Indicates whether a specified TimeSpan is less than or equal to another specified TimeSpan. `timeSpan` 인스턴스와 지정된 `factor`의 곱하기 결과를 값으로 가지는 새 TimeSpan 개체를 반환합니다.Returns a new TimeSpan object which value is the result of multiplication of `timeSpan` instance and the specified `factor`. 지정된 TimeSpan을 지정된 다른 TimeSpan에서 뺍니다.Subtracts a specified TimeSpan from another specified TimeSpan. 지정된 인스턴스의 부정 값과 같은 값의 TimeSpan을 반환합니다.Returns a TimeSpan whose value is the negated value of the specified instance. TimeSpan의 지정된 인스턴스를 반환합니다.Returns the specified instance of TimeSpan.