mirror of
https://github.com/BepInEx/mono.git
synced 2026-11-16 17:10:20 -10:00
* Remove unnecessary asserts * Make several classes static * Use is instead of as+null check * Use T? instead of Nullable<T> * more static classes * Mark locals as const * Merge declaration and initialization of some variables * Remove unnecessary casts * Remove unnecessary "unsafe"s * Simplify several lambda expressions * Remove redundant parentheses * Remove redundant '== true' * Remove redundant empty lines * Simplify boolean comparison with '== false' * Replace if-statement with return statement * Use while for infinite loop * Add static to all partial static class declarations * Use ++/-- operator instead of assignment * Use string.IsNullOrEmpty * Use coalesce expression * Simplify lazy initialization * Use coalese expression * Join string expressions * Use regular string literal instead of verbatim string literal * Optimize StringBuilder.Append calls * Remove redundant assignment * Remove unnecessary unsafe context * Merge processor directives * Use String.Equals instead of String.Compare * Use Debug.Fail instead of Debug.Assert(false * Remove Attribute suffix * Use predefined type * Use compound assignment * Use while statement to create an infinite loop * Remove redundant base ctor call * Avoid using catch (Exception) * Remove empty regions * Span comparison to null * Avoid unnecessary boxing of value type * Expression is always equal to 'true' * Remove unused method * update coalesce assignment * fix unsafe * fix redundant parens * Fix whitespace errors introduced Signed-off-by: dotnet-bot <[email protected]>
856 lines
41 KiB
C#
856 lines
41 KiB
C#
// 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;
|
|
}
|
|
}
|