TimeSpan Структура

Определение

Пространство имен:

System

Сборка:

System.Runtime.dll

Исходный код:

TimeSpan.cs

Представляет интервал времени.

public value class TimeSpan : IComparable, IComparable<TimeSpan>, IEquatable<TimeSpan>, IParsable<TimeSpan>, ISpanFormattable, ISpanParsable<TimeSpan>, IUtf8SpanFormattable

public readonly struct TimeSpan : IComparable, IComparable<TimeSpan>, IEquatable<TimeSpan>, IParsable<TimeSpan>, ISpanFormattable, ISpanParsable<TimeSpan>, IUtf8SpanFormattable

type TimeSpan = struct
    interface IFormattable
    interface IParsable<TimeSpan>
    interface ISpanFormattable
    interface ISpanParsable<TimeSpan>
    interface IUtf8SpanFormattable

Public Structure TimeSpan
Implements IComparable, IComparable(Of TimeSpan), IEquatable(Of TimeSpan), IParsable(Of TimeSpan), ISpanFormattable, ISpanParsable(Of TimeSpan), IUtf8SpanFormattable

Наследование

Object

ValueType

TimeSpan

Реализации

IComparable IComparable<TimeSpan> IEquatable<TimeSpan> IFormattable ISpanFormattable IParsable<TimeSpan> IParsable<TSelf> ISpanParsable<TimeSpan> IUtf8SpanFormattable

Примеры

В следующем примере создается экземпляр объекта TimeSpan, представляющего разницу между двумя датами. Затем он отображает свойства объекта TimeSpan.

// 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.
let date1 = DateTime(2010, 1, 1, 8, 0, 15)
let date2 = DateTime(2010, 8, 18, 13, 30, 30)

// Calculate the interval between the two dates.
let interval = date2 - date1
printfn $"{date2} - {date1} = {interval}"

// Display individual properties of the resulting TimeSpan object.
printfn $"""   {"Value of Days Component:",-35} {interval.Days,20}""" 
printfn $"""   {"Total Number of Days:",-35} {interval.TotalDays,20}""" 
printfn $"""   {"Value of Hours Component:",-35} {interval.Hours,20}""" 
printfn $"""   {"Total Number of Hours:",-35} {interval.TotalHours,20}""" 
printfn $"""   {"Value of Minutes Component:",-35} {interval.Minutes,20}""" 
printfn $"""   {"Total Number of Minutes:",-35} {interval.TotalMinutes,20}""" 
printfn $"""   {"Value of Seconds Component:",-35} {interval.Seconds,20:N0}""" 
printfn $"""   {"Total Number of Seconds:",-35} {interval.TotalSeconds,20:N0}""" 
printfn $"""   {"Value of Milliseconds Component:",-35} {interval.Milliseconds,20:N0}""" 
printfn $"""   {"Total Number of Milliseconds:",-35} {interval.TotalMilliseconds,20:N0}""" 
printfn $"""   {"Ticks:",-35} {interval.Ticks,20:N0}""" 

// 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
#>

Комментарии

Дополнительные сведения об этом API см. в дополнительных примечаний API для TimeSpan.

Конструкторы

TimeSpan(Int32, Int32, Int32)	Инициализирует новый экземпляр структуры TimeSpan до указанного количества часов, минут и секунд.
TimeSpan(Int32, Int32, Int32, Int32)	Инициализирует новый экземпляр структуры TimeSpan в указанное количество дней, часов, минут и секунд.
TimeSpan(Int32, Int32, Int32, Int32, Int32)	Инициализирует новый экземпляр структуры TimeSpan до указанного количества дней, часов, минут, секунд и миллисекунд.
TimeSpan(Int32, Int32, Int32, Int32, Int32, Int32)	Инициализирует новый экземпляр структуры TimeSpan до указанного количества дней, часов, минут, секунд, миллисекунд и микросекунд.
TimeSpan(Int64)	Инициализирует новый экземпляр TimeSpan структуры до указанного числа тиков.

Поля

