DateTime.cs source code in C# .NET

Source code for the .NET framework in C#

                        

Code:

/ 4.0 / 4.0 / DEVDIV_TFS / Dev10 / Releases / RTMRel / ndp / clr / src / BCL / System / DateTime.cs / 1305376 / DateTime.cs

                            // ==++== 
//
//   Copyright (c) Microsoft Corporation.  All rights reserved.
//
// ==--== 
namespace System {
 
    using System; 
    using System.Threading;
    using System.Globalization; 
    using System.Runtime;
    using System.Runtime.InteropServices;
    using System.Runtime.CompilerServices;
    using System.Runtime.Serialization; 
    using System.Security.Permissions;
    using System.Diagnostics.Contracts; 
    using CultureInfo = System.Globalization.CultureInfo; 
    using Calendar = System.Globalization.Calendar;
 
    // This value type represents a date and time.  Every DateTime
    // object has a private field (Ticks) of type Int64 that stores the
    // date and time as the number of 100 nanosecond intervals since
    // 12:00 AM January 1, year 1 A.D. in the proleptic Gregorian Calendar. 
    //
    // Starting from V2.0, DateTime also stored some context about its time 
    // zone in the form of a 3-state value representing Unspecified, Utc or 
    // Local. This is stored in the two top bits of the 64-bit numeric value
    // with the remainder of the bits storing the tick count. This information 
    // is only used during time zone conversions and is not part of the
    // identity of the DateTime. Thus, operations like Compare and Equals
    // ignore this state. This is to stay compatible with earlier behavior
    // and performance characteristics and to avoid forcing  people into dealing 
    // with the effects of daylight savings. Note, that this has little effect
    // on how the DateTime works except in a context where its specific time 
    // zone is needed, such as during conversions and some parsing and formatting 
    // cases.
    // 
    // There is also 4th state stored that is a special type of Local value that
    // is used to avoid data loss when round-tripping between local and UTC time.
    // See below for more information on this 4th state, although it is
    // effectively hidden from most users, who just see the 3-state DateTimeKind 
    // enumeration.
    // 
    // For compatability, DateTime does not serialize the Kind data when used in 
    // binary serialization.
    // 
    // For a description of various calendar issues, look at
    //
    // Calendar Studies web site, at
    // http://serendipity.nofadz.com/hermetic/cal_stud.htm. 
    //
    // 
    [StructLayout(LayoutKind.Auto)] 
    [Serializable]
    public struct DateTime : IComparable, IFormattable, IConvertible, ISerializable, IComparable,IEquatable { 

        // Number of 100ns ticks per time unit
        private const long TicksPerMillisecond = 10000;
        private const long TicksPerSecond = TicksPerMillisecond * 1000; 
        private const long TicksPerMinute = TicksPerSecond * 60;
        private const long TicksPerHour = TicksPerMinute * 60; 
        private const long TicksPerDay = TicksPerHour * 24; 

        // Number of milliseconds per time unit 
        private const int MillisPerSecond = 1000;
        private const int MillisPerMinute = MillisPerSecond * 60;
        private const int MillisPerHour = MillisPerMinute * 60;
        private const int MillisPerDay = MillisPerHour * 24; 

        // Number of days in a non-leap year 
        private const int DaysPerYear = 365; 
        // Number of days in 4 years
        private const int DaysPer4Years = DaysPerYear * 4 + 1; 
        // Number of days in 100 years
        private const int DaysPer100Years = DaysPer4Years * 25 - 1;
        // Number of days in 400 years
        private const int DaysPer400Years = DaysPer100Years * 4 + 1; 

        // Number of days from 1/1/0001 to 12/31/1600 
        private const int DaysTo1601 = DaysPer400Years * 4; 
        // Number of days from 1/1/0001 to 12/30/1899
        private const int DaysTo1899 = DaysPer400Years * 4 + DaysPer100Years * 3 - 367; 
        // Number of days from 1/1/0001 to 12/31/9999
        private const int DaysTo10000 = DaysPer400Years * 25 - 366;

        internal const long MinTicks = 0; 
        internal const long MaxTicks = DaysTo10000 * TicksPerDay - 1;
        private const long MaxMillis = (long)DaysTo10000 * MillisPerDay; 
 
        private const long FileTimeOffset = DaysTo1601 * TicksPerDay;
        private const long DoubleDateOffset = DaysTo1899 * TicksPerDay; 
        // The minimum OA date is 0100/01/01 (Note it's year 100).
        // The maximum OA date is 9999/12/31
        private const long OADateMinAsTicks = (DaysPer100Years - DaysPerYear) * TicksPerDay;
        // All OA dates must be greater than (not >=) OADateMinAsDouble 
        private const double OADateMinAsDouble = -657435.0;
        // All OA dates must be less than (not <=) OADateMaxAsDouble 
        private const double OADateMaxAsDouble = 2958466.0; 

        private const int DatePartYear = 0; 
        private const int DatePartDayOfYear = 1;
        private const int DatePartMonth = 2;
        private const int DatePartDay = 3;
 
        private static readonly int[] DaysToMonth365 = {
            0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334, 365}; 
        private static readonly int[] DaysToMonth366 = { 
            0, 31, 60, 91, 121, 152, 182, 213, 244, 274, 305, 335, 366};
 
        public static readonly DateTime MinValue = new DateTime(MinTicks, DateTimeKind.Unspecified);
        public static readonly DateTime MaxValue = new DateTime(MaxTicks, DateTimeKind.Unspecified);

        private const UInt64 TicksMask             = 0x3FFFFFFFFFFFFFFF; 
        private const UInt64 FlagsMask             = 0xC000000000000000;
        private const UInt64 LocalMask             = 0x8000000000000000; 
        private const Int64 TicksCeiling           = 0x4000000000000000; 
        private const UInt64 KindUnspecified       = 0x0000000000000000;
        private const UInt64 KindUtc               = 0x4000000000000000; 
        private const UInt64 KindLocal             = 0x8000000000000000;
        private const UInt64 KindLocalAmbiguousDst = 0xC000000000000000;
        private const Int32 KindShift = 62;
 
        private const String TicksField            = "ticks";
        private const String DateDataField         = "dateData"; 
 
        // The data is stored as an unsigned 64-bit integeter
        //   Bits 01-62: The value of 100-nanosecond ticks where 0 represents 1/1/0001 12:00am, up until the value 
        //               12/31/9999 23:59:59.9999999
        //   Bits 63-64: A four-state value that describes the DateTimeKind value of the date time, with a 2nd
        //               value for the rare case where the date time is local, but is in an overlapped daylight
        //               savings time hour and it is in daylight savings time. This allows distinction of these 
        //               otherwise ambiguous local times and prevents data loss when round tripping from Local to
        //               UTC time. 
        private UInt64 dateData; 

        // Constructs a DateTime from a tick count. The ticks 
        // argument specifies the date as the number of 100-nanosecond intervals
        // that have elapsed since 1/1/0001 12:00am.
        //
        public DateTime(long ticks) { 
            if (ticks < MinTicks || ticks > MaxTicks)
                throw new ArgumentOutOfRangeException("ticks", Environment.GetResourceString("ArgumentOutOfRange_DateTimeBadTicks")); 
            Contract.EndContractBlock(); 
            dateData = (UInt64)ticks;
        } 

        private DateTime(UInt64 dateData) {
            this.dateData = dateData;
        } 

        public DateTime(long ticks, DateTimeKind kind) { 
            if (ticks < MinTicks || ticks > MaxTicks) { 
                throw new ArgumentOutOfRangeException("ticks", Environment.GetResourceString("ArgumentOutOfRange_DateTimeBadTicks"));
            } 
            if (kind < DateTimeKind.Unspecified || kind > DateTimeKind.Local) {
                throw new ArgumentException(Environment.GetResourceString("Argument_InvalidDateTimeKind"), "kind");
            }
            Contract.EndContractBlock(); 
            this.dateData = ((UInt64)ticks | ((UInt64)kind << KindShift));
        } 
 
        internal DateTime(long ticks, DateTimeKind kind, Boolean isAmbiguousDst) {
            if (ticks < MinTicks || ticks > MaxTicks) { 
                throw new ArgumentOutOfRangeException("ticks", Environment.GetResourceString("ArgumentOutOfRange_DateTimeBadTicks"));
            }
            Contract.Requires(kind == DateTimeKind.Local, "Internal Constructor is for local times only");
            Contract.EndContractBlock(); 
            dateData = ((UInt64)ticks | (isAmbiguousDst ? KindLocalAmbiguousDst : KindLocal));
        } 
 
        // Constructs a DateTime from a given year, month, and day. The
        // time-of-day of the resulting DateTime is always midnight. 
        //
        public DateTime(int year, int month, int day) {
            this.dateData = (UInt64) DateToTicks(year, month, day);
        } 

        // Constructs a DateTime from a given year, month, and day for 
        // the specified calendar. The 
        // time-of-day of the resulting DateTime is always midnight.
        // 
        public DateTime(int year, int month, int day, Calendar calendar)
            : this(year, month, day, 0, 0, 0, calendar) {
        }
 
        // Constructs a DateTime from a given year, month, day, hour,
        // minute, and second. 
        // 
        public DateTime(int year, int month, int day, int hour, int minute, int second) {
            this.dateData = (UInt64)(DateToTicks(year, month, day) + TimeToTicks(hour, minute, second)); 
        }

        public DateTime(int year, int month, int day, int hour, int minute, int second, DateTimeKind kind) {
            if (kind < DateTimeKind.Unspecified || kind > DateTimeKind.Local) { 
                throw new ArgumentException(Environment.GetResourceString("Argument_InvalidDateTimeKind"), "kind");
            } 
            Contract.EndContractBlock(); 
            Int64 ticks = DateToTicks(year, month, day) + TimeToTicks(hour, minute, second);
            this.dateData = ((UInt64)ticks | ((UInt64)kind << KindShift)); 
        }

        // Constructs a DateTime from a given year, month, day, hour,
        // minute, and second for the specified calendar. 
        //
        public DateTime(int year, int month, int day, int hour, int minute, int second, Calendar calendar) { 
            if (calendar == null) 
                throw new ArgumentNullException("calendar");
            Contract.EndContractBlock(); 
            this.dateData = (UInt64)calendar.ToDateTime(year, month, day, hour, minute, second, 0).Ticks;
        }

        // Constructs a DateTime from a given year, month, day, hour, 
        // minute, and second.
        // 
        public DateTime(int year, int month, int day, int hour, int minute, int second, int millisecond) { 
            if (millisecond < 0 || millisecond >= MillisPerSecond) {
                throw new ArgumentOutOfRangeException("millisecond", Environment.GetResourceString("ArgumentOutOfRange_Range", 0, MillisPerSecond - 1)); 
            }
            Contract.EndContractBlock();
            Int64 ticks = DateToTicks(year, month, day) + TimeToTicks(hour, minute, second);
            ticks += millisecond * TicksPerMillisecond; 
            if (ticks < MinTicks || ticks > MaxTicks)
                throw new ArgumentException(Environment.GetResourceString("Arg_DateTimeRange")); 
            this.dateData = (UInt64)ticks; 
        }
 
        public DateTime(int year, int month, int day, int hour, int minute, int second, int millisecond, DateTimeKind kind) {
            if (millisecond < 0 || millisecond >= MillisPerSecond) {
                throw new ArgumentOutOfRangeException("millisecond", Environment.GetResourceString("ArgumentOutOfRange_Range", 0, MillisPerSecond - 1));
            } 
            if (kind < DateTimeKind.Unspecified || kind > DateTimeKind.Local) {
                throw new ArgumentException(Environment.GetResourceString("Argument_InvalidDateTimeKind"), "kind"); 
            } 
            Contract.EndContractBlock();
            Int64 ticks = DateToTicks(year, month, day) + TimeToTicks(hour, minute, second); 
            ticks += millisecond * TicksPerMillisecond;
            if (ticks < MinTicks || ticks > MaxTicks)
                throw new ArgumentException(Environment.GetResourceString("Arg_DateTimeRange"));
            this.dateData = ((UInt64)ticks | ((UInt64)kind << KindShift)); 
        }
 
        // Constructs a DateTime from a given year, month, day, hour, 
        // minute, and second for the specified calendar.
        // 
        public DateTime(int year, int month, int day, int hour, int minute, int second, int millisecond, Calendar calendar) {
            if (calendar == null)
                throw new ArgumentNullException("calendar");
            if (millisecond < 0 || millisecond >= MillisPerSecond) { 
                throw new ArgumentOutOfRangeException("millisecond", Environment.GetResourceString("ArgumentOutOfRange_Range", 0, MillisPerSecond - 1));
            } 
            Contract.EndContractBlock(); 
            Int64 ticks = calendar.ToDateTime(year, month, day, hour, minute, second, 0).Ticks;
            ticks += millisecond * TicksPerMillisecond; 
            if (ticks < MinTicks || ticks > MaxTicks)
                throw new ArgumentException(Environment.GetResourceString("Arg_DateTimeRange"));
            this.dateData = (UInt64)ticks;
        } 

        public DateTime(int year, int month, int day, int hour, int minute, int second, int millisecond, Calendar calendar, DateTimeKind kind) { 
            if (calendar == null) 
                throw new ArgumentNullException("calendar");
            if (millisecond < 0 || millisecond >= MillisPerSecond) { 
                throw new ArgumentOutOfRangeException("millisecond", Environment.GetResourceString("ArgumentOutOfRange_Range", 0, MillisPerSecond - 1));
            }
            if (kind < DateTimeKind.Unspecified || kind > DateTimeKind.Local) {
                throw new ArgumentException(Environment.GetResourceString("Argument_InvalidDateTimeKind"), "kind"); 
            }
            Contract.EndContractBlock(); 
            Int64 ticks = calendar.ToDateTime(year, month, day, hour, minute, second, 0).Ticks; 
            ticks += millisecond * TicksPerMillisecond;
            if (ticks < MinTicks || ticks > MaxTicks) 
                throw new ArgumentException(Environment.GetResourceString("Arg_DateTimeRange"));
            this.dateData = ((UInt64)ticks | ((UInt64)kind << KindShift));
        }
 
