From: 011netservice@gmail.com Date: 2022-04-24 Subject: TimeSpan.txt ---------- 20200716 TimeSpan Constructors TimeSpan(Int64) Initializes a new instance of the TimeSpan structure to the specified number of ticks. TimeSpan(Int32, Int32, Int32) Initializes a new instance of the TimeSpan structure to a specified number of hours, minutes, and seconds. TimeSpan(Int32, Int32, Int32, Int32) Initializes a new instance of the TimeSpan structure to a specified number of days, hours, minutes, and seconds. TimeSpan(Int32, Int32, Int32, Int32, Int32) Initializes a new instance of the TimeSpan structure to a specified number of days, hours, minutes, seconds, and milliseconds. TimeSpan(Int64) Initializes a new instance of the TimeSpan structure to the specified number of ticks. public TimeSpan (long ticks); ticks, Int64, A time period expressed in 100-nanosecond units. Examples The following example creates several TimeSpan objects using the constructor overload that initializes a TimeSpan to a specified number of ticks. // Example of the TimeSpan( long ) constructor. using System; class TimeSpanCtorLDemo { // Create a TimeSpan object and display its value. static void CreateTimeSpan( long ticks ) { TimeSpan elapsedTime = new TimeSpan( ticks ); // Format the constructor for display. string ctor = String.Format( "TimeSpan( {0} )", ticks ); // Pad the end of a TimeSpan string with spaces if // it does not contain milliseconds. string elapsedStr = elapsedTime.ToString( ); int pointIndex = elapsedStr.IndexOf( ':' ); pointIndex = elapsedStr.IndexOf( '.', pointIndex ); if( pointIndex < 0 ) elapsedStr += " "; // Display the constructor and its value. Console.WriteLine( "{0,-33}{1,24}", ctor, elapsedStr ); } static void Main( ) { Console.WriteLine( "This example of the TimeSpan( long ) constructor " + "\ngenerates the following output.\n" ); Console.WriteLine( "{0,-33}{1,16}", "Constructor", "Value" ); Console.WriteLine( "{0,-33}{1,16}", "-----------", "-----" ); CreateTimeSpan( 1 ); CreateTimeSpan( 999999 ); CreateTimeSpan( -1000000000000 ); CreateTimeSpan( 18012202000000 ); CreateTimeSpan( 999999999999999999 ); CreateTimeSpan( 1000000000000000000 ); } } /* This example of the TimeSpan( long ) constructor generates the following output. Constructor Value ----------- ----- TimeSpan( 1 ) 00:00:00.0000001 TimeSpan( 999999 ) 00:00:00.0999999 TimeSpan( -1000000000000 ) -1.03:46:40 TimeSpan( 18012202000000 ) 20.20:20:20.2000000 TimeSpan( 999999999999999999 ) 1157407.09:46:39.9999999 TimeSpan( 1000000000000000000 ) 1157407.09:46:40 */ Remarks A single tick represents one hundred nanoseconds or one ten-millionth of a second. There are 10,000 ticks in a millisecond. TimeSpan(Int32, Int32, Int32) Initializes a new instance of the TimeSpan structure to a specified number of hours, minutes, and seconds. public TimeSpan (int hours, int minutes, int seconds); hours: Int32, Number of hours. minutes: Int32, Number of minutes. seconds: Int32, Number of seconds. Examples The following example creates several TimeSpan objects using the constructor overload that initializes a TimeSpan to a specified number of hours, minutes, and seconds. // Example of the TimeSpan( int, int, int ) constructor. using System; class TimeSpanCtorIIIDemo { // Create a TimeSpan object and display its value. static void CreateTimeSpan( int hours, int minutes, int seconds ) { TimeSpan elapsedTime = new TimeSpan( hours, minutes, seconds ); // Format the constructor for display. string ctor = String.Format( "TimeSpan( {0}, {1}, {2} )", hours, minutes, seconds); // Display the constructor and its value. Console.WriteLine( "{0,-37}{1,16}", ctor, elapsedTime.ToString( ) ); } static void Main( ) { Console.WriteLine( "This example of the TimeSpan( int, int, int ) " + "\nconstructor generates the following output.\n" ); Console.WriteLine( "{0,-37}{1,16}", "Constructor", "Value" ); Console.WriteLine( "{0,-37}{1,16}", "-----------", "-----" ); CreateTimeSpan( 10, 20, 30 ); CreateTimeSpan( -10, 20, 30 ); CreateTimeSpan( 0, 0, 37230 ); CreateTimeSpan( 1000, 2000, 3000 ); CreateTimeSpan( 1000, -2000, -3000 ); CreateTimeSpan( 999999, 999999, 999999 ); } } /* This example of the TimeSpan( int, int, int ) constructor generates the following output. Constructor Value ----------- ----- TimeSpan( 10, 20, 30 ) 10:20:30 TimeSpan( -10, 20, 30 ) -09:39:30 TimeSpan( 0, 0, 37230 ) 10:20:30 TimeSpan( 1000, 2000, 3000 ) 43.02:10:00 TimeSpan( 1000, -2000, -3000 ) 40.05:50:00 TimeSpan( 999999, 999999, 999999 ) 42372.15:25:39 */ Remarks The specified hours, minutes, and seconds are converted to ticks, and that value initializes this instance. TimeSpan(Int32, Int32, Int32, Int32) Initializes a new instance of the TimeSpan structure to a specified number of days, hours, minutes, and seconds. public TimeSpan (int days, int hours, int minutes, int seconds); Examples The following example creates several TimeSpan objects using the constructor overload that initializes a TimeSpan to a specified number of days, hours, minutes, and seconds. using System; class Example { // Create a TimeSpan object and display its value. static void CreateTimeSpan( int days, int hours, int minutes, int seconds ) { TimeSpan elapsedTime = new TimeSpan( days, hours, minutes, seconds ); // Format the constructor for display. string ctor = String.Format( "TimeSpan( {0}, {1}, {2}, {3} )", days, hours, minutes, seconds); // Display the constructor and its value. Console.WriteLine( "{0,-44}{1,16}", ctor, elapsedTime.ToString( ) ); } static void Main( ) { Console.WriteLine( "{0,-44}{1,16}", "Constructor", "Value" ); Console.WriteLine( "{0,-44}{1,16}", "-----------", "-----" ); CreateTimeSpan( 10, 20, 30, 40 ); CreateTimeSpan( -10, 20, 30, 40 ); CreateTimeSpan( 0, 0, 0, 937840 ); CreateTimeSpan( 1000, 2000, 3000, 4000 ); CreateTimeSpan( 1000, -2000, -3000, -4000 ); CreateTimeSpan( 999999, 999999, 999999, 999999 ); } } // The example displays the following output: // Constructor Value // ----------- ----- // TimeSpan( 10, 20, 30, 40 ) 10.20:30:40 // TimeSpan( -10, 20, 30, 40 ) -9.03:29:20 // TimeSpan( 0, 0, 0, 937840 ) 10.20:30:40 // TimeSpan( 1000, 2000, 3000, 4000 ) 1085.11:06:40 // TimeSpan( 1000, -2000, -3000, -4000 ) 914.12:53:20 // TimeSpan( 999999, 999999, 999999, 999999 ) 1042371.15:25:39 Remarks The specified days, hours, minutes, and seconds are converted to ticks, and that value initializes this instance. TimeSpan(Int32, Int32, Int32, Int32, Int32) Initializes a new instance of the TimeSpan structure to a specified number of days, hours, minutes, seconds, and milliseconds. public TimeSpan (int days, int hours, int minutes, int seconds, int milliseconds); Examples The following example creates several TimeSpan objects using the constructor overload that initializes a TimeSpan to a specified number of days, hours, minutes, seconds, and milliseconds. // Example of the TimeSpan( int, int, int, int, int ) constructor. using System; class TimeSpanCtorIIIIIDemo { // Create a TimeSpan object and display its value. static void CreateTimeSpan( int days, int hours, int minutes, int seconds, int millisec ) { TimeSpan elapsedTime = new TimeSpan( days, hours, minutes, seconds, millisec ); // Format the constructor for display. string ctor = String.Format( "TimeSpan( {0}, {1}, {2}, {3}, {4} )", days, hours, minutes, seconds, millisec); // Display the constructor and its value. Console.WriteLine( "{0,-48}{1,24}", ctor, elapsedTime.ToString( ) ); } static void Main( ) { Console.WriteLine( "This example of the " + "TimeSpan( int, int, int, int, int ) " + "\nconstructor generates the following output.\n" ); Console.WriteLine( "{0,-48}{1,16}", "Constructor", "Value" ); Console.WriteLine( "{0,-48}{1,16}", "-----------", "-----" ); CreateTimeSpan( 10, 20, 30, 40, 50 ); CreateTimeSpan( -10, 20, 30, 40, 50 ); CreateTimeSpan( 0, 0, 0, 0, 937840050 ); CreateTimeSpan( 1111, 2222, 3333, 4444, 5555 ); CreateTimeSpan( 1111, -2222, -3333, -4444, -5555 ); CreateTimeSpan( 99999, 99999, 99999, 99999, 99999 ); } } /* This example of the TimeSpan( int, int, int, int, int ) constructor generates the following output. Constructor Value ----------- ----- TimeSpan( 10, 20, 30, 40, 50 ) 10.20:30:40.0500000 TimeSpan( -10, 20, 30, 40, 50 ) -9.03:29:19.9500000 TimeSpan( 0, 0, 0, 0, 937840050 ) 10.20:30:40.0500000 TimeSpan( 1111, 2222, 3333, 4444, 5555 ) 1205.22:47:09.5550000 TimeSpan( 1111, -2222, -3333, -4444, -5555 ) 1016.01:12:50.4450000 TimeSpan( 99999, 99999, 99999, 99999, 99999 ) 104236.05:27:18.9990000 */ Remarks The specified days, hours, minutes, seconds, and milliseconds are converted to ticks, and that value initializes this instance. ---------- 20200716 TimeSpan.Ticks TimeSpan.ticks: The smallest unit of time is the tick, which is equal to 100 nanoseconds or one ten-millionth of a second. There are 10,000 ticks in a millisecond. The value of the Ticks property can be negative or positive to represent a negative or positive time interval. 1. 時間最小單位為 tick. 2. 1 tick = 1 nanoseconds = 0.0000001s = 0.0001ms = one billionth of a second = 10億分之1秒 1 s = 10,000,000 ticks = 1 second. 1 ms = 10,000 ticks = 1 millisecond. Constructor Value ----------- ----- TimeSpan( 1 ) 00:00:00.0000001 TimeSpan( 999999 ) 00:00:00.0999999 TimeSpan( -1000000000000 ) -1.03:46:40 TimeSpan( 18012202000000 ) 20.20:20:20.2000000 TimeSpan( 999999999999999999 ) 1157407.09:46:39.9999999 (約 3,171 年) TimeSpan( 1000000000000000000 ) 1157407.09:46:40 // The example displays the following output if the current culture is en-US: // TimeSpan( 1 ) 00:00:00.0000001 // Days 0 TotalDays 0.000 // Hours 0 TotalHours 0.000 // Minutes 0 TotalMinutes 0.000 // Seconds 0 TotalSeconds 0.000 // Milliseconds 0 TotalMilliseconds 0.000 // Ticks 1 // // TimeSpan( 111222333444555 ) 128.17:30:33.3444555 // Days 128 TotalDays 128.730 // Hours 17 TotalHours 3,089.509 // Minutes 30 TotalMinutes 185,370.556 // Seconds 33 TotalSeconds 11,122,233.344 // Milliseconds 344 TotalMilliseconds 11,122,233,344.456 // Ticks 111,222,333,444,555 // // TimeSpan( 10, 20, 30, 40, 50 ) 10.20:30:40.0500000 // Days 10 TotalDays 10.855 // Hours 20 TotalHours 260.511 // Minutes 30 TotalMinutes 15,630.668 // Seconds 40 TotalSeconds 937,840.050 // Milliseconds 50 TotalMilliseconds 937,840,050.000 // Ticks 9,378,400,500,000 // // TimeSpan( 1111, 2222, 3333, 4444, 5555 ) 1205.22:47:09.5550000 // Days 1205 TotalDays 1,205.949 // Hours 22 TotalHours 28,942.786 // Minutes 47 TotalMinutes 1,736,567.159 // Seconds 9 TotalSeconds 104,194,029.555 // Milliseconds 555 TotalMilliseconds 104,194,029,555.000 // Ticks 1,041,940,295,550,000 // // FromDays( 20.84745602 ) 20.20:20:20.2000000 // Days 20 TotalDays 20.847 // Hours 20 TotalHours 500.339 // Minutes 20 TotalMinutes 30,020.337 // Seconds 20 TotalSeconds 1,801,220.200 // Milliseconds 200 TotalMilliseconds 1,801,220,200.000 // Ticks 18,012,202,000,000 using System; class Example { static void Main() { // Create and display a TimeSpan value of 1 tick. Console.Write("\n{0,-45}", "TimeSpan( 1 )"); ShowTimeSpanProperties(new TimeSpan(1)); // Create a TimeSpan value with a large number of ticks. Console.Write("\n{0,-45}", "TimeSpan( 111222333444555 )"); ShowTimeSpanProperties(new TimeSpan(111222333444555)); // This TimeSpan has all fields specified. Console.Write("\n{0,-45}", "TimeSpan( 10, 20, 30, 40, 50 )"); ShowTimeSpanProperties(new TimeSpan(10, 20, 30, 40, 50)); // This TimeSpan has all fields overflowing. Console.Write("\n{0,-45}", "TimeSpan( 1111, 2222, 3333, 4444, 5555 )"); ShowTimeSpanProperties( new TimeSpan(1111, 2222, 3333, 4444, 5555)); // This TimeSpan is based on a number of days. Console.Write("\n{0,-45}", "FromDays( 20.84745602 )"); ShowTimeSpanProperties(TimeSpan.FromDays( 20.84745602)); } static void ShowTimeSpanProperties( TimeSpan interval ) { Console.WriteLine("{0,21}", interval); Console.WriteLine("{0,-12}{1,8} {2,-18}{3,21:N3}", "Days", interval.Days, "TotalDays", interval.TotalDays); Console.WriteLine("{0,-12}{1,8} {2,-18}{3,21:N3}", "Hours", interval.Hours, "TotalHours", interval.TotalHours); Console.WriteLine("{0,-12}{1,8} {2,-18}{3,21:N3}", "Minutes", interval.Minutes, "TotalMinutes", interval.TotalMinutes); Console.WriteLine("{0,-12}{1,8} {2,-18}{3,21:N3}", "Seconds", interval.Seconds, "TotalSeconds", interval.TotalSeconds); Console.WriteLine("{0,-12}{1,8} {2,-18}{3,21:N3}", "Milliseconds", interval.Milliseconds, "TotalMilliseconds", interval.TotalMilliseconds); Console.WriteLine("{0,-12}{1,8} {2,-18}{3,21:N0}", null, null, "Ticks", interval.Ticks); } } // The example displays the following output if the current culture is en-US: // TimeSpan( 1 ) 00:00:00.0000001 // Days 0 TotalDays 0.000 // Hours 0 TotalHours 0.000 // Minutes 0 TotalMinutes 0.000 // Seconds 0 TotalSeconds 0.000 // Milliseconds 0 TotalMilliseconds 0.000 // Ticks 1 // // TimeSpan( 111222333444555 ) 128.17:30:33.3444555 // Days 128 TotalDays 128.730 // Hours 17 TotalHours 3,089.509 // Minutes 30 TotalMinutes 185,370.556 // Seconds 33 TotalSeconds 11,122,233.344 // Milliseconds 344 TotalMilliseconds 11,122,233,344.456 // Ticks 111,222,333,444,555 // // TimeSpan( 10, 20, 30, 40, 50 ) 10.20:30:40.0500000 // Days 10 TotalDays 10.855 // Hours 20 TotalHours 260.511 // Minutes 30 TotalMinutes 15,630.668 // Seconds 40 TotalSeconds 937,840.050 // Milliseconds 50 TotalMilliseconds 937,840,050.000 // Ticks 9,378,400,500,000 // // TimeSpan( 1111, 2222, 3333, 4444, 5555 ) 1205.22:47:09.5550000 // Days 1205 TotalDays 1,205.949 // Hours 22 TotalHours 28,942.786 // Minutes 47 TotalMinutes 1,736,567.159 // Seconds 9 TotalSeconds 104,194,029.555 // Milliseconds 555 TotalMilliseconds 104,194,029,555.000 // Ticks 1,041,940,295,550,000 // // FromDays( 20.84745602 ) 20.20:20:20.2000000 // Days 20 TotalDays 20.847 // Hours 20 TotalHours 500.339 // Minutes 20 TotalMinutes 30,020.337 // Seconds 20 TotalSeconds 1,801,220.200 // Milliseconds 200 TotalMilliseconds 1,801,220,200.000 // Ticks 18,012,202,000,000 ---------- 20191231 // Example of the TimeSpan class properties. using System; class TimeSpanPropertiesDemo { const string headerFmt = "\n{0,-45}"; const string dataFmt = "{0,-12}{1,8} {2,-18}{3,21}" ; // Display the properties of the TimeSpan parameter. static void ShowTimeSpanProperties( TimeSpan interval ) { Console.WriteLine( "{0,21}", interval ); Console.WriteLine( dataFmt, "Days", interval.Days, "TotalDays", interval.TotalDays ); Console.WriteLine( dataFmt, "Hours", interval.Hours, "TotalHours", interval.TotalHours ); Console.WriteLine( dataFmt, "Minutes", interval.Minutes, "TotalMinutes", interval.TotalMinutes ); Console.WriteLine( dataFmt, "Seconds", interval.Seconds, "TotalSeconds", interval.TotalSeconds ); Console.WriteLine( dataFmt, "Milliseconds", interval.Milliseconds, "TotalMilliseconds", interval.TotalMilliseconds ); Console.WriteLine( dataFmt, null, null, "Ticks", interval.Ticks ); } static void Main( ) { Console.WriteLine( "This example of the TimeSpan class properties " + "generates the \nfollowing output. It " + "creates several TimeSpan objects and \ndisplays " + "the values of the TimeSpan properties for each." ); // Create and display a TimeSpan value of 1 tick. Console.Write( headerFmt, "TimeSpan( 1 )" ); ShowTimeSpanProperties( new TimeSpan( 1 ) ); // Create a TimeSpan value with a large number of ticks. Console.Write( headerFmt, "TimeSpan( 111222333444555 )" ); ShowTimeSpanProperties( new TimeSpan( 111222333444555 ) ); // This TimeSpan has all fields specified. Console.Write( headerFmt, "TimeSpan( 10, 20, 30, 40, 50 )" ); ShowTimeSpanProperties( new TimeSpan( 10, 20, 30, 40, 50 ) ); // This TimeSpan has all fields overflowing. Console.Write( headerFmt, "TimeSpan( 1111, 2222, 3333, 4444, 5555 )" ); ShowTimeSpanProperties( new TimeSpan( 1111, 2222, 3333, 4444, 5555 ) ); // This TimeSpan is based on a number of days. Console.Write( headerFmt, "FromDays( 20.84745602 )" ); ShowTimeSpanProperties( TimeSpan.FromDays( 20.84745602 ) ); } } /* This example of the TimeSpan class properties generates the following output. It creates several TimeSpan objects and displays the values of the TimeSpan properties for each. TimeSpan( 1 ) 00:00:00.0000001 Days 0 TotalDays 1.15740740740741E-12 Hours 0 TotalHours 2.77777777777778E-11 Minutes 0 TotalMinutes 1.66666666666667E-09 Seconds 0 TotalSeconds 1E-07 Milliseconds 0 TotalMilliseconds 0.0001 Ticks 1 TimeSpan( 111222333444555 ) 128.17:30:33.3444555 Days 128 TotalDays 128.729552597865 Hours 17 TotalHours 3089.50926234875 Minutes 30 TotalMinutes 185370.555740925 Seconds 33 TotalSeconds 11122233.3444555 Milliseconds 344 TotalMilliseconds 11122233344.4555 Ticks 111222333444555 TimeSpan( 10, 20, 30, 40, 50 ) 10.20:30:40.0500000 Days 10 TotalDays 10.8546302083333 Hours 20 TotalHours 260.511125 Minutes 30 TotalMinutes 15630.6675 Seconds 40 TotalSeconds 937840.05 Milliseconds 50 TotalMilliseconds 937840050 Ticks 9378400500000 TimeSpan( 1111, 2222, 3333, 4444, 5555 ) 1205.22:47:09.5550000 Days 1205 TotalDays 1205.94941614583 Hours 22 TotalHours 28942.7859875 Minutes 47 TotalMinutes 1736567.15925 Seconds 9 TotalSeconds 104194029.555 Milliseconds 555 TotalMilliseconds 104194029555 Ticks 1041940295550000 FromDays( 20.84745602 ) 20.20:20:20.2000000 Days 20 TotalDays 20.8474560185185 Hours 20 TotalHours 500.338944444444 Minutes 20 TotalMinutes 30020.3366666667 Seconds 20 TotalSeconds 1801220.2 Milliseconds 200 TotalMilliseconds 1801220200 Ticks 18012202000000 */ ---------------------------------------------------------------------- // Example of the TimeSpan.Parse( string ) and TimeSpan.ToString( ) // methods. using System; class TSParseToStringDemo { static void ParseNDisplayTimeSpan( string intervalStr ) { // Write the first part of the output line. Console.Write( "{0,20} ", intervalStr ); // Parse the parameter, and then convert it back to a string. try { TimeSpan intervalVal = TimeSpan.Parse( intervalStr ); string intervalToStr = intervalVal.ToString( ); // Pad the end of the TimeSpan string with spaces if it // does not contain milliseconds. int pIndex = intervalToStr.IndexOf( ':' ); pIndex = intervalToStr.IndexOf( '.', pIndex ); if( pIndex < 0 ) intervalToStr += " "; Console.WriteLine( "{0,21}", intervalToStr ); } catch( Exception ex ) { // If Parse throws an exception, write the message. Console.WriteLine( ex.Message ); } } static void Main( ) { Console.WriteLine( "This example of TimeSpan.Parse( string ) and \n" + "TimeSpan.ToString( ) " + "generates the following output.\n" ); Console.WriteLine( "{0,20} {1,21}", "String to Parse", "TimeSpan or Exception" ); Console.WriteLine( "{0,20} {1,21}", "---------------", "---------------------" ); ParseNDisplayTimeSpan( "0" ); ParseNDisplayTimeSpan( "14" ); ParseNDisplayTimeSpan( "1:2:3" ); ParseNDisplayTimeSpan( "0:0:0.250" ); ParseNDisplayTimeSpan( "10.20:30:40.50" ); ParseNDisplayTimeSpan( "99.23:59:59.9999999" ); ParseNDisplayTimeSpan( "0023:0059:0059.0099" ); ParseNDisplayTimeSpan( "24:0:0" ); ParseNDisplayTimeSpan( "0:60:0" ); ParseNDisplayTimeSpan( "0:0:60" ); ParseNDisplayTimeSpan( "10:" ); ParseNDisplayTimeSpan( ":10" ); ParseNDisplayTimeSpan( "10:20:" ); ParseNDisplayTimeSpan( ".123" ); ParseNDisplayTimeSpan( "10." ); ParseNDisplayTimeSpan( "10.12" ); } } /* This example of TimeSpan.Parse( string ) and TimeSpan.ToString( ) generates the following output. String to Parse TimeSpan or Exception --------------- --------------------- 0 00:00:00 14 14.00:00:00 1:2:3 01:02:03 0:0:0.250 00:00:00.2500000 10.20:30:40.50 10.20:30:40.5000000 99.23:59:59.9999999 99.23:59:59.9999999 0023:0059:0059.0099 23:59:59.0099000 24:0:0 TimeSpan overflowed because the duration is too long. 0:60:0 TimeSpan overflowed because the duration is too long. 0:0:60 TimeSpan overflowed because the duration is too long. 10: Input string was not in a correct format. :10 Input string was not in a correct format. 10:20: Input string was not in a correct format. .123 Input string was not in a correct format. 10. Input string was not in a correct format. 10.12 Input string was not in a correct format. */