MaxValue	Представляет максимальное значение TimeSpan. Это поле доступно только для чтения.
MinValue	Представляет минимальное значение TimeSpan. Это поле доступно только для чтения.
NanosecondsPerTick	Представляет число наносекунд на галок. Это поле является константой.
TicksPerDay	Представляет количество галок в течение 1 дня. Это поле является константой.
TicksPerHour	Представляет количество галок в течение 1 часа. Это поле является константой.
TicksPerMicrosecond	Представляет количество тиков в 1 микросекундах. Это поле является константой.
TicksPerMillisecond	Представляет количество галок в 1 миллисекундах. Это поле является константой.
TicksPerMinute	Представляет количество тиков в 1 минуту. Это поле является константой.
TicksPerSecond	Представляет количество галок в 1 секунде.
Zero	Представляет нулевое значение TimeSpan. Это поле доступно только для чтения.

Свойства

Days	Возвращает компонент дней интервала времени, представленного текущей структурой TimeSpan.
Hours	Возвращает компонент часов интервала времени, представленного текущей структурой TimeSpan.
Microseconds	Возвращает компонент микросекунд интервала времени, представленного текущей структурой TimeSpan.
Milliseconds	Возвращает компонент миллисекунда интервала времени, представленного текущей структурой TimeSpan.
Minutes	Возвращает компонент минут интервала времени, представленного текущей структурой TimeSpan.
Nanoseconds	Возвращает компонент nanoseconds интервала времени, представленного текущей структурой TimeSpan.
Seconds	Возвращает компонент секунд интервала времени, представленного текущей структурой TimeSpan.
Ticks	Возвращает количество тиков, представляющих значение текущей структуры TimeSpan.
TotalDays	Возвращает значение текущей структуры TimeSpan, выраженной в целом и дробных днях.
TotalHours	Возвращает значение текущей TimeSpan структуры, выраженной в целом и дробных часах.
TotalMicroseconds	Возвращает значение текущей TimeSpan структуры, выраженной в целом и дробных микросекундах.
TotalMilliseconds	Возвращает значение текущей TimeSpan структуры, выраженной в целом и дробных миллисекундах.
TotalMinutes	Возвращает значение текущей TimeSpan структуры, выраженной в целом и дробных минутах.
TotalNanoseconds	Возвращает значение текущей TimeSpan структуры, выраженной в целом и дробных наносекундах.
TotalSeconds	Возвращает значение текущей TimeSpan структуры, выраженной в целом и дробных секундах.

Методы