        private DateTime(SerializationInfo info, StreamingContext context) {
            if (info==null) 
                throw new ArgumentNullException("info"); 
            Contract.EndContractBlock();
 
            Boolean foundTicks = false;
            Boolean foundDateData = false;
            Int64 serializedTicks = 0;
            UInt64 serializedDateData = 0; 

 
            // Get the data 
            SerializationInfoEnumerator enumerator = info.GetEnumerator();
            while( enumerator.MoveNext()) { 
                switch( enumerator.Name) {
                    case TicksField:
                        serializedTicks = Convert.ToInt64(enumerator.Value, CultureInfo.InvariantCulture);
                        foundTicks = true; 
                        break;
                    case DateDataField: 
                        serializedDateData = Convert.ToUInt64(enumerator.Value, CultureInfo.InvariantCulture); 
                        foundDateData = true;
                        break; 
                    default:
                        // Ignore other fields for forward compatability.
                        break;
                } 
            }
            if (foundDateData) { 
                this.dateData = serializedDateData; 
            }
            else if (foundTicks) { 
                this.dateData = (UInt64)serializedTicks;
            }
            else {
                throw new SerializationException(Environment.GetResourceString("Serialization_MissingDateTimeData")); 
            }
            Int64 ticks = InternalTicks; 
            if (ticks < MinTicks || ticks > MaxTicks) { 
                throw new SerializationException(Environment.GetResourceString("Serialization_DateTimeTicksOutOfRange"));
            } 
        }


 
        internal Int64 InternalTicks {
#if !FEATURE_CORECLR 
            [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")] 
#endif
            get { 
                return (Int64)(dateData & TicksMask);
            }
        }
 
        private UInt64 InternalKind {
#if !FEATURE_CORECLR 
            [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")] 
#endif
            get { 
                return (dateData & FlagsMask);
            }
        }
 
        // Returns the DateTime resulting from adding the given
        // TimeSpan to this DateTime. 
        // 
        public DateTime Add(TimeSpan value) {
            return AddTicks(value._ticks); 
        }

        // Returns the DateTime resulting from adding a fractional number of
        // time units to this DateTime. 
        private DateTime Add(double value, int scale) {
            long millis = (long)(value * scale + (value >= 0? 0.5: -0.5)); 
            if (millis <= -MaxMillis || millis >= MaxMillis) 
                throw new ArgumentOutOfRangeException("value", Environment.GetResourceString("ArgumentOutOfRange_AddValue"));
            return AddTicks(millis * TicksPerMillisecond); 
        }

        // Returns the DateTime resulting from adding a fractional number of
        // days to this DateTime. The result is computed by rounding the 
        // fractional number of days given by value to the nearest
        // millisecond, and adding that interval to this DateTime. The 
        // value argument is permitted to be negative. 
        //
        public DateTime AddDays(double value) { 
            return Add(value, MillisPerDay);
        }

        // Returns the DateTime resulting from adding a fractional number of 
        // hours to this DateTime. The result is computed by rounding the
        // fractional number of hours given by value to the nearest 
        // millisecond, and adding that interval to this DateTime. The 
        // value argument is permitted to be negative.
        // 
        public DateTime AddHours(double value) {
            return Add(value, MillisPerHour);
        }
 
        // Returns the DateTime resulting from the given number of
        // milliseconds to this DateTime. The result is computed by rounding 
        // the number of milliseconds given by value to the nearest integer, 
        // and adding that interval to this DateTime. The value
        // argument is permitted to be negative. 
        //
        public DateTime AddMilliseconds(double value) {
            return Add(value, 1);
        } 

        // Returns the DateTime resulting from adding a fractional number of 
        // minutes to this DateTime. The result is computed by rounding the 
        // fractional number of minutes given by value to the nearest
        // millisecond, and adding that interval to this DateTime. The 
        // value argument is permitted to be negative.
        //
        public DateTime AddMinutes(double value) {
            return Add(value, MillisPerMinute); 
        }
 
        // Returns the DateTime resulting from adding the given number of 
        // months to this DateTime. The result is computed by incrementing
        // (or decrementing) the year and month parts of this DateTime by 
        // months months, and, if required, adjusting the day part of the
        // resulting date downwards to the last day of the resulting month in the
        // resulting year. The time-of-day part of the result is the same as the
        // time-of-day part of this DateTime. 
        //
        // In more precise terms, considering this DateTime to be of the 
        // form y / m / d + t, where y is the 
        // year, m is the month, d is the day, and t is the
        // time-of-day, the result is y1 / m1 / d1 + t, 
        // where y1 and m1 are computed by adding months months
        // to y and m, and d1 is the largest value less than
        // or equal to d that denotes a valid day in month m1 of year
        // y1. 
        //
        public DateTime AddMonths(int months) { 
            if (months < -120000 || months > 120000) throw new ArgumentOutOfRangeException("months", Environment.GetResourceString("ArgumentOutOfRange_DateTimeBadMonths")); 
            Contract.EndContractBlock();
            int y = GetDatePart(DatePartYear); 
            int m = GetDatePart(DatePartMonth);
            int d = GetDatePart(DatePartDay);
            int i = m - 1 + months;
            if (i >= 0) { 
                m = i % 12 + 1;
                y = y + i / 12; 
            } 
            else {
                m = 12 + (i + 1) % 12; 
                y = y + (i - 11) / 12;
            }
            if (y < 1 || y > 9999) {
                throw new ArgumentOutOfRangeException("months", Environment.GetResourceString("ArgumentOutOfRange_DateArithmetic")); 
            }
            int days = DaysInMonth(y, m); 
            if (d > days) d = days; 
            return new DateTime((UInt64)(DateToTicks(y, m, d) + InternalTicks % TicksPerDay) | InternalKind);
        } 

        // Returns the DateTime resulting from adding a fractional number of
        // seconds to this DateTime. The result is computed by rounding the
        // fractional number of seconds given by value to the nearest 
        // millisecond, and adding that interval to this DateTime. The
        // value argument is permitted to be negative. 
        // 
        public DateTime AddSeconds(double value) {
            return Add(value, MillisPerSecond); 
        }

        // Returns the DateTime resulting from adding the given number of
        // 100-nanosecond ticks to this DateTime. The value argument 
        // is permitted to be negative.
        // 
        public DateTime AddTicks(long value) { 
            long ticks = InternalTicks;
            if (value > MaxTicks - ticks || value < MinTicks - ticks) { 
                throw new ArgumentOutOfRangeException("value", Environment.GetResourceString("ArgumentOutOfRange_DateArithmetic"));
            }
            return new DateTime((UInt64)(ticks + value) | InternalKind);
        } 

        // Returns the DateTime resulting from adding the given number of 
        // years to this DateTime. The result is computed by incrementing 
        // (or decrementing) the year part of this DateTime by value
        // years. If the month and day of this DateTime is 2/29, and if the 
        // resulting year is not a leap year, the month and day of the resulting
        // DateTime becomes 2/28. Otherwise, the month, day, and time-of-day
        // parts of the result are the same as those of this DateTime.
        // 
        public DateTime AddYears(int value) {
            if (value < -10000 || value > 10000) throw new ArgumentOutOfRangeException("years", Environment.GetResourceString("ArgumentOutOfRange_DateTimeBadYears")); 
            Contract.EndContractBlock(); 
            return AddMonths(value * 12);
        } 

        // Compares two DateTime values, returning an integer that indicates
        // their relationship.
        // 
        public static int Compare(DateTime t1, DateTime t2) {
            Int64 ticks1 = t1.InternalTicks; 
            Int64 ticks2 = t2.InternalTicks; 
            if (ticks1 > ticks2) return 1;
            if (ticks1 < ticks2) return -1; 
            return 0;
        }

        // Compares this DateTime to a given object. This method provides an 
        // implementation of the IComparable interface. The object
        // argument must be another DateTime, or otherwise an exception 
        // occurs.  Null is considered less than any instance. 
        //
        // Returns a value less than zero if this  object 
        public int CompareTo(Object value) {
            if (value == null) return 1;
            if (!(value is DateTime)) {
                throw new ArgumentException(Environment.GetResourceString("Arg_MustBeDateTime")); 
            }
 
            long valueTicks = ((DateTime)value).InternalTicks; 
            long ticks = InternalTicks;
            if (ticks > valueTicks) return 1; 
            if (ticks < valueTicks) return -1;
            return 0;
        }
 
        public int CompareTo(DateTime value) {
            long valueTicks = value.InternalTicks; 
            long ticks = InternalTicks; 
            if (ticks > valueTicks) return 1;
            if (ticks < valueTicks) return -1; 
            return 0;
        }

        // Returns the tick count corresponding to the given year, month, and day. 
        // Will check the if the parameters are valid.
        private static long DateToTicks(int year, int month, int day) { 
            if (year >= 1 && year <= 9999 && month >= 1 && month <= 12) { 
                int[] days = IsLeapYear(year)? DaysToMonth366: DaysToMonth365;
                if (day >= 1 && day <= days[month] - days[month - 1]) { 
                    int y = year - 1;
                    int n = y * 365 + y / 4 - y / 100 + y / 400 + days[month - 1] + day - 1;
                    return n * TicksPerDay;
                } 
            }
            throw new ArgumentOutOfRangeException(null, Environment.GetResourceString("ArgumentOutOfRange_BadYearMonthDay")); 
        } 

        // Return the tick count corresponding to the given hour, minute, second. 
        // Will check the if the parameters are valid.
        private static long TimeToTicks(int hour, int minute, int second)
        {
            //TimeSpan.TimeToTicks is a family access function which does no error checking, so 
            //we need to put some error checking out here.
            if (hour >= 0 && hour < 24 && minute >= 0 && minute < 60 && second >=0 && second < 60) 
            { 
                return (TimeSpan.TimeToTicks(hour, minute, second));
            } 
            throw new ArgumentOutOfRangeException(null, Environment.GetResourceString("ArgumentOutOfRange_BadHourMinuteSecond"));
        }

        // Returns the number of days in the month given by the year and 
        // month arguments.
        // 
        public static int DaysInMonth(int year, int month) { 
            if (month < 1 || month > 12) throw new ArgumentOutOfRangeException("month", Environment.GetResourceString("ArgumentOutOfRange_Month"));
            Contract.EndContractBlock(); 
            // IsLeapYear checks the year argument
            int[] days = IsLeapYear(year)? DaysToMonth366: DaysToMonth365;
            return days[month] - days[month - 1];
        } 

        // Converts an OLE Date to a tick count. 
        // This function is duplicated in COMDateTime.cpp 
        internal static long DoubleDateToTicks(double value) {
            if (value >= OADateMaxAsDouble || value <= OADateMinAsDouble) 
                throw new ArgumentException(Environment.GetResourceString("Arg_OleAutDateInvalid"));
            long millis = (long)(value * MillisPerDay + (value >= 0? 0.5: -0.5));
            // The interesting thing here is when you have a value like 12.5 it all positive 12 days and 12 hours from 01/01/1899
            // However if you a value of -12.25 it is minus 12 days but still positive 6 hours, almost as though you meant -11.75 all negative 
            // This line below fixes up the millis in the negative case
            if (millis < 0) { 
                millis -= (millis % MillisPerDay) * 2; 
            }
 
            millis += DoubleDateOffset / TicksPerMillisecond;

            if (millis < 0 || millis >= MaxMillis) throw new ArgumentException(Environment.GetResourceString("Arg_OleAutDateScale"));
            return millis * TicksPerMillisecond; 
        }
 
        // Checks if this DateTime is equal to a given object. Returns 
        // true if the given object is a boxed DateTime and its value
        // is equal to the value of this DateTime. Returns false 
        // otherwise.
        //
        public override bool Equals(Object value) {
            if (value is DateTime) { 
                return InternalTicks == ((DateTime)value).InternalTicks;
            } 
            return false; 
        }
 
        public bool Equals(DateTime value) {
            return InternalTicks == value.InternalTicks;
        }
 
        // Compares two DateTime values for equality. Returns true if
        // the two DateTime values are equal, or false if they are 
        // not equal. 
        //
        public static bool Equals(DateTime t1, DateTime t2) { 
            return t1.InternalTicks == t2.InternalTicks;
        }

        public static DateTime FromBinary(Int64 dateData) { 
            if ((dateData & (unchecked( (Int64) LocalMask))) != 0) {
                // Local times need to be adjusted as you move from one time zone to another, 
                // just as they are when serializing in text. As such the format for local times 
                // changes to store the ticks of the UTC time, but with flags that look like a
                // local date. 
                Int64 ticks = dateData & (unchecked((Int64)TicksMask));
                // Negative ticks are stored in the top part of the range and should be converted back into a negative number
                if (ticks > TicksCeiling - TicksPerDay) {
                    ticks = ticks - TicksCeiling; 
                }
                // Convert the ticks back to local. If the UTC ticks are out of range, we need to default to 
                // the UTC offset from MinValue and MaxValue to be consistent with Parse. 
                Boolean isAmbiguousLocalDst = false;
                Int64 offsetTicks; 
                if (ticks < MinTicks) {
                    offsetTicks = TimeZoneInfo.Local.GetUtcOffset(DateTime.MinValue, TimeZoneInfoOptions.NoThrowOnInvalidTime).Ticks;
                }
                else if (ticks > MaxTicks) { 
                    offsetTicks = TimeZoneInfo.Local.GetUtcOffset(DateTime.MaxValue, TimeZoneInfoOptions.NoThrowOnInvalidTime).Ticks;
                } 
                else { 
                    // Because the ticks conversion between UTC and local is lossy, we need to capture whether the
                    // time is in a repeated hour so that it can be passed to the DateTime constructor. 
                    DateTime utcDt = new DateTime(ticks, DateTimeKind.Utc);
                    Boolean isDaylightSavings = false;
                    offsetTicks = TimeZoneInfo.GetUtcOffsetFromUtc(utcDt, TimeZoneInfo.Local, out isDaylightSavings, out isAmbiguousLocalDst).Ticks;
                } 
                ticks += offsetTicks;
                // Another behaviour of parsing is to cause small times to wrap around, so that they can be used 
                // to compare times of day 
                if (ticks < 0) {
                    ticks += TicksPerDay; 
                }
                if (ticks < MinTicks || ticks > MaxTicks) {
                    throw new ArgumentException(Environment.GetResourceString("Argument_DateTimeBadBinaryData"), "dateData");
                } 
                return new DateTime(ticks, DateTimeKind.Local, isAmbiguousLocalDst);
            } 
            else { 
                return DateTime.FromBinaryRaw(dateData);
            } 
        }

        // A version of ToBinary that uses the real representation and does not adjust local times. This is needed for
        // scenarios where the serialized data must maintain compatability 
        internal static DateTime FromBinaryRaw(Int64 dateData) {
            Int64 ticks = dateData & (Int64)TicksMask; 
            if (ticks < MinTicks || ticks > MaxTicks) 
                throw new ArgumentException(Environment.GetResourceString("Argument_DateTimeBadBinaryData"), "dateData");
            return new DateTime((UInt64)dateData); 
        }

        // Creates a DateTime from a Windows filetime. A Windows filetime is
        // a long representing the date and time as the number of 
        // 100-nanosecond intervals that have elapsed since 1/1/1601 12:00am.
        // 
        public static DateTime FromFileTime(long fileTime) { 
            return FromFileTimeUtc(fileTime).ToLocalTime();
        } 

        public static DateTime FromFileTimeUtc(long fileTime) {
            if (fileTime < 0 || fileTime > MaxTicks - FileTimeOffset) {
                throw new ArgumentOutOfRangeException("fileTime", Environment.GetResourceString("ArgumentOutOfRange_FileTimeInvalid")); 
            }
            Contract.EndContractBlock(); 
 
            // This is the ticks in Universal time for this fileTime.
            long universalTicks = fileTime + FileTimeOffset; 
            return new DateTime(universalTicks, DateTimeKind.Utc);
        }

        // Creates a DateTime from an OLE Automation Date. 
        //
        public static DateTime FromOADate(double d) { 
            return new DateTime(DoubleDateToTicks(d), DateTimeKind.Unspecified); 
        }
 
#if FEATURE_SERIALIZATION
        [System.Security.SecurityCritical /*auto-generated_required*/]
        void ISerializable.GetObjectData(SerializationInfo info, StreamingContext context) {
            if (info==null) { 
                throw new ArgumentNullException("info");
            } 
            Contract.EndContractBlock(); 

            // Serialize both the old and the new format 
            info.AddValue(TicksField, InternalTicks);
            info.AddValue(DateDataField, dateData);
        }
#endif 

        public Boolean IsDaylightSavingTime() { 
            if (Kind == DateTimeKind.Utc) { 
                return false;
            } 
            return TimeZoneInfo.Local.IsDaylightSavingTime(this, TimeZoneInfoOptions.NoThrowOnInvalidTime);
        }

#if !FEATURE_CORECLR 
        [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")]
#endif 
        public static DateTime SpecifyKind(DateTime value, DateTimeKind kind) { 
            return new DateTime(value.InternalTicks, kind);
        } 

        public Int64 ToBinary() {
            if (Kind == DateTimeKind.Local) {
                // Local times need to be adjusted as you move from one time zone to another, 
                // just as they are when serializing in text. As such the format for local times
                // changes to store the ticks of the UTC time, but with flags that look like a 
                // local date. 

                // To match serialization in text we need to be able to handle cases where 
                // the UTC value would be out of range. Unused parts of the ticks range are
                // used for this, so that values just past max value are stored just past the
                // end of the maximum range, and values just below minimum value are stored
                // at the end of the ticks area, just below 2^62. 
                TimeSpan offset = TimeZoneInfo.Local.GetUtcOffset(this, TimeZoneInfoOptions.NoThrowOnInvalidTime);
                Int64 ticks = Ticks; 
                Int64 storedTicks = ticks - offset.Ticks; 
                if (storedTicks < 0) {
                    storedTicks = TicksCeiling + storedTicks; 
                }
                return storedTicks | (unchecked((Int64) LocalMask));
            }
            else { 
                return (Int64)dateData;
            } 
        } 

        // Return the underlying data, without adjust local times to the right time zone. Needed if performance 
        // or compatability are important.
#if !FEATURE_CORECLR
        [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")]
#endif 
#if false
        private void TrimSrcHack() {}    // workaround to avoid unclosed "#if !FEATURE_CORECLR" 
#endif 
        internal Int64 ToBinaryRaw() {
            return (Int64)dateData; 
        }

        // Returns the date part of this DateTime. The resulting value
        // corresponds to this DateTime with the time-of-day part set to 
        // zero (midnight).
        // 
        public DateTime Date { 
#if !FEATURE_CORECLR
            [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")] 
#endif
            get {
                Int64 ticks = InternalTicks;
                return new DateTime((UInt64)(ticks - ticks % TicksPerDay) | InternalKind); 
            }
        } 
 
        // Returns a given date part of this DateTime. This method is used
        // to compute the year, day-of-year, month, or day part. 
        private int GetDatePart(int part) {
            Int64 ticks = InternalTicks;
            // n = number of days since 1/1/0001
            int n = (int)(ticks / TicksPerDay); 
            // y400 = number of whole 400-year periods since 1/1/0001
            int y400 = n / DaysPer400Years; 
            // n = day number within 400-year period 
            n -= y400 * DaysPer400Years;
            // y100 = number of whole 100-year periods within 400-year period 
            int y100 = n / DaysPer100Years;
            // Last 100-year period has an extra day, so decrement result if 4
            if (y100 == 4) y100 = 3;
            // n = day number within 100-year period 
            n -= y100 * DaysPer100Years;
            // y4 = number of whole 4-year periods within 100-year period 
            int y4 = n / DaysPer4Years; 
            // n = day number within 4-year period
            n -= y4 * DaysPer4Years; 
            // y1 = number of whole years within 4-year period
            int y1 = n / DaysPerYear;
            // Last year has an extra day, so decrement result if 4
            if (y1 == 4) y1 = 3; 
            // If year was requested, compute and return it
            if (part == DatePartYear) { 
                return y400 * 400 + y100 * 100 + y4 * 4 + y1 + 1; 
            }
            // n = day number within year 
            n -= y1 * DaysPerYear;
            // If day-of-year was requested, return it
            if (part == DatePartDayOfYear) return n + 1;
            // Leap year calculation looks different from IsLeapYear since y1, y4, 
            // and y100 are relative to year 1, not year 0
            bool leapYear = y1 == 3 && (y4 != 24 || y100 == 3); 
            int[] days = leapYear? DaysToMonth366: DaysToMonth365; 
            // All months have less than 32 days, so n >> 5 is a good conservative
            // estimate for the month 
            int m = n >> 5 + 1;
            // m = 1-based month number
            while (n >= days[m]) m++;
            // If month was requested, return it 
            if (part == DatePartMonth) return m;
            // Return 1-based day-of-month 
            return n - days[m - 1] + 1; 
        }
 
        // Returns the day-of-month part of this DateTime. The returned
        // value is an integer between 1 and 31.
        //
        public int Day { 
            get {
                Contract.Ensures(Contract.Result() >= 1); 
                Contract.Ensures(Contract.Result() <= 31); 
                return GetDatePart(DatePartDay);
            } 
        }

        // Returns the day-of-week part of this DateTime. The returned value
        // is an integer between 0 and 6, where 0 indicates Sunday, 1 indicates 
        // Monday, 2 indicates Tuesday, 3 indicates Wednesday, 4 indicates
        // Thursday, 5 indicates Friday, and 6 indicates Saturday. 
        // 
        public DayOfWeek DayOfWeek {
#if !FEATURE_CORECLR 
            [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")]
#endif
            get {
                Contract.Ensures(Contract.Result() >= DayOfWeek.Sunday); 
                Contract.Ensures(Contract.Result() <= DayOfWeek.Saturday);
                return (DayOfWeek)((InternalTicks / TicksPerDay + 1) % 7); 
            } 
        }
 
        // Returns the day-of-year part of this DateTime. The returned value
        // is an integer between 1 and 366.
        //
        public int DayOfYear { 
            get {
                Contract.Ensures(Contract.Result() >= 1); 
                Contract.Ensures(Contract.Result() <= 366);  // leap year 
                return GetDatePart(DatePartDayOfYear);
            } 
        }

        // Returns the hash code for this DateTime.
        // 
#if !FEATURE_CORECLR
        [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")] 
#endif 
        public override int GetHashCode() {
            Int64 ticks = InternalTicks; 
            return unchecked((int)ticks) ^ (int)(ticks >> 32);
        }

        // Returns the hour part of this DateTime. The returned value is an 
        // integer between 0 and 23.
        // 
        public int Hour { 
#if !FEATURE_CORECLR
            [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")] 
#endif
            get {
                Contract.Ensures(Contract.Result() >= 0);
                Contract.Ensures(Contract.Result() < 24); 
                return (int)((InternalTicks / TicksPerHour) % 24);
            } 
        } 

        internal Boolean IsAmbiguousDaylightSavingTime() { 
            return (InternalKind == KindLocalAmbiguousDst);
        }

        [Pure] 
        public DateTimeKind Kind {
#if !FEATURE_CORECLR 
            [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")] 
#endif
            get { 
                switch (InternalKind) {
                    case KindUnspecified:
                        return DateTimeKind.Unspecified;
                    case KindUtc: 
                        return DateTimeKind.Utc;
                    default: 
                        return DateTimeKind.Local; 
                }
            } 
        }

        // Returns the millisecond part of this DateTime. The returned value
        // is an integer between 0 and 999. 
        //
        public int Millisecond { 
#if !FEATURE_CORECLR 
            [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")]
#endif 
            get {
                Contract.Ensures(Contract.Result() >= 0);
                Contract.Ensures(Contract.Result() < 1000);
                return (int)((InternalTicks/ TicksPerMillisecond) % 1000); 
            }
        } 
 
        // Returns the minute part of this DateTime. The returned value is
        // an integer between 0 and 59. 
        //
        public int Minute {
#if !FEATURE_CORECLR
            [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")] 
#endif
            get { 
                Contract.Ensures(Contract.Result() >= 0); 
                Contract.Ensures(Contract.Result() < 60);
                return (int)((InternalTicks / TicksPerMinute) % 60); 
            }
        }

        // Returns the month part of this DateTime. The returned value is an 
        // integer between 1 and 12.
        // 
        public int Month { 
            get {
                Contract.Ensures(Contract.Result() >= 1); 
                return GetDatePart(DatePartMonth);
            }
        }
 
        // Returns a DateTime representing the current date and time. The
        // resolution of the returned value depends on the system timer. For 
        // Windows NT 3.5 and later the timer resolution is approximately 10ms, 
        // for Windows NT 3.1 it is approximately 16ms, and for Windows 95 and 98
        // it is approximately 55ms. 
        //
        public static DateTime Now {
            get {
                Contract.Ensures(Contract.Result().Kind == DateTimeKind.Local); 

                DateTime utc = UtcNow; 
                Boolean isAmbiguousLocalDst = false; 
                Int64 offset = TimeZoneInfo.GetDateTimeNowUtcOffsetFromUtc(utc, out isAmbiguousLocalDst).Ticks;
                long tick = utc.Ticks + offset; 
                if (tick>DateTime.MaxTicks) {
                    return new DateTime(DateTime.MaxTicks, DateTimeKind.Local);
                }
                if (tick().Kind == DateTimeKind.Utc);
                // following code is tuned for speed. Don't change it without running benchmark. 
                long ticks = 0;
                ticks = GetSystemTimeAsFileTime();
                return new DateTime( ((UInt64)(ticks + FileTimeOffset)) | KindUtc);
            } 
        }
 
 
        [System.Security.SecurityCritical]  // auto-generated
        [MethodImplAttribute(MethodImplOptions.InternalCall)] 
        internal static extern long GetSystemTimeAsFileTime();


 
        // Returns the second part of this DateTime. The returned value is
        // an integer between 0 and 59. 
        // 
        public int Second {
#if !FEATURE_CORECLR 
            [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")]
#endif
            get {
                Contract.Ensures(Contract.Result() >= 0); 
                Contract.Ensures(Contract.Result() < 60);
                return (int)((InternalTicks / TicksPerSecond) % 60); 
            } 
        }
 
        // Returns the tick count for this DateTime. The returned value is
        // the number of 100-nanosecond intervals that have elapsed since 1/1/0001
        // 12:00am.
        // 
        public long Ticks {
            get { 
                return InternalTicks; 
            }
        } 

        // Returns the time-of-day part of this DateTime. The returned value
        // is a TimeSpan that indicates the time elapsed since midnight.
        // 
        public TimeSpan TimeOfDay {
#if !FEATURE_CORECLR 
            [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")] 
#endif
            get { 
                return new TimeSpan(InternalTicks % TicksPerDay);
            }
        }
 
        // Returns a DateTime representing the current date. The date part
        // of the returned value is the current date, and the time-of-day part of 
        // the returned value is zero (midnight). 
        //
        public static DateTime Today { 
#if !FEATURE_CORECLR
            [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")]
#endif
            get { 
                return DateTime.Now.Date;
            } 
        } 

        // Returns the year part of this DateTime. The returned value is an 
        // integer between 1 and 9999.
        //
        public int Year {
            get { return GetDatePart(DatePartYear); } 
        }
 
        // Checks whether a given year is a leap year. This method returns true if 
        // year is a leap year, or false if not.
        // 
        public static bool IsLeapYear(int year) {
            if (year < 1 || year > 9999) {
                throw new ArgumentOutOfRangeException("year", Environment.GetResourceString("ArgumentOutOfRange_Year"));
            } 
            Contract.EndContractBlock();
            return year % 4 == 0 && (year % 100 != 0 || year % 400 == 0); 
        } 

        // Constructs a DateTime from a string. The string must specify a 
        // date and optionally a time in a culture-specific or universal format.
        // Leading and trailing whitespace characters are allowed.
        //
        [System.Security.SecuritySafeCritical]  // auto-generated 
        public static DateTime Parse(String s) {
            return (DateTimeParse.Parse(s, DateTimeFormatInfo.CurrentInfo, DateTimeStyles.None)); 
        } 

        // Constructs a DateTime from a string. The string must specify a 
        // date and optionally a time in a culture-specific or universal format.
        // Leading and trailing whitespace characters are allowed.
        //
        [System.Security.SecuritySafeCritical]  // auto-generated 
        public static DateTime Parse(String s, IFormatProvider provider) {
            return (DateTimeParse.Parse(s, DateTimeFormatInfo.GetInstance(provider), DateTimeStyles.None)); 
        } 

        [System.Security.SecuritySafeCritical]  // auto-generated 
        public static DateTime Parse(String s, IFormatProvider provider, DateTimeStyles styles) {
            DateTimeFormatInfo.ValidateStyles(styles, "styles");
            return (DateTimeParse.Parse(s, DateTimeFormatInfo.GetInstance(provider), styles));
        } 

        // Constructs a DateTime from a string. The string must specify a 
        // date and optionally a time in a culture-specific or universal format. 
        // Leading and trailing whitespace characters are allowed.
        // 
        public static DateTime ParseExact(String s, String format, IFormatProvider provider) {
            return (DateTimeParse.ParseExact(s, format, DateTimeFormatInfo.GetInstance(provider), DateTimeStyles.None));
        }
 
        // Constructs a DateTime from a string. The string must specify a
        // date and optionally a time in a culture-specific or universal format. 
        // Leading and trailing whitespace characters are allowed. 
        //
        public static DateTime ParseExact(String s, String format, IFormatProvider provider, DateTimeStyles style) { 
            DateTimeFormatInfo.ValidateStyles(style, "style");
            return (DateTimeParse.ParseExact(s, format, DateTimeFormatInfo.GetInstance(provider), style));
        }
 
        public static DateTime ParseExact(String s, String[] formats, IFormatProvider provider, DateTimeStyles style) {
            DateTimeFormatInfo.ValidateStyles(style, "style"); 
            return DateTimeParse.ParseExactMultiple(s, formats, DateTimeFormatInfo.GetInstance(provider), style); 
        }
 
#if !FEATURE_CORECLR
        [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")]
#endif
        public TimeSpan Subtract(DateTime value) { 
            return new TimeSpan(InternalTicks - value.InternalTicks);
        } 
 
        public DateTime Subtract(TimeSpan value) {
            long ticks = InternalTicks; 
            long valueTicks = value._ticks;
            if (ticks - MinTicks < valueTicks || ticks - MaxTicks > valueTicks) {
                throw new ArgumentOutOfRangeException("value", Environment.GetResourceString("ArgumentOutOfRange_DateArithmetic"));
            } 
            return new DateTime((UInt64)(ticks - valueTicks) | InternalKind);
        } 
 
        // This function is duplicated in COMDateTime.cpp
        private static double TicksToOADate(long value) { 
            if (value == 0)
                return 0.0;  // Returns OleAut's zero'ed date value.
            if (value < TicksPerDay) // This is a fix for VB. They want the default day to be 1/1/0001 rathar then 12/30/1899.
                value += DoubleDateOffset; // We could have moved this fix down but we would like to keep the bounds check. 
            if (value < OADateMinAsTicks)
                throw new OverflowException(Environment.GetResourceString("Arg_OleAutDateInvalid")); 
            // Currently, our max date == OA's max date (12/31/9999), so we don't 
            // need an overflow check in that direction.
            long millis = (value  - DoubleDateOffset) / TicksPerMillisecond; 
            if (millis < 0) {
                long frac = millis % MillisPerDay;
                if (frac != 0) millis -= (MillisPerDay + frac) * 2;
            } 
            return (double)millis / MillisPerDay;
        } 
 
        // Converts the DateTime instance into an OLE Automation compatible
        // double date. 
        public double ToOADate() {
            return TicksToOADate(InternalTicks);
        }
 
        public long ToFileTime() {
            // Treats the input as local if it is not specified 
            return ToUniversalTime().ToFileTimeUtc(); 
        }
 
        public long ToFileTimeUtc() {
            // Treats the input as universal if it is not specified
            long ticks = ((InternalKind & LocalMask) != 0) ? ToUniversalTime().InternalTicks : this.InternalTicks;
            ticks -= FileTimeOffset; 
            if (ticks < 0) {
                throw new ArgumentOutOfRangeException(null, Environment.GetResourceString("ArgumentOutOfRange_FileTimeInvalid")); 
            } 
            return ticks;
        } 

        public DateTime ToLocalTime() {
            if (Kind == DateTimeKind.Local) {
                return this; 
            }
            Boolean isDaylightSavings = false; 
            Boolean isAmbiguousLocalDst = false; 
            Int64 offset = TimeZoneInfo.GetUtcOffsetFromUtc(this, TimeZoneInfo.Local, out isDaylightSavings, out isAmbiguousLocalDst).Ticks;
            long tick = Ticks + offset; 
            if (tick>DateTime.MaxTicks) {
                return new DateTime(DateTime.MaxTicks, DateTimeKind.Local);
            }
            if (tick() != null);
            return DateTimeFormat.Format(this, "D", DateTimeFormatInfo.CurrentInfo); 
        }
 
        [System.Security.SecuritySafeCritical]  // auto-generated 
        public String ToLongTimeString() {
            Contract.Ensures(Contract.Result() != null); 
            return DateTimeFormat.Format(this, "T", DateTimeFormatInfo.CurrentInfo);
        }

        [System.Security.SecuritySafeCritical]  // auto-generated 
        public String ToShortDateString() {
            Contract.Ensures(Contract.Result() != null); 
            return DateTimeFormat.Format(this, "d", DateTimeFormatInfo.CurrentInfo); 
        }
 
        [System.Security.SecuritySafeCritical]  // auto-generated
        public String ToShortTimeString() {
            Contract.Ensures(Contract.Result() != null);
            return DateTimeFormat.Format(this, "t", DateTimeFormatInfo.CurrentInfo); 
        }
 
        [System.Security.SecuritySafeCritical]  // auto-generated 
        public override String ToString() {
            Contract.Ensures(Contract.Result() != null); 
            return DateTimeFormat.Format(this, null, DateTimeFormatInfo.CurrentInfo);
        }

        [System.Security.SecuritySafeCritical]  // auto-generated 
        public String ToString(String format) {
            Contract.Ensures(Contract.Result() != null); 
            return DateTimeFormat.Format(this, format, DateTimeFormatInfo.CurrentInfo); 
        }
 
        [System.Security.SecuritySafeCritical]  // auto-generated
#if !FEATURE_CORECLR
        [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")]
#endif 
        public String ToString(IFormatProvider provider) {
            Contract.Ensures(Contract.Result() != null); 
            return DateTimeFormat.Format(this, null, DateTimeFormatInfo.GetInstance(provider)); 
        }
 
        [System.Security.SecuritySafeCritical]  // auto-generated
        public String ToString(String format, IFormatProvider provider) {
            Contract.Ensures(Contract.Result() != null);
            return DateTimeFormat.Format(this, format, DateTimeFormatInfo.GetInstance(provider)); 
        }
 
        public DateTime ToUniversalTime() { 
            return TimeZoneInfo.ConvertTimeToUtc(this, TimeZoneInfoOptions.NoThrowOnInvalidTime);
        } 

        [System.Security.SecuritySafeCritical]  // auto-generated
        public static Boolean TryParse(String s, out DateTime result) {
            return DateTimeParse.TryParse(s, DateTimeFormatInfo.CurrentInfo, DateTimeStyles.None, out result); 
        }
 
        [System.Security.SecuritySafeCritical]  // auto-generated 
        public static Boolean TryParse(String s, IFormatProvider provider, DateTimeStyles styles, out DateTime result) {
            DateTimeFormatInfo.ValidateStyles(styles, "styles"); 
            return DateTimeParse.TryParse(s, DateTimeFormatInfo.GetInstance(provider), styles, out result);
        }

        public static Boolean TryParseExact(String s, String format, IFormatProvider provider, DateTimeStyles style, out DateTime result) { 
            DateTimeFormatInfo.ValidateStyles(style, "style");
            return DateTimeParse.TryParseExact(s, format, DateTimeFormatInfo.GetInstance(provider), style, out result); 
        } 

        public static Boolean TryParseExact(String s, String[] formats, IFormatProvider provider, DateTimeStyles style, out DateTime result) { 
            DateTimeFormatInfo.ValidateStyles(style, "style");
            return DateTimeParse.TryParseExactMultiple(s, formats, DateTimeFormatInfo.GetInstance(provider), style, out result);
        }
 
        public static DateTime operator +(DateTime d, TimeSpan t) {
            long ticks = d.InternalTicks; 
            long valueTicks = t._ticks; 
            if (valueTicks > MaxTicks - ticks || valueTicks < MinTicks - ticks) {
                throw new ArgumentOutOfRangeException("t", Environment.GetResourceString("ArgumentOutOfRange_DateArithmetic")); 
            }
            return new DateTime((UInt64)(ticks + valueTicks) | d.InternalKind);
        }
 
        public static DateTime operator -(DateTime d, TimeSpan t) {
            long ticks = d.InternalTicks; 
            long valueTicks = t._ticks; 
            if (ticks - MinTicks < valueTicks || ticks - MaxTicks > valueTicks) {
                throw new ArgumentOutOfRangeException("t", Environment.GetResourceString("ArgumentOutOfRange_DateArithmetic")); 
            }
            return new DateTime((UInt64)(ticks - valueTicks) | d.InternalKind);
        }
 
#if !FEATURE_CORECLR
        [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")] 
#endif 
        public static TimeSpan operator -(DateTime d1, DateTime d2) {
            return new TimeSpan(d1.InternalTicks - d2.InternalTicks); 
        }

#if !FEATURE_CORECLR
        [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")] 
#endif
        public static bool operator ==(DateTime d1, DateTime d2) { 
            return d1.InternalTicks == d2.InternalTicks; 
        }
 
#if !FEATURE_CORECLR
        [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")]
#endif
        public static bool operator !=(DateTime d1, DateTime d2) { 
            return d1.InternalTicks != d2.InternalTicks;
        } 
 
#if !FEATURE_CORECLR
        [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")] 
#endif
        public static bool operator <(DateTime t1, DateTime t2) {
            return t1.InternalTicks < t2.InternalTicks;
        } 

#if !FEATURE_CORECLR 
        [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")] 
#endif
        public static bool operator <=(DateTime t1, DateTime t2) { 
            return t1.InternalTicks <= t2.InternalTicks;
        }

#if !FEATURE_CORECLR 
        [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")]
#endif 
        public static bool operator >(DateTime t1, DateTime t2) { 
            return t1.InternalTicks > t2.InternalTicks;
        } 

#if !FEATURE_CORECLR
        [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")]
#endif 
        public static bool operator >=(DateTime t1, DateTime t2) {
            return t1.InternalTicks >= t2.InternalTicks; 
        } 

 
        // Returns a string array containing all of the known date and time options for the
        // current culture.  The strings returned are properly formatted date and
        // time strings for the current instance of DateTime.
        public String[] GetDateTimeFormats() 
        {
            Contract.Ensures(Contract.Result() != null); 
            return (GetDateTimeFormats(CultureInfo.CurrentCulture)); 
        }
 
        // Returns a string array containing all of the known date and time options for the
        // using the information provided by IFormatProvider.  The strings returned are properly formatted date and
        // time strings for the current instance of DateTime.
        public String[] GetDateTimeFormats(IFormatProvider provider) 
        {
            Contract.Ensures(Contract.Result() != null); 
            return (DateTimeFormat.GetAllDateTimes(this, DateTimeFormatInfo.GetInstance(provider))); 
        }
 

        // Returns a string array containing all of the date and time options for the
        // given format format and current culture.  The strings returned are properly formatted date and
        // time strings for the current instance of DateTime. 
        public String[] GetDateTimeFormats(char format)
        { 
            Contract.Ensures(Contract.Result() != null); 
            return (GetDateTimeFormats(format, CultureInfo.CurrentCulture));
        } 

        // Returns a string array containing all of the date and time options for the
        // given format format and given culture.  The strings returned are properly formatted date and
        // time strings for the current instance of DateTime. 
        public String[] GetDateTimeFormats(char format, IFormatProvider provider)
        { 
            Contract.Ensures(Contract.Result() != null); 
            return (DateTimeFormat.GetAllDateTimes(this, format, DateTimeFormatInfo.GetInstance(provider)));
        } 

        //
        // IConvertible implementation
        // 

#if !FEATURE_CORECLR 
        [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")] 
#endif
        public TypeCode GetTypeCode() { 
            return TypeCode.DateTime;
        }

 
        /// 
        bool IConvertible.ToBoolean(IFormatProvider provider) { 
            throw new InvalidCastException(Environment.GetResourceString("InvalidCast_FromTo", "DateTime", "Boolean")); 
        }
 
        /// 
        char IConvertible.ToChar(IFormatProvider provider) {
            throw new InvalidCastException(Environment.GetResourceString("InvalidCast_FromTo", "DateTime", "Char"));
        } 

        ///  
        sbyte IConvertible.ToSByte(IFormatProvider provider) { 
            throw new InvalidCastException(Environment.GetResourceString("InvalidCast_FromTo", "DateTime", "SByte"));
        } 

        /// 
        byte IConvertible.ToByte(IFormatProvider provider) {
            throw new InvalidCastException(Environment.GetResourceString("InvalidCast_FromTo", "DateTime", "Byte")); 
        }
 
        ///  
        short IConvertible.ToInt16(IFormatProvider provider) {
            throw new InvalidCastException(Environment.GetResourceString("InvalidCast_FromTo", "DateTime", "Int16")); 
        }

        /// 
        ushort IConvertible.ToUInt16(IFormatProvider provider) { 
            throw new InvalidCastException(Environment.GetResourceString("InvalidCast_FromTo", "DateTime", "UInt16"));
        } 
 
        /// 
        int IConvertible.ToInt32(IFormatProvider provider) { 
            throw new InvalidCastException(Environment.GetResourceString("InvalidCast_FromTo", "DateTime", "Int32"));
        }

        ///  
        uint IConvertible.ToUInt32(IFormatProvider provider) {
            throw new InvalidCastException(Environment.GetResourceString("InvalidCast_FromTo", "DateTime", "UInt32")); 
        } 

        ///  
        long IConvertible.ToInt64(IFormatProvider provider) {
            throw new InvalidCastException(Environment.GetResourceString("InvalidCast_FromTo", "DateTime", "Int64"));
        }
 
        /// 
        ulong IConvertible.ToUInt64(IFormatProvider provider) { 
            throw new InvalidCastException(Environment.GetResourceString("InvalidCast_FromTo", "DateTime", "UInt64")); 
        }
 
        /// 
        float IConvertible.ToSingle(IFormatProvider provider) {
            throw new InvalidCastException(Environment.GetResourceString("InvalidCast_FromTo", "DateTime", "Single"));
        } 

        ///  
        double IConvertible.ToDouble(IFormatProvider provider) { 
            throw new InvalidCastException(Environment.GetResourceString("InvalidCast_FromTo", "DateTime", "Double"));
        } 

        /// 
        Decimal IConvertible.ToDecimal(IFormatProvider provider) {
            throw new InvalidCastException(Environment.GetResourceString("InvalidCast_FromTo", "DateTime", "Decimal")); 
        }
 
        ///  
#if !FEATURE_CORECLR
        [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")] 
#endif
        DateTime IConvertible.ToDateTime(IFormatProvider provider) {
            return this;
        } 

        ///  
        Object IConvertible.ToType(Type type, IFormatProvider provider) { 
            return Convert.DefaultToType((IConvertible)this, type, provider);
        } 

        // Tries to construct a DateTime from a given year, month, day, hour,
        // minute, second and millisecond.
        // 
        internal static Boolean TryCreate(int year, int month, int day, int hour, int minute, int second, int millisecond, out DateTime result) {
            result = DateTime.MinValue; 
            if (year < 1 || year > 9999 || month < 1 || month > 12) { 
                return false;
            } 
            int[] days = IsLeapYear(year) ? DaysToMonth366 : DaysToMonth365;
            if (day < 1 || day > days[month] - days[month - 1]) {
                return false;
            } 
            if (hour < 0 || hour >= 24 || minute < 0 || minute >= 60 || second < 0 || second >= 60) {
                return false; 
            } 
            if (millisecond < 0 || millisecond >= MillisPerSecond) {
                return false; 
            }
            long ticks = DateToTicks(year, month, day) + TimeToTicks(hour, minute, second);

            ticks += millisecond * TicksPerMillisecond; 
            if (ticks < MinTicks || ticks > MaxTicks) {
                return false; 
            } 
            result = new DateTime(ticks, DateTimeKind.Unspecified);
            return true; 
        }
    }
}

// File provided for Reference Use Only by Microsoft Corporation (c) 2007.
// ==++== 
//
//   Copyright (c) Microsoft Corporation.  All rights reserved.
//
// ==--== 
namespace System {
 
    using System; 
    using System.Threading;
    using System.Globalization; 
    using System.Runtime;
    using System.Runtime.InteropServices;
    using System.Runtime.CompilerServices;
    using System.Runtime.Serialization; 
    using System.Security.Permissions;
    using System.Diagnostics.Contracts; 
    using CultureInfo = System.Globalization.CultureInfo; 
    using Calendar = System.Globalization.Calendar;
 
    // This value type represents a date and time.  Every DateTime
    // object has a private field (Ticks) of type Int64 that stores the
    // date and time as the number of 100 nanosecond intervals since
    // 12:00 AM January 1, year 1 A.D. in the proleptic Gregorian Calendar. 
    //
    // Starting from V2.0, DateTime also stored some context about its time 
    // zone in the form of a 3-state value representing Unspecified, Utc or 
    // Local. This is stored in the two top bits of the 64-bit numeric value
    // with the remainder of the bits storing the tick count. This information 
    // is only used during time zone conversions and is not part of the
    // identity of the DateTime. Thus, operations like Compare and Equals
    // ignore this state. This is to stay compatible with earlier behavior
    // and performance characteristics and to avoid forcing  people into dealing 
    // with the effects of daylight savings. Note, that this has little effect
    // on how the DateTime works except in a context where its specific time 
    // zone is needed, such as during conversions and some parsing and formatting 
    // cases.
    // 
    // There is also 4th state stored that is a special type of Local value that
    // is used to avoid data loss when round-tripping between local and UTC time.
    // See below for more information on this 4th state, although it is
    // effectively hidden from most users, who just see the 3-state DateTimeKind 
    // enumeration.
    // 
    // For compatability, DateTime does not serialize the Kind data when used in 
    // binary serialization.
    // 
    // For a description of various calendar issues, look at
    //
    // Calendar Studies web site, at
    // http://serendipity.nofadz.com/hermetic/cal_stud.htm. 
    //
    // 
    [StructLayout(LayoutKind.Auto)] 
    [Serializable]
    public struct DateTime : IComparable, IFormattable, IConvertible, ISerializable, IComparable,IEquatable { 

        // Number of 100ns ticks per time unit
        private const long TicksPerMillisecond = 10000;
        private const long TicksPerSecond = TicksPerMillisecond * 1000; 
        private const long TicksPerMinute = TicksPerSecond * 60;
        private const long TicksPerHour = TicksPerMinute * 60; 
        private const long TicksPerDay = TicksPerHour * 24; 

        // Number of milliseconds per time unit 
        private const int MillisPerSecond = 1000;
        private const int MillisPerMinute = MillisPerSecond * 60;
        private const int MillisPerHour = MillisPerMinute * 60;
        private const int MillisPerDay = MillisPerHour * 24; 

        // Number of days in a non-leap year 
        private const int DaysPerYear = 365; 
        // Number of days in 4 years
        private const int DaysPer4Years = DaysPerYear * 4 + 1; 
        // Number of days in 100 years
        private const int DaysPer100Years = DaysPer4Years * 25 - 1;
        // Number of days in 400 years
        private const int DaysPer400Years = DaysPer100Years * 4 + 1; 

        // Number of days from 1/1/0001 to 12/31/1600 
        private const int DaysTo1601 = DaysPer400Years * 4; 
        // Number of days from 1/1/0001 to 12/30/1899
        private const int DaysTo1899 = DaysPer400Years * 4 + DaysPer100Years * 3 - 367; 
        // Number of days from 1/1/0001 to 12/31/9999
        private const int DaysTo10000 = DaysPer400Years * 25 - 366;

        internal const long MinTicks = 0; 
        internal const long MaxTicks = DaysTo10000 * TicksPerDay - 1;
        private const long MaxMillis = (long)DaysTo10000 * MillisPerDay; 
 
        private const long FileTimeOffset = DaysTo1601 * TicksPerDay;
        private const long DoubleDateOffset = DaysTo1899 * TicksPerDay; 
        // The minimum OA date is 0100/01/01 (Note it's year 100).
        // The maximum OA date is 9999/12/31
        private const long OADateMinAsTicks = (DaysPer100Years - DaysPerYear) * TicksPerDay;
        // All OA dates must be greater than (not >=) OADateMinAsDouble 
        private const double OADateMinAsDouble = -657435.0;
        // All OA dates must be less than (not <=) OADateMaxAsDouble 
        private const double OADateMaxAsDouble = 2958466.0; 

        private const int DatePartYear = 0; 
        private const int DatePartDayOfYear = 1;
        private const int DatePartMonth = 2;
        private const int DatePartDay = 3;
 
        private static readonly int[] DaysToMonth365 = {
            0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334, 365}; 
        private static readonly int[] DaysToMonth366 = { 
            0, 31, 60, 91, 121, 152, 182, 213, 244, 274, 305, 335, 366};
 
        public static readonly DateTime MinValue = new DateTime(MinTicks, DateTimeKind.Unspecified);
        public static readonly DateTime MaxValue = new DateTime(MaxTicks, DateTimeKind.Unspecified);

        private const UInt64 TicksMask             = 0x3FFFFFFFFFFFFFFF; 
        private const UInt64 FlagsMask             = 0xC000000000000000;
        private const UInt64 LocalMask             = 0x8000000000000000; 
        private const Int64 TicksCeiling           = 0x4000000000000000; 
        private const UInt64 KindUnspecified       = 0x0000000000000000;
        private const UInt64 KindUtc               = 0x4000000000000000; 
        private const UInt64 KindLocal             = 0x8000000000000000;
        private const UInt64 KindLocalAmbiguousDst = 0xC000000000000000;
        private const Int32 KindShift = 62;
 
        private const String TicksField            = "ticks";
        private const String DateDataField         = "dateData"; 
 
        // The data is stored as an unsigned 64-bit integeter
        //   Bits 01-62: The value of 100-nanosecond ticks where 0 represents 1/1/0001 12:00am, up until the value 
        //               12/31/9999 23:59:59.9999999
        //   Bits 63-64: A four-state value that describes the DateTimeKind value of the date time, with a 2nd
        //               value for the rare case where the date time is local, but is in an overlapped daylight
        //               savings time hour and it is in daylight savings time. This allows distinction of these 
        //               otherwise ambiguous local times and prevents data loss when round tripping from Local to
        //               UTC time. 
        private UInt64 dateData; 

        // Constructs a DateTime from a tick count. The ticks 
        // argument specifies the date as the number of 100-nanosecond intervals
        // that have elapsed since 1/1/0001 12:00am.
        //
        public DateTime(long ticks) { 
            if (ticks < MinTicks || ticks > MaxTicks)
                throw new ArgumentOutOfRangeException("ticks", Environment.GetResourceString("ArgumentOutOfRange_DateTimeBadTicks")); 
            Contract.EndContractBlock(); 
            dateData = (UInt64)ticks;
        } 

        private DateTime(UInt64 dateData) {
            this.dateData = dateData;
        } 

        public DateTime(long ticks, DateTimeKind kind) { 
            if (ticks < MinTicks || ticks > MaxTicks) { 
                throw new ArgumentOutOfRangeException("ticks", Environment.GetResourceString("ArgumentOutOfRange_DateTimeBadTicks"));
            } 
            if (kind < DateTimeKind.Unspecified || kind > DateTimeKind.Local) {
                throw new ArgumentException(Environment.GetResourceString("Argument_InvalidDateTimeKind"), "kind");
            }
            Contract.EndContractBlock(); 
            this.dateData = ((UInt64)ticks | ((UInt64)kind << KindShift));
        } 
 
        internal DateTime(long ticks, DateTimeKind kind, Boolean isAmbiguousDst) {
            if (ticks < MinTicks || ticks > MaxTicks) { 
                throw new ArgumentOutOfRangeException("ticks", Environment.GetResourceString("ArgumentOutOfRange_DateTimeBadTicks"));
            }
            Contract.Requires(kind == DateTimeKind.Local, "Internal Constructor is for local times only");
            Contract.EndContractBlock(); 
            dateData = ((UInt64)ticks | (isAmbiguousDst ? KindLocalAmbiguousDst : KindLocal));
        } 
 
        // Constructs a DateTime from a given year, month, and day. The
        // time-of-day of the resulting DateTime is always midnight. 
        //
        public DateTime(int year, int month, int day) {
            this.dateData = (UInt64) DateToTicks(year, month, day);
        } 

        // Constructs a DateTime from a given year, month, and day for 
        // the specified calendar. The 
        // time-of-day of the resulting DateTime is always midnight.
        // 
        public DateTime(int year, int month, int day, Calendar calendar)
            : this(year, month, day, 0, 0, 0, calendar) {
        }
 
        // Constructs a DateTime from a given year, month, day, hour,
        // minute, and second. 
        // 
        public DateTime(int year, int month, int day, int hour, int minute, int second) {
            this.dateData = (UInt64)(DateToTicks(year, month, day) + TimeToTicks(hour, minute, second)); 
        }

        public DateTime(int year, int month, int day, int hour, int minute, int second, DateTimeKind kind) {
            if (kind < DateTimeKind.Unspecified || kind > DateTimeKind.Local) { 
                throw new ArgumentException(Environment.GetResourceString("Argument_InvalidDateTimeKind"), "kind");
            } 
            Contract.EndContractBlock(); 
            Int64 ticks = DateToTicks(year, month, day) + TimeToTicks(hour, minute, second);
            this.dateData = ((UInt64)ticks | ((UInt64)kind << KindShift)); 
        }

        // Constructs a DateTime from a given year, month, day, hour,
        // minute, and second for the specified calendar. 
        //
        public DateTime(int year, int month, int day, int hour, int minute, int second, Calendar calendar) { 
            if (calendar == null) 
                throw new ArgumentNullException("calendar");
            Contract.EndContractBlock(); 
            this.dateData = (UInt64)calendar.ToDateTime(year, month, day, hour, minute, second, 0).Ticks;
        }

        // Constructs a DateTime from a given year, month, day, hour, 
        // minute, and second.
        // 
        public DateTime(int year, int month, int day, int hour, int minute, int second, int millisecond) { 
            if (millisecond < 0 || millisecond >= MillisPerSecond) {
                throw new ArgumentOutOfRangeException("millisecond", Environment.GetResourceString("ArgumentOutOfRange_Range", 0, MillisPerSecond - 1)); 
            }
            Contract.EndContractBlock();
            Int64 ticks = DateToTicks(year, month, day) + TimeToTicks(hour, minute, second);
            ticks += millisecond * TicksPerMillisecond; 
            if (ticks < MinTicks || ticks > MaxTicks)
                throw new ArgumentException(Environment.GetResourceString("Arg_DateTimeRange")); 
            this.dateData = (UInt64)ticks; 
        }
 
        public DateTime(int year, int month, int day, int hour, int minute, int second, int millisecond, DateTimeKind kind) {
            if (millisecond < 0 || millisecond >= MillisPerSecond) {
                throw new ArgumentOutOfRangeException("millisecond", Environment.GetResourceString("ArgumentOutOfRange_Range", 0, MillisPerSecond - 1));
            } 
            if (kind < DateTimeKind.Unspecified || kind > DateTimeKind.Local) {
                throw new ArgumentException(Environment.GetResourceString("Argument_InvalidDateTimeKind"), "kind"); 
            } 
            Contract.EndContractBlock();
            Int64 ticks = DateToTicks(year, month, day) + TimeToTicks(hour, minute, second); 
            ticks += millisecond * TicksPerMillisecond;
            if (ticks < MinTicks || ticks > MaxTicks)
                throw new ArgumentException(Environment.GetResourceString("Arg_DateTimeRange"));
            this.dateData = ((UInt64)ticks | ((UInt64)kind << KindShift)); 
        }
 
        // Constructs a DateTime from a given year, month, day, hour, 
        // minute, and second for the specified calendar.
        // 
        public DateTime(int year, int month, int day, int hour, int minute, int second, int millisecond, Calendar calendar) {
            if (calendar == null)
                throw new ArgumentNullException("calendar");
            if (millisecond < 0 || millisecond >= MillisPerSecond) { 
                throw new ArgumentOutOfRangeException("millisecond", Environment.GetResourceString("ArgumentOutOfRange_Range", 0, MillisPerSecond - 1));
            } 
            Contract.EndContractBlock(); 
            Int64 ticks = calendar.ToDateTime(year, month, day, hour, minute, second, 0).Ticks;
            ticks += millisecond * TicksPerMillisecond; 
            if (ticks < MinTicks || ticks > MaxTicks)
                throw new ArgumentException(Environment.GetResourceString("Arg_DateTimeRange"));
            this.dateData = (UInt64)ticks;
        } 

        public DateTime(int year, int month, int day, int hour, int minute, int second, int millisecond, Calendar calendar, DateTimeKind kind) { 
            if (calendar == null) 
                throw new ArgumentNullException("calendar");
            if (millisecond < 0 || millisecond >= MillisPerSecond) { 
                throw new ArgumentOutOfRangeException("millisecond", Environment.GetResourceString("ArgumentOutOfRange_Range", 0, MillisPerSecond - 1));
            }
            if (kind < DateTimeKind.Unspecified || kind > DateTimeKind.Local) {
                throw new ArgumentException(Environment.GetResourceString("Argument_InvalidDateTimeKind"), "kind"); 
            }
            Contract.EndContractBlock(); 
            Int64 ticks = calendar.ToDateTime(year, month, day, hour, minute, second, 0).Ticks; 
            ticks += millisecond * TicksPerMillisecond;
            if (ticks < MinTicks || ticks > MaxTicks) 
                throw new ArgumentException(Environment.GetResourceString("Arg_DateTimeRange"));
            this.dateData = ((UInt64)ticks | ((UInt64)kind << KindShift));
        }
 
        private DateTime(SerializationInfo info, StreamingContext context) {
            if (info==null) 
                throw new ArgumentNullException("info"); 
            Contract.EndContractBlock();
 
            Boolean foundTicks = false;
            Boolean foundDateData = false;
            Int64 serializedTicks = 0;
            UInt64 serializedDateData = 0; 

 
            // Get the data 
            SerializationInfoEnumerator enumerator = info.GetEnumerator();
            while( enumerator.MoveNext()) { 
                switch( enumerator.Name) {
                    case TicksField:
                        serializedTicks = Convert.ToInt64(enumerator.Value, CultureInfo.InvariantCulture);
                        foundTicks = true; 
                        break;
                    case DateDataField: 
                        serializedDateData = Convert.ToUInt64(enumerator.Value, CultureInfo.InvariantCulture); 
                        foundDateData = true;
                        break; 
                    default:
                        // Ignore other fields for forward compatability.
                        break;
                } 
            }
            if (foundDateData) { 
                this.dateData = serializedDateData; 
            }
            else if (foundTicks) { 
                this.dateData = (UInt64)serializedTicks;
            }
            else {
                throw new SerializationException(Environment.GetResourceString("Serialization_MissingDateTimeData")); 
            }
            Int64 ticks = InternalTicks; 
            if (ticks < MinTicks || ticks > MaxTicks) { 
                throw new SerializationException(Environment.GetResourceString("Serialization_DateTimeTicksOutOfRange"));
            } 
        }


 
        internal Int64 InternalTicks {
#if !FEATURE_CORECLR 
            [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")] 
#endif
            get { 
                return (Int64)(dateData & TicksMask);
            }
        }
 
        private UInt64 InternalKind {
#if !FEATURE_CORECLR 
            [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")] 
#endif
            get { 
                return (dateData & FlagsMask);
            }
        }
 
        // Returns the DateTime resulting from adding the given
        // TimeSpan to this DateTime. 
        // 
        public DateTime Add(TimeSpan value) {
            return AddTicks(value._ticks); 
        }

        // Returns the DateTime resulting from adding a fractional number of
        // time units to this DateTime. 
        private DateTime Add(double value, int scale) {
            long millis = (long)(value * scale + (value >= 0? 0.5: -0.5)); 
            if (millis <= -MaxMillis || millis >= MaxMillis) 
                throw new ArgumentOutOfRangeException("value", Environment.GetResourceString("ArgumentOutOfRange_AddValue"));
            return AddTicks(millis * TicksPerMillisecond); 
        }

        // Returns the DateTime resulting from adding a fractional number of
        // days to this DateTime. The result is computed by rounding the 
        // fractional number of days given by value to the nearest
        // millisecond, and adding that interval to this DateTime. The 
        // value argument is permitted to be negative. 
        //
        public DateTime AddDays(double value) { 
            return Add(value, MillisPerDay);
        }

        // Returns the DateTime resulting from adding a fractional number of 
        // hours to this DateTime. The result is computed by rounding the
        // fractional number of hours given by value to the nearest 
        // millisecond, and adding that interval to this DateTime. The 
        // value argument is permitted to be negative.
        // 
        public DateTime AddHours(double value) {
            return Add(value, MillisPerHour);
        }
 
        // Returns the DateTime resulting from the given number of
        // milliseconds to this DateTime. The result is computed by rounding 
        // the number of milliseconds given by value to the nearest integer, 
        // and adding that interval to this DateTime. The value
        // argument is permitted to be negative. 
        //
        public DateTime AddMilliseconds(double value) {
            return Add(value, 1);
        } 

        // Returns the DateTime resulting from adding a fractional number of 
        // minutes to this DateTime. The result is computed by rounding the 
        // fractional number of minutes given by value to the nearest
        // millisecond, and adding that interval to this DateTime. The 
        // value argument is permitted to be negative.
        //
        public DateTime AddMinutes(double value) {
            return Add(value, MillisPerMinute); 
        }
 
        // Returns the DateTime resulting from adding the given number of 
        // months to this DateTime. The result is computed by incrementing
        // (or decrementing) the year and month parts of this DateTime by 
        // months months, and, if required, adjusting the day part of the
        // resulting date downwards to the last day of the resulting month in the
        // resulting year. The time-of-day part of the result is the same as the
        // time-of-day part of this DateTime. 
        //
        // In more precise terms, considering this DateTime to be of the 
        // form y / m / d + t, where y is the 
        // year, m is the month, d is the day, and t is the
        // time-of-day, the result is y1 / m1 / d1 + t, 
        // where y1 and m1 are computed by adding months months
        // to y and m, and d1 is the largest value less than
        // or equal to d that denotes a valid day in month m1 of year
        // y1. 
        //
        public DateTime AddMonths(int months) { 
            if (months < -120000 || months > 120000) throw new ArgumentOutOfRangeException("months", Environment.GetResourceString("ArgumentOutOfRange_DateTimeBadMonths")); 
            Contract.EndContractBlock();
            int y = GetDatePart(DatePartYear); 
            int m = GetDatePart(DatePartMonth);
            int d = GetDatePart(DatePartDay);
            int i = m - 1 + months;
            if (i >= 0) { 
                m = i % 12 + 1;
                y = y + i / 12; 
            } 
            else {
                m = 12 + (i + 1) % 12; 
                y = y + (i - 11) / 12;
            }
            if (y < 1 || y > 9999) {
                throw new ArgumentOutOfRangeException("months", Environment.GetResourceString("ArgumentOutOfRange_DateArithmetic")); 
            }
            int days = DaysInMonth(y, m); 
            if (d > days) d = days; 
            return new DateTime((UInt64)(DateToTicks(y, m, d) + InternalTicks % TicksPerDay) | InternalKind);
        } 

        // Returns the DateTime resulting from adding a fractional number of
        // seconds to this DateTime. The result is computed by rounding the
        // fractional number of seconds given by value to the nearest 
        // millisecond, and adding that interval to this DateTime. The
        // value argument is permitted to be negative. 
        // 
        public DateTime AddSeconds(double value) {
            return Add(value, MillisPerSecond); 
        }

        // Returns the DateTime resulting from adding the given number of
        // 100-nanosecond ticks to this DateTime. The value argument 
        // is permitted to be negative.
        // 
        public DateTime AddTicks(long value) { 
            long ticks = InternalTicks;
            if (value > MaxTicks - ticks || value < MinTicks - ticks) { 
                throw new ArgumentOutOfRangeException("value", Environment.GetResourceString("ArgumentOutOfRange_DateArithmetic"));
            }
            return new DateTime((UInt64)(ticks + value) | InternalKind);
        } 

        // Returns the DateTime resulting from adding the given number of 
        // years to this DateTime. The result is computed by incrementing 
        // (or decrementing) the year part of this DateTime by value
        // years. If the month and day of this DateTime is 2/29, and if the 
        // resulting year is not a leap year, the month and day of the resulting
        // DateTime becomes 2/28. Otherwise, the month, day, and time-of-day
        // parts of the result are the same as those of this DateTime.
        // 
        public DateTime AddYears(int value) {
            if (value < -10000 || value > 10000) throw new ArgumentOutOfRangeException("years", Environment.GetResourceString("ArgumentOutOfRange_DateTimeBadYears")); 
            Contract.EndContractBlock(); 
            return AddMonths(value * 12);
        } 

        // Compares two DateTime values, returning an integer that indicates
        // their relationship.
        // 
        public static int Compare(DateTime t1, DateTime t2) {
            Int64 ticks1 = t1.InternalTicks; 
            Int64 ticks2 = t2.InternalTicks; 
            if (ticks1 > ticks2) return 1;
            if (ticks1 < ticks2) return -1; 
            return 0;
        }

        // Compares this DateTime to a given object. This method provides an 
        // implementation of the IComparable interface. The object
        // argument must be another DateTime, or otherwise an exception 
        // occurs.  Null is considered less than any instance. 
        //
        // Returns a value less than zero if this  object 
        public int CompareTo(Object value) {
            if (value == null) return 1;
            if (!(value is DateTime)) {
                throw new ArgumentException(Environment.GetResourceString("Arg_MustBeDateTime")); 
            }
 
            long valueTicks = ((DateTime)value).InternalTicks; 
            long ticks = InternalTicks;
            if (ticks > valueTicks) return 1; 
            if (ticks < valueTicks) return -1;
            return 0;
        }
 
        public int CompareTo(DateTime value) {
            long valueTicks = value.InternalTicks; 
            long ticks = InternalTicks; 
            if (ticks > valueTicks) return 1;
            if (ticks < valueTicks) return -1; 
            return 0;
        }

        // Returns the tick count corresponding to the given year, month, and day. 
        // Will check the if the parameters are valid.
        private static long DateToTicks(int year, int month, int day) { 
            if (year >= 1 && year <= 9999 && month >= 1 && month <= 12) { 
                int[] days = IsLeapYear(year)? DaysToMonth366: DaysToMonth365;
                if (day >= 1 && day <= days[month] - days[month - 1]) { 
                    int y = year - 1;
                    int n = y * 365 + y / 4 - y / 100 + y / 400 + days[month - 1] + day - 1;
                    return n * TicksPerDay;
                } 
            }
            throw new ArgumentOutOfRangeException(null, Environment.GetResourceString("ArgumentOutOfRange_BadYearMonthDay")); 
        } 

        // Return the tick count corresponding to the given hour, minute, second. 
        // Will check the if the parameters are valid.
        private static long TimeToTicks(int hour, int minute, int second)
        {
            //TimeSpan.TimeToTicks is a family access function which does no error checking, so 
            //we need to put some error checking out here.
            if (hour >= 0 && hour < 24 && minute >= 0 && minute < 60 && second >=0 && second < 60) 
            { 
                return (TimeSpan.TimeToTicks(hour, minute, second));
            } 
            throw new ArgumentOutOfRangeException(null, Environment.GetResourceString("ArgumentOutOfRange_BadHourMinuteSecond"));
        }

        // Returns the number of days in the month given by the year and 
        // month arguments.
        // 
        public static int DaysInMonth(int year, int month) { 
            if (month < 1 || month > 12) throw new ArgumentOutOfRangeException("month", Environment.GetResourceString("ArgumentOutOfRange_Month"));
            Contract.EndContractBlock(); 
            // IsLeapYear checks the year argument
            int[] days = IsLeapYear(year)? DaysToMonth366: DaysToMonth365;
            return days[month] - days[month - 1];
        } 

        // Converts an OLE Date to a tick count. 
        // This function is duplicated in COMDateTime.cpp 
        internal static long DoubleDateToTicks(double value) {
            if (value >= OADateMaxAsDouble || value <= OADateMinAsDouble) 
                throw new ArgumentException(Environment.GetResourceString("Arg_OleAutDateInvalid"));
            long millis = (long)(value * MillisPerDay + (value >= 0? 0.5: -0.5));
            // The interesting thing here is when you have a value like 12.5 it all positive 12 days and 12 hours from 01/01/1899
            // However if you a value of -12.25 it is minus 12 days but still positive 6 hours, almost as though you meant -11.75 all negative 
            // This line below fixes up the millis in the negative case
            if (millis < 0) { 
                millis -= (millis % MillisPerDay) * 2; 
            }
 
            millis += DoubleDateOffset / TicksPerMillisecond;

            if (millis < 0 || millis >= MaxMillis) throw new ArgumentException(Environment.GetResourceString("Arg_OleAutDateScale"));
            return millis * TicksPerMillisecond; 
        }
 
        // Checks if this DateTime is equal to a given object. Returns 
        // true if the given object is a boxed DateTime and its value
        // is equal to the value of this DateTime. Returns false 
        // otherwise.
        //
        public override bool Equals(Object value) {
            if (value is DateTime) { 
                return InternalTicks == ((DateTime)value).InternalTicks;
            } 
            return false; 
        }
 
        public bool Equals(DateTime value) {
            return InternalTicks == value.InternalTicks;
        }
 
        // Compares two DateTime values for equality. Returns true if
        // the two DateTime values are equal, or false if they are 
        // not equal. 
        //
        public static bool Equals(DateTime t1, DateTime t2) { 
            return t1.InternalTicks == t2.InternalTicks;
        }

        public static DateTime FromBinary(Int64 dateData) { 
            if ((dateData & (unchecked( (Int64) LocalMask))) != 0) {
                // Local times need to be adjusted as you move from one time zone to another, 
                // just as they are when serializing in text. As such the format for local times 
                // changes to store the ticks of the UTC time, but with flags that look like a
                // local date. 
                Int64 ticks = dateData & (unchecked((Int64)TicksMask));
                // Negative ticks are stored in the top part of the range and should be converted back into a negative number
                if (ticks > TicksCeiling - TicksPerDay) {
                    ticks = ticks - TicksCeiling; 
                }
                // Convert the ticks back to local. If the UTC ticks are out of range, we need to default to 
                // the UTC offset from MinValue and MaxValue to be consistent with Parse. 
                Boolean isAmbiguousLocalDst = false;
                Int64 offsetTicks; 
                if (ticks < MinTicks) {
                    offsetTicks = TimeZoneInfo.Local.GetUtcOffset(DateTime.MinValue, TimeZoneInfoOptions.NoThrowOnInvalidTime).Ticks;
                }
                else if (ticks > MaxTicks) { 
                    offsetTicks = TimeZoneInfo.Local.GetUtcOffset(DateTime.MaxValue, TimeZoneInfoOptions.NoThrowOnInvalidTime).Ticks;
                } 
                else { 
                    // Because the ticks conversion between UTC and local is lossy, we need to capture whether the
                    // time is in a repeated hour so that it can be passed to the DateTime constructor. 
                    DateTime utcDt = new DateTime(ticks, DateTimeKind.Utc);
                    Boolean isDaylightSavings = false;
                    offsetTicks = TimeZoneInfo.GetUtcOffsetFromUtc(utcDt, TimeZoneInfo.Local, out isDaylightSavings, out isAmbiguousLocalDst).Ticks;
                } 
                ticks += offsetTicks;
                // Another behaviour of parsing is to cause small times to wrap around, so that they can be used 
                // to compare times of day 
                if (ticks < 0) {
                    ticks += TicksPerDay; 
                }
                if (ticks < MinTicks || ticks > MaxTicks) {
                    throw new ArgumentException(Environment.GetResourceString("Argument_DateTimeBadBinaryData"), "dateData");
                } 
                return new DateTime(ticks, DateTimeKind.Local, isAmbiguousLocalDst);
            } 
            else { 
                return DateTime.FromBinaryRaw(dateData);
            } 
        }

        // A version of ToBinary that uses the real representation and does not adjust local times. This is needed for
        // scenarios where the serialized data must maintain compatability 
        internal static DateTime FromBinaryRaw(Int64 dateData) {
            Int64 ticks = dateData & (Int64)TicksMask; 
            if (ticks < MinTicks || ticks > MaxTicks) 
                throw new ArgumentException(Environment.GetResourceString("Argument_DateTimeBadBinaryData"), "dateData");
            return new DateTime((UInt64)dateData); 
        }

        // Creates a DateTime from a Windows filetime. A Windows filetime is
        // a long representing the date and time as the number of 
        // 100-nanosecond intervals that have elapsed since 1/1/1601 12:00am.
        // 
        public static DateTime FromFileTime(long fileTime) { 
            return FromFileTimeUtc(fileTime).ToLocalTime();
        } 

        public static DateTime FromFileTimeUtc(long fileTime) {
            if (fileTime < 0 || fileTime > MaxTicks - FileTimeOffset) {
                throw new ArgumentOutOfRangeException("fileTime", Environment.GetResourceString("ArgumentOutOfRange_FileTimeInvalid")); 
            }
            Contract.EndContractBlock(); 
 
            // This is the ticks in Universal time for this fileTime.
            long universalTicks = fileTime + FileTimeOffset; 
            return new DateTime(universalTicks, DateTimeKind.Utc);
        }

        // Creates a DateTime from an OLE Automation Date. 
        //
        public static DateTime FromOADate(double d) { 
            return new DateTime(DoubleDateToTicks(d), DateTimeKind.Unspecified); 
        }
 
#if FEATURE_SERIALIZATION
        [System.Security.SecurityCritical /*auto-generated_required*/]
        void ISerializable.GetObjectData(SerializationInfo info, StreamingContext context) {
            if (info==null) { 
                throw new ArgumentNullException("info");
            } 
            Contract.EndContractBlock(); 

            // Serialize both the old and the new format 
            info.AddValue(TicksField, InternalTicks);
            info.AddValue(DateDataField, dateData);
        }
#endif 

        public Boolean IsDaylightSavingTime() { 
            if (Kind == DateTimeKind.Utc) { 
                return false;
            } 
            return TimeZoneInfo.Local.IsDaylightSavingTime(this, TimeZoneInfoOptions.NoThrowOnInvalidTime);
        }

#if !FEATURE_CORECLR 
        [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")]
#endif 
        public static DateTime SpecifyKind(DateTime value, DateTimeKind kind) { 
            return new DateTime(value.InternalTicks, kind);
        } 

        public Int64 ToBinary() {
            if (Kind == DateTimeKind.Local) {
                // Local times need to be adjusted as you move from one time zone to another, 
                // just as they are when serializing in text. As such the format for local times
                // changes to store the ticks of the UTC time, but with flags that look like a 
                // local date. 

                // To match serialization in text we need to be able to handle cases where 
                // the UTC value would be out of range. Unused parts of the ticks range are
                // used for this, so that values just past max value are stored just past the
                // end of the maximum range, and values just below minimum value are stored
                // at the end of the ticks area, just below 2^62. 
                TimeSpan offset = TimeZoneInfo.Local.GetUtcOffset(this, TimeZoneInfoOptions.NoThrowOnInvalidTime);
                Int64 ticks = Ticks; 
                Int64 storedTicks = ticks - offset.Ticks; 
                if (storedTicks < 0) {
                    storedTicks = TicksCeiling + storedTicks; 
                }
                return storedTicks | (unchecked((Int64) LocalMask));
            }
            else { 
                return (Int64)dateData;
            } 
        } 

        // Return the underlying data, without adjust local times to the right time zone. Needed if performance 
        // or compatability are important.
#if !FEATURE_CORECLR
        [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")]
#endif 
#if false
        private void TrimSrcHack() {}    // workaround to avoid unclosed "#if !FEATURE_CORECLR" 
#endif 
        internal Int64 ToBinaryRaw() {
            return (Int64)dateData; 
        }

        // Returns the date part of this DateTime. The resulting value
        // corresponds to this DateTime with the time-of-day part set to 
        // zero (midnight).
        // 
        public DateTime Date { 
#if !FEATURE_CORECLR
            [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")] 
#endif
            get {
                Int64 ticks = InternalTicks;
                return new DateTime((UInt64)(ticks - ticks % TicksPerDay) | InternalKind); 
            }
        } 
 
        // Returns a given date part of this DateTime. This method is used
        // to compute the year, day-of-year, month, or day part. 
        private int GetDatePart(int part) {
            Int64 ticks = InternalTicks;
            // n = number of days since 1/1/0001
            int n = (int)(ticks / TicksPerDay); 
            // y400 = number of whole 400-year periods since 1/1/0001
            int y400 = n / DaysPer400Years; 
            // n = day number within 400-year period 
            n -= y400 * DaysPer400Years;
            // y100 = number of whole 100-year periods within 400-year period 
            int y100 = n / DaysPer100Years;
            // Last 100-year period has an extra day, so decrement result if 4
            if (y100 == 4) y100 = 3;
            // n = day number within 100-year period 
            n -= y100 * DaysPer100Years;
            // y4 = number of whole 4-year periods within 100-year period 
            int y4 = n / DaysPer4Years; 
            // n = day number within 4-year period
            n -= y4 * DaysPer4Years; 
            // y1 = number of whole years within 4-year period
            int y1 = n / DaysPerYear;
            // Last year has an extra day, so decrement result if 4
            if (y1 == 4) y1 = 3; 
            // If year was requested, compute and return it
            if (part == DatePartYear) { 
                return y400 * 400 + y100 * 100 + y4 * 4 + y1 + 1; 
            }
            // n = day number within year 
            n -= y1 * DaysPerYear;
            // If day-of-year was requested, return it
            if (part == DatePartDayOfYear) return n + 1;
            // Leap year calculation looks different from IsLeapYear since y1, y4, 
            // and y100 are relative to year 1, not year 0
            bool leapYear = y1 == 3 && (y4 != 24 || y100 == 3); 
            int[] days = leapYear? DaysToMonth366: DaysToMonth365; 
            // All months have less than 32 days, so n >> 5 is a good conservative
            // estimate for the month 
            int m = n >> 5 + 1;
            // m = 1-based month number
            while (n >= days[m]) m++;
            // If month was requested, return it 
            if (part == DatePartMonth) return m;
            // Return 1-based day-of-month 
            return n - days[m - 1] + 1; 
        }
 
        // Returns the day-of-month part of this DateTime. The returned
        // value is an integer between 1 and 31.
        //
        public int Day { 
            get {
                Contract.Ensures(Contract.Result() >= 1); 
                Contract.Ensures(Contract.Result() <= 31); 
                return GetDatePart(DatePartDay);
            } 
        }

        // Returns the day-of-week part of this DateTime. The returned value
        // is an integer between 0 and 6, where 0 indicates Sunday, 1 indicates 
        // Monday, 2 indicates Tuesday, 3 indicates Wednesday, 4 indicates
        // Thursday, 5 indicates Friday, and 6 indicates Saturday. 
        // 
        public DayOfWeek DayOfWeek {
#if !FEATURE_CORECLR 
            [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")]
#endif
            get {
                Contract.Ensures(Contract.Result() >= DayOfWeek.Sunday); 
                Contract.Ensures(Contract.Result() <= DayOfWeek.Saturday);
                return (DayOfWeek)((InternalTicks / TicksPerDay + 1) % 7); 
            } 
        }
 
        // Returns the day-of-year part of this DateTime. The returned value
        // is an integer between 1 and 366.
        //
        public int DayOfYear { 
            get {
                Contract.Ensures(Contract.Result() >= 1); 
                Contract.Ensures(Contract.Result() <= 366);  // leap year 
                return GetDatePart(DatePartDayOfYear);
            } 
        }

        // Returns the hash code for this DateTime.
        // 
#if !FEATURE_CORECLR
        [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")] 
#endif 
        public override int GetHashCode() {
            Int64 ticks = InternalTicks; 
            return unchecked((int)ticks) ^ (int)(ticks >> 32);
        }

        // Returns the hour part of this DateTime. The returned value is an 
        // integer between 0 and 23.
        // 
        public int Hour { 
#if !FEATURE_CORECLR
            [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")] 
#endif
            get {
                Contract.Ensures(Contract.Result() >= 0);
                Contract.Ensures(Contract.Result() < 24); 
                return (int)((InternalTicks / TicksPerHour) % 24);
            } 
        } 

        internal Boolean IsAmbiguousDaylightSavingTime() { 
            return (InternalKind == KindLocalAmbiguousDst);
        }

        [Pure] 
        public DateTimeKind Kind {
#if !FEATURE_CORECLR 
            [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")] 
#endif
            get { 
                switch (InternalKind) {
                    case KindUnspecified:
                        return DateTimeKind.Unspecified;
                    case KindUtc: 
                        return DateTimeKind.Utc;
                    default: 
                        return DateTimeKind.Local; 
                }
            } 
        }

        // Returns the millisecond part of this DateTime. The returned value
        // is an integer between 0 and 999. 
        //
        public int Millisecond { 
#if !FEATURE_CORECLR 
            [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")]
#endif 
            get {
                Contract.Ensures(Contract.Result() >= 0);
                Contract.Ensures(Contract.Result() < 1000);
                return (int)((InternalTicks/ TicksPerMillisecond) % 1000); 
            }
        } 
 
        // Returns the minute part of this DateTime. The returned value is
        // an integer between 0 and 59. 
        //
        public int Minute {
#if !FEATURE_CORECLR
            [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")] 
#endif
            get { 
                Contract.Ensures(Contract.Result() >= 0); 
                Contract.Ensures(Contract.Result() < 60);
                return (int)((InternalTicks / TicksPerMinute) % 60); 
            }
        }

        // Returns the month part of this DateTime. The returned value is an 
        // integer between 1 and 12.
        // 
        public int Month { 
            get {
                Contract.Ensures(Contract.Result() >= 1); 
                return GetDatePart(DatePartMonth);
            }
        }
 
        // Returns a DateTime representing the current date and time. The
        // resolution of the returned value depends on the system timer. For 
        // Windows NT 3.5 and later the timer resolution is approximately 10ms, 
        // for Windows NT 3.1 it is approximately 16ms, and for Windows 95 and 98
        // it is approximately 55ms. 
        //
        public static DateTime Now {
            get {
                Contract.Ensures(Contract.Result().Kind == DateTimeKind.Local); 

                DateTime utc = UtcNow; 
                Boolean isAmbiguousLocalDst = false; 
                Int64 offset = TimeZoneInfo.GetDateTimeNowUtcOffsetFromUtc(utc, out isAmbiguousLocalDst).Ticks;
                long tick = utc.Ticks + offset; 
                if (tick>DateTime.MaxTicks) {
                    return new DateTime(DateTime.MaxTicks, DateTimeKind.Local);
                }
                if (tick().Kind == DateTimeKind.Utc);
                // following code is tuned for speed. Don't change it without running benchmark. 
                long ticks = 0;
                ticks = GetSystemTimeAsFileTime();
                return new DateTime( ((UInt64)(ticks + FileTimeOffset)) | KindUtc);
            } 
        }
 
 
        [System.Security.SecurityCritical]  // auto-generated
        [MethodImplAttribute(MethodImplOptions.InternalCall)] 
        internal static extern long GetSystemTimeAsFileTime();


 
        // Returns the second part of this DateTime. The returned value is
        // an integer between 0 and 59. 
        // 
        public int Second {
#if !FEATURE_CORECLR 
            [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")]
#endif
            get {
                Contract.Ensures(Contract.Result() >= 0); 
                Contract.Ensures(Contract.Result() < 60);
                return (int)((InternalTicks / TicksPerSecond) % 60); 
            } 
        }
 
        // Returns the tick count for this DateTime. The returned value is
        // the number of 100-nanosecond intervals that have elapsed since 1/1/0001
        // 12:00am.
        // 
        public long Ticks {
            get { 
                return InternalTicks; 
            }
        } 

        // Returns the time-of-day part of this DateTime. The returned value
        // is a TimeSpan that indicates the time elapsed since midnight.
        // 
        public TimeSpan TimeOfDay {
#if !FEATURE_CORECLR 
            [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")] 
#endif
            get { 
                return new TimeSpan(InternalTicks % TicksPerDay);
            }
        }
 
        // Returns a DateTime representing the current date. The date part
        // of the returned value is the current date, and the time-of-day part of 
        // the returned value is zero (midnight). 
        //
        public static DateTime Today { 
#if !FEATURE_CORECLR
            [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")]
#endif
            get { 
                return DateTime.Now.Date;
            } 
        } 

        // Returns the year part of this DateTime. The returned value is an 
        // integer between 1 and 9999.
        //
        public int Year {
            get { return GetDatePart(DatePartYear); } 
        }
 
        // Checks whether a given year is a leap year. This method returns true if 
        // year is a leap year, or false if not.
        // 
        public static bool IsLeapYear(int year) {
            if (year < 1 || year > 9999) {
                throw new ArgumentOutOfRangeException("year", Environment.GetResourceString("ArgumentOutOfRange_Year"));
            } 
            Contract.EndContractBlock();
            return year % 4 == 0 && (year % 100 != 0 || year % 400 == 0); 
        } 

        // Constructs a DateTime from a string. The string must specify a 
        // date and optionally a time in a culture-specific or universal format.
        // Leading and trailing whitespace characters are allowed.
        //
        [System.Security.SecuritySafeCritical]  // auto-generated 
        public static DateTime Parse(String s) {
            return (DateTimeParse.Parse(s, DateTimeFormatInfo.CurrentInfo, DateTimeStyles.None)); 
        } 

        // Constructs a DateTime from a string. The string must specify a 
        // date and optionally a time in a culture-specific or universal format.
        // Leading and trailing whitespace characters are allowed.
        //
        [System.Security.SecuritySafeCritical]  // auto-generated 
        public static DateTime Parse(String s, IFormatProvider provider) {
            return (DateTimeParse.Parse(s, DateTimeFormatInfo.GetInstance(provider), DateTimeStyles.None)); 
        } 

        [System.Security.SecuritySafeCritical]  // auto-generated 
        public static DateTime Parse(String s, IFormatProvider provider, DateTimeStyles styles) {
            DateTimeFormatInfo.ValidateStyles(styles, "styles");
            return (DateTimeParse.Parse(s, DateTimeFormatInfo.GetInstance(provider), styles));
        } 

        // Constructs a DateTime from a string. The string must specify a 
        // date and optionally a time in a culture-specific or universal format. 
        // Leading and trailing whitespace characters are allowed.
        // 
        public static DateTime ParseExact(String s, String format, IFormatProvider provider) {
            return (DateTimeParse.ParseExact(s, format, DateTimeFormatInfo.GetInstance(provider), DateTimeStyles.None));
        }
 
        // Constructs a DateTime from a string. The string must specify a
        // date and optionally a time in a culture-specific or universal format. 
        // Leading and trailing whitespace characters are allowed. 
        //
        public static DateTime ParseExact(String s, String format, IFormatProvider provider, DateTimeStyles style) { 
            DateTimeFormatInfo.ValidateStyles(style, "style");
            return (DateTimeParse.ParseExact(s, format, DateTimeFormatInfo.GetInstance(provider), style));
        }
 
        public static DateTime ParseExact(String s, String[] formats, IFormatProvider provider, DateTimeStyles style) {
            DateTimeFormatInfo.ValidateStyles(style, "style"); 
            return DateTimeParse.ParseExactMultiple(s, formats, DateTimeFormatInfo.GetInstance(provider), style); 
        }
 
#if !FEATURE_CORECLR
        [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")]
#endif
        public TimeSpan Subtract(DateTime value) { 
            return new TimeSpan(InternalTicks - value.InternalTicks);
        } 
 
        public DateTime Subtract(TimeSpan value) {
            long ticks = InternalTicks; 
            long valueTicks = value._ticks;
            if (ticks - MinTicks < valueTicks || ticks - MaxTicks > valueTicks) {
                throw new ArgumentOutOfRangeException("value", Environment.GetResourceString("ArgumentOutOfRange_DateArithmetic"));
            } 
            return new DateTime((UInt64)(ticks - valueTicks) | InternalKind);
        } 
 
        // This function is duplicated in COMDateTime.cpp
        private static double TicksToOADate(long value) { 
            if (value == 0)
                return 0.0;  // Returns OleAut's zero'ed date value.
            if (value < TicksPerDay) // This is a fix for VB. They want the default day to be 1/1/0001 rathar then 12/30/1899.
                value += DoubleDateOffset; // We could have moved this fix down but we would like to keep the bounds check. 
            if (value < OADateMinAsTicks)
                throw new OverflowException(Environment.GetResourceString("Arg_OleAutDateInvalid")); 
            // Currently, our max date == OA's max date (12/31/9999), so we don't 
            // need an overflow check in that direction.
            long millis = (value  - DoubleDateOffset) / TicksPerMillisecond; 
            if (millis < 0) {
                long frac = millis % MillisPerDay;
                if (frac != 0) millis -= (MillisPerDay + frac) * 2;
            } 
            return (double)millis / MillisPerDay;
        } 
 
        // Converts the DateTime instance into an OLE Automation compatible
        // double date. 
        public double ToOADate() {
            return TicksToOADate(InternalTicks);
        }
 
        public long ToFileTime() {
            // Treats the input as local if it is not specified 
            return ToUniversalTime().ToFileTimeUtc(); 
        }
 
        public long ToFileTimeUtc() {
            // Treats the input as universal if it is not specified
            long ticks = ((InternalKind & LocalMask) != 0) ? ToUniversalTime().InternalTicks : this.InternalTicks;
            ticks -= FileTimeOffset; 
            if (ticks < 0) {
                throw new ArgumentOutOfRangeException(null, Environment.GetResourceString("ArgumentOutOfRange_FileTimeInvalid")); 
            } 
            return ticks;
        } 

        public DateTime ToLocalTime() {
            if (Kind == DateTimeKind.Local) {
                return this; 
            }
            Boolean isDaylightSavings = false; 
            Boolean isAmbiguousLocalDst = false; 
            Int64 offset = TimeZoneInfo.GetUtcOffsetFromUtc(this, TimeZoneInfo.Local, out isDaylightSavings, out isAmbiguousLocalDst).Ticks;
            long tick = Ticks + offset; 
            if (tick>DateTime.MaxTicks) {
                return new DateTime(DateTime.MaxTicks, DateTimeKind.Local);
            }
            if (tick() != null);
            return DateTimeFormat.Format(this, "D", DateTimeFormatInfo.CurrentInfo); 
        }
 
        [System.Security.SecuritySafeCritical]  // auto-generated 
        public String ToLongTimeString() {
            Contract.Ensures(Contract.Result() != null); 
            return DateTimeFormat.Format(this, "T", DateTimeFormatInfo.CurrentInfo);
        }

        [System.Security.SecuritySafeCritical]  // auto-generated 
        public String ToShortDateString() {
            Contract.Ensures(Contract.Result() != null); 
            return DateTimeFormat.Format(this, "d", DateTimeFormatInfo.CurrentInfo); 
        }
 
        [System.Security.SecuritySafeCritical]  // auto-generated
        public String ToShortTimeString() {
            Contract.Ensures(Contract.Result() != null);
            return DateTimeFormat.Format(this, "t", DateTimeFormatInfo.CurrentInfo); 
        }
 
        [System.Security.SecuritySafeCritical]  // auto-generated 
        public override String ToString() {
            Contract.Ensures(Contract.Result() != null); 
            return DateTimeFormat.Format(this, null, DateTimeFormatInfo.CurrentInfo);
        }

        [System.Security.SecuritySafeCritical]  // auto-generated 
        public String ToString(String format) {
            Contract.Ensures(Contract.Result() != null); 
            return DateTimeFormat.Format(this, format, DateTimeFormatInfo.CurrentInfo); 
        }
 
        [System.Security.SecuritySafeCritical]  // auto-generated
#if !FEATURE_CORECLR
        [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")]
#endif 
        public String ToString(IFormatProvider provider) {
            Contract.Ensures(Contract.Result() != null); 
            return DateTimeFormat.Format(this, null, DateTimeFormatInfo.GetInstance(provider)); 
        }
 
        [System.Security.SecuritySafeCritical]  // auto-generated
        public String ToString(String format, IFormatProvider provider) {
            Contract.Ensures(Contract.Result() != null);
            return DateTimeFormat.Format(this, format, DateTimeFormatInfo.GetInstance(provider)); 
        }
 
        public DateTime ToUniversalTime() { 
            return TimeZoneInfo.ConvertTimeToUtc(this, TimeZoneInfoOptions.NoThrowOnInvalidTime);
        } 

        [System.Security.SecuritySafeCritical]  // auto-generated
        public static Boolean TryParse(String s, out DateTime result) {
            return DateTimeParse.TryParse(s, DateTimeFormatInfo.CurrentInfo, DateTimeStyles.None, out result); 
        }
 
        [System.Security.SecuritySafeCritical]  // auto-generated 
        public static Boolean TryParse(String s, IFormatProvider provider, DateTimeStyles styles, out DateTime result) {
            DateTimeFormatInfo.ValidateStyles(styles, "styles"); 
            return DateTimeParse.TryParse(s, DateTimeFormatInfo.GetInstance(provider), styles, out result);
        }

        public static Boolean TryParseExact(String s, String format, IFormatProvider provider, DateTimeStyles style, out DateTime result) { 
            DateTimeFormatInfo.ValidateStyles(style, "style");
            return DateTimeParse.TryParseExact(s, format, DateTimeFormatInfo.GetInstance(provider), style, out result); 
        } 

        public static Boolean TryParseExact(String s, String[] formats, IFormatProvider provider, DateTimeStyles style, out DateTime result) { 
            DateTimeFormatInfo.ValidateStyles(style, "style");
            return DateTimeParse.TryParseExactMultiple(s, formats, DateTimeFormatInfo.GetInstance(provider), style, out result);
        }
 
        public static DateTime operator +(DateTime d, TimeSpan t) {
            long ticks = d.InternalTicks; 
            long valueTicks = t._ticks; 
            if (valueTicks > MaxTicks - ticks || valueTicks < MinTicks - ticks) {
                throw new ArgumentOutOfRangeException("t", Environment.GetResourceString("ArgumentOutOfRange_DateArithmetic")); 
            }
            return new DateTime((UInt64)(ticks + valueTicks) | d.InternalKind);
        }
 
        public static DateTime operator -(DateTime d, TimeSpan t) {
            long ticks = d.InternalTicks; 
            long valueTicks = t._ticks; 
            if (ticks - MinTicks < valueTicks || ticks - MaxTicks > valueTicks) {
                throw new ArgumentOutOfRangeException("t", Environment.GetResourceString("ArgumentOutOfRange_DateArithmetic")); 
            }
            return new DateTime((UInt64)(ticks - valueTicks) | d.InternalKind);
        }
 
#if !FEATURE_CORECLR
        [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")] 
#endif 
        public static TimeSpan operator -(DateTime d1, DateTime d2) {
            return new TimeSpan(d1.InternalTicks - d2.InternalTicks); 
        }

#if !FEATURE_CORECLR
        [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")] 
#endif
        public static bool operator ==(DateTime d1, DateTime d2) { 
            return d1.InternalTicks == d2.InternalTicks; 
        }
 
#if !FEATURE_CORECLR
        [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")]
#endif
        public static bool operator !=(DateTime d1, DateTime d2) { 
            return d1.InternalTicks != d2.InternalTicks;
        } 
 
#if !FEATURE_CORECLR
        [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")] 
#endif
        public static bool operator <(DateTime t1, DateTime t2) {
            return t1.InternalTicks < t2.InternalTicks;
        } 

#if !FEATURE_CORECLR 
        [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")] 
#endif
        public static bool operator <=(DateTime t1, DateTime t2) { 
            return t1.InternalTicks <= t2.InternalTicks;
        }

#if !FEATURE_CORECLR 
        [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")]
#endif 
        public static bool operator >(DateTime t1, DateTime t2) { 
            return t1.InternalTicks > t2.InternalTicks;
        } 

#if !FEATURE_CORECLR
        [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")]
#endif 
        public static bool operator >=(DateTime t1, DateTime t2) {
            return t1.InternalTicks >= t2.InternalTicks; 
        } 

 
        // Returns a string array containing all of the known date and time options for the
        // current culture.  The strings returned are properly formatted date and
        // time strings for the current instance of DateTime.
        public String[] GetDateTimeFormats() 
        {
            Contract.Ensures(Contract.Result() != null); 
            return (GetDateTimeFormats(CultureInfo.CurrentCulture)); 
        }
 
        // Returns a string array containing all of the known date and time options for the
        // using the information provided by IFormatProvider.  The strings returned are properly formatted date and
        // time strings for the current instance of DateTime.
        public String[] GetDateTimeFormats(IFormatProvider provider) 
        {
            Contract.Ensures(Contract.Result() != null); 
            return (DateTimeFormat.GetAllDateTimes(this, DateTimeFormatInfo.GetInstance(provider))); 
        }
 

        // Returns a string array containing all of the date and time options for the
        // given format format and current culture.  The strings returned are properly formatted date and
        // time strings for the current instance of DateTime. 
        public String[] GetDateTimeFormats(char format)
        { 
            Contract.Ensures(Contract.Result() != null); 
            return (GetDateTimeFormats(format, CultureInfo.CurrentCulture));
        } 

        // Returns a string array containing all of the date and time options for the
        // given format format and given culture.  The strings returned are properly formatted date and
        // time strings for the current instance of DateTime. 
        public String[] GetDateTimeFormats(char format, IFormatProvider provider)
        { 
            Contract.Ensures(Contract.Result() != null); 
            return (DateTimeFormat.GetAllDateTimes(this, format, DateTimeFormatInfo.GetInstance(provider)));
        } 

        //
        // IConvertible implementation
        // 

#if !FEATURE_CORECLR 
        [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")] 
#endif
        public TypeCode GetTypeCode() { 
            return TypeCode.DateTime;
        }

 
        /// 
        bool IConvertible.ToBoolean(IFormatProvider provider) { 
            throw new InvalidCastException(Environment.GetResourceString("InvalidCast_FromTo", "DateTime", "Boolean")); 
        }
 
        /// 
        char IConvertible.ToChar(IFormatProvider provider) {
            throw new InvalidCastException(Environment.GetResourceString("InvalidCast_FromTo", "DateTime", "Char"));
        } 

        ///  
        sbyte IConvertible.ToSByte(IFormatProvider provider) { 
            throw new InvalidCastException(Environment.GetResourceString("InvalidCast_FromTo", "DateTime", "SByte"));
        } 

        /// 
        byte IConvertible.ToByte(IFormatProvider provider) {
            throw new InvalidCastException(Environment.GetResourceString("InvalidCast_FromTo", "DateTime", "Byte")); 
        }
 
        ///  
        short IConvertible.ToInt16(IFormatProvider provider) {
            throw new InvalidCastException(Environment.GetResourceString("InvalidCast_FromTo", "DateTime", "Int16")); 
        }

        /// 
        ushort IConvertible.ToUInt16(IFormatProvider provider) { 
            throw new InvalidCastException(Environment.GetResourceString("InvalidCast_FromTo", "DateTime", "UInt16"));
        } 
 
        /// 
        int IConvertible.ToInt32(IFormatProvider provider) { 
            throw new InvalidCastException(Environment.GetResourceString("InvalidCast_FromTo", "DateTime", "Int32"));
        }

        ///  
        uint IConvertible.ToUInt32(IFormatProvider provider) {
            throw new InvalidCastException(Environment.GetResourceString("InvalidCast_FromTo", "DateTime", "UInt32")); 
        } 

        ///  
        long IConvertible.ToInt64(IFormatProvider provider) {
            throw new InvalidCastException(Environment.GetResourceString("InvalidCast_FromTo", "DateTime", "Int64"));
        }
 
        /// 
        ulong IConvertible.ToUInt64(IFormatProvider provider) { 
            throw new InvalidCastException(Environment.GetResourceString("InvalidCast_FromTo", "DateTime", "UInt64")); 
        }
 
        /// 
        float IConvertible.ToSingle(IFormatProvider provider) {
            throw new InvalidCastException(Environment.GetResourceString("InvalidCast_FromTo", "DateTime", "Single"));
        } 

        ///  
        double IConvertible.ToDouble(IFormatProvider provider) { 
            throw new InvalidCastException(Environment.GetResourceString("InvalidCast_FromTo", "DateTime", "Double"));
        } 

        /// 
        Decimal IConvertible.ToDecimal(IFormatProvider provider) {
            throw new InvalidCastException(Environment.GetResourceString("InvalidCast_FromTo", "DateTime", "Decimal")); 
        }
 
        ///  
#if !FEATURE_CORECLR
        [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")] 
#endif
        DateTime IConvertible.ToDateTime(IFormatProvider provider) {
            return this;
        } 

        ///  
        Object IConvertible.ToType(Type type, IFormatProvider provider) { 
            return Convert.DefaultToType((IConvertible)this, type, provider);
        } 

        // Tries to construct a DateTime from a given year, month, day, hour,
        // minute, second and millisecond.
        // 
        internal static Boolean TryCreate(int year, int month, int day, int hour, int minute, int second, int millisecond, out DateTime result) {
            result = DateTime.MinValue; 
            if (year < 1 || year > 9999 || month < 1 || month > 12) { 
                return false;
            } 
            int[] days = IsLeapYear(year) ? DaysToMonth366 : DaysToMonth365;
            if (day < 1 || day > days[month] - days[month - 1]) {
                return false;
            } 
            if (hour < 0 || hour >= 24 || minute < 0 || minute >= 60 || second < 0 || second >= 60) {
                return false; 
            } 
            if (millisecond < 0 || millisecond >= MillisPerSecond) {
                return false; 
            }
            long ticks = DateToTicks(year, month, day) + TimeToTicks(hour, minute, second);

            ticks += millisecond * TicksPerMillisecond; 
            if (ticks < MinTicks || ticks > MaxTicks) {
                return false; 
            } 
            result = new DateTime(ticks, DateTimeKind.Unspecified);
            return true; 
        }
    }
}

// File provided for Reference Use Only by Microsoft Corporation (c) 2007.

                        

Link Menu

Network programming in C#, Network Programming in VB.NET, Network Programming in .NET
This book is available now!
Buy at Amazon US or
Buy at Amazon UK