C# Timespan Milliseconds vs TotalMilliseconds

Question

In the example below, why does the Milliseconds property return 0 but the TotalMilliseconds property return 5000?

// 5 seconds
TimeSpan intervalTimespan = new TimeSpan(0, 0, 5);

// returns 0
intervalTimespan.Milliseconds;

// returns 5000.0
intervalTimespan.TotalMilliseconds

@AJM the docs for [Timespan](http://msdn.microsoft.com/en-us/library/system.timespan.aspx) make it pretty explicit what is what with the examples. — kͩeͣmͮpͥ ͩ, Mar 31 '11 at 10:10
Just a note that all the components of `TimeSpan` come in property pairs like this, not just milliseconds. `Mintes` / `TotalMinutes`, `Hours` / `TotalHours`, etc... — Bradley Uffner, Jun 29 '18 at 13:46

score 92 · Accepted Answer · edited Sep 02 '20 at 15:59

92

Simple:

Milliseconds are the remaining milliseconds, that don't form a whole second.
TotalMilliseconds is the complete duration of the timespan expressed as milliseconds.

edited Sep 02 '20 at 15:59

Neuron

5,141
5
38
59

answered Mar 30 '11 at 09:20

Daniel Hilgarth

171,043
40
335
443

score 84 · Answer 2 · answered Mar 30 '11 at 09:20

84

Because Milliseconds returns the Milliseconds portion, and TotalMilliseconds returns the total milliseconds represented by the Timespan

Example: 0:00:05.047

Milliseconds: 47

Total Milliseconds: 5047

answered Mar 30 '11 at 09:20

kͩeͣmͮpͥ ͩ

7,783
26
40

score 4 · Answer 3 · edited Oct 08 '20 at 00:46

This hapens because intervalTimespan.Milliseconds returns the millisecond component of the timespan. In your timespan constructor, you only have hour, minute, and second components, which is why the result is 0.

intervalTimespan.TotalMilliseconds gets you the total milliseconds of the timespan.

Example:

// 5 milliseconds
TimeSpan intervalTimespan = new TimeSpan(0, 0,0,0,5);

// returns 5
intervalTimespan.Milliseconds;

// returns 5
intervalTimespan.TotalMilliseconds

score 2 · Answer 4 · edited Oct 08 '20 at 00:44

2

TimeSpan has other overloads:

TimeSpan(hour, minute, seconds)
TimeSpan(days, hour, minute, seconds)
TimeSpan(days, hour, minute, seconds, milliseconds)

The Milliseconds property returns the actual milliseconds value.

The TotalMilliseconds property returns the overall milliseconds including days, hours, minutes, and seconds.

edited Oct 08 '20 at 00:44

Pang

9,564
146
81
122

answered Mar 30 '11 at 09:38

hallie

2,760
19
27

score 1 · Answer 5 · edited Oct 08 '20 at 00:44

1

Miliseconds returns just the milliseconds part of your TimeSpan, while TotalMilliseconds calculates how many milliseconds are in time represented by TimeSpan.

In your case, first returns 0 because you have exactly 5 seconds, second returns 5000 because 5s == 5000ms

edited Oct 08 '20 at 00:44

Pang

9,564
146
81
122

answered Mar 30 '11 at 09:22

Jarek

3,359
1
27
33

score 0 · Answer 6 · answered Jun 29 '18 at 13:41

One important thing other things don't mention, is that (according to the docs):

The Milliseconds property represents whole milliseconds, whereas the TotalMilliseconds property represents whole and fractional milliseconds.

That is also deductible from the remarks of TotalMilliseconds:

This property converts the value of this instance from ticks to milliseconds.

This has a huge implication, IMO, because if you want the most precise representation in seconds or milliseconds, you must use TotalSeconds or TotalMilliseconds properties, both of them are of type double.

C# Timespan Milliseconds vs TotalMilliseconds

6 Answers6

Linked