Add(TimeSpan)	Возвращает новый объект TimeSpan, значение которого является суммой указанного объекта TimeSpan и этого экземпляра.
Compare(TimeSpan, TimeSpan)	Сравнивает два значения TimeSpan и возвращает целое число, указывающее, короче ли первое значение, равное или длине второго значения.
CompareTo(Object)	Сравнивает этот экземпляр с указанным объектом и возвращает целое число, указывающее, короче ли этот экземпляр, равно или длиннее указанного объекта.
CompareTo(TimeSpan)	Сравнивает этот экземпляр с указанным объектом TimeSpan и возвращает целое число, указывающее, короче ли этот экземпляр, равно или длиннее объекта TimeSpan.
Divide(Double)	Возвращает новый объект TimeSpan, значение которого является результатом деления этого экземпляра на указанный divisor.
Divide(TimeSpan)	Возвращает новое значение Double, которое является результатом деления этого экземпляра на ts.
Duration()	Возвращает новый объект TimeSpan, значение которого является абсолютным значением текущего объекта TimeSpan.
Equals(Object)	Возвращает значение, указывающее, равен ли этот экземпляр указанному объекту.
Equals(TimeSpan)	Возвращает значение, указывающее, равен ли этот экземпляр указанному объекту TimeSpan.
Equals(TimeSpan, TimeSpan)	Возвращает значение, указывающее, равны ли два указанных экземпляра TimeSpan.
FromDays(Double)	Возвращает TimeSpan, представляющее указанное число дней, где спецификация является точной до ближайшей миллисекунда.
FromHours(Double)	Возвращает TimeSpan, представляющее указанное количество часов, где спецификация является точной до ближайшей миллисекунда.
FromMicroseconds(Double)	Возвращает TimeSpan, представляющий указанное число микросекунд.
FromMilliseconds(Double)	Возвращает TimeSpan, представляющий указанное число миллисекундах.
FromMinutes(Double)	Возвращает TimeSpan, представляющее указанное количество минут, где спецификация является точной до ближайшей миллисекунда.
FromSeconds(Double)	Возвращает TimeSpan, представляющее указанное количество секунд, где спецификация является точной до ближайшей миллисекунд.
FromTicks(Int64)	Возвращает TimeSpan, представляющий указанное время, где спецификация находится в единицах тиков.
GetHashCode()	Возвращает хэш-код для этого экземпляра.
Multiply(Double)	Возвращает новый объект TimeSpan, значение которого является результатом умножения этого экземпляра и указанного factor.
Negate()	Возвращает новый объект TimeSpan, значение которого является отрицаемым значением этого экземпляра.
Parse(ReadOnlySpan<Char>, IFormatProvider)	Преобразует представление интервала интервала в его TimeSpan эквивалент, используя указанные сведения о формате, зависящий от языка и региональных параметров.
Parse(String)	Преобразует строковое представление интервала времени в его TimeSpan эквивалент.
Parse(String, IFormatProvider)	Преобразует строковое представление интервала времени в его TimeSpan эквивалент с помощью указанных сведений о формате, зависящих от языка и региональных параметров.
ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, TimeSpanStyles)	Преобразует интервал времени в его TimeSpan эквивалент с помощью указанного формата и сведений о формате и региональных параметрах. Формат строкового представления должен точно соответствовать указанному формату.
ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, TimeSpanStyles)	Преобразует строковое представление интервала времени в его TimeSpan эквивалент с помощью указанных форматов, сведений о формате и стилях, зависящих от языка и региональных параметров. Формат строкового представления должен точно соответствовать одному из указанных форматов.
ParseExact(String, String, IFormatProvider)	Преобразует строковое представление интервала времени в его TimeSpan эквивалент, используя указанные сведения о формате и языке и региональных параметрах. Формат строкового представления должен точно соответствовать указанному формату.
ParseExact(String, String, IFormatProvider, TimeSpanStyles)	Преобразует строковое представление интервала времени в его TimeSpan эквивалент с помощью указанного формата, сведений о формате, региональных параметрах и стилях. Формат строкового представления должен точно соответствовать указанному формату.
ParseExact(String, String[], IFormatProvider)	Преобразует строковое представление интервала времени в его TimeSpan эквивалент с помощью указанного массива строк формата и сведений о формате, зависящих от языка и региональных параметров. Формат строкового представления должен точно соответствовать одному из указанных форматов.
ParseExact(String, String[], IFormatProvider, TimeSpanStyles)	Преобразует строковое представление интервала времени в его TimeSpan эквивалент с помощью указанных форматов, сведений о формате и стилях, зависящих от языка и региональных параметров. Формат строкового представления должен точно соответствовать одному из указанных форматов.
Subtract(TimeSpan)	Возвращает новый объект TimeSpan, значение которого является разницей между указанным объектом TimeSpan и этим экземпляром.
ToString()	Преобразует значение текущего объекта TimeSpan в эквивалентное строковое представление.
ToString(String)	Преобразует значение текущего объекта TimeSpan в эквивалентное строковое представление с помощью указанного формата.
ToString(String, IFormatProvider)	Преобразует значение текущего объекта TimeSpan в эквивалентное строковое представление с помощью указанного формата и сведений о форматировании с учетом языка и региональных параметров.
TryFormat(Span<Byte>, Int32, ReadOnlySpan<Char>, IFormatProvider)	Пытается отформатировать значение текущего экземпляра как UTF-8 в предоставленный диапазон байтов.
TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)	Пытается отформатировать значение текущего экземпляра интервала времени в предоставленный диапазон символов.
TryParse(ReadOnlySpan<Char>, IFormatProvider, TimeSpan)	Преобразует представление интервала интервала в его TimeSpan эквивалент, используя указанные сведения о форматировании, зависящее от языка и региональных параметров, и возвращает значение, указывающее, выполнено ли преобразование успешно.
TryParse(ReadOnlySpan<Char>, TimeSpan)	Преобразует представление интервала интервала в его TimeSpan эквивалент и возвращает значение, указывающее, выполнено ли преобразование успешно.
TryParse(String, IFormatProvider, TimeSpan)	Преобразует строковое представление интервала времени в его TimeSpan эквивалент, используя указанные сведения о форматировании, зависящее от языка и региональных параметров, и возвращает значение, указывающее, выполнено ли преобразование успешно.
TryParse(String, TimeSpan)	Преобразует строковое представление интервала времени в его TimeSpan эквивалент и возвращает значение, указывающее, выполнено ли преобразование успешно.
TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, TimeSpan)	Преобразует указанное представление интервала времени в его TimeSpan эквивалент, используя указанные сведения о формате и языке и региональных параметрах. Формат строкового представления должен точно соответствовать указанному формату.
TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, TimeSpanStyles, TimeSpan)	Преобразует указанное представление интервала времени в его TimeSpan эквивалент с помощью указанного формата, сведений о формате и стилях конкретного языка и региональных параметров, а также возвращает значение, указывающее, выполнено ли преобразование успешно. Формат строкового представления должен точно соответствовать указанному формату.
TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, TimeSpan)	Преобразует указанное представление интервала времени в его TimeSpan эквивалент с помощью указанных форматов и сведений о формате, зависящих от языка и региональных параметров. Формат строкового представления должен точно соответствовать одному из указанных форматов.
TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, TimeSpanStyles, TimeSpan)	Преобразует указанное представление интервала времени в его TimeSpan эквивалент с помощью указанных форматов, сведений о формате и стилях, зависящих от языка и региональных параметров. Формат строкового представления должен точно соответствовать одному из указанных форматов.
TryParseExact(String, String, IFormatProvider, TimeSpan)	Преобразует строковое представление интервала времени в его TimeSpan эквивалент, используя указанные сведения о формате и языке и региональных параметрах. Формат строкового представления должен точно соответствовать указанному формату.
TryParseExact(String, String, IFormatProvider, TimeSpanStyles, TimeSpan)	Преобразует строковое представление интервала времени в его TimeSpan эквивалент с помощью указанного формата, сведений о формате и стилях, зависящих от языка и региональных параметров. Формат строкового представления должен точно соответствовать указанному формату.
TryParseExact(String, String[], IFormatProvider, TimeSpan)	Преобразует указанное строковое представление интервала времени в его TimeSpan эквивалент с помощью указанных форматов и сведений о формате, зависящих от языка и региональных параметров. Формат строкового представления должен точно соответствовать одному из указанных форматов.
TryParseExact(String, String[], IFormatProvider, TimeSpanStyles, TimeSpan)	Преобразует указанное строковое представление интервала времени в его TimeSpan эквивалент с помощью указанных форматов, сведений о формате и стилях, зависящих от языка и региональных параметров. Формат строкового представления должен точно соответствовать одному из указанных форматов.

