diff options
author | Zoltan Varga <vargaz@gmail.com> | 2020-09-09 00:52:33 +0300 |
---|---|---|
committer | GitHub <noreply@github.com> | 2020-09-09 00:52:33 +0300 |
commit | 6e103e7191dcb17120032f2516cc7f8e9e04c32e (patch) | |
tree | a3ee2ea7450809dac229fc084683df3f335942ad /netcore/System.Private.CoreLib/shared/System/DateTimeOffset.cs | |
parent | 427395f4c6a18466c26d0cf782bed106d05e77ae (diff) |
Remove netcore/ directory from the mono/mono repository. (#20361)
Diffstat (limited to 'netcore/System.Private.CoreLib/shared/System/DateTimeOffset.cs')
-rw-r--r-- | netcore/System.Private.CoreLib/shared/System/DateTimeOffset.cs | 855 |
1 files changed, 0 insertions, 855 deletions
diff --git a/netcore/System.Private.CoreLib/shared/System/DateTimeOffset.cs b/netcore/System.Private.CoreLib/shared/System/DateTimeOffset.cs deleted file mode 100644 index 81a06124163..00000000000 --- a/netcore/System.Private.CoreLib/shared/System/DateTimeOffset.cs +++ /dev/null @@ -1,855 +0,0 @@ -// Licensed to the .NET Foundation under one or more agreements. -// The .NET Foundation licenses this file to you under the MIT license. -// See the LICENSE file in the project root for more information. - -using System.Diagnostics; -using System.Globalization; -using System.Runtime.InteropServices; -using System.Runtime.Serialization; - -namespace System -{ - // DateTimeOffset is a value type that consists of a DateTime and a time zone offset, - // ie. how far away the time is from GMT. The DateTime is stored whole, and the offset - // is stored as an Int16 internally to save space, but presented as a TimeSpan. - // - // The range is constrained so that both the represented clock time and the represented - // UTC time fit within the boundaries of MaxValue. This gives it the same range as DateTime - // for actual UTC times, and a slightly constrained range on one end when an offset is - // present. - // - // This class should be substitutable for date time in most cases; so most operations - // effectively work on the clock time. However, the underlying UTC time is what counts - // for the purposes of identity, sorting and subtracting two instances. - // - // - // There are theoretically two date times stored, the UTC and the relative local representation - // or the 'clock' time. It actually does not matter which is stored in m_dateTime, so it is desirable - // for most methods to go through the helpers UtcDateTime and ClockDateTime both to abstract this - // out and for internal readability. - - [StructLayout(LayoutKind.Auto)] - [Serializable] - [System.Runtime.CompilerServices.TypeForwardedFrom("mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")] - public readonly struct DateTimeOffset : IComparable, IFormattable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, ISerializable, IDeserializationCallback, ISpanFormattable - { - // Constants - internal const long MaxOffset = TimeSpan.TicksPerHour * 14; - internal const long MinOffset = -MaxOffset; - - private const long UnixEpochSeconds = DateTime.UnixEpochTicks / TimeSpan.TicksPerSecond; // 62,135,596,800 - private const long UnixEpochMilliseconds = DateTime.UnixEpochTicks / TimeSpan.TicksPerMillisecond; // 62,135,596,800,000 - - internal const long UnixMinSeconds = DateTime.MinTicks / TimeSpan.TicksPerSecond - UnixEpochSeconds; - internal const long UnixMaxSeconds = DateTime.MaxTicks / TimeSpan.TicksPerSecond - UnixEpochSeconds; - - // Static Fields - public static readonly DateTimeOffset MinValue = new DateTimeOffset(DateTime.MinTicks, TimeSpan.Zero); - public static readonly DateTimeOffset MaxValue = new DateTimeOffset(DateTime.MaxTicks, TimeSpan.Zero); - public static readonly DateTimeOffset UnixEpoch = new DateTimeOffset(DateTime.UnixEpochTicks, TimeSpan.Zero); - - // Instance Fields - private readonly DateTime _dateTime; - private readonly short _offsetMinutes; - - // Constructors - - // Constructs a DateTimeOffset from a tick count and offset - public DateTimeOffset(long ticks, TimeSpan offset) - { - _offsetMinutes = ValidateOffset(offset); - // Let the DateTime constructor do the range checks - DateTime dateTime = new DateTime(ticks); - _dateTime = ValidateDate(dateTime, offset); - } - - // Constructs a DateTimeOffset from a DateTime. For Local and Unspecified kinds, - // extracts the local offset. For UTC, creates a UTC instance with a zero offset. - public DateTimeOffset(DateTime dateTime) - { - TimeSpan offset; - if (dateTime.Kind != DateTimeKind.Utc) - { - // Local and Unspecified are both treated as Local - offset = TimeZoneInfo.GetLocalUtcOffset(dateTime, TimeZoneInfoOptions.NoThrowOnInvalidTime); - } - else - { - offset = new TimeSpan(0); - } - _offsetMinutes = ValidateOffset(offset); - _dateTime = ValidateDate(dateTime, offset); - } - - // Constructs a DateTimeOffset from a DateTime. And an offset. Always makes the clock time - // consistent with the DateTime. For Utc ensures the offset is zero. For local, ensures that - // the offset corresponds to the local. - public DateTimeOffset(DateTime dateTime, TimeSpan offset) - { - if (dateTime.Kind == DateTimeKind.Local) - { - if (offset != TimeZoneInfo.GetLocalUtcOffset(dateTime, TimeZoneInfoOptions.NoThrowOnInvalidTime)) - { - throw new ArgumentException(SR.Argument_OffsetLocalMismatch, nameof(offset)); - } - } - else if (dateTime.Kind == DateTimeKind.Utc) - { - if (offset != TimeSpan.Zero) - { - throw new ArgumentException(SR.Argument_OffsetUtcMismatch, nameof(offset)); - } - } - _offsetMinutes = ValidateOffset(offset); - _dateTime = ValidateDate(dateTime, offset); - } - - // Constructs a DateTimeOffset from a given year, month, day, hour, - // minute, second and offset. - public DateTimeOffset(int year, int month, int day, int hour, int minute, int second, TimeSpan offset) - { - _offsetMinutes = ValidateOffset(offset); - - int originalSecond = second; - if (second == 60 && DateTime.s_systemSupportsLeapSeconds) - { - // Reset the leap second to 59 for now and then we'll validate it after getting the final UTC time. - second = 59; - } - - _dateTime = ValidateDate(new DateTime(year, month, day, hour, minute, second), offset); - - if (originalSecond == 60 && - !DateTime.IsValidTimeWithLeapSeconds(_dateTime.Year, _dateTime.Month, _dateTime.Day, _dateTime.Hour, _dateTime.Minute, 60, DateTimeKind.Utc)) - { - throw new ArgumentOutOfRangeException(null, SR.ArgumentOutOfRange_BadHourMinuteSecond); - } - } - - // Constructs a DateTimeOffset from a given year, month, day, hour, - // minute, second, millsecond and offset - public DateTimeOffset(int year, int month, int day, int hour, int minute, int second, int millisecond, TimeSpan offset) - { - _offsetMinutes = ValidateOffset(offset); - - int originalSecond = second; - if (second == 60 && DateTime.s_systemSupportsLeapSeconds) - { - // Reset the leap second to 59 for now and then we'll validate it after getting the final UTC time. - second = 59; - } - - _dateTime = ValidateDate(new DateTime(year, month, day, hour, minute, second, millisecond), offset); - - if (originalSecond == 60 && - !DateTime.IsValidTimeWithLeapSeconds(_dateTime.Year, _dateTime.Month, _dateTime.Day, _dateTime.Hour, _dateTime.Minute, 60, DateTimeKind.Utc)) - { - throw new ArgumentOutOfRangeException(null, SR.ArgumentOutOfRange_BadHourMinuteSecond); - } - } - - // Constructs a DateTimeOffset from a given year, month, day, hour, - // minute, second, millsecond, Calendar and offset. - public DateTimeOffset(int year, int month, int day, int hour, int minute, int second, int millisecond, Calendar calendar, TimeSpan offset) - { - _offsetMinutes = ValidateOffset(offset); - - int originalSecond = second; - if (second == 60 && DateTime.s_systemSupportsLeapSeconds) - { - // Reset the leap second to 59 for now and then we'll validate it after getting the final UTC time. - second = 59; - } - - _dateTime = ValidateDate(new DateTime(year, month, day, hour, minute, second, millisecond, calendar), offset); - - if (originalSecond == 60 && - !DateTime.IsValidTimeWithLeapSeconds(_dateTime.Year, _dateTime.Month, _dateTime.Day, _dateTime.Hour, _dateTime.Minute, 60, DateTimeKind.Utc)) - { - throw new ArgumentOutOfRangeException(null, SR.ArgumentOutOfRange_BadHourMinuteSecond); - } - } - - // Returns a DateTimeOffset representing the current date and time. The - // resolution of the returned value depends on the system timer. - public static DateTimeOffset Now => ToLocalTime(DateTime.UtcNow, true); - - public static DateTimeOffset UtcNow => new DateTimeOffset(DateTime.UtcNow); - - public DateTime DateTime => ClockDateTime; - - public DateTime UtcDateTime => DateTime.SpecifyKind(_dateTime, DateTimeKind.Utc); - - public DateTime LocalDateTime => UtcDateTime.ToLocalTime(); - - // Adjust to a given offset with the same UTC time. Can throw ArgumentException - // - public DateTimeOffset ToOffset(TimeSpan offset) => - new DateTimeOffset((_dateTime + offset).Ticks, offset); - - // Instance Properties - - // The clock or visible time represented. This is just a wrapper around the internal date because this is - // the chosen storage mechanism. Going through this helper is good for readability and maintainability. - // This should be used for display but not identity. - private DateTime ClockDateTime => new DateTime((_dateTime + Offset).Ticks, DateTimeKind.Unspecified); - - // Returns the date part of this DateTimeOffset. The resulting value - // corresponds to this DateTimeOffset with the time-of-day part set to - // zero (midnight). - // - public DateTime Date => ClockDateTime.Date; - - // Returns the day-of-month part of this DateTimeOffset. The returned - // value is an integer between 1 and 31. - // - public int Day => ClockDateTime.Day; - - // Returns the day-of-week part of this DateTimeOffset. 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 => ClockDateTime.DayOfWeek; - - // Returns the day-of-year part of this DateTimeOffset. The returned value - // is an integer between 1 and 366. - // - public int DayOfYear => ClockDateTime.DayOfYear; - - // Returns the hour part of this DateTimeOffset. The returned value is an - // integer between 0 and 23. - // - public int Hour => ClockDateTime.Hour; - - // Returns the millisecond part of this DateTimeOffset. The returned value - // is an integer between 0 and 999. - // - public int Millisecond => ClockDateTime.Millisecond; - - // Returns the minute part of this DateTimeOffset. The returned value is - // an integer between 0 and 59. - // - public int Minute => ClockDateTime.Minute; - - // Returns the month part of this DateTimeOffset. The returned value is an - // integer between 1 and 12. - // - public int Month => ClockDateTime.Month; - - public TimeSpan Offset => new TimeSpan(0, _offsetMinutes, 0); - - // Returns the second part of this DateTimeOffset. The returned value is - // an integer between 0 and 59. - // - public int Second => ClockDateTime.Second; - - // Returns the tick count for this DateTimeOffset. The returned value is - // the number of 100-nanosecond intervals that have elapsed since 1/1/0001 - // 12:00am. - // - public long Ticks => ClockDateTime.Ticks; - - public long UtcTicks => UtcDateTime.Ticks; - - // Returns the time-of-day part of this DateTimeOffset. The returned value - // is a TimeSpan that indicates the time elapsed since midnight. - // - public TimeSpan TimeOfDay => ClockDateTime.TimeOfDay; - - // Returns the year part of this DateTimeOffset. The returned value is an - // integer between 1 and 9999. - // - public int Year => ClockDateTime.Year; - - // Returns the DateTimeOffset resulting from adding the given - // TimeSpan to this DateTimeOffset. - // - public DateTimeOffset Add(TimeSpan timeSpan) => - new DateTimeOffset(ClockDateTime.Add(timeSpan), Offset); - - // Returns the DateTimeOffset resulting from adding a fractional number of - // days to this DateTimeOffset. The result is computed by rounding the - // fractional number of days given by value to the nearest - // millisecond, and adding that interval to this DateTimeOffset. The - // value argument is permitted to be negative. - // - public DateTimeOffset AddDays(double days) => - new DateTimeOffset(ClockDateTime.AddDays(days), Offset); - - // Returns the DateTimeOffset resulting from adding a fractional number of - // hours to this DateTimeOffset. The result is computed by rounding the - // fractional number of hours given by value to the nearest - // millisecond, and adding that interval to this DateTimeOffset. The - // value argument is permitted to be negative. - // - public DateTimeOffset AddHours(double hours) => - new DateTimeOffset(ClockDateTime.AddHours(hours), Offset); - - // Returns the DateTimeOffset resulting from the given number of - // milliseconds to this DateTimeOffset. The result is computed by rounding - // the number of milliseconds given by value to the nearest integer, - // and adding that interval to this DateTimeOffset. The value - // argument is permitted to be negative. - // - public DateTimeOffset AddMilliseconds(double milliseconds) => - new DateTimeOffset(ClockDateTime.AddMilliseconds(milliseconds), Offset); - - // Returns the DateTimeOffset resulting from adding a fractional number of - // minutes to this DateTimeOffset. The result is computed by rounding the - // fractional number of minutes given by value to the nearest - // millisecond, and adding that interval to this DateTimeOffset. The - // value argument is permitted to be negative. - // - public DateTimeOffset AddMinutes(double minutes) => - new DateTimeOffset(ClockDateTime.AddMinutes(minutes), Offset); - - public DateTimeOffset AddMonths(int months) => - new DateTimeOffset(ClockDateTime.AddMonths(months), Offset); - - // Returns the DateTimeOffset resulting from adding a fractional number of - // seconds to this DateTimeOffset. The result is computed by rounding the - // fractional number of seconds given by value to the nearest - // millisecond, and adding that interval to this DateTimeOffset. The - // value argument is permitted to be negative. - // - public DateTimeOffset AddSeconds(double seconds) => - new DateTimeOffset(ClockDateTime.AddSeconds(seconds), Offset); - - // Returns the DateTimeOffset resulting from adding the given number of - // 100-nanosecond ticks to this DateTimeOffset. The value argument - // is permitted to be negative. - // - public DateTimeOffset AddTicks(long ticks) => - new DateTimeOffset(ClockDateTime.AddTicks(ticks), Offset); - - // Returns the DateTimeOffset resulting from adding the given number of - // years to this DateTimeOffset. The result is computed by incrementing - // (or decrementing) the year part of this DateTimeOffset by value - // years. If the month and day of this DateTimeOffset is 2/29, and if the - // resulting year is not a leap year, the month and day of the resulting - // DateTimeOffset becomes 2/28. Otherwise, the month, day, and time-of-day - // parts of the result are the same as those of this DateTimeOffset. - // - public DateTimeOffset AddYears(int years) => - new DateTimeOffset(ClockDateTime.AddYears(years), Offset); - - // Compares two DateTimeOffset values, returning an integer that indicates - // their relationship. - // - public static int Compare(DateTimeOffset first, DateTimeOffset second) => - DateTime.Compare(first.UtcDateTime, second.UtcDateTime); - - // Compares this DateTimeOffset to a given object. This method provides an - // implementation of the IComparable interface. The object - // argument must be another DateTimeOffset, or otherwise an exception - // occurs. Null is considered less than any instance. - // - int IComparable.CompareTo(object? obj) - { - if (obj == null) return 1; - if (!(obj is DateTimeOffset)) - { - throw new ArgumentException(SR.Arg_MustBeDateTimeOffset); - } - - DateTime objUtc = ((DateTimeOffset)obj).UtcDateTime; - DateTime utc = UtcDateTime; - if (utc > objUtc) return 1; - if (utc < objUtc) return -1; - return 0; - } - - public int CompareTo(DateTimeOffset other) - { - DateTime otherUtc = other.UtcDateTime; - DateTime utc = UtcDateTime; - if (utc > otherUtc) return 1; - if (utc < otherUtc) return -1; - return 0; - } - - // Checks if this DateTimeOffset is equal to a given object. Returns - // true if the given object is a boxed DateTimeOffset and its value - // is equal to the value of this DateTimeOffset. Returns false - // otherwise. - // - public override bool Equals(object? obj) => - obj is DateTimeOffset && UtcDateTime.Equals(((DateTimeOffset)obj).UtcDateTime); - - public bool Equals(DateTimeOffset other) => - UtcDateTime.Equals(other.UtcDateTime); - - public bool EqualsExact(DateTimeOffset other) => - // - // returns true when the ClockDateTime, Kind, and Offset match - // - // currently the Kind should always be Unspecified, but there is always the possibility that a future version - // of DateTimeOffset overloads the Kind field - // - ClockDateTime == other.ClockDateTime && Offset == other.Offset && ClockDateTime.Kind == other.ClockDateTime.Kind; - - // Compares two DateTimeOffset values for equality. Returns true if - // the two DateTimeOffset values are equal, or false if they are - // not equal. - // - public static bool Equals(DateTimeOffset first, DateTimeOffset second) => - DateTime.Equals(first.UtcDateTime, second.UtcDateTime); - - // Creates a DateTimeOffset 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 DateTimeOffset FromFileTime(long fileTime) => - ToLocalTime(DateTime.FromFileTimeUtc(fileTime), true); - - public static DateTimeOffset FromUnixTimeSeconds(long seconds) - { - if (seconds < UnixMinSeconds || seconds > UnixMaxSeconds) - { - throw new ArgumentOutOfRangeException(nameof(seconds), - SR.Format(SR.ArgumentOutOfRange_Range, UnixMinSeconds, UnixMaxSeconds)); - } - - long ticks = seconds * TimeSpan.TicksPerSecond + DateTime.UnixEpochTicks; - return new DateTimeOffset(ticks, TimeSpan.Zero); - } - - public static DateTimeOffset FromUnixTimeMilliseconds(long milliseconds) - { - const long MinMilliseconds = DateTime.MinTicks / TimeSpan.TicksPerMillisecond - UnixEpochMilliseconds; - const long MaxMilliseconds = DateTime.MaxTicks / TimeSpan.TicksPerMillisecond - UnixEpochMilliseconds; - - if (milliseconds < MinMilliseconds || milliseconds > MaxMilliseconds) - { - throw new ArgumentOutOfRangeException(nameof(milliseconds), - SR.Format(SR.ArgumentOutOfRange_Range, MinMilliseconds, MaxMilliseconds)); - } - - long ticks = milliseconds * TimeSpan.TicksPerMillisecond + DateTime.UnixEpochTicks; - return new DateTimeOffset(ticks, TimeSpan.Zero); - } - - // ----- SECTION: private serialization instance methods ----------------* - - void IDeserializationCallback.OnDeserialization(object? sender) - { - try - { - ValidateOffset(Offset); - ValidateDate(ClockDateTime, Offset); - } - catch (ArgumentException e) - { - throw new SerializationException(SR.Serialization_InvalidData, e); - } - } - - void ISerializable.GetObjectData(SerializationInfo info, StreamingContext context) - { - if (info == null) - { - throw new ArgumentNullException(nameof(info)); - } - - info.AddValue("DateTime", _dateTime); // Do not rename (binary serialization) - info.AddValue("OffsetMinutes", _offsetMinutes); // Do not rename (binary serialization) - } - - private DateTimeOffset(SerializationInfo info, StreamingContext context) - { - if (info == null) - { - throw new ArgumentNullException(nameof(info)); - } - - _dateTime = (DateTime)info.GetValue("DateTime", typeof(DateTime))!; // Do not rename (binary serialization) - _offsetMinutes = (short)info.GetValue("OffsetMinutes", typeof(short))!; // Do not rename (binary serialization) - } - - // Returns the hash code for this DateTimeOffset. - // - public override int GetHashCode() => UtcDateTime.GetHashCode(); - - // Constructs a DateTimeOffset 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 DateTimeOffset Parse(string input) - { - if (input == null) ThrowHelper.ThrowArgumentNullException(ExceptionArgument.input); - - TimeSpan offset; - DateTime dateResult = DateTimeParse.Parse(input, - DateTimeFormatInfo.CurrentInfo, - DateTimeStyles.None, - out offset); - return new DateTimeOffset(dateResult.Ticks, offset); - } - - // Constructs a DateTimeOffset 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 DateTimeOffset Parse(string input, IFormatProvider? formatProvider) - { - if (input == null) ThrowHelper.ThrowArgumentNullException(ExceptionArgument.input); - return Parse(input, formatProvider, DateTimeStyles.None); - } - - public static DateTimeOffset Parse(string input, IFormatProvider? formatProvider, DateTimeStyles styles) - { - styles = ValidateStyles(styles, nameof(styles)); - if (input == null) ThrowHelper.ThrowArgumentNullException(ExceptionArgument.input); - - TimeSpan offset; - DateTime dateResult = DateTimeParse.Parse(input, - DateTimeFormatInfo.GetInstance(formatProvider), - styles, - out offset); - return new DateTimeOffset(dateResult.Ticks, offset); - } - - public static DateTimeOffset Parse(ReadOnlySpan<char> input, IFormatProvider? formatProvider = null, DateTimeStyles styles = DateTimeStyles.None) - { - styles = ValidateStyles(styles, nameof(styles)); - DateTime dateResult = DateTimeParse.Parse(input, DateTimeFormatInfo.GetInstance(formatProvider), styles, out TimeSpan offset); - return new DateTimeOffset(dateResult.Ticks, offset); - } - - // Constructs a DateTimeOffset 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 DateTimeOffset ParseExact(string input, string format, IFormatProvider? formatProvider) - { - if (input == null) ThrowHelper.ThrowArgumentNullException(ExceptionArgument.input); - if (format == null) ThrowHelper.ThrowArgumentNullException(ExceptionArgument.format); - return ParseExact(input, format, formatProvider, DateTimeStyles.None); - } - - // Constructs a DateTimeOffset 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 DateTimeOffset ParseExact(string input, string format, IFormatProvider? formatProvider, DateTimeStyles styles) - { - styles = ValidateStyles(styles, nameof(styles)); - if (input == null) ThrowHelper.ThrowArgumentNullException(ExceptionArgument.input); - if (format == null) ThrowHelper.ThrowArgumentNullException(ExceptionArgument.format); - - TimeSpan offset; - DateTime dateResult = DateTimeParse.ParseExact(input, - format, - DateTimeFormatInfo.GetInstance(formatProvider), - styles, - out offset); - return new DateTimeOffset(dateResult.Ticks, offset); - } - - public static DateTimeOffset ParseExact(ReadOnlySpan<char> input, ReadOnlySpan<char> format, IFormatProvider? formatProvider, DateTimeStyles styles = DateTimeStyles.None) - { - styles = ValidateStyles(styles, nameof(styles)); - DateTime dateResult = DateTimeParse.ParseExact(input, format, DateTimeFormatInfo.GetInstance(formatProvider), styles, out TimeSpan offset); - return new DateTimeOffset(dateResult.Ticks, offset); - } - - public static DateTimeOffset ParseExact(string input, string[] formats, IFormatProvider? formatProvider, DateTimeStyles styles) - { - styles = ValidateStyles(styles, nameof(styles)); - if (input == null) ThrowHelper.ThrowArgumentNullException(ExceptionArgument.input); - - TimeSpan offset; - DateTime dateResult = DateTimeParse.ParseExactMultiple(input, - formats, - DateTimeFormatInfo.GetInstance(formatProvider), - styles, - out offset); - return new DateTimeOffset(dateResult.Ticks, offset); - } - - public static DateTimeOffset ParseExact(ReadOnlySpan<char> input, string[] formats, IFormatProvider? formatProvider, DateTimeStyles styles = DateTimeStyles.None) - { - styles = ValidateStyles(styles, nameof(styles)); - DateTime dateResult = DateTimeParse.ParseExactMultiple(input, formats, DateTimeFormatInfo.GetInstance(formatProvider), styles, out TimeSpan offset); - return new DateTimeOffset(dateResult.Ticks, offset); - } - - public TimeSpan Subtract(DateTimeOffset value) => - UtcDateTime.Subtract(value.UtcDateTime); - - public DateTimeOffset Subtract(TimeSpan value) => - new DateTimeOffset(ClockDateTime.Subtract(value), Offset); - - public long ToFileTime() => UtcDateTime.ToFileTime(); - - public long ToUnixTimeSeconds() - { - // Truncate sub-second precision before offsetting by the Unix Epoch to avoid - // the last digit being off by one for dates that result in negative Unix times. - // - // For example, consider the DateTimeOffset 12/31/1969 12:59:59.001 +0 - // ticks = 621355967990010000 - // ticksFromEpoch = ticks - DateTime.UnixEpochTicks = -9990000 - // secondsFromEpoch = ticksFromEpoch / TimeSpan.TicksPerSecond = 0 - // - // Notice that secondsFromEpoch is rounded *up* by the truncation induced by integer division, - // whereas we actually always want to round *down* when converting to Unix time. This happens - // automatically for positive Unix time values. Now the example becomes: - // seconds = ticks / TimeSpan.TicksPerSecond = 62135596799 - // secondsFromEpoch = seconds - UnixEpochSeconds = -1 - // - // In other words, we want to consistently round toward the time 1/1/0001 00:00:00, - // rather than toward the Unix Epoch (1/1/1970 00:00:00). - long seconds = UtcDateTime.Ticks / TimeSpan.TicksPerSecond; - return seconds - UnixEpochSeconds; - } - - public long ToUnixTimeMilliseconds() - { - // Truncate sub-millisecond precision before offsetting by the Unix Epoch to avoid - // the last digit being off by one for dates that result in negative Unix times - long milliseconds = UtcDateTime.Ticks / TimeSpan.TicksPerMillisecond; - return milliseconds - UnixEpochMilliseconds; - } - - public DateTimeOffset ToLocalTime() => - ToLocalTime(false); - - internal DateTimeOffset ToLocalTime(bool throwOnOverflow) => - ToLocalTime(UtcDateTime, throwOnOverflow); - - private static DateTimeOffset ToLocalTime(DateTime utcDateTime, bool throwOnOverflow) - { - TimeSpan offset = TimeZoneInfo.GetLocalUtcOffset(utcDateTime, TimeZoneInfoOptions.NoThrowOnInvalidTime); - long localTicks = utcDateTime.Ticks + offset.Ticks; - if (localTicks < DateTime.MinTicks || localTicks > DateTime.MaxTicks) - { - if (throwOnOverflow) - throw new ArgumentException(SR.Arg_ArgumentOutOfRangeException); - - localTicks = localTicks < DateTime.MinTicks ? DateTime.MinTicks : DateTime.MaxTicks; - } - - return new DateTimeOffset(localTicks, offset); - } - - public override string ToString() => - DateTimeFormat.Format(ClockDateTime, null, null, Offset); - - public string ToString(string? format) => - DateTimeFormat.Format(ClockDateTime, format, null, Offset); - - public string ToString(IFormatProvider? formatProvider) => - DateTimeFormat.Format(ClockDateTime, null, formatProvider, Offset); - - public string ToString(string? format, IFormatProvider? formatProvider) => - DateTimeFormat.Format(ClockDateTime, format, formatProvider, Offset); - - public bool TryFormat(Span<char> destination, out int charsWritten, ReadOnlySpan<char> format = default, IFormatProvider? formatProvider = null) => - DateTimeFormat.TryFormat(ClockDateTime, destination, out charsWritten, format, formatProvider, Offset); - - public DateTimeOffset ToUniversalTime() => - new DateTimeOffset(UtcDateTime); - - public static bool TryParse(string? input, out DateTimeOffset result) - { - TimeSpan offset; - DateTime dateResult; - bool parsed = DateTimeParse.TryParse(input, - DateTimeFormatInfo.CurrentInfo, - DateTimeStyles.None, - out dateResult, - out offset); - result = new DateTimeOffset(dateResult.Ticks, offset); - return parsed; - } - - public static bool TryParse(ReadOnlySpan<char> input, out DateTimeOffset result) - { - bool parsed = DateTimeParse.TryParse(input, DateTimeFormatInfo.CurrentInfo, DateTimeStyles.None, out DateTime dateResult, out TimeSpan offset); - result = new DateTimeOffset(dateResult.Ticks, offset); - return parsed; - } - - public static bool TryParse(string? input, IFormatProvider? formatProvider, DateTimeStyles styles, out DateTimeOffset result) - { - styles = ValidateStyles(styles, nameof(styles)); - if (input == null) - { - result = default; - return false; - } - - TimeSpan offset; - DateTime dateResult; - bool parsed = DateTimeParse.TryParse(input, - DateTimeFormatInfo.GetInstance(formatProvider), - styles, - out dateResult, - out offset); - result = new DateTimeOffset(dateResult.Ticks, offset); - return parsed; - } - - public static bool TryParse(ReadOnlySpan<char> input, IFormatProvider? formatProvider, DateTimeStyles styles, out DateTimeOffset result) - { - styles = ValidateStyles(styles, nameof(styles)); - bool parsed = DateTimeParse.TryParse(input, DateTimeFormatInfo.GetInstance(formatProvider), styles, out DateTime dateResult, out TimeSpan offset); - result = new DateTimeOffset(dateResult.Ticks, offset); - return parsed; - } - - public static bool TryParseExact(string? input, string? format, IFormatProvider? formatProvider, DateTimeStyles styles, - out DateTimeOffset result) - { - styles = ValidateStyles(styles, nameof(styles)); - if (input == null || format == null) - { - result = default; - return false; - } - - TimeSpan offset; - DateTime dateResult; - bool parsed = DateTimeParse.TryParseExact(input, - format, - DateTimeFormatInfo.GetInstance(formatProvider), - styles, - out dateResult, - out offset); - result = new DateTimeOffset(dateResult.Ticks, offset); - return parsed; - } - - public static bool TryParseExact( - ReadOnlySpan<char> input, ReadOnlySpan<char> format, IFormatProvider? formatProvider, DateTimeStyles styles, out DateTimeOffset result) - { - styles = ValidateStyles(styles, nameof(styles)); - bool parsed = DateTimeParse.TryParseExact(input, format, DateTimeFormatInfo.GetInstance(formatProvider), styles, out DateTime dateResult, out TimeSpan offset); - result = new DateTimeOffset(dateResult.Ticks, offset); - return parsed; - } - - public static bool TryParseExact(string? input, string?[]? formats, IFormatProvider? formatProvider, DateTimeStyles styles, - out DateTimeOffset result) - { - styles = ValidateStyles(styles, nameof(styles)); - if (input == null) - { - result = default; - return false; - } - - TimeSpan offset; - DateTime dateResult; - bool parsed = DateTimeParse.TryParseExactMultiple(input, - formats, - DateTimeFormatInfo.GetInstance(formatProvider), - styles, - out dateResult, - out offset); - result = new DateTimeOffset(dateResult.Ticks, offset); - return parsed; - } - - public static bool TryParseExact( - ReadOnlySpan<char> input, string?[]? formats, IFormatProvider? formatProvider, DateTimeStyles styles, out DateTimeOffset result) - { - styles = ValidateStyles(styles, nameof(styles)); - bool parsed = DateTimeParse.TryParseExactMultiple(input, formats, DateTimeFormatInfo.GetInstance(formatProvider), styles, out DateTime dateResult, out TimeSpan offset); - result = new DateTimeOffset(dateResult.Ticks, offset); - return parsed; - } - - // Ensures the TimeSpan is valid to go in a DateTimeOffset. - private static short ValidateOffset(TimeSpan offset) - { - long ticks = offset.Ticks; - if (ticks % TimeSpan.TicksPerMinute != 0) - { - throw new ArgumentException(SR.Argument_OffsetPrecision, nameof(offset)); - } - if (ticks < MinOffset || ticks > MaxOffset) - { - throw new ArgumentOutOfRangeException(nameof(offset), SR.Argument_OffsetOutOfRange); - } - return (short)(offset.Ticks / TimeSpan.TicksPerMinute); - } - - // Ensures that the time and offset are in range. - private static DateTime ValidateDate(DateTime dateTime, TimeSpan offset) - { - // The key validation is that both the UTC and clock times fit. The clock time is validated - // by the DateTime constructor. - Debug.Assert(offset.Ticks >= MinOffset && offset.Ticks <= MaxOffset, "Offset not validated."); - - // This operation cannot overflow because offset should have already been validated to be within - // 14 hours and the DateTime instance is more than that distance from the boundaries of long. - long utcTicks = dateTime.Ticks - offset.Ticks; - if (utcTicks < DateTime.MinTicks || utcTicks > DateTime.MaxTicks) - { - throw new ArgumentOutOfRangeException(nameof(offset), SR.Argument_UTCOutOfRange); - } - // make sure the Kind is set to Unspecified - // - return new DateTime(utcTicks, DateTimeKind.Unspecified); - } - - private static DateTimeStyles ValidateStyles(DateTimeStyles style, string parameterName) - { - if ((style & DateTimeFormatInfo.InvalidDateTimeStyles) != 0) - { - throw new ArgumentException(SR.Argument_InvalidDateTimeStyles, parameterName); - } - if (((style & (DateTimeStyles.AssumeLocal)) != 0) && ((style & (DateTimeStyles.AssumeUniversal)) != 0)) - { - throw new ArgumentException(SR.Argument_ConflictingDateTimeStyles, parameterName); - } - if ((style & DateTimeStyles.NoCurrentDateDefault) != 0) - { - throw new ArgumentException(SR.Argument_DateTimeOffsetInvalidDateTimeStyles, parameterName); - } - - // RoundtripKind does not make sense for DateTimeOffset; ignore this flag for backward compatibility with DateTime - style &= ~DateTimeStyles.RoundtripKind; - - // AssumeLocal is also ignored as that is what we do by default with DateTimeOffset.Parse - style &= ~DateTimeStyles.AssumeLocal; - - return style; - } - - // Operators - - public static implicit operator DateTimeOffset(DateTime dateTime) => - new DateTimeOffset(dateTime); - - public static DateTimeOffset operator +(DateTimeOffset dateTimeOffset, TimeSpan timeSpan) => - new DateTimeOffset(dateTimeOffset.ClockDateTime + timeSpan, dateTimeOffset.Offset); - - public static DateTimeOffset operator -(DateTimeOffset dateTimeOffset, TimeSpan timeSpan) => - new DateTimeOffset(dateTimeOffset.ClockDateTime - timeSpan, dateTimeOffset.Offset); - - public static TimeSpan operator -(DateTimeOffset left, DateTimeOffset right) => - left.UtcDateTime - right.UtcDateTime; - - public static bool operator ==(DateTimeOffset left, DateTimeOffset right) => - left.UtcDateTime == right.UtcDateTime; - - public static bool operator !=(DateTimeOffset left, DateTimeOffset right) => - left.UtcDateTime != right.UtcDateTime; - - public static bool operator <(DateTimeOffset left, DateTimeOffset right) => - left.UtcDateTime < right.UtcDateTime; - - public static bool operator <=(DateTimeOffset left, DateTimeOffset right) => - left.UtcDateTime <= right.UtcDateTime; - - public static bool operator >(DateTimeOffset left, DateTimeOffset right) => - left.UtcDateTime > right.UtcDateTime; - - public static bool operator >=(DateTimeOffset left, DateTimeOffset right) => - left.UtcDateTime >= right.UtcDateTime; - } -} |