|
|
| System.TimeSpan Structure |
|
| |
| Description | |
|
The TimeSpan holds a time span in days, hours, minutes, seconds and milliseconds. Unlike DateTime, which is a point in time, TimeSpan is an elapsed period of time. For example, two and a half hours.
Internally, the elapsed time is in terms of a number of elemental ticks (0.0000001 seconds).
It can be used in arithmetic on DateTime values, for example, by adding a TimeSpan value to a point in time, or as the result of the difference between two dates. |
|
| Syntax | | | | Constructor Create ( | Ticks : Long
; ); | | Constructor Create ( | Hours : Integer; Minutes : Integer; Seconds : Integer
); | | Constructor Create ( | Days : Integer; Hours : Integer; Minutes : Integer; Seconds : Integer
); | | Constructor Create ( | Days : Integer; Hours : Integer; Minutes : Integer; Seconds : Integer; Milliseconds : Integer ); |
| | Methods | | | | Add | Adds a timespan to the current timespan | | Compare | Compares twoTimeSpan values | | CompareTo | Compares the current TimeSpan value to another | | Duration | Returns the absolute value of the current TimeSpan | | Equals | Returns true if TimeSpan values are exactly the same | | FromDays | Creates a TimeSpan value from a given number of days | | FromHours | Creates a TimeSpan value from a given number of hours | | FromMilliseconds | Creates a TimeSpan value from a given number of milliseconds | | FromMinutes | Creates a TimeSpan value from a given number of minutes | | FromSeconds | Creates a TimeSpan value from a given number of seconds | | FromTicks | Creates a TimeSpan value from a given number of ticks | | Negate | Negates the current TimeSpan value | | Parse | Converts a string representation of time span into a TimeSpan value | | Subtract | Subtracts a TimeSpan from the current TimeSpan | | ToString | Converts a TimeSpan value into a string |
|
|
| | Fields | | | | MinValue | | Int64 | | Minimum number of ticks : -9,223,372,036,854,775,808
| | MaxValue | | Int64 | | Maximum number of ticks : 9,223,372,036,854,775,807
| | TicksPerDay | | Int64 | | Constant number of ticks in a day : 864,000,000,000
| | TicksPerHour | | Int64 | | Constant number of ticks in an hour : 36,000,000,000
| | TicksPerMinute | | Int64 | | Constant number of ticks in a minute : 600,000,000
| | TicksPerSecond | | Int64 | | Constant number of ticks in a second : 10,000,000
| | TicksPerMillisecond | | Int64 | | Constant number of ticks in a millisecond : 10,000
| | Zero | | TimeSpan | | 0 value time span : 0 ticks
|
| | Properties | | | | Days | | Integer | | Days component
| | Hours | | Integer | | Hours component
| | Minutes | | Integer | | Minutes component
| | Seconds | | Integer | | Seconds component
| | Milliseconds | | Integer | | Milliseconds component
| | Ticks | | Int64 | | Ticks component
| | TotalDays | | Double | | Timespan expressed as days and part days
| | TotalHours | | Double | | Timespan expressed as hours and part hours
| | TotalMinutes | | Double | | Timespan expressed as minutes and part minutes
| | TotalSeconds | | Double | | Timespan expressed as seconds and part seconds
| | TotalMilliseconds | | Double | | Timespan expressed as milliseconds and part milliseconds |
| | Operators | | | | + | Adds a specified time interval to a specified date and time or time span.
| | = | Determines whether two specified instances of TimeSpan are equal.
| | > | Determines whether one specified TimeSpan is greater than another specified TimeSpan.
| | >= | Determines whether one specified TimeSpan is greater than or equal to another specified TimeSpan.
| | <> | Determines whether two specified instances of TimeSpan are not equal.
| | < | Determines whether one specified TimeSpan is less than another specified TimeSpan.
| | <= | Determines whether one specified TimeSpan is less than or equal to another specified TimeSpan.
| | - | Subtracts a specified TimeSpan from a specified TimeSpan or DateTime. Also negates a TimeSpan value (unary operator). |
|
Microsoft MSDN links
| |
|
|
|
|
|
| |
|
|
|