Операторы

Addition(TimeSpan, TimeSpan)	Добавляет два указанных экземпляра TimeSpan.
Division(TimeSpan, Double)	Возвращает новый объект TimeSpan, значение которого является результатом деления указанного timeSpan указанным divisor.
Division(TimeSpan, TimeSpan)	Возвращает новое значение Double, которое является результатом деления t1 на t2.
Equality(TimeSpan, TimeSpan)	Указывает, равны ли два экземпляра TimeSpan.
GreaterThan(TimeSpan, TimeSpan)	Указывает, превышает ли указанный TimeSpan указанный TimeSpan.
GreaterThanOrEqual(TimeSpan, TimeSpan)	Указывает, превышает ли указанный TimeSpan значение или равно другому указанному TimeSpan.
Inequality(TimeSpan, TimeSpan)	Указывает, равны ли два экземпляра TimeSpan.
LessThan(TimeSpan, TimeSpan)	Указывает, меньше ли указанный TimeSpan, чем другой указанный TimeSpan.
LessThanOrEqual(TimeSpan, TimeSpan)	Указывает, меньше ли указанное TimeSpan или равно другому указанному TimeSpan.
Multiply(Double, TimeSpan)	Возвращает новый объект TimeSpan, значение которого является результатом умножения указанного factor и указанного экземпляра timeSpan.
Multiply(TimeSpan, Double)	Возвращает новый объект TimeSpan, значение которого является результатом умножения указанного экземпляра timeSpan и указанного factor.
Subtraction(TimeSpan, TimeSpan)	Вычитает указанный TimeSpan из другого указанного TimeSpan.
UnaryNegation(TimeSpan)	Возвращает TimeSpan, значение которого является отрицанием указанного экземпляра.
UnaryPlus(TimeSpan)	Возвращает указанный экземпляр TimeSpan.

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

• DateTime
• DateTimeOffset
• Calendar