diff options
Diffstat (limited to 'src/mscorlib/src/System/TimeZoneInfo.cs')
| -rw-r--r-- | src/mscorlib/src/System/TimeZoneInfo.cs | 5535 |
1 files changed, 888 insertions, 4647 deletions
diff --git a/src/mscorlib/src/System/TimeZoneInfo.cs b/src/mscorlib/src/System/TimeZoneInfo.cs index 72fc28fc3e..fc5625be2e 100644 --- a/src/mscorlib/src/System/TimeZoneInfo.cs +++ b/src/mscorlib/src/System/TimeZoneInfo.cs @@ -2,38 +2,15 @@ // The .NET Foundation licenses this file to you under the MIT license. // See the LICENSE file in the project root for more information. -/*============================================================ -** -** -** -** Purpose: -** This class is used to represent a Dynamic TimeZone. It -** has methods for converting a DateTime between TimeZones, -** and for reading TimeZone data from the Windows Registry -** -** -============================================================*/ - -namespace System { - using Microsoft.Win32; - using Microsoft.Win32.SafeHandles; - using System; - using System.Collections; - using System.Collections.Generic; - using System.Collections.ObjectModel; - using System.Diagnostics; - using System.Diagnostics.Contracts; - using System.Globalization; - using System.IO; - using System.Runtime.CompilerServices; - using System.Runtime.InteropServices; - using System.Runtime.Serialization; - using System.Runtime.Versioning; - using System.Security; - using System.Security.Permissions; - using System.Text; - using System.Threading; - +using System.Collections.Generic; +using System.Collections.ObjectModel; +using System.Diagnostics.Contracts; +using System.Globalization; +using System.Runtime.Serialization; +using System.Threading; + +namespace System +{ // // DateTime uses TimeZoneInfo under the hood for IsDaylightSavingTime, IsAmbiguousTime, and GetUtcOffset. // These TimeZoneInfo APIs can throw ArgumentException when an Invalid-Time is passed in. To avoid this @@ -44,137 +21,101 @@ namespace System { // demand for this alternate behavior. // [Flags] - internal enum TimeZoneInfoOptions { - None = 1, - NoThrowOnInvalidTime = 2 + internal enum TimeZoneInfoOptions + { + None = 1, + NoThrowOnInvalidTime = 2 }; [Serializable] - [System.Security.Permissions.HostProtection(MayLeakOnAbort = true)] - sealed public class TimeZoneInfo : IEquatable<TimeZoneInfo>, ISerializable, IDeserializationCallback + public sealed partial class TimeZoneInfo : IEquatable<TimeZoneInfo>, ISerializable, IDeserializationCallback { - // ---- SECTION: members supporting exposed properties -------------* - private readonly String m_id; - private readonly String m_displayName; - private readonly String m_standardDisplayName; - private readonly String m_daylightDisplayName; - private readonly TimeSpan m_baseUtcOffset; - private readonly Boolean m_supportsDaylightSavingTime; - private readonly AdjustmentRule[] m_adjustmentRules; - - // ---- SECTION: members for internal support ---------* - private enum TimeZoneInfoResult { - Success = 0, + private enum TimeZoneInfoResult + { + Success = 0, TimeZoneNotFoundException = 1, - InvalidTimeZoneException = 2, - SecurityException = 3 + InvalidTimeZoneException = 2, + SecurityException = 3 }; - -#if FEATURE_WIN32_REGISTRY - // registry constants for the 'Time Zones' hive - // - private const string c_timeZonesRegistryHive = @"SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones"; - private const string c_timeZonesRegistryHivePermissionList = @"HKEY_LOCAL_MACHINE\" + c_timeZonesRegistryHive; - private const string c_displayValue = "Display"; - private const string c_daylightValue = "Dlt"; - private const string c_standardValue = "Std"; - private const string c_muiDisplayValue = "MUI_Display"; - private const string c_muiDaylightValue = "MUI_Dlt"; - private const string c_muiStandardValue = "MUI_Std"; - private const string c_timeZoneInfoValue = "TZI"; - private const string c_firstEntryValue = "FirstEntry"; - private const string c_lastEntryValue = "LastEntry"; - -#endif // FEATURE_WIN32_REGISTRY - -#if PLATFORM_UNIX - private const string c_defaultTimeZoneDirectory = "/usr/share/zoneinfo/"; - private const string c_zoneTabFileName = "zone.tab"; - private const string c_timeZoneEnvironmentVariable = "TZ"; - private const string c_timeZoneDirectoryEnvironmentVariable = "TZDIR"; -#endif // PLATFORM_UNIX + private readonly string _id; + private readonly string _displayName; + private readonly string _standardDisplayName; + private readonly string _daylightDisplayName; + private readonly TimeSpan _baseUtcOffset; + private readonly bool _supportsDaylightSavingTime; + private readonly AdjustmentRule[] _adjustmentRules; // constants for TimeZoneInfo.Local and TimeZoneInfo.Utc - private const string c_utcId = "UTC"; - private const string c_localId = "Local"; - - private const int c_maxKeyLength = 255; + private const string UtcId = "UTC"; + private const string LocalId = "Local"; - private const int c_regByteLength = 44; + private static readonly TimeZoneInfo s_utcTimeZone = CreateCustomTimeZone(UtcId, TimeSpan.Zero, UtcId, UtcId); - // Number of 100ns ticks per time unit - private const long c_ticksPerMillisecond = 10000; - private const long c_ticksPerSecond = c_ticksPerMillisecond * 1000; - private const long c_ticksPerMinute = c_ticksPerSecond * 60; - private const long c_ticksPerHour = c_ticksPerMinute * 60; - private const long c_ticksPerDay = c_ticksPerHour * 24; - private const long c_ticksPerDayRange = c_ticksPerDay - c_ticksPerMillisecond; - - private static readonly TimeZoneInfo s_utcTimeZone = CreateCustomTimeZone(c_utcId, TimeSpan.Zero, c_utcId, c_utcId); + private static CachedData s_cachedData = new CachedData(); // // All cached data are encapsulated in a helper class to allow consistent view even when the data are refreshed using ClearCachedData() // - // For example, TimeZoneInfo.Local can be cleared by another thread calling TimeZoneInfo.ClearCachedData. Without the consistent snapshot, + // For example, TimeZoneInfo.Local can be cleared by another thread calling TimeZoneInfo.ClearCachedData. Without the consistent snapshot, // there is a chance that the internal ConvertTime calls will throw since 'source' won't be reference equal to the new TimeZoneInfo.Local. // #pragma warning disable 0420 - class CachedData + private sealed partial class CachedData { - private volatile TimeZoneInfo m_localTimeZone; + private volatile TimeZoneInfo _localTimeZone; private TimeZoneInfo CreateLocal() { lock (this) { - TimeZoneInfo timeZone = m_localTimeZone; - if (timeZone == null) { - timeZone = TimeZoneInfo.GetLocalTimeZone(this); + TimeZoneInfo timeZone = _localTimeZone; + if (timeZone == null) + { + timeZone = GetLocalTimeZone(this); // this step is to break the reference equality // between TimeZoneInfo.Local and a second time zone // such as "Pacific Standard Time" timeZone = new TimeZoneInfo( - timeZone.m_id, - timeZone.m_baseUtcOffset, - timeZone.m_displayName, - timeZone.m_standardDisplayName, - timeZone.m_daylightDisplayName, - timeZone.m_adjustmentRules, - false); - - m_localTimeZone = timeZone; + timeZone._id, + timeZone._baseUtcOffset, + timeZone._displayName, + timeZone._standardDisplayName, + timeZone._daylightDisplayName, + timeZone._adjustmentRules, + disableDaylightSavingTime: false); + + _localTimeZone = timeZone; } return timeZone; } } - public TimeZoneInfo Local { - get { - TimeZoneInfo timeZone = m_localTimeZone; - if (timeZone == null) { + public TimeZoneInfo Local + { + get + { + TimeZoneInfo timeZone = _localTimeZone; + if (timeZone == null) + { timeZone = CreateLocal(); } return timeZone; } } - // - // GetCorrespondingKind- - // - // Helper function that returns the corresponding DateTimeKind for this TimeZoneInfo - // - public DateTimeKind GetCorrespondingKind(TimeZoneInfo timeZone) { - DateTimeKind kind; - - // - // we check reference equality to see if 'this' is the same as - // TimeZoneInfo.Local or TimeZoneInfo.Utc. This check is needed to + /// <summary> + /// Helper function that returns the corresponding DateTimeKind for this TimeZoneInfo. + /// </summary> + public DateTimeKind GetCorrespondingKind(TimeZoneInfo timeZone) + { + // We check reference equality to see if 'this' is the same as + // TimeZoneInfo.Local or TimeZoneInfo.Utc. This check is needed to // support setting the DateTime Kind property to 'Local' or - // 'Utc' on the ConverTime(...) return value. + // 'Utc' on the ConverTime(...) return value. // - // Using reference equality instead of value equality was a + // Using reference equality instead of value equality was a // performance based design compromise. The reference equality // has much greater performance, but it reduces the number of // returned DateTime's that can be properly set as 'Local' or 'Utc'. @@ -187,244 +128,133 @@ namespace System { // in this example. Only when the user passes in TimeZoneInfo.Local or // TimeZoneInfo.Utc to the ConvertTime(...) methods will this check succeed. // - if ((object)timeZone == (object)s_utcTimeZone) { - kind = DateTimeKind.Utc; - } - else if ((object)timeZone == (object)m_localTimeZone) { - kind = DateTimeKind.Local; - } - else { - kind = DateTimeKind.Unspecified; - } - - return kind; - } - - public Dictionary<string, TimeZoneInfo> m_systemTimeZones; - public ReadOnlyCollection<TimeZoneInfo> m_readOnlySystemTimeZones; - public bool m_allSystemTimeZonesRead; - -#if FEATURE_WIN32_REGISTRY - private static TimeZoneInfo GetCurrentOneYearLocal() { - // load the data from the OS - TimeZoneInfo match; - - Win32Native.TimeZoneInformation timeZoneInformation = new Win32Native.TimeZoneInformation(); - long result = UnsafeNativeMethods.GetTimeZoneInformation(out timeZoneInformation); - if (result == Win32Native.TIME_ZONE_ID_INVALID) - match = CreateCustomTimeZone(c_localId, TimeSpan.Zero, c_localId, c_localId); - else - match = GetLocalTimeZoneFromWin32Data(timeZoneInformation, false); - return match; - } - - private volatile OffsetAndRule m_oneYearLocalFromUtc; - - public OffsetAndRule GetOneYearLocalFromUtc(int year) { - OffsetAndRule oneYearLocFromUtc = m_oneYearLocalFromUtc; - if (oneYearLocFromUtc == null || oneYearLocFromUtc.year != year) { - TimeZoneInfo currentYear = GetCurrentOneYearLocal(); - AdjustmentRule rule = currentYear.m_adjustmentRules == null ? null : currentYear.m_adjustmentRules[0]; - oneYearLocFromUtc = new OffsetAndRule(year, currentYear.BaseUtcOffset, rule); - m_oneYearLocalFromUtc = oneYearLocFromUtc; - } - return oneYearLocFromUtc; + return + ReferenceEquals(timeZone, s_utcTimeZone) ? DateTimeKind.Utc : + ReferenceEquals(timeZone, _localTimeZone) ? DateTimeKind.Local : + DateTimeKind.Unspecified; } -#endif // FEATURE_WIN32_REGISTRY + public Dictionary<string, TimeZoneInfo> _systemTimeZones; + public ReadOnlyCollection<TimeZoneInfo> _readOnlySystemTimeZones; + public bool _allSystemTimeZonesRead; }; #pragma warning restore 0420 - static CachedData s_cachedData = new CachedData(); - - private class OffsetAndRule { - public int year; - public TimeSpan offset; - public AdjustmentRule rule; - public OffsetAndRule(int year, TimeSpan offset, AdjustmentRule rule) { - this.year = year; - this.offset = offset; - this.rule = rule; - } - } - // used by GetUtcOffsetFromUtc (DateTime.Now, DateTime.ToLocalTime) for max/min whole-day range checks - private static DateTime s_maxDateOnly = new DateTime(9999, 12, 31); - private static DateTime s_minDateOnly = new DateTime(1, 1, 2); - - // ---- SECTION: public properties --------------* - - public String Id { - get { - return m_id; - } - } - - public String DisplayName { - get { - return (m_displayName == null ? String.Empty : m_displayName); - } - } + private static readonly DateTime s_maxDateOnly = new DateTime(9999, 12, 31); + private static readonly DateTime s_minDateOnly = new DateTime(1, 1, 2); - public String StandardName { - get { - return (m_standardDisplayName == null ? String.Empty : m_standardDisplayName); - } - } + public string Id => _id; - public String DaylightName { - get { - return (m_daylightDisplayName == null? String.Empty : m_daylightDisplayName); - } - } - - public TimeSpan BaseUtcOffset { - get { - return m_baseUtcOffset; - } - } + public string DisplayName => _displayName ?? string.Empty; - public Boolean SupportsDaylightSavingTime { - get { - return m_supportsDaylightSavingTime; - } - } + public string StandardName => _standardDisplayName ?? string.Empty; -#if PLATFORM_UNIX - // The rules we use in Unix cares mostly about the start and end dates but doesn’t fill the transition start and end info. - // as the rules now is public, we should fill it properly so the caller doesn’t have to know how we use it internally - // and can use it as it is used in Windows + public string DaylightName => _daylightDisplayName ?? string.Empty; - private AdjustmentRule[] GetFilledRules() - { - Debug.Assert(m_adjustmentRules != null, "m_adjustmentRules expected to be not null"); - AdjustmentRule[] rules = new AdjustmentRule[m_adjustmentRules.Length]; + public TimeSpan BaseUtcOffset => _baseUtcOffset; - for (int i = 0; i < m_adjustmentRules.Length; i++) - { - var rule = m_adjustmentRules[i]; - var start = rule.DateStart.Kind == DateTimeKind.Utc ? - new DateTime(TimeZoneInfo.ConvertTime(rule.DateStart, this).Ticks, DateTimeKind.Unspecified) : - rule.DateStart; - var end = rule.DateEnd.Kind == DateTimeKind.Utc ? - new DateTime(TimeZoneInfo.ConvertTime(rule.DateEnd, this).Ticks - 1, DateTimeKind.Unspecified) : - rule.DateEnd; - - var startTransition = TimeZoneInfo.TransitionTime.CreateFixedDateRule(new DateTime(1, 1, 1, start.Hour, start.Minute, start.Second), start.Month, start.Day); - var endTransition = TimeZoneInfo.TransitionTime.CreateFixedDateRule(new DateTime(1, 1, 1, end.Hour, end.Minute, end.Second), end.Month, end.Day); - - rules[i] = TimeZoneInfo.AdjustmentRule.CreateAdjustmentRule(start.Date, end.Date, rule.DaylightDelta, startTransition, endTransition); - } + public bool SupportsDaylightSavingTime => _supportsDaylightSavingTime; - return rules; - } -#endif // PLATFORM_UNIX - - // ---- SECTION: public methods --------------* - // - // GetAdjustmentRules - - // - // returns a cloned array of AdjustmentRule objects - // - public AdjustmentRule [] GetAdjustmentRules() + /// <summary> + /// Returns an array of TimeSpan objects representing all of + /// possible UTC offset values for this ambiguous time. + /// </summary> + public TimeSpan[] GetAmbiguousTimeOffsets(DateTimeOffset dateTimeOffset) { - if (m_adjustmentRules == null) - { - return Array.Empty<AdjustmentRule>(); - } - else + if (!SupportsDaylightSavingTime) { -#if PLATFORM_UNIX - return GetFilledRules(); -#else - return (AdjustmentRule[]) m_adjustmentRules.Clone(); -#endif // PLATFORM_UNIX - } - } - - // - // GetAmbiguousTimeOffsets - - // - // returns an array of TimeSpan objects representing all of - // possible UTC offset values for this ambiguous time - // - public TimeSpan[] GetAmbiguousTimeOffsets(DateTimeOffset dateTimeOffset) { - if (!SupportsDaylightSavingTime) { throw new ArgumentException(Environment.GetResourceString("Argument_DateTimeOffsetIsNotAmbiguous"), nameof(dateTimeOffset)); } Contract.EndContractBlock(); - DateTime adjustedTime = (TimeZoneInfo.ConvertTime(dateTimeOffset, this)).DateTime; + DateTime adjustedTime = ConvertTime(dateTimeOffset, this).DateTime; - Boolean isAmbiguous = false; + bool isAmbiguous = false; AdjustmentRule rule = GetAdjustmentRuleForAmbiguousOffsets(adjustedTime); - if (rule != null && rule.HasDaylightSaving) { + if (rule != null && rule.HasDaylightSaving) + { DaylightTimeStruct daylightTime = GetDaylightTime(adjustedTime.Year, rule); isAmbiguous = GetIsAmbiguousTime(adjustedTime, rule, daylightTime); } - if (!isAmbiguous) { + if (!isAmbiguous) + { throw new ArgumentException(Environment.GetResourceString("Argument_DateTimeOffsetIsNotAmbiguous"), nameof(dateTimeOffset)); } // the passed in dateTime is ambiguous in this TimeZoneInfo instance TimeSpan[] timeSpans = new TimeSpan[2]; - TimeSpan actualUtcOffset = m_baseUtcOffset + rule.BaseUtcOffsetDelta; + TimeSpan actualUtcOffset = _baseUtcOffset + rule.BaseUtcOffsetDelta; // the TimeSpan array must be sorted from least to greatest - if (rule.DaylightDelta > TimeSpan.Zero) { + if (rule.DaylightDelta > TimeSpan.Zero) + { timeSpans[0] = actualUtcOffset; // FUTURE: + rule.StandardDelta; timeSpans[1] = actualUtcOffset + rule.DaylightDelta; - } - else { + } + else + { timeSpans[0] = actualUtcOffset + rule.DaylightDelta; timeSpans[1] = actualUtcOffset; // FUTURE: + rule.StandardDelta; } return timeSpans; } - - public TimeSpan[] GetAmbiguousTimeOffsets(DateTime dateTime) { - if (!SupportsDaylightSavingTime) { + /// <summary> + /// Returns an array of TimeSpan objects representing all of + /// possible UTC offset values for this ambiguous time. + /// </summary> + public TimeSpan[] GetAmbiguousTimeOffsets(DateTime dateTime) + { + if (!SupportsDaylightSavingTime) + { throw new ArgumentException(Environment.GetResourceString("Argument_DateTimeIsNotAmbiguous"), nameof(dateTime)); } Contract.EndContractBlock(); DateTime adjustedTime; - if (dateTime.Kind == DateTimeKind.Local) { + if (dateTime.Kind == DateTimeKind.Local) + { CachedData cachedData = s_cachedData; - adjustedTime = TimeZoneInfo.ConvertTime(dateTime, cachedData.Local, this, TimeZoneInfoOptions.None, cachedData); + adjustedTime = ConvertTime(dateTime, cachedData.Local, this, TimeZoneInfoOptions.None, cachedData); } - else if (dateTime.Kind == DateTimeKind.Utc) { + else if (dateTime.Kind == DateTimeKind.Utc) + { CachedData cachedData = s_cachedData; - adjustedTime = TimeZoneInfo.ConvertTime(dateTime, s_utcTimeZone, this, TimeZoneInfoOptions.None, cachedData); + adjustedTime = ConvertTime(dateTime, s_utcTimeZone, this, TimeZoneInfoOptions.None, cachedData); } - else { + else + { adjustedTime = dateTime; } - Boolean isAmbiguous = false; + bool isAmbiguous = false; AdjustmentRule rule = GetAdjustmentRuleForAmbiguousOffsets(adjustedTime); - if (rule != null && rule.HasDaylightSaving) { + if (rule != null && rule.HasDaylightSaving) + { DaylightTimeStruct daylightTime = GetDaylightTime(adjustedTime.Year, rule); isAmbiguous = GetIsAmbiguousTime(adjustedTime, rule, daylightTime); } - if (!isAmbiguous) { + if (!isAmbiguous) + { throw new ArgumentException(Environment.GetResourceString("Argument_DateTimeIsNotAmbiguous"), nameof(dateTime)); } // the passed in dateTime is ambiguous in this TimeZoneInfo instance TimeSpan[] timeSpans = new TimeSpan[2]; - TimeSpan actualUtcOffset = m_baseUtcOffset + rule.BaseUtcOffsetDelta; - + TimeSpan actualUtcOffset = _baseUtcOffset + rule.BaseUtcOffsetDelta; + // the TimeSpan array must be sorted from least to greatest - if (rule.DaylightDelta > TimeSpan.Zero) { + if (rule.DaylightDelta > TimeSpan.Zero) + { timeSpans[0] = actualUtcOffset; // FUTURE: + rule.StandardDelta; timeSpans[1] = actualUtcOffset + rule.DaylightDelta; - } - else { + } + else + { timeSpans[0] = actualUtcOffset + rule.DaylightDelta; timeSpans[1] = actualUtcOffset; // FUTURE: + rule.StandardDelta; } @@ -448,55 +278,58 @@ namespace System { /// <summary> /// Gets the AdjustmentRule that is immediately preceeding the specified rule. - /// If the specified rule is the first AdjustmentRule, or it isn't in m_adjustmentRules, + /// If the specified rule is the first AdjustmentRule, or it isn't in _adjustmentRules, /// then the specified rule is returned. /// </summary> private AdjustmentRule GetPreviousAdjustmentRule(AdjustmentRule rule) { AdjustmentRule result = rule; - for (int i = 1; i < m_adjustmentRules.Length; i++) + for (int i = 1; i < _adjustmentRules.Length; i++) { - if (rule.Equals(m_adjustmentRules[i])) + if (rule.Equals(_adjustmentRules[i])) { - result = m_adjustmentRules[i - 1]; + result = _adjustmentRules[i - 1]; break; } } return result; } - // - // GetUtcOffset - - // - // returns the Universal Coordinated Time (UTC) Offset - // for the current TimeZoneInfo instance. - // - public TimeSpan GetUtcOffset(DateTimeOffset dateTimeOffset) { - return GetUtcOffsetFromUtc(dateTimeOffset.UtcDateTime, this); - } - + /// <summary> + /// Returns the Universal Coordinated Time (UTC) Offset for the current TimeZoneInfo instance. + /// </summary> + public TimeSpan GetUtcOffset(DateTimeOffset dateTimeOffset) => + GetUtcOffsetFromUtc(dateTimeOffset.UtcDateTime, this); - public TimeSpan GetUtcOffset(DateTime dateTime) { - return GetUtcOffset(dateTime, TimeZoneInfoOptions.NoThrowOnInvalidTime, s_cachedData); - } + /// <summary> + /// Returns the Universal Coordinated Time (UTC) Offset for the current TimeZoneInfo instance. + /// </summary> + public TimeSpan GetUtcOffset(DateTime dateTime) => + GetUtcOffset(dateTime, TimeZoneInfoOptions.NoThrowOnInvalidTime, s_cachedData); // Shortcut for TimeZoneInfo.Local.GetUtcOffset - internal static TimeSpan GetLocalUtcOffset(DateTime dateTime, TimeZoneInfoOptions flags) { + internal static TimeSpan GetLocalUtcOffset(DateTime dateTime, TimeZoneInfoOptions flags) + { CachedData cachedData = s_cachedData; return cachedData.Local.GetUtcOffset(dateTime, flags, cachedData); } - internal TimeSpan GetUtcOffset(DateTime dateTime, TimeZoneInfoOptions flags) { - return GetUtcOffset(dateTime, flags, s_cachedData); - } + /// <summary> + /// Returns the Universal Coordinated Time (UTC) Offset for the current TimeZoneInfo instance. + /// </summary> + internal TimeSpan GetUtcOffset(DateTime dateTime, TimeZoneInfoOptions flags) => + GetUtcOffset(dateTime, flags, s_cachedData); - private TimeSpan GetUtcOffset(DateTime dateTime, TimeZoneInfoOptions flags, CachedData cachedData) { - if (dateTime.Kind == DateTimeKind.Local) { - if (cachedData.GetCorrespondingKind(this) != DateTimeKind.Local) { + private TimeSpan GetUtcOffset(DateTime dateTime, TimeZoneInfoOptions flags, CachedData cachedData) + { + if (dateTime.Kind == DateTimeKind.Local) + { + if (cachedData.GetCorrespondingKind(this) != DateTimeKind.Local) + { // // normal case of converting from Local to Utc and then getting the offset from the UTC DateTime // - DateTime adjustedTime = TimeZoneInfo.ConvertTime(dateTime, cachedData.Local, s_utcTimeZone, flags); + DateTime adjustedTime = ConvertTime(dateTime, cachedData.Local, s_utcTimeZone, flags); return GetUtcOffsetFromUtc(adjustedTime, this); } @@ -507,7 +340,7 @@ namespace System { // Consider the invalid PST time "2007-03-11T02:00:00.0000000-08:00" // // By directly calling GetUtcOffset instead of converting to UTC and then calling GetUtcOffsetFromUtc - // the correct invalid offset of "-08:00" is returned. In the normal case of converting to UTC as an + // the correct invalid offset of "-08:00" is returned. In the normal case of converting to UTC as an // interim-step, the invalid time is adjusted into a *valid* UTC time which causes a change in output: // // 1) invalid PST time "2007-03-11T02:00:00.0000000-08:00" @@ -515,11 +348,14 @@ namespace System { // 3) offset returned "2007-03-11T03:00:00.0000000-07:00" // } - else if (dateTime.Kind == DateTimeKind.Utc) { - if (cachedData.GetCorrespondingKind(this) == DateTimeKind.Utc) { - return m_baseUtcOffset; + else if (dateTime.Kind == DateTimeKind.Utc) + { + if (cachedData.GetCorrespondingKind(this) == DateTimeKind.Utc) + { + return _baseUtcOffset; } - else { + else + { // // passing in a UTC dateTime to a non-UTC TimeZoneInfo instance is a // special Loss-Less case. @@ -531,90 +367,93 @@ namespace System { return GetUtcOffset(dateTime, this, flags); } - // - // IsAmbiguousTime - - // - // returns true if the time is during the ambiguous time period - // for the current TimeZoneInfo instance. - // - public Boolean IsAmbiguousTime(DateTimeOffset dateTimeOffset) { - if (!m_supportsDaylightSavingTime) { + /// <summary> + /// Returns true if the time is during the ambiguous time period + /// for the current TimeZoneInfo instance. + /// </summary> + public bool IsAmbiguousTime(DateTimeOffset dateTimeOffset) + { + if (!_supportsDaylightSavingTime) + { return false; } - DateTimeOffset adjustedTime = TimeZoneInfo.ConvertTime(dateTimeOffset, this); + DateTimeOffset adjustedTime = ConvertTime(dateTimeOffset, this); return IsAmbiguousTime(adjustedTime.DateTime); } + /// <summary> + /// Returns true if the time is during the ambiguous time period + /// for the current TimeZoneInfo instance. + /// </summary> + public bool IsAmbiguousTime(DateTime dateTime) => + IsAmbiguousTime(dateTime, TimeZoneInfoOptions.NoThrowOnInvalidTime); - public Boolean IsAmbiguousTime(DateTime dateTime) { - return IsAmbiguousTime(dateTime, TimeZoneInfoOptions.NoThrowOnInvalidTime); - } - - internal Boolean IsAmbiguousTime(DateTime dateTime, TimeZoneInfoOptions flags) { - if (!m_supportsDaylightSavingTime) { + /// <summary> + /// Returns true if the time is during the ambiguous time period + /// for the current TimeZoneInfo instance. + /// </summary> + internal bool IsAmbiguousTime(DateTime dateTime, TimeZoneInfoOptions flags) + { + if (!_supportsDaylightSavingTime) + { return false; } - DateTime adjustedTime; - if (dateTime.Kind == DateTimeKind.Local) { - CachedData cachedData = s_cachedData; - adjustedTime = TimeZoneInfo.ConvertTime(dateTime, cachedData.Local, this, flags, cachedData); - } - else if (dateTime.Kind == DateTimeKind.Utc) { - CachedData cachedData = s_cachedData; - adjustedTime = TimeZoneInfo.ConvertTime(dateTime, s_utcTimeZone, this, flags, cachedData); - } - else { - adjustedTime = dateTime; - } + CachedData cachedData = s_cachedData; + DateTime adjustedTime = + dateTime.Kind == DateTimeKind.Local ? ConvertTime(dateTime, cachedData.Local, this, flags, cachedData) : + dateTime.Kind == DateTimeKind.Utc ? ConvertTime(dateTime, s_utcTimeZone, this, flags, cachedData) : + dateTime; AdjustmentRule rule = GetAdjustmentRuleForTime(adjustedTime); - if (rule != null && rule.HasDaylightSaving) { + if (rule != null && rule.HasDaylightSaving) + { DaylightTimeStruct daylightTime = GetDaylightTime(adjustedTime.Year, rule); return GetIsAmbiguousTime(adjustedTime, rule, daylightTime); } return false; } - - - // - // IsDaylightSavingTime - - // - // Returns true if the time is during Daylight Saving time - // for the current TimeZoneInfo instance. - // - public Boolean IsDaylightSavingTime(DateTimeOffset dateTimeOffset) { - Boolean isDaylightSavingTime; + /// <summary> + /// Returns true if the time is during Daylight Saving time for the current TimeZoneInfo instance. + /// </summary> + public bool IsDaylightSavingTime(DateTimeOffset dateTimeOffset) + { + bool isDaylightSavingTime; GetUtcOffsetFromUtc(dateTimeOffset.UtcDateTime, this, out isDaylightSavingTime); return isDaylightSavingTime; } + /// <summary> + /// Returns true if the time is during Daylight Saving time for the current TimeZoneInfo instance. + /// </summary> + public bool IsDaylightSavingTime(DateTime dateTime) => + IsDaylightSavingTime(dateTime, TimeZoneInfoOptions.NoThrowOnInvalidTime, s_cachedData); - public Boolean IsDaylightSavingTime(DateTime dateTime) { - return IsDaylightSavingTime(dateTime, TimeZoneInfoOptions.NoThrowOnInvalidTime, s_cachedData); - } - - internal Boolean IsDaylightSavingTime(DateTime dateTime, TimeZoneInfoOptions flags) { - return IsDaylightSavingTime(dateTime, flags, s_cachedData); - } + /// <summary> + /// Returns true if the time is during Daylight Saving time for the current TimeZoneInfo instance. + /// </summary> + internal bool IsDaylightSavingTime(DateTime dateTime, TimeZoneInfoOptions flags) => + IsDaylightSavingTime(dateTime, flags, s_cachedData); - private Boolean IsDaylightSavingTime(DateTime dateTime, TimeZoneInfoOptions flags, CachedData cachedData) { + private bool IsDaylightSavingTime(DateTime dateTime, TimeZoneInfoOptions flags, CachedData cachedData) + { // // dateTime.Kind is UTC, then time will be converted from UTC // into current instance's timezone - // dateTime.Kind is Local, then time will be converted from Local + // dateTime.Kind is Local, then time will be converted from Local // into current instance's timezone // dateTime.Kind is UnSpecified, then time is already in // current instance's timezone // // Our DateTime handles ambiguous times, (one is in the daylight and - // one is in standard.) If a new DateTime is constructed during ambiguous + // one is in standard.) If a new DateTime is constructed during ambiguous // time, it is defaulted to "Standard" (i.e. this will return false). // For Invalid times, we will return false - if (!m_supportsDaylightSavingTime || m_adjustmentRules == null) { + if (!_supportsDaylightSavingTime || _adjustmentRules == null) + { return false; } @@ -622,25 +461,30 @@ namespace System { // // handle any Local/Utc special cases... // - if (dateTime.Kind == DateTimeKind.Local) { - adjustedTime = TimeZoneInfo.ConvertTime(dateTime, cachedData.Local, this, flags, cachedData); - } - else if (dateTime.Kind == DateTimeKind.Utc) { - if (cachedData.GetCorrespondingKind(this) == DateTimeKind.Utc) { + if (dateTime.Kind == DateTimeKind.Local) + { + adjustedTime = ConvertTime(dateTime, cachedData.Local, this, flags, cachedData); + } + else if (dateTime.Kind == DateTimeKind.Utc) + { + if (cachedData.GetCorrespondingKind(this) == DateTimeKind.Utc) + { // simple always false case: TimeZoneInfo.Utc.IsDaylightSavingTime(dateTime, flags); return false; } - else { + else + { // // passing in a UTC dateTime to a non-UTC TimeZoneInfo instance is a // special Loss-Less case. // - Boolean isDaylightSavings; + bool isDaylightSavings; GetUtcOffsetFromUtc(dateTime, this, out isDaylightSavings); return isDaylightSavings; } } - else { + else + { adjustedTime = dateTime; } @@ -648,35 +492,38 @@ namespace System { // handle the normal cases... // AdjustmentRule rule = GetAdjustmentRuleForTime(adjustedTime); - if (rule != null && rule.HasDaylightSaving) { + if (rule != null && rule.HasDaylightSaving) + { DaylightTimeStruct daylightTime = GetDaylightTime(adjustedTime.Year, rule); return GetIsDaylightSavings(adjustedTime, rule, daylightTime, flags); } - else { + else + { return false; } } + /// <summary> + /// Returns true when dateTime falls into a "hole in time". + /// </summary> + public bool IsInvalidTime(DateTime dateTime) + { + bool isInvalid = false; - // - // IsInvalidTime - - // - // returns true when dateTime falls into a "hole in time". - // - public Boolean IsInvalidTime(DateTime dateTime) { - Boolean isInvalid = false; - - if ( (dateTime.Kind == DateTimeKind.Unspecified) - || (dateTime.Kind == DateTimeKind.Local && s_cachedData.GetCorrespondingKind(this) == DateTimeKind.Local) ) { + if ((dateTime.Kind == DateTimeKind.Unspecified) || + (dateTime.Kind == DateTimeKind.Local && s_cachedData.GetCorrespondingKind(this) == DateTimeKind.Local)) + { // only check Unspecified and (Local when this TimeZoneInfo instance is Local) AdjustmentRule rule = GetAdjustmentRuleForTime(dateTime); - if (rule != null && rule.HasDaylightSaving) { + if (rule != null && rule.HasDaylightSaving) + { DaylightTimeStruct daylightTime = GetDaylightTime(dateTime.Year, rule); isInvalid = GetIsInvalidTime(dateTime, rule, daylightTime); } - else { + else + { isInvalid = false; } } @@ -684,35 +531,33 @@ namespace System { return isInvalid; } - - // - // ClearCachedData - - // - // Clears data from static members - // - static public void ClearCachedData() { + /// <summary> + /// Clears data from static members. + /// </summary> + public static void ClearCachedData() + { // Clear a fresh instance of cached data s_cachedData = new CachedData(); } - // - // ConvertTimeBySystemTimeZoneId - - // - // Converts the value of a DateTime object from sourceTimeZone to destinationTimeZone - // - static public DateTimeOffset ConvertTimeBySystemTimeZoneId(DateTimeOffset dateTimeOffset, String destinationTimeZoneId) - { - return ConvertTime(dateTimeOffset, FindSystemTimeZoneById(destinationTimeZoneId)); - } + /// <summary> + /// Converts the value of a DateTime object from sourceTimeZone to destinationTimeZone. + /// </summary> + public static DateTimeOffset ConvertTimeBySystemTimeZoneId(DateTimeOffset dateTimeOffset, string destinationTimeZoneId) => + ConvertTime(dateTimeOffset, FindSystemTimeZoneById(destinationTimeZoneId)); - static public DateTime ConvertTimeBySystemTimeZoneId(DateTime dateTime, String destinationTimeZoneId) - { - return ConvertTime(dateTime, FindSystemTimeZoneById(destinationTimeZoneId)); - } + /// <summary> + /// Converts the value of a DateTime object from sourceTimeZone to destinationTimeZone. + /// </summary> + public static DateTime ConvertTimeBySystemTimeZoneId(DateTime dateTime, string destinationTimeZoneId) => + ConvertTime(dateTime, FindSystemTimeZoneById(destinationTimeZoneId)); - static public DateTime ConvertTimeBySystemTimeZoneId(DateTime dateTime, String sourceTimeZoneId, String destinationTimeZoneId) + /// <summary> + /// Converts the value of a DateTime object from sourceTimeZone to destinationTimeZone. + /// </summary> + public static DateTime ConvertTimeBySystemTimeZoneId(DateTime dateTime, string sourceTimeZoneId, string destinationTimeZoneId) { - if (dateTime.Kind == DateTimeKind.Local && String.Compare(sourceTimeZoneId, TimeZoneInfo.Local.Id, StringComparison.OrdinalIgnoreCase) == 0) + if (dateTime.Kind == DateTimeKind.Local && string.Equals(sourceTimeZoneId, Local.Id, StringComparison.OrdinalIgnoreCase)) { // TimeZoneInfo.Local can be cleared by another thread calling TimeZoneInfo.ClearCachedData. // Take snapshot of cached data to guarantee this method will not be impacted by the ClearCachedData call. @@ -721,16 +566,10 @@ namespace System { // CachedData cachedData = s_cachedData; return ConvertTime(dateTime, cachedData.Local, FindSystemTimeZoneById(destinationTimeZoneId), TimeZoneInfoOptions.None, cachedData); - } - else if (dateTime.Kind == DateTimeKind.Utc && String.Compare(sourceTimeZoneId, TimeZoneInfo.Utc.Id, StringComparison.OrdinalIgnoreCase) == 0) + } + else if (dateTime.Kind == DateTimeKind.Utc && string.Equals(sourceTimeZoneId, Utc.Id, StringComparison.OrdinalIgnoreCase)) { - // TimeZoneInfo.Utc can be cleared by another thread calling TimeZoneInfo.ClearCachedData. - // Take snapshot of cached data to guarantee this method will not be impacted by the ClearCachedData call. - // Without the snapshot, there is a chance that ConvertTime will throw since 'source' won't - // be reference equal to the new TimeZoneInfo.Utc - // - CachedData cachedData = s_cachedData; - return ConvertTime(dateTime, s_utcTimeZone, FindSystemTimeZoneById(destinationTimeZoneId), TimeZoneInfoOptions.None, cachedData); + return ConvertTime(dateTime, s_utcTimeZone, FindSystemTimeZoneById(destinationTimeZoneId), TimeZoneInfoOptions.None, s_cachedData); } else { @@ -738,77 +577,80 @@ namespace System { } } - // - // ConvertTime - - // - // Converts the value of the dateTime object from sourceTimeZone to destinationTimeZone - // - - static public DateTimeOffset ConvertTime(DateTimeOffset dateTimeOffset, TimeZoneInfo destinationTimeZone) { - if (destinationTimeZone == null) { + /// <summary> + /// Converts the value of the dateTime object from sourceTimeZone to destinationTimeZone + /// </summary> + public static DateTimeOffset ConvertTime(DateTimeOffset dateTimeOffset, TimeZoneInfo destinationTimeZone) + { + if (destinationTimeZone == null) + { throw new ArgumentNullException(nameof(destinationTimeZone)); } - Contract.EndContractBlock(); + // calculate the destination time zone offset DateTime utcDateTime = dateTimeOffset.UtcDateTime; TimeSpan destinationOffset = GetUtcOffsetFromUtc(utcDateTime, destinationTimeZone); // check for overflow - Int64 ticks = utcDateTime.Ticks + destinationOffset.Ticks; + long ticks = utcDateTime.Ticks + destinationOffset.Ticks; - if (ticks > DateTimeOffset.MaxValue.Ticks) { - return DateTimeOffset.MaxValue; - } - else if (ticks < DateTimeOffset.MinValue.Ticks) { - return DateTimeOffset.MinValue; - } - else { - return new DateTimeOffset(ticks, destinationOffset); - } + return + ticks > DateTimeOffset.MaxValue.Ticks ? DateTimeOffset.MaxValue : + ticks < DateTimeOffset.MinValue.Ticks ? DateTimeOffset.MinValue : + new DateTimeOffset(ticks, destinationOffset); } - static public DateTime ConvertTime(DateTime dateTime, TimeZoneInfo destinationTimeZone) { - if (destinationTimeZone == null) { + /// <summary> + /// Converts the value of the dateTime object from sourceTimeZone to destinationTimeZone + /// </summary> + public static DateTime ConvertTime(DateTime dateTime, TimeZoneInfo destinationTimeZone) + { + if (destinationTimeZone == null) + { throw new ArgumentNullException(nameof(destinationTimeZone)); } Contract.EndContractBlock(); // Special case to give a way clearing the cache without exposing ClearCachedData() - if (dateTime.Ticks == 0) { + if (dateTime.Ticks == 0) + { ClearCachedData(); } CachedData cachedData = s_cachedData; - if (dateTime.Kind == DateTimeKind.Utc) { - return ConvertTime(dateTime, s_utcTimeZone, destinationTimeZone, TimeZoneInfoOptions.None, cachedData); - } - else { - return ConvertTime(dateTime, cachedData.Local, destinationTimeZone, TimeZoneInfoOptions.None, cachedData); - } - } - - static public DateTime ConvertTime(DateTime dateTime, TimeZoneInfo sourceTimeZone, TimeZoneInfo destinationTimeZone) { - return ConvertTime(dateTime, sourceTimeZone, destinationTimeZone, TimeZoneInfoOptions.None, s_cachedData); + TimeZoneInfo sourceTimeZone = dateTime.Kind == DateTimeKind.Utc ? s_utcTimeZone : cachedData.Local; + return ConvertTime(dateTime, sourceTimeZone, destinationTimeZone, TimeZoneInfoOptions.None, cachedData); } + /// <summary> + /// Converts the value of the dateTime object from sourceTimeZone to destinationTimeZone + /// </summary> + public static DateTime ConvertTime(DateTime dateTime, TimeZoneInfo sourceTimeZone, TimeZoneInfo destinationTimeZone) => + ConvertTime(dateTime, sourceTimeZone, destinationTimeZone, TimeZoneInfoOptions.None, s_cachedData); - static internal DateTime ConvertTime(DateTime dateTime, TimeZoneInfo sourceTimeZone, TimeZoneInfo destinationTimeZone, TimeZoneInfoOptions flags) { - return ConvertTime(dateTime, sourceTimeZone, destinationTimeZone, flags, s_cachedData); - } + /// <summary> + /// Converts the value of the dateTime object from sourceTimeZone to destinationTimeZone + /// </summary> + internal static DateTime ConvertTime(DateTime dateTime, TimeZoneInfo sourceTimeZone, TimeZoneInfo destinationTimeZone, TimeZoneInfoOptions flags) => + ConvertTime(dateTime, sourceTimeZone, destinationTimeZone, flags, s_cachedData); - static private DateTime ConvertTime(DateTime dateTime, TimeZoneInfo sourceTimeZone, TimeZoneInfo destinationTimeZone, TimeZoneInfoOptions flags, CachedData cachedData) { - if (sourceTimeZone == null) { + private static DateTime ConvertTime(DateTime dateTime, TimeZoneInfo sourceTimeZone, TimeZoneInfo destinationTimeZone, TimeZoneInfoOptions flags, CachedData cachedData) + { + if (sourceTimeZone == null) + { throw new ArgumentNullException(nameof(sourceTimeZone)); } - if (destinationTimeZone == null) { + if (destinationTimeZone == null) + { throw new ArgumentNullException(nameof(destinationTimeZone)); } Contract.EndContractBlock(); DateTimeKind sourceKind = cachedData.GetCorrespondingKind(sourceTimeZone); - if ( ((flags & TimeZoneInfoOptions.NoThrowOnInvalidTime) == 0) && (dateTime.Kind != DateTimeKind.Unspecified) && (dateTime.Kind != sourceKind) ) { - throw new ArgumentException(Environment.GetResourceString("Argument_ConvertMismatch"), nameof(sourceTimeZone)); + if (((flags & TimeZoneInfoOptions.NoThrowOnInvalidTime) == 0) && (dateTime.Kind != DateTimeKind.Unspecified) && (dateTime.Kind != sourceKind)) + { + throw new ArgumentException(Environment.GetResourceString("Argument_ConvertMismatch"), nameof(sourceTimeZone)); } // @@ -822,15 +664,18 @@ namespace System { AdjustmentRule sourceRule = sourceTimeZone.GetAdjustmentRuleForTime(dateTime); TimeSpan sourceOffset = sourceTimeZone.BaseUtcOffset; - if (sourceRule != null) { + if (sourceRule != null) + { sourceOffset = sourceOffset + sourceRule.BaseUtcOffsetDelta; - if (sourceRule.HasDaylightSaving) { - Boolean sourceIsDaylightSavings = false; + if (sourceRule.HasDaylightSaving) + { + bool sourceIsDaylightSavings = false; DaylightTimeStruct sourceDaylightTime = sourceTimeZone.GetDaylightTime(dateTime.Year, sourceRule); // 'dateTime' might be in an invalid time range since it is in an AdjustmentRule - // period that supports DST - if (((flags & TimeZoneInfoOptions.NoThrowOnInvalidTime) == 0) && GetIsInvalidTime(dateTime, sourceRule, sourceDaylightTime)) { + // period that supports DST + if (((flags & TimeZoneInfoOptions.NoThrowOnInvalidTime) == 0) && GetIsInvalidTime(dateTime, sourceRule, sourceDaylightTime)) + { throw new ArgumentException(Environment.GetResourceString("Argument_DateTimeIsInvalid"), nameof(dateTime)); } sourceIsDaylightSavings = GetIsDaylightSavings(dateTime, sourceRule, sourceDaylightTime, flags); @@ -843,91 +688,86 @@ namespace System { DateTimeKind targetKind = cachedData.GetCorrespondingKind(destinationTimeZone); // handle the special case of Loss-less Local->Local and UTC->UTC) - if (dateTime.Kind != DateTimeKind.Unspecified && sourceKind != DateTimeKind.Unspecified - && sourceKind == targetKind) { + if (dateTime.Kind != DateTimeKind.Unspecified && sourceKind != DateTimeKind.Unspecified && sourceKind == targetKind) + { return dateTime; } - Int64 utcTicks = dateTime.Ticks - sourceOffset.Ticks; + long utcTicks = dateTime.Ticks - sourceOffset.Ticks; // handle the normal case by converting from 'source' to UTC and then to 'target' - Boolean isAmbiguousLocalDst = false; + bool isAmbiguousLocalDst; DateTime targetConverted = ConvertUtcToTimeZone(utcTicks, destinationTimeZone, out isAmbiguousLocalDst); - - if (targetKind == DateTimeKind.Local) { - // Because the ticks conversion between UTC and local is lossy, we need to capture whether the + + if (targetKind == DateTimeKind.Local) + { + // 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. - return new DateTime(targetConverted.Ticks, DateTimeKind.Local, isAmbiguousLocalDst); + return new DateTime(targetConverted.Ticks, DateTimeKind.Local, isAmbiguousLocalDst); } - else { + else + { return new DateTime(targetConverted.Ticks, targetKind); } } + /// <summary> + /// Converts the value of a DateTime object from Coordinated Universal Time (UTC) to the destinationTimeZone. + /// </summary> + public static DateTime ConvertTimeFromUtc(DateTime dateTime, TimeZoneInfo destinationTimeZone) => + ConvertTime(dateTime, s_utcTimeZone, destinationTimeZone, TimeZoneInfoOptions.None, s_cachedData); - - // - // ConvertTimeFromUtc - - // - // Converts the value of a DateTime object from Coordinated Universal Time (UTC) to - // the destinationTimeZone. - // - static public DateTime ConvertTimeFromUtc(DateTime dateTime, TimeZoneInfo destinationTimeZone) { - CachedData cachedData = s_cachedData; - return ConvertTime(dateTime, s_utcTimeZone, destinationTimeZone, TimeZoneInfoOptions.None, cachedData); - } - - - // - // ConvertTimeToUtc - - // - // Converts the value of a DateTime object to Coordinated Universal Time (UTC). - // - static public DateTime ConvertTimeToUtc(DateTime dateTime) { - if (dateTime.Kind == DateTimeKind.Utc) { + /// <summary> + /// Converts the value of a DateTime object to Coordinated Universal Time (UTC). + /// </summary> + public static DateTime ConvertTimeToUtc(DateTime dateTime) + { + if (dateTime.Kind == DateTimeKind.Utc) + { return dateTime; } CachedData cachedData = s_cachedData; return ConvertTime(dateTime, cachedData.Local, s_utcTimeZone, TimeZoneInfoOptions.None, cachedData); } - - static internal DateTime ConvertTimeToUtc(DateTime dateTime, TimeZoneInfoOptions flags) { - if (dateTime.Kind == DateTimeKind.Utc) { + /// <summary> + /// Converts the value of a DateTime object to Coordinated Universal Time (UTC). + /// </summary> + internal static DateTime ConvertTimeToUtc(DateTime dateTime, TimeZoneInfoOptions flags) + { + if (dateTime.Kind == DateTimeKind.Utc) + { return dateTime; } CachedData cachedData = s_cachedData; return ConvertTime(dateTime, cachedData.Local, s_utcTimeZone, flags, cachedData); } - static public DateTime ConvertTimeToUtc(DateTime dateTime, TimeZoneInfo sourceTimeZone) { - CachedData cachedData = s_cachedData; - return ConvertTime(dateTime, sourceTimeZone, s_utcTimeZone, TimeZoneInfoOptions.None, cachedData); - } - + /// <summary> + /// Converts the value of a DateTime object to Coordinated Universal Time (UTC). + /// </summary> + public static DateTime ConvertTimeToUtc(DateTime dateTime, TimeZoneInfo sourceTimeZone) => + ConvertTime(dateTime, sourceTimeZone, s_utcTimeZone, TimeZoneInfoOptions.None, s_cachedData); - // - // IEquatable.Equals - - // - // returns value equality. Equals does not compare any localizable - // String objects (DisplayName, StandardName, DaylightName). - // - public bool Equals(TimeZoneInfo other) { - return (other != null && String.Compare(this.m_id, other.m_id, StringComparison.OrdinalIgnoreCase) == 0 && HasSameRules(other)); - } + /// <summary> + /// Returns value equality. Equals does not compare any localizable + /// String objects (DisplayName, StandardName, DaylightName). + /// </summary> + public bool Equals(TimeZoneInfo other) => + other != null && + string.Equals(_id, other._id, StringComparison.OrdinalIgnoreCase) && + HasSameRules(other); - public override bool Equals(object obj) { - return Equals(obj as TimeZoneInfo); - } + public override bool Equals(object obj) => Equals(obj as TimeZoneInfo); - // - // FromSerializedString - - // - static public TimeZoneInfo FromSerializedString(string source) { - if (source == null) { + public static TimeZoneInfo FromSerializedString(string source) + { + if (source == null) + { throw new ArgumentNullException(nameof(source)); } - if (source.Length == 0) { + if (source.Length == 0) + { throw new ArgumentException(Environment.GetResourceString("Argument_InvalidSerializedString", source), nameof(source)); } Contract.EndContractBlock(); @@ -935,42 +775,33 @@ namespace System { return StringSerializer.GetDeserializedTimeZoneInfo(source); } + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(_id); - // - // GetHashCode - - // - public override int GetHashCode() { - return StringComparer.OrdinalIgnoreCase.GetHashCode(m_id); - } - - // - // GetSystemTimeZones - - // - // returns a ReadOnlyCollection<TimeZoneInfo> containing all valid TimeZone's - // from the local machine. The entries in the collection are sorted by - // 'DisplayName'. - // - // This method does *not* throw TimeZoneNotFoundException or - // InvalidTimeZoneException. - // - // <SecurityKernel Critical="True" Ring="0"> - // <Asserts Name="Imperative: System.Security.PermissionSet" /> - // </SecurityKernel> - static public ReadOnlyCollection<TimeZoneInfo> GetSystemTimeZones() { - + /// <summary> + /// Returns a ReadOnlyCollection<TimeZoneInfo> containing all valid TimeZone's + /// from the local machine. The entries in the collection are sorted by + /// <see cref="DisplayName"/>. + /// This method does *not* throw TimeZoneNotFoundException or InvalidTimeZoneException. + /// </summary> + public static ReadOnlyCollection<TimeZoneInfo> GetSystemTimeZones() + { CachedData cachedData = s_cachedData; - lock (cachedData) { - if (cachedData.m_readOnlySystemTimeZones == null) { + lock (cachedData) + { + if (cachedData._readOnlySystemTimeZones == null) + { PopulateAllSystemTimeZones(cachedData); - cachedData.m_allSystemTimeZonesRead = true; + cachedData._allSystemTimeZonesRead = true; List<TimeZoneInfo> list; - if (cachedData.m_systemTimeZones != null) { + if (cachedData._systemTimeZones != null) + { // return a collection of the cached system time zones - list = new List<TimeZoneInfo>(cachedData.m_systemTimeZones.Values); + list = new List<TimeZoneInfo>(cachedData._systemTimeZones.Values); } - else { + else + { // return an empty collection list = new List<TimeZoneInfo>(); } @@ -983,111 +814,79 @@ namespace System { return comparison == 0 ? string.CompareOrdinal(x.DisplayName, y.DisplayName) : comparison; }); - cachedData.m_readOnlySystemTimeZones = new ReadOnlyCollection<TimeZoneInfo>(list); - } + cachedData._readOnlySystemTimeZones = new ReadOnlyCollection<TimeZoneInfo>(list); + } } - return cachedData.m_readOnlySystemTimeZones; + return cachedData._readOnlySystemTimeZones; } - private static void PopulateAllSystemTimeZones(CachedData cachedData) + /// <summary> + /// Value equality on the "adjustmentRules" array + /// </summary> + public bool HasSameRules(TimeZoneInfo other) { -#if FEATURE_WIN32_REGISTRY - PermissionSet permSet = new PermissionSet(PermissionState.None); - permSet.AddPermission(new RegistryPermission(RegistryPermissionAccess.Read, c_timeZonesRegistryHivePermissionList)); - permSet.Assert(); - - using (RegistryKey reg = Registry.LocalMachine.OpenSubKey(c_timeZonesRegistryHive, false)) - { - if (reg != null) - { - foreach (string keyName in reg.GetSubKeyNames()) - { - TimeZoneInfo value; - Exception ex; - TryGetTimeZone(keyName, false, out value, out ex, cachedData); // populate the cache - } - } - } -#elif PLATFORM_UNIX // FEATURE_WIN32_REGISTRY - string timeZoneDirectory = GetTimeZoneDirectory(); - foreach (string timeZoneId in GetTimeZoneIds(timeZoneDirectory)) + if (other == null) { - TimeZoneInfo value; - Exception ex; - TryGetTimeZone(timeZoneId, false, out value, out ex, cachedData); // populate the cache - } -#endif // FEATURE_WIN32_REGISTRY - } - - // - // HasSameRules - - // - // Value equality on the "adjustmentRules" array - // - public Boolean HasSameRules(TimeZoneInfo other) { - if (other == null) { throw new ArgumentNullException(nameof(other)); } - - // check the utcOffset and supportsDaylightSavingTime members Contract.EndContractBlock(); - if (this.m_baseUtcOffset != other.m_baseUtcOffset - || this.m_supportsDaylightSavingTime != other.m_supportsDaylightSavingTime) { + // check the utcOffset and supportsDaylightSavingTime members + if (_baseUtcOffset != other._baseUtcOffset || + _supportsDaylightSavingTime != other._supportsDaylightSavingTime) + { return false; } bool sameRules; - AdjustmentRule[] currentRules = this.m_adjustmentRules; - AdjustmentRule[] otherRules = other.m_adjustmentRules; + AdjustmentRule[] currentRules = _adjustmentRules; + AdjustmentRule[] otherRules = other._adjustmentRules; - sameRules = (currentRules == null && otherRules == null) - ||(currentRules != null && otherRules != null); + sameRules = + (currentRules == null && otherRules == null) || + (currentRules != null && otherRules != null); - if (!sameRules) { + if (!sameRules) + { // AdjustmentRule array mismatch return false; } - if (currentRules != null) { - if (currentRules.Length != otherRules.Length) { + if (currentRules != null) + { + if (currentRules.Length != otherRules.Length) + { // AdjustmentRule array length mismatch return false; } - for(int i = 0; i < currentRules.Length; i++) { - if (!(currentRules[i]).Equals(otherRules[i])) { + for (int i = 0; i < currentRules.Length; i++) + { + if (!(currentRules[i]).Equals(otherRules[i])) + { // AdjustmentRule value-equality mismatch return false; } } } - return sameRules; - } - - // - // Local - - // - // returns a TimeZoneInfo instance that represents the local time on the machine. - // Accessing this property may throw InvalidTimeZoneException or COMException - // if the machine is in an unstable or corrupt state. - // - static public TimeZoneInfo Local { - get { - Contract.Ensures(Contract.Result<TimeZoneInfo>() != null); - return s_cachedData.Local; - } + return sameRules; } + /// <summary> + /// Returns a TimeZoneInfo instance that represents the local time on the machine. + /// Accessing this property may throw InvalidTimeZoneException or COMException + /// if the machine is in an unstable or corrupt state. + /// </summary> + public static TimeZoneInfo Local => s_cachedData.Local; // // ToSerializedString - // // "TimeZoneInfo" := TimeZoneInfo Data;[AdjustmentRule Data 1];...;[AdjustmentRule Data N] // - // "TimeZoneInfo Data" := <m_id>;<m_baseUtcOffset>;<m_displayName>; - // <m_standardDisplayName>;<m_daylightDispayName>; + // "TimeZoneInfo Data" := <_id>;<_baseUtcOffset>;<_displayName>; + // <_standardDisplayName>;<_daylightDispayName>; // // "AdjustmentRule Data" := <DateStart>;<DateEnd>;<DaylightDelta>; // [TransitionTime Data DST Start] @@ -1095,322 +894,166 @@ namespace System { // // "TransitionTime Data" += <DaylightStartTimeOfDat>;<Month>;<Week>;<DayOfWeek>;<Day> // - public String ToSerializedString() { - return StringSerializer.GetSerializedString(this); - } - - - // - // ToString - - // - // returns the DisplayName: - // "(GMT-08:00) Pacific Time (US & Canada); Tijuana" - // - public override string ToString() { - return this.DisplayName; - } - - - // - // Utc - - // - // returns a TimeZoneInfo instance that represents Universal Coordinated Time (UTC) - // - static public TimeZoneInfo Utc { - get { - Contract.Ensures(Contract.Result<TimeZoneInfo>() != null); - return s_utcTimeZone; - } - } - - - // -------- SECTION: constructors -----------------* - // - // TimeZoneInfo - - // - // private ctor - // -#if FEATURE_WIN32_REGISTRY - private TimeZoneInfo(Win32Native.TimeZoneInformation zone, Boolean dstDisabled) { - - if (String.IsNullOrEmpty(zone.StandardName)) { - m_id = c_localId; // the ID must contain at least 1 character - initialize m_id to "Local" - } - else { - m_id = zone.StandardName; - } - m_baseUtcOffset = new TimeSpan(0, -(zone.Bias), 0); - - if (!dstDisabled) { - // only create the adjustment rule if DST is enabled - Win32Native.RegistryTimeZoneInformation regZone = new Win32Native.RegistryTimeZoneInformation(zone); - AdjustmentRule rule = CreateAdjustmentRuleFromTimeZoneInformation(regZone, DateTime.MinValue.Date, DateTime.MaxValue.Date, zone.Bias); - if (rule != null) { - m_adjustmentRules = new AdjustmentRule[1]; - m_adjustmentRules[0] = rule; - } - } - - ValidateTimeZoneInfo(m_id, m_baseUtcOffset, m_adjustmentRules, out m_supportsDaylightSavingTime); - m_displayName = zone.StandardName; - m_standardDisplayName = zone.StandardName; - m_daylightDisplayName = zone.DaylightName; - } -#endif // FEATURE_WIN32_REGISTRY - -#if PLATFORM_UNIX - private TimeZoneInfo(byte[] data, string id, Boolean dstDisabled) - { - TZifHead t; - DateTime[] dts; - Byte[] typeOfLocalTime; - TZifType[] transitionType; - String zoneAbbreviations; - Boolean[] StandardTime; - Boolean[] GmtTime; - string futureTransitionsPosixFormat; - - // parse the raw TZif bytes; this method can throw ArgumentException when the data is malformed. - TZif_ParseRaw(data, out t, out dts, out typeOfLocalTime, out transitionType, out zoneAbbreviations, out StandardTime, out GmtTime, out futureTransitionsPosixFormat); - - m_id = id; - m_displayName = c_localId; - m_baseUtcOffset = TimeSpan.Zero; - - // find the best matching baseUtcOffset and display strings based on the current utcNow value. - // NOTE: read the display strings from the the tzfile now in case they can't be loaded later - // from the globalization data. - DateTime utcNow = DateTime.UtcNow; - for (int i = 0; i < dts.Length && dts[i] <= utcNow; i++) { - int type = typeOfLocalTime[i]; - if (!transitionType[type].IsDst) { - m_baseUtcOffset = transitionType[type].UtcOffset; - m_standardDisplayName = TZif_GetZoneAbbreviation(zoneAbbreviations, transitionType[type].AbbreviationIndex); - } - else { - m_daylightDisplayName = TZif_GetZoneAbbreviation(zoneAbbreviations, transitionType[type].AbbreviationIndex); - } - } - - if (dts.Length == 0) { - // time zones like Africa/Bujumbura and Etc/GMT* have no transition times but still contain - // TZifType entries that may contain a baseUtcOffset and display strings - for (int i = 0; i < transitionType.Length; i++) { - if (!transitionType[i].IsDst) { - m_baseUtcOffset = transitionType[i].UtcOffset; - m_standardDisplayName = TZif_GetZoneAbbreviation(zoneAbbreviations, transitionType[i].AbbreviationIndex); - } - else { - m_daylightDisplayName = TZif_GetZoneAbbreviation(zoneAbbreviations, transitionType[i].AbbreviationIndex); - } - } - } - m_displayName = m_standardDisplayName; - - GetDisplayName(Interop.GlobalizationInterop.TimeZoneDisplayNameType.Generic, ref m_displayName); - GetDisplayName(Interop.GlobalizationInterop.TimeZoneDisplayNameType.Standard, ref m_standardDisplayName); - GetDisplayName(Interop.GlobalizationInterop.TimeZoneDisplayNameType.DaylightSavings, ref m_daylightDisplayName); - - // TZif supports seconds-level granularity with offsets but TimeZoneInfo only supports minutes since it aligns - // with DateTimeOffset, SQL Server, and the W3C XML Specification - if (m_baseUtcOffset.Ticks % TimeSpan.TicksPerMinute != 0) { - m_baseUtcOffset = new TimeSpan(m_baseUtcOffset.Hours, m_baseUtcOffset.Minutes, 0); - } - - if (!dstDisabled) { - // only create the adjustment rule if DST is enabled - TZif_GenerateAdjustmentRules(out m_adjustmentRules, m_baseUtcOffset, dts, typeOfLocalTime, transitionType, StandardTime, GmtTime, futureTransitionsPosixFormat); - } + public string ToSerializedString() => StringSerializer.GetSerializedString(this); - ValidateTimeZoneInfo(m_id, m_baseUtcOffset, m_adjustmentRules, out m_supportsDaylightSavingTime); - } - - private void GetDisplayName(Interop.GlobalizationInterop.TimeZoneDisplayNameType nameType, ref string displayName) - { - string timeZoneDisplayName; - bool result = Interop.CallStringMethod( - (locale, id, type, stringBuilder) => Interop.GlobalizationInterop.GetTimeZoneDisplayName( - locale, - id, - type, - stringBuilder, - stringBuilder.Capacity), - CultureInfo.CurrentUICulture.Name, - m_id, - nameType, - out timeZoneDisplayName); - - // If there is an unknown error, don't set the displayName field. - // It will be set to the abbreviation that was read out of the tzfile. - if (result) - { - displayName = timeZoneDisplayName; - } - } + /// <summary> + /// Returns the <see cref="DisplayName"/>: "(GMT-08:00) Pacific Time (US & Canada); Tijuana" + /// </summary> + public override string ToString() => DisplayName; -#endif // PLATFORM_UNIX + /// <summary> + /// Returns a TimeZoneInfo instance that represents Universal Coordinated Time (UTC) + /// </summary> + public static TimeZoneInfo Utc => s_utcTimeZone; private TimeZoneInfo( - String id, + string id, TimeSpan baseUtcOffset, - String displayName, - String standardDisplayName, - String daylightDisplayName, - AdjustmentRule [] adjustmentRules, - Boolean disableDaylightSavingTime) { + string displayName, + string standardDisplayName, + string daylightDisplayName, + AdjustmentRule[] adjustmentRules, + bool disableDaylightSavingTime) + { - Boolean adjustmentRulesSupportDst; + bool adjustmentRulesSupportDst; ValidateTimeZoneInfo(id, baseUtcOffset, adjustmentRules, out adjustmentRulesSupportDst); - m_id = id; - m_baseUtcOffset = baseUtcOffset; - m_displayName = displayName; - m_standardDisplayName = standardDisplayName; - m_daylightDisplayName = (disableDaylightSavingTime ? null : daylightDisplayName); - m_supportsDaylightSavingTime = adjustmentRulesSupportDst && !disableDaylightSavingTime; - m_adjustmentRules = adjustmentRules; + _id = id; + _baseUtcOffset = baseUtcOffset; + _displayName = displayName; + _standardDisplayName = standardDisplayName; + _daylightDisplayName = disableDaylightSavingTime ? null : daylightDisplayName; + _supportsDaylightSavingTime = adjustmentRulesSupportDst && !disableDaylightSavingTime; + _adjustmentRules = adjustmentRules; } - // -------- SECTION: factory methods -----------------* - - // - // CreateCustomTimeZone - - // - // returns a simple TimeZoneInfo instance that does - // not support Daylight Saving Time - // - static public TimeZoneInfo CreateCustomTimeZone( - String id, - TimeSpan baseUtcOffset, - String displayName, - String standardDisplayName) { - + /// <summary> + /// Returns a simple TimeZoneInfo instance that does not support Daylight Saving Time. + /// </summary> + public static TimeZoneInfo CreateCustomTimeZone( + string id, + TimeSpan baseUtcOffset, + string displayName, + string standardDisplayName) + { return new TimeZoneInfo( - id, - baseUtcOffset, - displayName, - standardDisplayName, - standardDisplayName, - null, - false); + id, + baseUtcOffset, + displayName, + standardDisplayName, + standardDisplayName, + adjustmentRules: null, + disableDaylightSavingTime: false); } - // - // CreateCustomTimeZone - - // - // returns a TimeZoneInfo instance that may - // support Daylight Saving Time - // - static public TimeZoneInfo CreateCustomTimeZone( - String id, - TimeSpan baseUtcOffset, - String displayName, - String standardDisplayName, - String daylightDisplayName, - AdjustmentRule [] adjustmentRules) { - + /// <summary> + /// Returns a TimeZoneInfo instance that may support Daylight Saving Time. + /// </summary> + public static TimeZoneInfo CreateCustomTimeZone( + string id, + TimeSpan baseUtcOffset, + string displayName, + string standardDisplayName, + string daylightDisplayName, + AdjustmentRule[] adjustmentRules) + { return CreateCustomTimeZone( - id, - baseUtcOffset, - displayName, - standardDisplayName, - daylightDisplayName, - adjustmentRules, - false); + id, + baseUtcOffset, + displayName, + standardDisplayName, + daylightDisplayName, + adjustmentRules, + disableDaylightSavingTime: false); } - - // - // CreateCustomTimeZone - - // - // returns a TimeZoneInfo instance that may - // support Daylight Saving Time - // - // This class factory method is identical to the - // TimeZoneInfo private constructor - // - static public TimeZoneInfo CreateCustomTimeZone( - String id, - TimeSpan baseUtcOffset, - String displayName, - String standardDisplayName, - String daylightDisplayName, - AdjustmentRule [] adjustmentRules, - Boolean disableDaylightSavingTime) { - - if (!disableDaylightSavingTime && adjustmentRules?.Length > 0) { + /// <summary> + /// Returns a TimeZoneInfo instance that may support Daylight Saving Time. + /// </summary> + public static TimeZoneInfo CreateCustomTimeZone( + string id, + TimeSpan baseUtcOffset, + string displayName, + string standardDisplayName, + string daylightDisplayName, + AdjustmentRule[] adjustmentRules, + bool disableDaylightSavingTime) + { + if (!disableDaylightSavingTime && adjustmentRules?.Length > 0) + { adjustmentRules = (AdjustmentRule[])adjustmentRules.Clone(); } return new TimeZoneInfo( - id, - baseUtcOffset, - displayName, - standardDisplayName, - daylightDisplayName, - adjustmentRules, - disableDaylightSavingTime); + id, + baseUtcOffset, + displayName, + standardDisplayName, + daylightDisplayName, + adjustmentRules, + disableDaylightSavingTime); } + void IDeserializationCallback.OnDeserialization(object sender) + { + try + { + bool adjustmentRulesSupportDst; + ValidateTimeZoneInfo(_id, _baseUtcOffset, _adjustmentRules, out adjustmentRulesSupportDst); - - // ----- SECTION: private serialization instance methods ----------------* - - void IDeserializationCallback.OnDeserialization(Object sender) { - try { - Boolean adjustmentRulesSupportDst; - ValidateTimeZoneInfo(m_id, m_baseUtcOffset, m_adjustmentRules, out adjustmentRulesSupportDst); - - if (adjustmentRulesSupportDst != m_supportsDaylightSavingTime) { + if (adjustmentRulesSupportDst != _supportsDaylightSavingTime) + { throw new SerializationException(Environment.GetResourceString("Serialization_CorruptField", "SupportsDaylightSavingTime")); } } - catch (ArgumentException e) { + catch (ArgumentException e) + { throw new SerializationException(Environment.GetResourceString("Serialization_InvalidData"), e); } - catch (InvalidTimeZoneException e) { + catch (InvalidTimeZoneException e) + { throw new SerializationException(Environment.GetResourceString("Serialization_InvalidData"), e); } } - - void ISerializable.GetObjectData(SerializationInfo info, StreamingContext context) { - if (info == null) { + void ISerializable.GetObjectData(SerializationInfo info, StreamingContext context) + { + if (info == null) + { throw new ArgumentNullException(nameof(info)); } Contract.EndContractBlock(); - info.AddValue("Id", m_id); - info.AddValue("DisplayName", m_displayName); - info.AddValue("StandardName", m_standardDisplayName); - info.AddValue("DaylightName", m_daylightDisplayName); - info.AddValue("BaseUtcOffset", m_baseUtcOffset); - info.AddValue("AdjustmentRules", m_adjustmentRules); - info.AddValue("SupportsDaylightSavingTime", m_supportsDaylightSavingTime); + info.AddValue("Id", _id); + info.AddValue("DisplayName", _displayName); + info.AddValue("StandardName", _standardDisplayName); + info.AddValue("DaylightName", _daylightDisplayName); + info.AddValue("BaseUtcOffset", _baseUtcOffset); + info.AddValue("AdjustmentRules", _adjustmentRules); + info.AddValue("SupportsDaylightSavingTime", _supportsDaylightSavingTime); } - - TimeZoneInfo(SerializationInfo info, StreamingContext context) { - if (info == null) { + TimeZoneInfo(SerializationInfo info, StreamingContext context) + { + if (info == null) + { throw new ArgumentNullException(nameof(info)); } - m_id = (String)info.GetValue("Id", typeof(String)); - m_displayName = (String)info.GetValue("DisplayName", typeof(String)); - m_standardDisplayName = (String)info.GetValue("StandardName", typeof(String)); - m_daylightDisplayName = (String)info.GetValue("DaylightName", typeof(String)); - m_baseUtcOffset = (TimeSpan)info.GetValue("BaseUtcOffset", typeof(TimeSpan)); - m_adjustmentRules = (AdjustmentRule[])info.GetValue("AdjustmentRules", typeof(AdjustmentRule[])); - m_supportsDaylightSavingTime = (Boolean)info.GetValue("SupportsDaylightSavingTime", typeof(Boolean)); + _id = (string)info.GetValue("Id", typeof(string)); + _displayName = (string)info.GetValue("DisplayName", typeof(string)); + _standardDisplayName = (string)info.GetValue("StandardName", typeof(string)); + _daylightDisplayName = (string)info.GetValue("DaylightName", typeof(string)); + _baseUtcOffset = (TimeSpan)info.GetValue("BaseUtcOffset", typeof(TimeSpan)); + _adjustmentRules = (AdjustmentRule[])info.GetValue("AdjustmentRules", typeof(AdjustmentRule[])); + _supportsDaylightSavingTime = (bool)info.GetValue("SupportsDaylightSavingTime", typeof(bool)); } - - - // ----- SECTION: internal instance utility methods ----------------* - - - private AdjustmentRule GetAdjustmentRuleForTime(DateTime dateTime, bool dateTimeisUtc = false) { - if (m_adjustmentRules == null || m_adjustmentRules.Length == 0) { + private AdjustmentRule GetAdjustmentRuleForTime(DateTime dateTime, bool dateTimeisUtc = false) + { + if (_adjustmentRules == null || _adjustmentRules.Length == 0) + { return null; } @@ -1418,20 +1061,16 @@ namespace System { // This is because the AdjustmentRule DateStart & DateEnd are stored as // Date-only values {4/2/2006 - 10/28/2006} but actually represent the // time span {4/2/2006@00:00:00.00000 - 10/28/2006@23:59:59.99999} - DateTime date; - if (dateTimeisUtc) - { - date = (dateTime + BaseUtcOffset).Date; - } - else - { - date = dateTime.Date; - } + DateTime date = dateTimeisUtc ? + (dateTime + BaseUtcOffset).Date : + dateTime.Date; - for (int i = 0; i < m_adjustmentRules.Length; i++) { - AdjustmentRule rule = m_adjustmentRules[i]; - AdjustmentRule previousRule = i > 0 ? m_adjustmentRules[i - 1] : rule; - if (IsAdjustmentRuleValid(rule, previousRule, dateTime, date, dateTimeisUtc)) { + for (int i = 0; i < _adjustmentRules.Length; i++) + { + AdjustmentRule rule = _adjustmentRules[i]; + AdjustmentRule previousRule = i > 0 ? _adjustmentRules[i - 1] : rule; + if (IsAdjustmentRuleValid(rule, previousRule, dateTime, date, dateTimeisUtc)) + { return rule; } } @@ -1448,18 +1087,11 @@ namespace System { bool isAfterStart; if (rule.DateStart.Kind == DateTimeKind.Utc) { - DateTime dateTimeToCompare; - if (dateTimeisUtc) - { - dateTimeToCompare = dateTime; - } - else - { - dateTimeToCompare = ConvertToUtc(dateTime, - // use the previous rule to compute the dateTimeToCompare, since the time daylight savings "switches" - // is based on the previous rule's offset - previousRule.DaylightDelta, previousRule.BaseUtcOffsetDelta); - } + DateTime dateTimeToCompare = dateTimeisUtc ? + dateTime : + // use the previous rule to compute the dateTimeToCompare, since the time daylight savings "switches" + // is based on the previous rule's offset + ConvertToUtc(dateTime, previousRule.DaylightDelta, previousRule.BaseUtcOffsetDelta); isAfterStart = dateTimeToCompare >= rule.DateStart; } @@ -1477,15 +1109,9 @@ namespace System { bool isBeforeEnd; if (rule.DateEnd.Kind == DateTimeKind.Utc) { - DateTime dateTimeToCompare; - if (dateTimeisUtc) - { - dateTimeToCompare = dateTime; - } - else - { - dateTimeToCompare = ConvertToUtc(dateTime, rule.DaylightDelta, rule.BaseUtcOffsetDelta); - } + DateTime dateTimeToCompare = dateTimeisUtc ? + dateTime : + ConvertToUtc(dateTime, rule.DaylightDelta, rule.BaseUtcOffsetDelta); isBeforeEnd = dateTimeToCompare <= rule.DateEnd; } @@ -1501,18 +1127,14 @@ namespace System { /// <summary> /// Converts the dateTime to UTC using the specified deltas. /// </summary> - private DateTime ConvertToUtc(DateTime dateTime, TimeSpan daylightDelta, TimeSpan baseUtcOffsetDelta) - { - return ConvertToFromUtc(dateTime, daylightDelta, baseUtcOffsetDelta, convertToUtc: true); - } + private DateTime ConvertToUtc(DateTime dateTime, TimeSpan daylightDelta, TimeSpan baseUtcOffsetDelta) => + ConvertToFromUtc(dateTime, daylightDelta, baseUtcOffsetDelta, convertToUtc: true); /// <summary> /// Converts the dateTime from UTC using the specified deltas. /// </summary> - private DateTime ConvertFromUtc(DateTime dateTime, TimeSpan daylightDelta, TimeSpan baseUtcOffsetDelta) - { - return ConvertToFromUtc(dateTime, daylightDelta, baseUtcOffsetDelta, convertToUtc: false); - } + private DateTime ConvertFromUtc(DateTime dateTime, TimeSpan daylightDelta, TimeSpan baseUtcOffsetDelta) => + ConvertToFromUtc(dateTime, daylightDelta, baseUtcOffsetDelta, convertToUtc: false); /// <summary> /// Converts the dateTime to or from UTC using the specified deltas. @@ -1527,184 +1149,40 @@ namespace System { long ticks = dateTime.Ticks + offset.Ticks; - DateTime result; - if (ticks > DateTime.MaxValue.Ticks) - { - result = DateTime.MaxValue; - } - else if (ticks < DateTime.MinValue.Ticks) - { - result = DateTime.MinValue; - } - else - { - result = new DateTime(ticks); - } - - return result; - } - - // ----- SECTION: internal static utility methods ----------------* - - // - // CheckDaylightSavingTimeNotSupported - - // - // Helper function to check if the current TimeZoneInformation struct does not support DST. This - // check returns true when the DaylightDate == StandardDate - // - // This check is only meant to be used for "Local". - // - static private Boolean CheckDaylightSavingTimeNotSupported(Win32Native.TimeZoneInformation timeZone) { - return ( timeZone.DaylightDate.Year == timeZone.StandardDate.Year - && timeZone.DaylightDate.Month == timeZone.StandardDate.Month - && timeZone.DaylightDate.DayOfWeek == timeZone.StandardDate.DayOfWeek - && timeZone.DaylightDate.Day == timeZone.StandardDate.Day - && timeZone.DaylightDate.Hour == timeZone.StandardDate.Hour - && timeZone.DaylightDate.Minute == timeZone.StandardDate.Minute - && timeZone.DaylightDate.Second == timeZone.StandardDate.Second - && timeZone.DaylightDate.Milliseconds == timeZone.StandardDate.Milliseconds); + return + ticks > DateTime.MaxValue.Ticks ? DateTime.MaxValue : + ticks < DateTime.MinValue.Ticks ? DateTime.MinValue : + new DateTime(ticks); } - - // - // ConvertUtcToTimeZone - - // - // Helper function that converts a dateTime from UTC into the destinationTimeZone - // - // * returns DateTime.MaxValue when the converted value is too large - // * returns DateTime.MinValue when the converted value is too small - // - static private DateTime ConvertUtcToTimeZone(Int64 ticks, TimeZoneInfo destinationTimeZone, out Boolean isAmbiguousLocalDst) { - DateTime utcConverted; - DateTime localConverted; - - // utcConverted is used to calculate the UTC offset in the destinationTimeZone - if (ticks > DateTime.MaxValue.Ticks) { - utcConverted = DateTime.MaxValue; - } - else if (ticks < DateTime.MinValue.Ticks) { - utcConverted = DateTime.MinValue; - } - else { - utcConverted = new DateTime(ticks); - } + /// <summary> + /// Helper function that converts a dateTime from UTC into the destinationTimeZone + /// - Returns DateTime.MaxValue when the converted value is too large. + /// - Returns DateTime.MinValue when the converted value is too small. + /// </summary> + private static DateTime ConvertUtcToTimeZone(long ticks, TimeZoneInfo destinationTimeZone, out bool isAmbiguousLocalDst) + { + // used to calculate the UTC offset in the destinationTimeZone + DateTime utcConverted = + ticks > DateTime.MaxValue.Ticks ? DateTime.MaxValue : + ticks < DateTime.MinValue.Ticks ? DateTime.MinValue : + new DateTime(ticks); // verify the time is between MinValue and MaxValue in the new time zone TimeSpan offset = GetUtcOffsetFromUtc(utcConverted, destinationTimeZone, out isAmbiguousLocalDst); ticks += offset.Ticks; - if (ticks > DateTime.MaxValue.Ticks) { - localConverted = DateTime.MaxValue; - } - else if (ticks < DateTime.MinValue.Ticks) { - localConverted = DateTime.MinValue; - } - else { - localConverted = new DateTime(ticks); - } - return localConverted; + return + ticks > DateTime.MaxValue.Ticks ? DateTime.MaxValue : + ticks < DateTime.MinValue.Ticks ? DateTime.MinValue : + new DateTime(ticks); } -#if FEATURE_WIN32_REGISTRY - // - // CreateAdjustmentRuleFromTimeZoneInformation- - // - // Converts a Win32Native.RegistryTimeZoneInformation (REG_TZI_FORMAT struct) to an AdjustmentRule - // - static private AdjustmentRule CreateAdjustmentRuleFromTimeZoneInformation(Win32Native.RegistryTimeZoneInformation timeZoneInformation, DateTime startDate, DateTime endDate, int defaultBaseUtcOffset) { - AdjustmentRule rule; - bool supportsDst = (timeZoneInformation.StandardDate.Month != 0); - - if (!supportsDst) { - if (timeZoneInformation.Bias == defaultBaseUtcOffset) - { - // this rule will not contain any information to be used to adjust dates. just ignore it - return null; - } - - return rule = AdjustmentRule.CreateAdjustmentRule( - startDate, - endDate, - TimeSpan.Zero, // no daylight saving transition - TransitionTime.CreateFixedDateRule(DateTime.MinValue, 1, 1), - TransitionTime.CreateFixedDateRule(DateTime.MinValue.AddMilliseconds(1), 1, 1), - new TimeSpan(0, defaultBaseUtcOffset - timeZoneInformation.Bias, 0), // Bias delta is all what we need from this rule - noDaylightTransitions: false); - } - - // - // Create an AdjustmentRule with TransitionTime objects - // - TransitionTime daylightTransitionStart; - if (!TransitionTimeFromTimeZoneInformation(timeZoneInformation, out daylightTransitionStart, true /* start date */)) { - return null; - } - - TransitionTime daylightTransitionEnd; - if (!TransitionTimeFromTimeZoneInformation(timeZoneInformation, out daylightTransitionEnd, false /* end date */)) { - return null; - } - - if (daylightTransitionStart.Equals(daylightTransitionEnd)) { - // this happens when the time zone does support DST but the OS has DST disabled - return null; - } - - rule = AdjustmentRule.CreateAdjustmentRule( - startDate, - endDate, - new TimeSpan(0, -timeZoneInformation.DaylightBias, 0), - (TransitionTime)daylightTransitionStart, - (TransitionTime)daylightTransitionEnd, - new TimeSpan(0, defaultBaseUtcOffset - timeZoneInformation.Bias, 0), - noDaylightTransitions: false); - - return rule; - } - - // - // FindIdFromTimeZoneInformation - - // - // Helper function that searches the registry for a time zone entry - // that matches the TimeZoneInformation struct - // - static private String FindIdFromTimeZoneInformation(Win32Native.TimeZoneInformation timeZone, out Boolean dstDisabled) { - dstDisabled = false; - - try { - PermissionSet permSet = new PermissionSet(PermissionState.None); - permSet.AddPermission(new RegistryPermission(RegistryPermissionAccess.Read, c_timeZonesRegistryHivePermissionList)); - permSet.Assert(); - - using (RegistryKey key = Registry.LocalMachine.OpenSubKey(c_timeZonesRegistryHive, false)) - { - if (key == null) - { - return null; - } - foreach (string keyName in key.GetSubKeyNames()) - { - if (TryCompareTimeZoneInformationToRegistry(timeZone, keyName, out dstDisabled)) - { - return keyName; - } - } - } - } - finally { - PermissionSet.RevertAssert(); - } - return null; - } -#endif // FEATURE_WIN32_REGISTRY - - - // - // GetDaylightTime - - // - // Helper function that returns a DaylightTime from a year and AdjustmentRule - // - private DaylightTimeStruct GetDaylightTime(Int32 year, AdjustmentRule rule) { + /// <summary> + /// Helper function that returns a DaylightTime from a year and AdjustmentRule. + /// </summary> + private DaylightTimeStruct GetDaylightTime(int year, AdjustmentRule rule) + { TimeSpan delta = rule.DaylightDelta; DateTime startTime; DateTime endTime; @@ -1728,28 +1206,35 @@ namespace System { return new DaylightTimeStruct(startTime, endTime, delta); } - // - // GetIsDaylightSavings - - // - // Helper function that checks if a given dateTime is in Daylight Saving Time (DST) - // This function assumes the dateTime and AdjustmentRule are both in the same time zone - // - static private Boolean GetIsDaylightSavings(DateTime time, AdjustmentRule rule, DaylightTimeStruct daylightTime, TimeZoneInfoOptions flags) { - if (rule == null) { + /// <summary> + /// Helper function that checks if a given dateTime is in Daylight Saving Time (DST). + /// This function assumes the dateTime and AdjustmentRule are both in the same time zone. + /// </summary> + private static bool GetIsDaylightSavings(DateTime time, AdjustmentRule rule, DaylightTimeStruct daylightTime, TimeZoneInfoOptions flags) + { + if (rule == null) + { return false; } DateTime startTime; DateTime endTime; - - if (time.Kind == DateTimeKind.Local) { - // startTime and endTime represent the period from either the start of DST to the end and ***includes*** the - // potentially overlapped times - startTime = rule.IsStartDateMarkerForBeginningOfYear() ? new DateTime(daylightTime.Start.Year, 1, 1, 0, 0, 0) : daylightTime.Start + daylightTime.Delta; - endTime = rule.IsEndDateMarkerForEndOfYear() ? new DateTime(daylightTime.End.Year + 1, 1, 1, 0, 0, 0).AddTicks(-1) : daylightTime.End; + + if (time.Kind == DateTimeKind.Local) + { + // startTime and endTime represent the period from either the start of + // DST to the end and ***includes*** the potentially overlapped times + startTime = rule.IsStartDateMarkerForBeginningOfYear() ? + new DateTime(daylightTime.Start.Year, 1, 1, 0, 0, 0) : + daylightTime.Start + daylightTime.Delta; + + endTime = rule.IsEndDateMarkerForEndOfYear() ? + new DateTime(daylightTime.End.Year + 1, 1, 1, 0, 0, 0).AddTicks(-1) : + daylightTime.End; } - else { - // startTime and endTime represent the period from either the start of DST to the end and + else + { + // startTime and endTime represent the period from either the start of DST to the end and // ***does not include*** the potentially overlapped times // // -=-=-=-=-=- Pacific Standard Time -=-=-=-=-=-=- @@ -1766,20 +1251,28 @@ namespace System { // | <ambiguous time> | | <invalid time> | // [======== DST ========>) // - Boolean invalidAtStart = rule.DaylightDelta > TimeSpan.Zero; - startTime = rule.IsStartDateMarkerForBeginningOfYear() ? new DateTime(daylightTime.Start.Year, 1, 1, 0, 0, 0) : daylightTime.Start + (invalidAtStart ? rule.DaylightDelta : TimeSpan.Zero); /* FUTURE: - rule.StandardDelta; */ - endTime = rule.IsEndDateMarkerForEndOfYear() ? new DateTime(daylightTime.End.Year + 1, 1, 1, 0, 0, 0).AddTicks(-1) : daylightTime.End + (invalidAtStart ? -rule.DaylightDelta : TimeSpan.Zero); + bool invalidAtStart = rule.DaylightDelta > TimeSpan.Zero; + + startTime = rule.IsStartDateMarkerForBeginningOfYear() ? + new DateTime(daylightTime.Start.Year, 1, 1, 0, 0, 0) : + daylightTime.Start + (invalidAtStart ? rule.DaylightDelta : TimeSpan.Zero); /* FUTURE: - rule.StandardDelta; */ + + endTime = rule.IsEndDateMarkerForEndOfYear() ? + new DateTime(daylightTime.End.Year + 1, 1, 1, 0, 0, 0).AddTicks(-1) : + daylightTime.End + (invalidAtStart ? -rule.DaylightDelta : TimeSpan.Zero); } - Boolean isDst = CheckIsDst(startTime, time, endTime, false, rule); + bool isDst = CheckIsDst(startTime, time, endTime, false, rule); // If this date was previously converted from a UTC date and we were able to detect that the local - // DateTime would be ambiguous, this data is stored in the DateTime to resolve this ambiguity. - if (isDst && time.Kind == DateTimeKind.Local) { - // For normal time zones, the ambiguous hour is the last hour of daylight saving when you wind the + // DateTime would be ambiguous, this data is stored in the DateTime to resolve this ambiguity. + if (isDst && time.Kind == DateTimeKind.Local) + { + // For normal time zones, the ambiguous hour is the last hour of daylight saving when you wind the // clock back. It is theoretically possible to have a positive delta, (which would really be daylight // reduction time), where you would have to wind the clock back in the begnning. - if (GetIsAmbiguousTime(time, rule, daylightTime)) { + if (GetIsAmbiguousTime(time, rule, daylightTime)) + { isDst = time.IsAmbiguousDaylightSavingTime(); } } @@ -1810,110 +1303,132 @@ namespace System { private TimeSpan GetDaylightSavingsEndOffsetFromUtc(TimeSpan baseUtcOffset, AdjustmentRule rule) { // NOTE: even NoDaylightTransitions rules use this logic since DST ends w.r.t. the current rule - return baseUtcOffset + rule.BaseUtcOffsetDelta + rule.DaylightDelta; /* FUTURE: + rule.StandardDelta; */ } - // - // GetIsDaylightSavingsFromUtc - - // - // Helper function that checks if a given dateTime is in Daylight Saving Time (DST) - // This function assumes the dateTime is in UTC and AdjustmentRule is in a different time zone - // - static private Boolean GetIsDaylightSavingsFromUtc(DateTime time, Int32 Year, TimeSpan utc, AdjustmentRule rule, out Boolean isAmbiguousLocalDst, TimeZoneInfo zone) { + /// <summary> + /// Helper function that checks if a given dateTime is in Daylight Saving Time (DST). + /// This function assumes the dateTime is in UTC and AdjustmentRule is in a different time zone. + /// </summary> + private static bool GetIsDaylightSavingsFromUtc(DateTime time, int year, TimeSpan utc, AdjustmentRule rule, out bool isAmbiguousLocalDst, TimeZoneInfo zone) + { isAmbiguousLocalDst = false; - if (rule == null) { + if (rule == null) + { return false; } - // Get the daylight changes for the year of the specified time. - DaylightTimeStruct daylightTime = zone.GetDaylightTime(Year, rule); + DaylightTimeStruct daylightTime = zone.GetDaylightTime(year, rule); - // The start and end times represent the range of universal times that are in DST for that year. + // The start and end times represent the range of universal times that are in DST for that year. // Within that there is an ambiguous hour, usually right at the end, but at the beginning in // the unusual case of a negative daylight savings delta. - // We need to handle the case if the current rule has daylight saving end by the end of year. If so, we need to check if next year starts with daylight saving on + // We need to handle the case if the current rule has daylight saving end by the end of year. If so, we need to check if next year starts with daylight saving on // and get the actual daylight saving end time. Here is example for such case: - // Converting the UTC datetime "12/31/2011 8:00:00 PM" to "(UTC+03:00) Moscow, St. Petersburg, Volgograd (RTZ 2)" zone. - // In 2011 the daylight saving will go through the end of the year. If we use the end of 2011 as the daylight saving end, - // that will fail the conversion because the UTC time +4 hours (3 hours for the zone UTC offset and 1 hour for daylight saving) will move us to the next year "1/1/2012 12:00 AM", + // Converting the UTC datetime "12/31/2011 8:00:00 PM" to "(UTC+03:00) Moscow, St. Petersburg, Volgograd (RTZ 2)" zone. + // In 2011 the daylight saving will go through the end of the year. If we use the end of 2011 as the daylight saving end, + // that will fail the conversion because the UTC time +4 hours (3 hours for the zone UTC offset and 1 hour for daylight saving) will move us to the next year "1/1/2012 12:00 AM", // checking against the end of 2011 will tell we are not in daylight saving which is wrong and the conversion will be off by one hour. // Note we handle the similar case when rule year start with daylight saving and previous year end with daylight saving. bool ignoreYearAdjustment = false; TimeSpan dstStartOffset = zone.GetDaylightSavingsStartOffsetFromUtc(utc, rule); DateTime startTime; - if (rule.IsStartDateMarkerForBeginningOfYear() && daylightTime.Start.Year > DateTime.MinValue.Year) { + if (rule.IsStartDateMarkerForBeginningOfYear() && daylightTime.Start.Year > DateTime.MinValue.Year) + { AdjustmentRule previousYearRule = zone.GetAdjustmentRuleForTime(new DateTime(daylightTime.Start.Year - 1, 12, 31)); - if (previousYearRule != null && previousYearRule.IsEndDateMarkerForEndOfYear()) { + if (previousYearRule != null && previousYearRule.IsEndDateMarkerForEndOfYear()) + { DaylightTimeStruct previousDaylightTime = zone.GetDaylightTime(daylightTime.Start.Year - 1, previousYearRule); startTime = previousDaylightTime.Start - utc - previousYearRule.BaseUtcOffsetDelta; ignoreYearAdjustment = true; - } else { + } + else + { startTime = new DateTime(daylightTime.Start.Year, 1, 1, 0, 0, 0) - dstStartOffset; } - } else { + } + else + { startTime = daylightTime.Start - dstStartOffset; } TimeSpan dstEndOffset = zone.GetDaylightSavingsEndOffsetFromUtc(utc, rule); DateTime endTime; - if (rule.IsEndDateMarkerForEndOfYear() && daylightTime.End.Year < DateTime.MaxValue.Year) { + if (rule.IsEndDateMarkerForEndOfYear() && daylightTime.End.Year < DateTime.MaxValue.Year) + { AdjustmentRule nextYearRule = zone.GetAdjustmentRuleForTime(new DateTime(daylightTime.End.Year + 1, 1, 1)); - if (nextYearRule != null && nextYearRule.IsStartDateMarkerForBeginningOfYear()) { - if (nextYearRule.IsEndDateMarkerForEndOfYear()) {// next year end with daylight saving on too + if (nextYearRule != null && nextYearRule.IsStartDateMarkerForBeginningOfYear()) + { + if (nextYearRule.IsEndDateMarkerForEndOfYear()) + { + // next year end with daylight saving on too endTime = new DateTime(daylightTime.End.Year + 1, 12, 31) - utc - nextYearRule.BaseUtcOffsetDelta - nextYearRule.DaylightDelta; - } else { + } + else + { DaylightTimeStruct nextdaylightTime = zone.GetDaylightTime(daylightTime.End.Year + 1, nextYearRule); endTime = nextdaylightTime.End - utc - nextYearRule.BaseUtcOffsetDelta - nextYearRule.DaylightDelta; } ignoreYearAdjustment = true; - } else { + } + else + { endTime = new DateTime(daylightTime.End.Year + 1, 1, 1, 0, 0, 0).AddTicks(-1) - dstEndOffset; } - } else { + } + else + { endTime = daylightTime.End - dstEndOffset; } DateTime ambiguousStart; DateTime ambiguousEnd; - if (daylightTime.Delta.Ticks > 0) { + if (daylightTime.Delta.Ticks > 0) + { ambiguousStart = endTime - daylightTime.Delta; ambiguousEnd = endTime; - } else { + } + else + { ambiguousStart = startTime; ambiguousEnd = startTime - daylightTime.Delta; } - Boolean isDst = CheckIsDst(startTime, time, endTime, ignoreYearAdjustment, rule); + bool isDst = CheckIsDst(startTime, time, endTime, ignoreYearAdjustment, rule); // See if the resulting local time becomes ambiguous. This must be captured here or the // DateTime will not be able to round-trip back to UTC accurately. - if (isDst) { + if (isDst) + { isAmbiguousLocalDst = (time >= ambiguousStart && time < ambiguousEnd); - if (!isAmbiguousLocalDst && ambiguousStart.Year != ambiguousEnd.Year) { + if (!isAmbiguousLocalDst && ambiguousStart.Year != ambiguousEnd.Year) + { // there exists an extreme corner case where the start or end period is on a year boundary and // because of this the comparison above might have been performed for a year-early or a year-later // than it should have been. DateTime ambiguousStartModified; DateTime ambiguousEndModified; - try { + try + { ambiguousStartModified = ambiguousStart.AddYears(1); - ambiguousEndModified = ambiguousEnd.AddYears(1); - isAmbiguousLocalDst = (time >= ambiguousStart && time < ambiguousEnd); + ambiguousEndModified = ambiguousEnd.AddYears(1); + isAmbiguousLocalDst = (time >= ambiguousStart && time < ambiguousEnd); } - catch (ArgumentOutOfRangeException) {} + catch (ArgumentOutOfRangeException) { } - if (!isAmbiguousLocalDst) { - try { + if (!isAmbiguousLocalDst) + { + try + { ambiguousStartModified = ambiguousStart.AddYears(-1); - ambiguousEndModified = ambiguousEnd.AddYears(-1); + ambiguousEndModified = ambiguousEnd.AddYears(-1); isAmbiguousLocalDst = (time >= ambiguousStart && time < ambiguousEnd); } - catch (ArgumentOutOfRangeException) {} + catch (ArgumentOutOfRangeException) { } } } @@ -1922,59 +1437,62 @@ namespace System { return isDst; } - - static private Boolean CheckIsDst(DateTime startTime, DateTime time, DateTime endTime, bool ignoreYearAdjustment, AdjustmentRule rule) { - Boolean isDst; - + private static bool CheckIsDst(DateTime startTime, DateTime time, DateTime endTime, bool ignoreYearAdjustment, AdjustmentRule rule) + { // NoDaylightTransitions AdjustmentRules should never get their year adjusted since they adjust the offset for the // entire time period - which may be for multiple years - if (!ignoreYearAdjustment && !rule.NoDaylightTransitions) { + if (!ignoreYearAdjustment && !rule.NoDaylightTransitions) + { int startTimeYear = startTime.Year; int endTimeYear = endTime.Year; - if (startTimeYear != endTimeYear) { + if (startTimeYear != endTimeYear) + { endTime = endTime.AddYears(startTimeYear - endTimeYear); } int timeYear = time.Year; - if (startTimeYear != timeYear) { + if (startTimeYear != timeYear) + { time = time.AddYears(startTimeYear - timeYear); } } - if (startTime > endTime) { + if (startTime > endTime) + { // In southern hemisphere, the daylight saving time starts later in the year, and ends in the beginning of next year. // Note, the summer in the southern hemisphere begins late in the year. - isDst = (time < endTime || time >= startTime); + return (time < endTime || time >= startTime); } - else if (rule.NoDaylightTransitions) { + else if (rule.NoDaylightTransitions) + { // In NoDaylightTransitions AdjustmentRules, the startTime is always before the endTime, // and both the start and end times are inclusive - isDst = (time >= startTime && time <= endTime); + return time >= startTime && time <= endTime; } - else { + else + { // In northern hemisphere, the daylight saving time starts in the middle of the year. - isDst = (time >= startTime && time < endTime); + return time >= startTime && time < endTime; } - return isDst; } - - // - // GetIsAmbiguousTime(DateTime dateTime, AdjustmentRule rule, DaylightTime daylightTime) - - // - // returns true when the dateTime falls into an ambiguous time range. - // For example, in Pacific Standard Time on Sunday, October 29, 2006 time jumps from - // 2AM to 1AM. This means the timeline on Sunday proceeds as follows: - // 12AM ... [1AM ... 1:59:59AM -> 1AM ... 1:59:59AM] 2AM ... 3AM ... - // - // In this example, any DateTime values that fall into the [1AM - 1:59:59AM] range - // are ambiguous; as it is unclear if these times are in Daylight Saving Time. - // - static private Boolean GetIsAmbiguousTime(DateTime time, AdjustmentRule rule, DaylightTimeStruct daylightTime) { - Boolean isAmbiguous = false; - if (rule == null || rule.DaylightDelta == TimeSpan.Zero) { + /// <summary> + /// Returns true when the dateTime falls into an ambiguous time range. + /// + /// For example, in Pacific Standard Time on Sunday, October 29, 2006 time jumps from + /// 2AM to 1AM. This means the timeline on Sunday proceeds as follows: + /// 12AM ... [1AM ... 1:59:59AM -> 1AM ... 1:59:59AM] 2AM ... 3AM ... + /// + /// In this example, any DateTime values that fall into the [1AM - 1:59:59AM] range + /// are ambiguous; as it is unclear if these times are in Daylight Saving Time. + /// </summary> + private static bool GetIsAmbiguousTime(DateTime time, AdjustmentRule rule, DaylightTimeStruct daylightTime) + { + bool isAmbiguous = false; + if (rule == null || rule.DaylightDelta == TimeSpan.Zero) + { return isAmbiguous; } @@ -1982,15 +1500,19 @@ namespace System { DateTime endAmbiguousTime; // if at DST start we transition forward in time then there is an ambiguous time range at the DST end - if (rule.DaylightDelta > TimeSpan.Zero) { - if (rule.IsEndDateMarkerForEndOfYear()) { // year end with daylight on so there is no ambiguous time + if (rule.DaylightDelta > TimeSpan.Zero) + { + if (rule.IsEndDateMarkerForEndOfYear()) + { // year end with daylight on so there is no ambiguous time return false; } startAmbiguousTime = daylightTime.End; endAmbiguousTime = daylightTime.End - rule.DaylightDelta; /* FUTURE: + rule.StandardDelta; */ } - else { - if (rule.IsStartDateMarkerForBeginningOfYear()) { // year start with daylight on so there is no ambiguous time + else + { + if (rule.IsStartDateMarkerForBeginningOfYear()) + { // year start with daylight on so there is no ambiguous time return false; } startAmbiguousTime = daylightTime.Start; @@ -1999,46 +1521,48 @@ namespace System { isAmbiguous = (time >= endAmbiguousTime && time < startAmbiguousTime); - if (!isAmbiguous && startAmbiguousTime.Year != endAmbiguousTime.Year) { + if (!isAmbiguous && startAmbiguousTime.Year != endAmbiguousTime.Year) + { // there exists an extreme corner case where the start or end period is on a year boundary and // because of this the comparison above might have been performed for a year-early or a year-later // than it should have been. DateTime startModifiedAmbiguousTime; DateTime endModifiedAmbiguousTime; - try { + try + { startModifiedAmbiguousTime = startAmbiguousTime.AddYears(1); - endModifiedAmbiguousTime = endAmbiguousTime.AddYears(1); + endModifiedAmbiguousTime = endAmbiguousTime.AddYears(1); isAmbiguous = (time >= endModifiedAmbiguousTime && time < startModifiedAmbiguousTime); } - catch (ArgumentOutOfRangeException) {} + catch (ArgumentOutOfRangeException) { } - if (!isAmbiguous) { - try { + if (!isAmbiguous) + { + try + { startModifiedAmbiguousTime = startAmbiguousTime.AddYears(-1); - endModifiedAmbiguousTime = endAmbiguousTime.AddYears(-1); + endModifiedAmbiguousTime = endAmbiguousTime.AddYears(-1); isAmbiguous = (time >= endModifiedAmbiguousTime && time < startModifiedAmbiguousTime); } - catch (ArgumentOutOfRangeException) {} + catch (ArgumentOutOfRangeException) { } } } return isAmbiguous; } - - - // - // GetIsInvalidTime - - // - // Helper function that checks if a given DateTime is in an invalid time ("time hole") - // A "time hole" occurs at a DST transition point when time jumps forward; - // For example, in Pacific Standard Time on Sunday, April 2, 2006 time jumps from - // 1:59:59.9999999 to 3AM. The time range 2AM to 2:59:59.9999999AM is the "time hole". - // A "time hole" is not limited to only occurring at the start of DST, and may occur at - // the end of DST as well. - // - static private Boolean GetIsInvalidTime(DateTime time, AdjustmentRule rule, DaylightTimeStruct daylightTime) { - Boolean isInvalid = false; - if (rule == null || rule.DaylightDelta == TimeSpan.Zero) { + /// <summary> + /// Helper function that checks if a given DateTime is in an invalid time ("time hole") + /// A "time hole" occurs at a DST transition point when time jumps forward; + /// For example, in Pacific Standard Time on Sunday, April 2, 2006 time jumps from + /// 1:59:59.9999999 to 3AM. The time range 2AM to 2:59:59.9999999AM is the "time hole". + /// A "time hole" is not limited to only occurring at the start of DST, and may occur at + /// the end of DST as well. + /// </summary> + private static bool GetIsInvalidTime(DateTime time, AdjustmentRule rule, DaylightTimeStruct daylightTime) + { + bool isInvalid = false; + if (rule == null || rule.DaylightDelta == TimeSpan.Zero) + { return isInvalid; } @@ -2046,7 +1570,8 @@ namespace System { DateTime endInvalidTime; // if at DST start we transition forward in time then there is an ambiguous time range at the DST end - if (rule.DaylightDelta < TimeSpan.Zero) { + if (rule.DaylightDelta < TimeSpan.Zero) + { // if the year ends with daylight saving on then there cannot be any time-hole's in that year. if (rule.IsEndDateMarkerForEndOfYear()) return false; @@ -2054,7 +1579,8 @@ namespace System { startInvalidTime = daylightTime.End; endInvalidTime = daylightTime.End - rule.DaylightDelta; /* FUTURE: + rule.StandardDelta; */ } - else { + else + { // if the year starts with daylight saving on then there cannot be any time-hole's in that year. if (rule.IsStartDateMarkerForBeginningOfYear()) return false; @@ -2065,646 +1591,105 @@ namespace System { isInvalid = (time >= startInvalidTime && time < endInvalidTime); - if (!isInvalid && startInvalidTime.Year != endInvalidTime.Year) { + if (!isInvalid && startInvalidTime.Year != endInvalidTime.Year) + { // there exists an extreme corner case where the start or end period is on a year boundary and // because of this the comparison above might have been performed for a year-early or a year-later // than it should have been. DateTime startModifiedInvalidTime; DateTime endModifiedInvalidTime; - try { + try + { startModifiedInvalidTime = startInvalidTime.AddYears(1); - endModifiedInvalidTime = endInvalidTime.AddYears(1); + endModifiedInvalidTime = endInvalidTime.AddYears(1); isInvalid = (time >= startModifiedInvalidTime && time < endModifiedInvalidTime); } - catch (ArgumentOutOfRangeException) {} + catch (ArgumentOutOfRangeException) { } - if (!isInvalid) { - try { + if (!isInvalid) + { + try + { startModifiedInvalidTime = startInvalidTime.AddYears(-1); - endModifiedInvalidTime = endInvalidTime.AddYears(-1); + endModifiedInvalidTime = endInvalidTime.AddYears(-1); isInvalid = (time >= startModifiedInvalidTime && time < endModifiedInvalidTime); } - catch (ArgumentOutOfRangeException) {} + catch (ArgumentOutOfRangeException) { } } } return isInvalid; } - - - // - // GetLocalTimeZone - - // - // Helper function for retrieving the local system time zone. - // - // returns a new TimeZoneInfo instance - // - // may throw COMException, TimeZoneNotFoundException, InvalidTimeZoneException - // - // assumes cachedData lock is taken - // - - static private TimeZoneInfo GetLocalTimeZone(CachedData cachedData) { - - -#if FEATURE_WIN32_REGISTRY - String id = null; - - // - // Try using the "kernel32!GetDynamicTimeZoneInformation" API to get the "id" - // - Win32Native.DynamicTimeZoneInformation dynamicTimeZoneInformation = - new Win32Native.DynamicTimeZoneInformation(); - - // call kernel32!GetDynamicTimeZoneInformation... - long result = UnsafeNativeMethods.GetDynamicTimeZoneInformation(out dynamicTimeZoneInformation); - if (result == Win32Native.TIME_ZONE_ID_INVALID) { - // return a dummy entry - return CreateCustomTimeZone(c_localId, TimeSpan.Zero, c_localId, c_localId); - } - - Win32Native.TimeZoneInformation timeZoneInformation = - new Win32Native.TimeZoneInformation(dynamicTimeZoneInformation); - - Boolean dstDisabled = dynamicTimeZoneInformation.DynamicDaylightTimeDisabled; - - // check to see if we can use the key name returned from the API call - if (!String.IsNullOrEmpty(dynamicTimeZoneInformation.TimeZoneKeyName)) { - TimeZoneInfo zone; - Exception ex; - - if (TryGetTimeZone(dynamicTimeZoneInformation.TimeZoneKeyName, dstDisabled, out zone, out ex, cachedData) == TimeZoneInfoResult.Success) { - // successfully loaded the time zone from the registry - return zone; - } - } - - // the key name was not returned or it pointed to a bogus entry - search for the entry ourselves - id = FindIdFromTimeZoneInformation(timeZoneInformation, out dstDisabled); - - if (id != null) { - TimeZoneInfo zone; - Exception ex; - if (TryGetTimeZone(id, dstDisabled, out zone, out ex, cachedData) == TimeZoneInfoResult.Success) { - // successfully loaded the time zone from the registry - return zone; - } - } - - // We could not find the data in the registry. Fall back to using - // the data from the Win32 API - return GetLocalTimeZoneFromWin32Data(timeZoneInformation, dstDisabled); - -#elif PLATFORM_UNIX // FEATURE_WIN32_REGISTRY - // Without Registry support, create the TimeZoneInfo from a TZ file - return GetLocalTimeZoneFromTzFile(); -#endif // FEATURE_WIN32_REGISTRY - } - - -#if PLATFORM_UNIX - private static TimeZoneInfoResult TryGetTimeZoneByFile(string id, out TimeZoneInfo value, out Exception e) - { - value = null; - e = null; - - string timeZoneDirectory = GetTimeZoneDirectory(); - string timeZoneFilePath = Path.Combine(timeZoneDirectory, id); - byte[] rawData; - try - { - rawData = File.ReadAllBytes(timeZoneFilePath); - } - catch (UnauthorizedAccessException ex) - { - e = ex; - return TimeZoneInfoResult.SecurityException; - } - catch (FileNotFoundException ex) - { - e = ex; - return TimeZoneInfoResult.TimeZoneNotFoundException; - } - catch (DirectoryNotFoundException ex) - { - e = ex; - return TimeZoneInfoResult.TimeZoneNotFoundException; - } - catch (IOException ex) - { - e = new InvalidTimeZoneException(Environment.GetResourceString("InvalidTimeZone_InvalidFileData", id, timeZoneFilePath), ex); - return TimeZoneInfoResult.InvalidTimeZoneException; - } - - value = GetTimeZoneFromTzData(rawData, id); - - if (value == null) - { - e = new InvalidTimeZoneException(Environment.GetResourceString("InvalidTimeZone_InvalidFileData", id, timeZoneFilePath)); - return TimeZoneInfoResult.InvalidTimeZoneException; - } - - return TimeZoneInfoResult.Success; - } - /// <summary> - /// Returns a collection of TimeZone Id values from the zone.tab file in the timeZoneDirectory. + /// Helper function that calculates the UTC offset for a dateTime in a timeZone. + /// This function assumes that the dateTime is already converted into the timeZone. /// </summary> - /// <remarks> - /// Lines that start with # are comments and are skipped. - /// </remarks> - private static IEnumerable<string> GetTimeZoneIds(string timeZoneDirectory) + private static TimeSpan GetUtcOffset(DateTime time, TimeZoneInfo zone, TimeZoneInfoOptions flags) { - string[] zoneTabFileLines = null; - try - { - zoneTabFileLines = File.ReadAllLines(Path.Combine(timeZoneDirectory, c_zoneTabFileName)); - } - catch (IOException) { } - catch (UnauthorizedAccessException) { } + TimeSpan baseOffset = zone.BaseUtcOffset; + AdjustmentRule rule = zone.GetAdjustmentRuleForTime(time); - List<string> timeZoneIds = new List<string>(); - if (zoneTabFileLines != null) + if (rule != null) { - foreach (string zoneTabFileLine in zoneTabFileLines) + baseOffset = baseOffset + rule.BaseUtcOffsetDelta; + if (rule.HasDaylightSaving) { - if (!string.IsNullOrEmpty(zoneTabFileLine) && !zoneTabFileLine.StartsWith("#")) - { - // the format of the line is "country-code \t coordinates \t TimeZone Id \t comments" - - int firstTabIndex = zoneTabFileLine.IndexOf('\t'); - if (firstTabIndex != -1) - { - int secondTabIndex = zoneTabFileLine.IndexOf('\t', firstTabIndex + 1); - if (secondTabIndex != -1) - { - string timeZoneId; - int startIndex = secondTabIndex + 1; - int thirdTabIndex = zoneTabFileLine.IndexOf('\t', startIndex); - if (thirdTabIndex != -1) - { - int length = thirdTabIndex - startIndex; - timeZoneId = zoneTabFileLine.Substring(startIndex, length); - } - else - { - timeZoneId = zoneTabFileLine.Substring(startIndex); - } - - if (!string.IsNullOrEmpty(timeZoneId)) - { - timeZoneIds.Add(timeZoneId); - } - } - } - } + DaylightTimeStruct daylightTime = zone.GetDaylightTime(time.Year, rule); + bool isDaylightSavings = GetIsDaylightSavings(time, rule, daylightTime, flags); + baseOffset += (isDaylightSavings ? rule.DaylightDelta : TimeSpan.Zero /* FUTURE: rule.StandardDelta */); } } - return timeZoneIds; + return baseOffset; } /// <summary> - /// Gets the tzfile raw data for the current 'local' time zone using the following rules. - /// 1. Read the TZ environment variable. If it is set, use it. - /// 2. Look for the data in /etc/localtime. - /// 3. Look for the data in GetTimeZoneDirectory()/localtime. - /// 4. Use UTC if all else fails. + /// Helper function that calculates the UTC offset for a UTC-dateTime in a timeZone. + /// This function assumes that the dateTime is represented in UTC and has *not* already been converted into the timeZone. /// </summary> - private static bool TryGetLocalTzFile(out byte[] rawData, out string id) + private static TimeSpan GetUtcOffsetFromUtc(DateTime time, TimeZoneInfo zone) { - rawData = null; - id = null; - string tzVariable = GetTzEnvironmentVariable(); - - // If the env var is null, use the localtime file - if (tzVariable == null) - { - return - TryLoadTzFile("/etc/localtime", ref rawData, ref id) || - TryLoadTzFile(Path.Combine(GetTimeZoneDirectory(), "localtime"), ref rawData, ref id); - } - - // If it's empty, use UTC (TryGetLocalTzFile() should return false). - if (tzVariable.Length == 0) - { - return false; - } - - // Otherwise, use the path from the env var. If it's not absolute, make it relative - // to the system timezone directory - string tzFilePath; - if (tzVariable[0] != '/') - { - id = tzVariable; - tzFilePath = Path.Combine(GetTimeZoneDirectory(), tzVariable); - } - else - { - tzFilePath = tzVariable; - } - return TryLoadTzFile(tzFilePath, ref rawData, ref id); - } - - private static string GetTzEnvironmentVariable() - { - string result = Environment.GetEnvironmentVariable(c_timeZoneEnvironmentVariable); - if (!string.IsNullOrEmpty(result)) - { - if (result[0] == ':') - { - // strip off the ':' prefix - result = result.Substring(1); - } - } - - return result; - } - - private static bool TryLoadTzFile(string tzFilePath, ref byte[] rawData, ref string id) - { - if (File.Exists(tzFilePath)) - { - try - { - rawData = File.ReadAllBytes(tzFilePath); - if (string.IsNullOrEmpty(id)) - { - id = FindTimeZoneIdUsingReadLink(tzFilePath); - - if (string.IsNullOrEmpty(id)) - { - id = FindTimeZoneId(rawData); - } - } - return true; - } - catch (IOException) { } - catch (SecurityException) { } - catch (UnauthorizedAccessException) { } - } - return false; + bool isDaylightSavings; + return GetUtcOffsetFromUtc(time, zone, out isDaylightSavings); } /// <summary> - /// Finds the time zone id by using 'readlink' on the path to see if tzFilePath is - /// a symlink to a file + /// Helper function that calculates the UTC offset for a UTC-dateTime in a timeZone. + /// This function assumes that the dateTime is represented in UTC and has *not* already been converted into the timeZone. /// </summary> - private static string FindTimeZoneIdUsingReadLink(string tzFilePath) + private static TimeSpan GetUtcOffsetFromUtc(DateTime time, TimeZoneInfo zone, out bool isDaylightSavings) { - string id = null; - - StringBuilder symlinkPathBuilder = StringBuilderCache.Acquire(Path.MaxPath); - bool result = Interop.GlobalizationInterop.ReadLink(tzFilePath, symlinkPathBuilder, (uint)symlinkPathBuilder.Capacity); - if (result) - { - string symlinkPath = StringBuilderCache.GetStringAndRelease(symlinkPathBuilder); - // time zone Ids have to point under the time zone directory - string timeZoneDirectory = GetTimeZoneDirectory(); - if (symlinkPath.StartsWith(timeZoneDirectory)) - { - id = symlinkPath.Substring(timeZoneDirectory.Length); - } - } - else - { - StringBuilderCache.Release(symlinkPathBuilder); - } - - return id; + bool isAmbiguousLocalDst; + return GetUtcOffsetFromUtc(time, zone, out isDaylightSavings, out isAmbiguousLocalDst); } /// <summary> - /// Find the time zone id by searching all the tzfiles for the one that matches rawData - /// and return its file name. + /// Helper function that calculates the UTC offset for a UTC-dateTime in a timeZone. + /// This function assumes that the dateTime is represented in UTC and has *not* already been converted into the timeZone. /// </summary> - private static string FindTimeZoneId(byte[] rawData) - { - // default to "Local" if we can't find the right tzfile - string id = c_localId; - string timeZoneDirectory = GetTimeZoneDirectory(); - string localtimeFilePath = Path.Combine(timeZoneDirectory, "localtime"); - string posixrulesFilePath = Path.Combine(timeZoneDirectory, "posixrules"); - byte[] buffer = new byte[rawData.Length]; - - try - { - foreach (string filePath in Directory.EnumerateFiles(timeZoneDirectory, "*", SearchOption.AllDirectories)) - { - // skip the localtime and posixrules file, since they won't give us the correct id - if (!string.Equals(filePath, localtimeFilePath, StringComparison.OrdinalIgnoreCase) - && !string.Equals(filePath, posixrulesFilePath, StringComparison.OrdinalIgnoreCase)) - { - if (CompareTimeZoneFile(filePath, buffer, rawData)) - { - // if all bytes are the same, this must be the right tz file - id = filePath; - - // strip off the root time zone directory - if (id.StartsWith(timeZoneDirectory)) - { - id = id.Substring(timeZoneDirectory.Length); - } - break; - } - } - } - } - catch (IOException) { } - catch (SecurityException) { } - catch (UnauthorizedAccessException) { } - - return id; - } - - private static bool CompareTimeZoneFile(string filePath, byte[] buffer, byte[] rawData) - { - try - { - using (FileStream stream = new FileStream(filePath, FileMode.Open, FileAccess.Read)) - { - if (stream.Length == rawData.Length) - { - int index = 0; - int count = rawData.Length; - - while (count > 0) - { - int n = stream.Read(buffer, index, count); - if (n == 0) - __Error.EndOfFile(); - - int end = index + n; - for (; index < end; index++) - { - if (buffer[index] != rawData[index]) - { - return false; - } - } - - count -= n; - } - - return true; - } - } - } - catch (IOException) { } - catch (SecurityException) { } - catch (UnauthorizedAccessException) { } - - return false; - } - - // - // GetLocalTimeZoneFromTzFile - - // - // Helper function used by 'GetLocalTimeZone()' - this function wraps the call - // for loading time zone data from computers without Registry support. - // - // The TryGetLocalTzFile() call returns a Byte[] containing the compiled tzfile. - // - static private TimeZoneInfo GetLocalTimeZoneFromTzFile() - { - byte[] rawData; - string id; - if (TryGetLocalTzFile(out rawData, out id)) - { - TimeZoneInfo result = GetTimeZoneFromTzData(rawData, id); - if (result != null) - { - return result; - } - } - - // if we can't find a local time zone, return UTC - return Utc; - } - - private static TimeZoneInfo GetTimeZoneFromTzData(byte[] rawData, string id) + internal static TimeSpan GetUtcOffsetFromUtc(DateTime time, TimeZoneInfo zone, out bool isDaylightSavings, out bool isAmbiguousLocalDst) { - if (rawData != null) - { - try - { - return new TimeZoneInfo(rawData, id, false); // create a TimeZoneInfo instance from the TZif data w/ DST support - } - catch (ArgumentException) { } - catch (InvalidTimeZoneException) { } - try - { - return new TimeZoneInfo(rawData, id, true); // create a TimeZoneInfo instance from the TZif data w/o DST support - } - catch (ArgumentException) { } - catch (InvalidTimeZoneException) { } - } - - return null; - } - - private static string GetTimeZoneDirectory() - { - string tzDirectory = Environment.GetEnvironmentVariable(c_timeZoneDirectoryEnvironmentVariable); - - if (tzDirectory == null) - { - tzDirectory = c_defaultTimeZoneDirectory; - } - else if (!tzDirectory.EndsWith(Path.DirectorySeparatorChar)) - { - tzDirectory += Path.DirectorySeparatorChar; - } - - return tzDirectory; - } -#elif FEATURE_WIN32_REGISTRY // PLATFORM_UNIX - - // - // GetLocalTimeZoneFromWin32Data - - // - // Helper function used by 'GetLocalTimeZone()' - this function wraps a bunch of - // try/catch logic for handling the TimeZoneInfo private constructor that takes - // a Win32Native.TimeZoneInformation structure. - // - static private TimeZoneInfo GetLocalTimeZoneFromWin32Data(Win32Native.TimeZoneInformation timeZoneInformation, Boolean dstDisabled) { - // first try to create the TimeZoneInfo with the original 'dstDisabled' flag - try { - return new TimeZoneInfo(timeZoneInformation, dstDisabled); - } - catch (ArgumentException) {} - catch (InvalidTimeZoneException) {} - - // if 'dstDisabled' was false then try passing in 'true' as a last ditch effort - if (!dstDisabled) { - try { - return new TimeZoneInfo(timeZoneInformation, true); - } - catch (ArgumentException) {} - catch (InvalidTimeZoneException) {} - } - - // the data returned from Windows is completely bogus; return a dummy entry - return CreateCustomTimeZone(c_localId, TimeSpan.Zero, c_localId, c_localId); - } -#endif // PLATFORM_UNIX - - // - // FindSystemTimeZoneById - - // - // Helper function for retrieving a TimeZoneInfo object by <time_zone_name>. - // This function wraps the logic necessary to keep the private - // SystemTimeZones cache in working order - // - // This function will either return a valid TimeZoneInfo instance or - // it will throw 'InvalidTimeZoneException' / 'TimeZoneNotFoundException'. - // - static public TimeZoneInfo FindSystemTimeZoneById(string id) { - - // Special case for Utc as it will not exist in the dictionary with the rest - // of the system time zones. There is no need to do this check for Local.Id - // since Local is a real time zone that exists in the dictionary cache - if (String.Compare(id, c_utcId, StringComparison.OrdinalIgnoreCase) == 0) { - return TimeZoneInfo.Utc; - } - - if (id == null) { - throw new ArgumentNullException(nameof(id)); - } - else if (!IsValidSystemTimeZoneId(id)) { - throw new TimeZoneNotFoundException(Environment.GetResourceString("TimeZoneNotFound_MissingData", id)); - } - - TimeZoneInfo value; - Exception e; - - TimeZoneInfoResult result; - - CachedData cachedData = s_cachedData; - - lock (cachedData) { - result = TryGetTimeZone(id, false, out value, out e, cachedData); - } - - if (result == TimeZoneInfoResult.Success) { - return value; - } - else if (result == TimeZoneInfoResult.InvalidTimeZoneException) { -#if FEATURE_WIN32_REGISTRY - throw new InvalidTimeZoneException(Environment.GetResourceString("InvalidTimeZone_InvalidRegistryData", id), e); -#elif PLATFORM_UNIX - Debug.Assert(e is InvalidTimeZoneException, - "TryGetTimeZone must create an InvalidTimeZoneException when it returns TimeZoneInfoResult.InvalidTimeZoneException"); - throw e; -#endif - } - else if (result == TimeZoneInfoResult.SecurityException) { -#if FEATURE_WIN32_REGISTRY - throw new SecurityException(Environment.GetResourceString("Security_CannotReadRegistryData", id), e); -#elif PLATFORM_UNIX - throw new SecurityException(Environment.GetResourceString("Security_CannotReadFileData", id), e); -#endif - } - else { - throw new TimeZoneNotFoundException(Environment.GetResourceString("TimeZoneNotFound_MissingData", id), e); - } - } - - private static bool IsValidSystemTimeZoneId(string id) - { - bool isValid = id.Length != 0 && !id.Contains("\0"); - -#if FEATURE_WIN32_REGISTRY - isValid &= id.Length <= c_maxKeyLength; -#endif // FEATURE_WIN32_REGISTRY - - return isValid; - } - - // - // GetUtcOffset - - // - // Helper function that calculates the UTC offset for a dateTime in a timeZone. - // This function assumes that the dateTime is already converted into the timeZone. - // - static private TimeSpan GetUtcOffset(DateTime time, TimeZoneInfo zone, TimeZoneInfoOptions flags) { - TimeSpan baseOffset = zone.BaseUtcOffset; - AdjustmentRule rule = zone.GetAdjustmentRuleForTime(time); - - if (rule != null) { - baseOffset = baseOffset + rule.BaseUtcOffsetDelta; - if (rule.HasDaylightSaving) { - DaylightTimeStruct daylightTime = zone.GetDaylightTime(time.Year, rule); - Boolean isDaylightSavings = GetIsDaylightSavings(time, rule, daylightTime, flags); - baseOffset += (isDaylightSavings ? rule.DaylightDelta : TimeSpan.Zero /* FUTURE: rule.StandardDelta */); - } - } - - return baseOffset; - } - - - // - // GetUtcOffsetFromUtc - - // - // Helper function that calculates the UTC offset for a UTC-dateTime in a timeZone. - // This function assumes that the dateTime is represented in UTC and has *not* - // already been converted into the timeZone. - // - static private TimeSpan GetUtcOffsetFromUtc(DateTime time, TimeZoneInfo zone) { - Boolean isDaylightSavings; - return GetUtcOffsetFromUtc(time, zone, out isDaylightSavings); - } - - static private TimeSpan GetUtcOffsetFromUtc(DateTime time, TimeZoneInfo zone, out Boolean isDaylightSavings) { - Boolean isAmbiguousLocalDst; - return GetUtcOffsetFromUtc(time, zone, out isDaylightSavings, out isAmbiguousLocalDst); - } - - // DateTime.Now fast path that avoids allocating an historically accurate TimeZoneInfo.Local and just creates a 1-year (current year) accurate time zone - static internal TimeSpan GetDateTimeNowUtcOffsetFromUtc(DateTime time, out Boolean isAmbiguousLocalDst) { - Boolean isDaylightSavings = false; -#if FEATURE_WIN32_REGISTRY - isAmbiguousLocalDst = false; - TimeSpan baseOffset; - int timeYear = time.Year; - - OffsetAndRule match = s_cachedData.GetOneYearLocalFromUtc(timeYear); - baseOffset = match.offset; - - if (match.rule != null) { - baseOffset = baseOffset + match.rule.BaseUtcOffsetDelta; - if (match.rule.HasDaylightSaving) { - isDaylightSavings = GetIsDaylightSavingsFromUtc(time, timeYear, match.offset, match.rule, out isAmbiguousLocalDst, TimeZoneInfo.Local); - baseOffset += (isDaylightSavings ? match.rule.DaylightDelta : TimeSpan.Zero /* FUTURE: rule.StandardDelta */); - } - } - return baseOffset; -#elif PLATFORM_UNIX - // Use the standard code path for the Macintosh since there isn't a faster way of handling current-year-only time zones - return GetUtcOffsetFromUtc(time, TimeZoneInfo.Local, out isDaylightSavings, out isAmbiguousLocalDst); -#endif // FEATURE_WIN32_REGISTRY - } - - static internal TimeSpan GetUtcOffsetFromUtc(DateTime time, TimeZoneInfo zone, out Boolean isDaylightSavings, out Boolean isAmbiguousLocalDst) { isDaylightSavings = false; isAmbiguousLocalDst = false; TimeSpan baseOffset = zone.BaseUtcOffset; - Int32 year; + int year; AdjustmentRule rule; - if (time > s_maxDateOnly) { + if (time > s_maxDateOnly) + { rule = zone.GetAdjustmentRuleForTime(DateTime.MaxValue); year = 9999; } - else if (time < s_minDateOnly) { + else if (time < s_minDateOnly) + { rule = zone.GetAdjustmentRuleForTime(DateTime.MinValue); year = 1; } - else { + else + { rule = zone.GetAdjustmentRuleForTime(time, dateTimeisUtc: true); - // As we get the associated rule using the adjusted targetTime, we should use the adjusted year (targetTime.Year) too as after adding the baseOffset, + // As we get the associated rule using the adjusted targetTime, we should use the adjusted year (targetTime.Year) too as after adding the baseOffset, // sometimes the year value can change if the input datetime was very close to the beginning or the end of the year. Examples of such cases: // Libya Standard Time when used with the date 2011-12-31T23:59:59.9999999Z // "W. Australia Standard Time" used with date 2005-12-31T23:59:00.0000000Z @@ -2712,10 +1697,12 @@ namespace System { year = targetTime.Year; } - if (rule != null) { + if (rule != null) + { baseOffset = baseOffset + rule.BaseUtcOffsetDelta; - if (rule.HasDaylightSaving) { - isDaylightSavings = GetIsDaylightSavingsFromUtc(time, year, zone.m_baseUtcOffset, rule, out isAmbiguousLocalDst, zone); + if (rule.HasDaylightSaving) + { + isDaylightSavings = GetIsDaylightSavingsFromUtc(time, year, zone._baseUtcOffset, rule, out isAmbiguousLocalDst, zone); baseOffset += (isDaylightSavings ? rule.DaylightDelta : TimeSpan.Zero /* FUTURE: rule.StandardDelta */); } } @@ -2723,140 +1710,28 @@ namespace System { return baseOffset; } -#if FEATURE_WIN32_REGISTRY - // - // TransitionTimeFromTimeZoneInformation - - // - // Converts a Win32Native.RegistryTimeZoneInformation (REG_TZI_FORMAT struct) to a TransitionTime - // - // * when the argument 'readStart' is true the corresponding daylightTransitionTimeStart field is read - // * when the argument 'readStart' is false the corresponding dayightTransitionTimeEnd field is read - // - static private bool TransitionTimeFromTimeZoneInformation(Win32Native.RegistryTimeZoneInformation timeZoneInformation, out TransitionTime transitionTime, bool readStartDate) { - // - // SYSTEMTIME - - // - // If the time zone does not support daylight saving time or if the caller needs - // to disable daylight saving time, the wMonth member in the SYSTEMTIME structure - // must be zero. If this date is specified, the DaylightDate value in the - // TIME_ZONE_INFORMATION structure must also be specified. Otherwise, the system - // assumes the time zone data is invalid and no changes will be applied. - // - bool supportsDst = (timeZoneInformation.StandardDate.Month != 0); - - if (!supportsDst) { - transitionTime = default(TransitionTime); - return false; - } - - // - // SYSTEMTIME - - // - // * FixedDateRule - - // If the Year member is not zero, the transition date is absolute; it will only occur one time - // - // * FloatingDateRule - - // To select the correct day in the month, set the Year member to zero, the Hour and Minute - // members to the transition time, the DayOfWeek member to the appropriate weekday, and the - // Day member to indicate the occurence of the day of the week within the month (first through fifth). - // - // Using this notation, specify the 2:00a.m. on the first Sunday in April as follows: - // Hour = 2, - // Month = 4, - // DayOfWeek = 0, - // Day = 1. - // - // Specify 2:00a.m. on the last Thursday in October as follows: - // Hour = 2, - // Month = 10, - // DayOfWeek = 4, - // Day = 5. - // - if (readStartDate) { - // - // read the "daylightTransitionStart" - // - if (timeZoneInformation.DaylightDate.Year == 0) { - transitionTime = TransitionTime.CreateFloatingDateRule( - new DateTime(1, /* year */ - 1, /* month */ - 1, /* day */ - timeZoneInformation.DaylightDate.Hour, - timeZoneInformation.DaylightDate.Minute, - timeZoneInformation.DaylightDate.Second, - timeZoneInformation.DaylightDate.Milliseconds), - timeZoneInformation.DaylightDate.Month, - timeZoneInformation.DaylightDate.Day, /* Week 1-5 */ - (DayOfWeek) timeZoneInformation.DaylightDate.DayOfWeek); - } - else { - transitionTime = TransitionTime.CreateFixedDateRule( - new DateTime(1, /* year */ - 1, /* month */ - 1, /* day */ - timeZoneInformation.DaylightDate.Hour, - timeZoneInformation.DaylightDate.Minute, - timeZoneInformation.DaylightDate.Second, - timeZoneInformation.DaylightDate.Milliseconds), - timeZoneInformation.DaylightDate.Month, - timeZoneInformation.DaylightDate.Day); - } - } - else { - // - // read the "daylightTransitionEnd" - // - if (timeZoneInformation.StandardDate.Year == 0) { - transitionTime = TransitionTime.CreateFloatingDateRule( - new DateTime(1, /* year */ - 1, /* month */ - 1, /* day */ - timeZoneInformation.StandardDate.Hour, - timeZoneInformation.StandardDate.Minute, - timeZoneInformation.StandardDate.Second, - timeZoneInformation.StandardDate.Milliseconds), - timeZoneInformation.StandardDate.Month, - timeZoneInformation.StandardDate.Day, /* Week 1-5 */ - (DayOfWeek) timeZoneInformation.StandardDate.DayOfWeek); - } - else { - transitionTime = TransitionTime.CreateFixedDateRule( - new DateTime(1, /* year */ - 1, /* month */ - 1, /* day */ - timeZoneInformation.StandardDate.Hour, - timeZoneInformation.StandardDate.Minute, - timeZoneInformation.StandardDate.Second, - timeZoneInformation.StandardDate.Milliseconds), - timeZoneInformation.StandardDate.Month, - timeZoneInformation.StandardDate.Day); - } - } - - return true; - } -#endif // FEATURE_WIN32_REGISTRY - - // - // TransitionTimeToDateTime - - // - // Helper function that converts a year and TransitionTime into a DateTime - // - internal static DateTime TransitionTimeToDateTime(Int32 year, TransitionTime transitionTime) { + /// <summary> + /// Helper function that converts a year and TransitionTime into a DateTime. + /// </summary> + internal static DateTime TransitionTimeToDateTime(int year, TransitionTime transitionTime) + { DateTime value; DateTime timeOfDay = transitionTime.TimeOfDay; - if (transitionTime.IsFixedDateRule) { + if (transitionTime.IsFixedDateRule) + { // create a DateTime from the passed in year and the properties on the transitionTime // if the day is out of range for the month then use the last day of the month - Int32 day = DateTime.DaysInMonth(year, transitionTime.Month); + int day = DateTime.DaysInMonth(year, transitionTime.Month); - value = new DateTime(year, transitionTime.Month, (day < transitionTime.Day) ? day : transitionTime.Day, + value = new DateTime(year, transitionTime.Month, (day < transitionTime.Day) ? day : transitionTime.Day, timeOfDay.Hour, timeOfDay.Minute, timeOfDay.Second, timeOfDay.Millisecond); } - else { - if (transitionTime.Week <= 4) { + else + { + if (transitionTime.Week <= 4) + { // // Get the (transitionTime.Week)th Sunday. // @@ -2865,31 +1740,36 @@ namespace System { int dayOfWeek = (int)value.DayOfWeek; int delta = (int)transitionTime.DayOfWeek - dayOfWeek; - if (delta < 0) { + if (delta < 0) + { delta += 7; } delta += 7 * (transitionTime.Week - 1); - if (delta > 0) { + if (delta > 0) + { value = value.AddDays(delta); } } - else { + else + { // // If TransitionWeek is greater than 4, we will get the last week. // - Int32 daysInMonth = DateTime.DaysInMonth(year, transitionTime.Month); + int daysInMonth = DateTime.DaysInMonth(year, transitionTime.Month); value = new DateTime(year, transitionTime.Month, daysInMonth, timeOfDay.Hour, timeOfDay.Minute, timeOfDay.Second, timeOfDay.Millisecond); // This is the day of week for the last day of the month. int dayOfWeek = (int)value.DayOfWeek; int delta = dayOfWeek - (int)transitionTime.DayOfWeek; - if (delta < 0) { + if (delta < 0) + { delta += 7; } - if (delta > 0) { + if (delta > 0) + { value = value.AddDays(-delta); } } @@ -2897,598 +1777,56 @@ namespace System { return value; } -#if FEATURE_WIN32_REGISTRY - // - // TryCreateAdjustmentRules - - // - // Helper function that takes - // 1. a string representing a <time_zone_name> registry key name - // 2. a RegistryTimeZoneInformation struct containing the default rule - // 3. an AdjustmentRule[] out-parameter - // - // returns - // TimeZoneInfoResult.InvalidTimeZoneException, - // TimeZoneInfoResult.TimeZoneNotFoundException, - // TimeZoneInfoResult.Success - // - // Optional, Dynamic Time Zone Registry Data - // -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- - // - // HKLM - // Software - // Microsoft - // Windows NT - // CurrentVersion - // Time Zones - // <time_zone_name> - // Dynamic DST - // * "FirstEntry" REG_DWORD "1980" - // First year in the table. If the current year is less than this value, - // this entry will be used for DST boundaries - // * "LastEntry" REG_DWORD "2038" - // Last year in the table. If the current year is greater than this value, - // this entry will be used for DST boundaries" - // * "<year1>" REG_BINARY REG_TZI_FORMAT - // See Win32Native.RegistryTimeZoneInformation - // * "<year2>" REG_BINARY REG_TZI_FORMAT - // See Win32Native.RegistryTimeZoneInformation - // * "<year3>" REG_BINARY REG_TZI_FORMAT - // See Win32Native.RegistryTimeZoneInformation - // - // This method expects that its caller has already Asserted RegistryPermission.Read - // - static private bool TryCreateAdjustmentRules(string id, Win32Native.RegistryTimeZoneInformation defaultTimeZoneInformation, out AdjustmentRule[] rules, out Exception e, int defaultBaseUtcOffset) { - e = null; - - try { - using (RegistryKey dynamicKey = Registry.LocalMachine.OpenSubKey( - c_timeZonesRegistryHive + "\\" + id + "\\Dynamic DST", - false)) { - if (dynamicKey == null) { - AdjustmentRule rule = CreateAdjustmentRuleFromTimeZoneInformation( - defaultTimeZoneInformation, DateTime.MinValue.Date, DateTime.MaxValue.Date, defaultBaseUtcOffset); - - if (rule == null) - { - rules = null; - } - else - { - rules = new AdjustmentRule[1]; - rules[0] = rule; - } - - return true; - } - - // - // loop over all of the "<time_zone_name>\Dynamic DST" hive entries - // - // read FirstEntry {MinValue - (year1, 12, 31)} - // read MiddleEntry {(yearN, 1, 1) - (yearN, 12, 31)} - // read LastEntry {(yearN, 1, 1) - MaxValue } - - // read the FirstEntry and LastEntry key values (ex: "1980", "2038") - Int32 first = (Int32)dynamicKey.GetValue(c_firstEntryValue, -1, RegistryValueOptions.None); - Int32 last = (Int32)dynamicKey.GetValue(c_lastEntryValue, -1, RegistryValueOptions.None); - - if (first == -1 || last == -1 || first > last) - { - rules = null; - return false; - } - - // read the first year entry - Win32Native.RegistryTimeZoneInformation dtzi; - Byte[] regValue = dynamicKey.GetValue(first.ToString(CultureInfo.InvariantCulture), null, RegistryValueOptions.None) as Byte[]; - if (regValue == null || regValue.Length != c_regByteLength) - { - rules = null; - return false; - } - dtzi = new Win32Native.RegistryTimeZoneInformation(regValue); - - if (first == last) - { - // there is just 1 dynamic rule for this time zone. - AdjustmentRule rule = CreateAdjustmentRuleFromTimeZoneInformation(dtzi, DateTime.MinValue.Date, DateTime.MaxValue.Date, defaultBaseUtcOffset); - - if (rule == null) - { - rules = null; - } - else - { - rules = new AdjustmentRule[1]; - rules[0] = rule; - } - - return true; - } - - List<AdjustmentRule> rulesList = new List<AdjustmentRule>(1); - - // there are more than 1 dynamic rules for this time zone. - AdjustmentRule firstRule = CreateAdjustmentRuleFromTimeZoneInformation( - dtzi, - DateTime.MinValue.Date, // MinValue - new DateTime(first, 12, 31), // December 31, <FirstYear> - defaultBaseUtcOffset); - if (firstRule != null) - { - rulesList.Add(firstRule); - } - - // read the middle year entries - for (Int32 i = first + 1; i < last; i++) - { - regValue = dynamicKey.GetValue(i.ToString(CultureInfo.InvariantCulture), null, RegistryValueOptions.None) as Byte[]; - if (regValue == null || regValue.Length != c_regByteLength) - { - rules = null; - return false; - } - dtzi = new Win32Native.RegistryTimeZoneInformation(regValue); - AdjustmentRule middleRule = CreateAdjustmentRuleFromTimeZoneInformation( - dtzi, - new DateTime(i, 1, 1), // January 01, <Year> - new DateTime(i, 12, 31), // December 31, <Year> - defaultBaseUtcOffset); - if (middleRule != null) - { - rulesList.Add(middleRule); - } - } - // read the last year entry - regValue = dynamicKey.GetValue(last.ToString(CultureInfo.InvariantCulture), null, RegistryValueOptions.None) as Byte[]; - dtzi = new Win32Native.RegistryTimeZoneInformation(regValue); - if (regValue == null || regValue.Length != c_regByteLength) - { - rules = null; - return false; - } - AdjustmentRule lastRule = CreateAdjustmentRuleFromTimeZoneInformation( - dtzi, - new DateTime(last, 1, 1), // January 01, <LastYear> - DateTime.MaxValue.Date, // MaxValue - defaultBaseUtcOffset); - if (lastRule != null) - { - rulesList.Add(lastRule); - } - - // convert the ArrayList to an AdjustmentRule array - rules = rulesList.ToArray(); - if (rules != null && rules.Length == 0) - { - rules = null; - } - } // end of: using (RegistryKey dynamicKey... - } - catch (InvalidCastException ex) { - // one of the RegistryKey.GetValue calls could not be cast to an expected value type - rules = null; - e = ex; - return false; - } - catch (ArgumentOutOfRangeException ex) { - rules = null; - e = ex; - return false; - } - catch (ArgumentException ex) { - rules = null; - e = ex; - return false; - } - return true; - } - - // - // TryCompareStandardDate - - // - // Helper function that compares the StandardBias and StandardDate portion a - // TimeZoneInformation struct to a time zone registry entry - // - static private Boolean TryCompareStandardDate(Win32Native.TimeZoneInformation timeZone, Win32Native.RegistryTimeZoneInformation registryTimeZoneInfo) { - return timeZone.Bias == registryTimeZoneInfo.Bias - && timeZone.StandardBias == registryTimeZoneInfo.StandardBias - && timeZone.StandardDate.Year == registryTimeZoneInfo.StandardDate.Year - && timeZone.StandardDate.Month == registryTimeZoneInfo.StandardDate.Month - && timeZone.StandardDate.DayOfWeek == registryTimeZoneInfo.StandardDate.DayOfWeek - && timeZone.StandardDate.Day == registryTimeZoneInfo.StandardDate.Day - && timeZone.StandardDate.Hour == registryTimeZoneInfo.StandardDate.Hour - && timeZone.StandardDate.Minute == registryTimeZoneInfo.StandardDate.Minute - && timeZone.StandardDate.Second == registryTimeZoneInfo.StandardDate.Second - && timeZone.StandardDate.Milliseconds == registryTimeZoneInfo.StandardDate.Milliseconds; - } - - // - // TryCompareTimeZoneInformationToRegistry - - // - // Helper function that compares a TimeZoneInformation struct to a time zone registry entry - // - static private Boolean TryCompareTimeZoneInformationToRegistry(Win32Native.TimeZoneInformation timeZone, string id, out Boolean dstDisabled) + /// <summary> + /// Helper function for retrieving a TimeZoneInfo object by <time_zone_name>. + /// + /// This function may return null. + /// + /// assumes cachedData lock is taken + /// </summary> + private static TimeZoneInfoResult TryGetTimeZone(string id, bool dstDisabled, out TimeZoneInfo value, out Exception e, CachedData cachedData, bool alwaysFallbackToLocalMachine = false) { - dstDisabled = false; - try { - PermissionSet permSet = new PermissionSet(PermissionState.None); - permSet.AddPermission(new RegistryPermission(RegistryPermissionAccess.Read, c_timeZonesRegistryHivePermissionList)); - permSet.Assert(); - - using (RegistryKey key = Registry.LocalMachine.OpenSubKey( - c_timeZonesRegistryHive + "\\" + id, - false)) - { - - if (key == null) { - return false; - } - - Win32Native.RegistryTimeZoneInformation registryTimeZoneInfo; - Byte[] regValue = (Byte[])key.GetValue(c_timeZoneInfoValue, null, RegistryValueOptions.None) as Byte[]; - if (regValue == null || regValue.Length != c_regByteLength) return false; - registryTimeZoneInfo = new Win32Native.RegistryTimeZoneInformation(regValue); - - // - // first compare the bias and standard date information between the data from the Win32 API - // and the data from the registry... - // - Boolean result = TryCompareStandardDate(timeZone, registryTimeZoneInfo); - - if (!result) - { - return false; - } - - result = dstDisabled || CheckDaylightSavingTimeNotSupported(timeZone) - // - // since Daylight Saving Time is not "disabled", do a straight comparision between - // the Win32 API data and the registry data ... - // - || (timeZone.DaylightBias == registryTimeZoneInfo.DaylightBias - && timeZone.DaylightDate.Year == registryTimeZoneInfo.DaylightDate.Year - && timeZone.DaylightDate.Month == registryTimeZoneInfo.DaylightDate.Month - && timeZone.DaylightDate.DayOfWeek == registryTimeZoneInfo.DaylightDate.DayOfWeek - && timeZone.DaylightDate.Day == registryTimeZoneInfo.DaylightDate.Day - && timeZone.DaylightDate.Hour == registryTimeZoneInfo.DaylightDate.Hour - && timeZone.DaylightDate.Minute == registryTimeZoneInfo.DaylightDate.Minute - && timeZone.DaylightDate.Second == registryTimeZoneInfo.DaylightDate.Second - && timeZone.DaylightDate.Milliseconds == registryTimeZoneInfo.DaylightDate.Milliseconds); - - // Finally compare the "StandardName" string value... - // - // we do not compare "DaylightName" as this TimeZoneInformation field may contain - // either "StandardName" or "DaylightName" depending on the time of year and current machine settings - // - if (result) - { - String registryStandardName = key.GetValue(c_standardValue, String.Empty, RegistryValueOptions.None) as String; - result = String.Compare(registryStandardName, timeZone.StandardName, StringComparison.Ordinal) == 0; - } - return result; - } - } - finally { - PermissionSet.RevertAssert(); - } - } - - // - // TryGetLocalizedNameByMuiNativeResource - - // - // Helper function for retrieving a localized string resource via MUI. - // The function expects a string in the form: "@resource.dll, -123" - // - // "resource.dll" is a language-neutral portable executable (LNPE) file in - // the %windir%\system32 directory. The OS is queried to find the best-fit - // localized resource file for this LNPE (ex: %windir%\system32\en-us\resource.dll.mui). - // If a localized resource file exists, we LoadString resource ID "123" and - // return it to our caller. - // - // <SecurityKernel Critical="True" Ring="0"> - // <CallsSuppressUnmanagedCode Name="UnsafeNativeMethods.GetFileMUIPath(System.Int32,System.String,System.Text.StringBuilder,System.Int32&,System.Text.StringBuilder,System.Int32&,System.Int64&):System.Boolean" /> - // <ReferencesCritical Name="Method: TryGetLocalizedNameByNativeResource(String, Int32):String" Ring="1" /> - // </SecurityKernel> - static private string TryGetLocalizedNameByMuiNativeResource(string resource) { - if (String.IsNullOrEmpty(resource)) { - return String.Empty; - } - - // parse "@tzres.dll, -100" - // - // filePath = "C:\Windows\System32\tzres.dll" - // resourceId = -100 - // - string[] resources = resource.Split(new char[] {','}, StringSplitOptions.None); - if (resources.Length != 2) { - return String.Empty; - } - - string filePath; - int resourceId; - - // get the path to Windows\System32 - string system32 = Environment.UnsafeGetFolderPath(Environment.SpecialFolder.System); - - // trim the string "@tzres.dll" => "tzres.dll" - string tzresDll = resources[0].TrimStart(new char[] {'@'}); - - try { - filePath = Path.Combine(system32, tzresDll); - } - catch (ArgumentException) { - // there were probably illegal characters in the path - return String.Empty; - } - - if (!Int32.TryParse(resources[1], NumberStyles.Integer, CultureInfo.InvariantCulture, out resourceId)) { - return String.Empty; - } - resourceId = -resourceId; - - - try { - StringBuilder fileMuiPath = StringBuilderCache.Acquire(Path.MaxPath); - fileMuiPath.Length = Path.MaxPath; - int fileMuiPathLength = Path.MaxPath; - int languageLength = 0; - Int64 enumerator = 0; - - Boolean succeeded = UnsafeNativeMethods.GetFileMUIPath( - Win32Native.MUI_PREFERRED_UI_LANGUAGES, - filePath, null /* language */, ref languageLength, - fileMuiPath, ref fileMuiPathLength, ref enumerator); - if (!succeeded) { - StringBuilderCache.Release(fileMuiPath); - return String.Empty; - } - return TryGetLocalizedNameByNativeResource(StringBuilderCache.GetStringAndRelease(fileMuiPath), resourceId); - } - catch (EntryPointNotFoundException) { - return String.Empty; - } - } - - // - // TryGetLocalizedNameByNativeResource - - // - // Helper function for retrieving a localized string resource via a native resource DLL. - // The function expects a string in the form: "C:\Windows\System32\en-us\resource.dll" - // - // "resource.dll" is a language-specific resource DLL. - // If the localized resource DLL exists, LoadString(resource) is returned. - // - static private string TryGetLocalizedNameByNativeResource(string filePath, int resource) { - using (SafeLibraryHandle handle = - UnsafeNativeMethods.LoadLibraryEx(filePath, IntPtr.Zero, Win32Native.LOAD_LIBRARY_AS_DATAFILE)) { - - if (!handle.IsInvalid) { - StringBuilder localizedResource = StringBuilderCache.Acquire(Win32Native.LOAD_STRING_MAX_LENGTH); - localizedResource.Length = Win32Native.LOAD_STRING_MAX_LENGTH; - - int result = UnsafeNativeMethods.LoadString(handle, resource, - localizedResource, localizedResource.Length); - - if (result != 0) { - return StringBuilderCache.GetStringAndRelease(localizedResource); - } - } - } - return String.Empty; - } - - // - // TryGetLocalizedNamesByRegistryKey - - // - // Helper function for retrieving the DisplayName, StandardName, and DaylightName from the registry - // - // The function first checks the MUI_ key-values, and if they exist, it loads the strings from the MUI - // resource dll(s). When the keys do not exist, the function falls back to reading from the standard - // key-values - // - // This method expects that its caller has already Asserted RegistryPermission.Read - // - static private Boolean TryGetLocalizedNamesByRegistryKey(RegistryKey key, out String displayName, out String standardName, out String daylightName) { - displayName = String.Empty; - standardName = String.Empty; - daylightName = String.Empty; - - // read the MUI_ registry keys - String displayNameMuiResource = key.GetValue(c_muiDisplayValue, String.Empty, RegistryValueOptions.None) as String; - String standardNameMuiResource = key.GetValue(c_muiStandardValue, String.Empty, RegistryValueOptions.None) as String; - String daylightNameMuiResource = key.GetValue(c_muiDaylightValue, String.Empty, RegistryValueOptions.None) as String; - - // try to load the strings from the native resource DLL(s) - if (!String.IsNullOrEmpty(displayNameMuiResource)) { - displayName = TryGetLocalizedNameByMuiNativeResource(displayNameMuiResource); - } - - if (!String.IsNullOrEmpty(standardNameMuiResource)) { - standardName = TryGetLocalizedNameByMuiNativeResource(standardNameMuiResource); - } - - if (!String.IsNullOrEmpty(daylightNameMuiResource)) { - daylightName = TryGetLocalizedNameByMuiNativeResource(daylightNameMuiResource); - } - - // fallback to using the standard registry keys - if (String.IsNullOrEmpty(displayName)) { - displayName = key.GetValue(c_displayValue, String.Empty, RegistryValueOptions.None) as String; - } - if (String.IsNullOrEmpty(standardName)) { - standardName = key.GetValue(c_standardValue, String.Empty, RegistryValueOptions.None) as String; - } - if (String.IsNullOrEmpty(daylightName)) { - daylightName = key.GetValue(c_daylightValue, String.Empty, RegistryValueOptions.None) as String; - } - - return true; - } - - // - // TryGetTimeZoneByRegistryKey - - // - // Helper function that takes a string representing a <time_zone_name> registry key name - // and returns a TimeZoneInfo instance. - // - // returns - // TimeZoneInfoResult.InvalidTimeZoneException, - // TimeZoneInfoResult.TimeZoneNotFoundException, - // TimeZoneInfoResult.SecurityException, - // TimeZoneInfoResult.Success - // - // - // Standard Time Zone Registry Data - // -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= - // HKLM - // Software - // Microsoft - // Windows NT - // CurrentVersion - // Time Zones - // <time_zone_name> - // * STD, REG_SZ "Standard Time Name" - // (For OS installed zones, this will always be English) - // * MUI_STD, REG_SZ "@tzres.dll,-1234" - // Indirect string to localized resource for Standard Time, - // add "%windir%\system32\" after "@" - // * DLT, REG_SZ "Daylight Time Name" - // (For OS installed zones, this will always be English) - // * MUI_DLT, REG_SZ "@tzres.dll,-1234" - // Indirect string to localized resource for Daylight Time, - // add "%windir%\system32\" after "@" - // * Display, REG_SZ "Display Name like (GMT-8:00) Pacific Time..." - // * MUI_Display, REG_SZ "@tzres.dll,-1234" - // Indirect string to localized resource for the Display, - // add "%windir%\system32\" after "@" - // * TZI, REG_BINARY REG_TZI_FORMAT - // See Win32Native.RegistryTimeZoneInformation - // - static private TimeZoneInfoResult TryGetTimeZoneByRegistryKey(string id, out TimeZoneInfo value, out Exception e) { - e = null; - - try { - PermissionSet permSet = new PermissionSet(PermissionState.None); - permSet.AddPermission(new RegistryPermission(RegistryPermissionAccess.Read, c_timeZonesRegistryHivePermissionList)); - permSet.Assert(); - - using (RegistryKey key = Registry.LocalMachine.OpenSubKey( - c_timeZonesRegistryHive + "\\" + id, - false)) { - - if (key == null) { - value = null; - return TimeZoneInfoResult.TimeZoneNotFoundException; - } - - Win32Native.RegistryTimeZoneInformation defaultTimeZoneInformation; - Byte[] regValue = key.GetValue(c_timeZoneInfoValue, null, RegistryValueOptions.None) as Byte[]; - if (regValue == null || regValue.Length != c_regByteLength) { - // the registry value could not be cast to a byte array - value = null; - return TimeZoneInfoResult.InvalidTimeZoneException; - } - defaultTimeZoneInformation = new Win32Native.RegistryTimeZoneInformation(regValue); + Debug.Assert(Monitor.IsEntered(cachedData)); - AdjustmentRule[] adjustmentRules; - if (!TryCreateAdjustmentRules(id, defaultTimeZoneInformation, out adjustmentRules, out e, defaultTimeZoneInformation.Bias)) { - value = null; - return TimeZoneInfoResult.InvalidTimeZoneException; - } - - string displayName; - string standardName; - string daylightName; - - if (!TryGetLocalizedNamesByRegistryKey(key, out displayName, out standardName, out daylightName)) { - value = null; - return TimeZoneInfoResult.InvalidTimeZoneException; - } - - try { - value = new TimeZoneInfo( - id, - new TimeSpan(0, -(defaultTimeZoneInformation.Bias), 0), - displayName, - standardName, - daylightName, - adjustmentRules, - false); - - return TimeZoneInfoResult.Success; - } - catch (ArgumentException ex) { - // TimeZoneInfo constructor can throw ArgumentException and InvalidTimeZoneException - value = null; - e = ex; - return TimeZoneInfoResult.InvalidTimeZoneException; - } - catch (InvalidTimeZoneException ex) { - // TimeZoneInfo constructor can throw ArgumentException and InvalidTimeZoneException - value = null; - e = ex; - return TimeZoneInfoResult.InvalidTimeZoneException; - } - - } - } - finally { - PermissionSet.RevertAssert(); - } - } -#endif // FEATURE_WIN32_REGISTRY - - - // - // TryGetTimeZone - - // - // Helper function for retrieving a TimeZoneInfo object by <time_zone_name>. - // - // This function may return null. - // - // assumes cachedData lock is taken - // - static private TimeZoneInfoResult TryGetTimeZone(string id, Boolean dstDisabled, out TimeZoneInfo value, out Exception e, CachedData cachedData) { TimeZoneInfoResult result = TimeZoneInfoResult.Success; e = null; TimeZoneInfo match = null; // check the cache - if (cachedData.m_systemTimeZones != null) { - if (cachedData.m_systemTimeZones.TryGetValue(id, out match)) { - if (dstDisabled && match.m_supportsDaylightSavingTime) { + if (cachedData._systemTimeZones != null) + { + if (cachedData._systemTimeZones.TryGetValue(id, out match)) + { + if (dstDisabled && match._supportsDaylightSavingTime) + { // we found a cache hit but we want a time zone without DST and this one has DST data - value = CreateCustomTimeZone(match.m_id, match.m_baseUtcOffset, match.m_displayName, match.m_standardDisplayName); + value = CreateCustomTimeZone(match._id, match._baseUtcOffset, match._displayName, match._standardDisplayName); } - else { - value = new TimeZoneInfo(match.m_id, match.m_baseUtcOffset, match.m_displayName, match.m_standardDisplayName, - match.m_daylightDisplayName, match.m_adjustmentRules, false); + else + { + value = new TimeZoneInfo(match._id, match._baseUtcOffset, match._displayName, match._standardDisplayName, + match._daylightDisplayName, match._adjustmentRules, disableDaylightSavingTime: false); } return result; } } - // fall back to reading from the local machine - // when the cache is not fully populated - if (!cachedData.m_allSystemTimeZonesRead) { - result = TryGetTimeZoneFromLocalMachine(id, dstDisabled, out value, out e, cachedData); - } -#if PLATFORM_UNIX + // Fall back to reading from the local machine when the cache is not fully populated. // On UNIX, there may be some tzfiles that aren't in the zones.tab file, and thus aren't returned from GetSystemTimeZones(). // If a caller asks for one of these zones before calling GetSystemTimeZones(), the time zone is returned successfully. But if // GetSystemTimeZones() is called first, FindSystemTimeZoneById will throw TimeZoneNotFoundException, which is inconsistent. - // To fix this, even if m_allSystemTimeZonesRead is true, try reading the tzfile from disk, but don't add the time zone to the - // list returned from GetSystemTimeZones(). These time zones will only be available if asked for directly. - else { + // To fix this, when 'alwaysFallbackToLocalMachine' is true, even if _allSystemTimeZonesRead is true, try reading the tzfile + // from disk, but don't add the time zone to the list returned from GetSystemTimeZones(). These time zones will only be + // available if asked for directly. + if (!cachedData._allSystemTimeZonesRead || alwaysFallbackToLocalMachine) + { result = TryGetTimeZoneFromLocalMachine(id, dstDisabled, out value, out e, cachedData); } -#else - else { + else + { result = TimeZoneInfoResult.TimeZoneNotFoundException; value = null; } -#endif // PLATFORM_UNIX return result; } @@ -3498,28 +1836,24 @@ namespace System { TimeZoneInfoResult result; TimeZoneInfo match; -#if FEATURE_WIN32_REGISTRY - result = TryGetTimeZoneByRegistryKey(id, out match, out e); -#elif PLATFORM_UNIX - result = TryGetTimeZoneByFile(id, out match, out e); -#endif // FEATURE_WIN32_REGISTRY + result = TryGetTimeZoneFromLocalMachine(id, out match, out e); if (result == TimeZoneInfoResult.Success) { - if (cachedData.m_systemTimeZones == null) - cachedData.m_systemTimeZones = new Dictionary<string, TimeZoneInfo>(); + if (cachedData._systemTimeZones == null) + cachedData._systemTimeZones = new Dictionary<string, TimeZoneInfo>(); - cachedData.m_systemTimeZones.Add(id, match); + cachedData._systemTimeZones.Add(id, match); - if (dstDisabled && match.m_supportsDaylightSavingTime) + if (dstDisabled && match._supportsDaylightSavingTime) { // we found a cache hit but we want a time zone without DST and this one has DST data - value = CreateCustomTimeZone(match.m_id, match.m_baseUtcOffset, match.m_displayName, match.m_standardDisplayName); + value = CreateCustomTimeZone(match._id, match._baseUtcOffset, match._displayName, match._standardDisplayName); } else { - value = new TimeZoneInfo(match.m_id, match.m_baseUtcOffset, match.m_displayName, match.m_standardDisplayName, - match.m_daylightDisplayName, match.m_adjustmentRules, false); + value = new TimeZoneInfo(match._id, match._baseUtcOffset, match._displayName, match._standardDisplayName, + match._daylightDisplayName, match._adjustmentRules, disableDaylightSavingTime: false); } } else @@ -3530,843 +1864,37 @@ namespace System { return result; } -#if PLATFORM_UNIX - // TZFILE(5) BSD File Formats Manual TZFILE(5) - // - // NAME - // tzfile -- timezone information - // - // SYNOPSIS - // #include "/usr/src/lib/libc/stdtime/tzfile.h" - // - // DESCRIPTION - // The time zone information files used by tzset(3) begin with the magic - // characters ``TZif'' to identify them as time zone information files, fol- - // lowed by sixteen bytes reserved for future use, followed by four four- - // byte values written in a ``standard'' byte order (the high-order byte of - // the value is written first). These values are, in order: - // - // tzh_ttisgmtcnt The number of UTC/local indicators stored in the file. - // tzh_ttisstdcnt The number of standard/wall indicators stored in the - // file. - // tzh_leapcnt The number of leap seconds for which data is stored in - // the file. - // tzh_timecnt The number of ``transition times'' for which data is - // stored in the file. - // tzh_typecnt The number of ``local time types'' for which data is - // stored in the file (must not be zero). - // tzh_charcnt The number of characters of ``time zone abbreviation - // strings'' stored in the file. - // - // The above header is followed by tzh_timecnt four-byte values of type - // long, sorted in ascending order. These values are written in ``stan- - // dard'' byte order. Each is used as a transition time (as returned by - // time(3)) at which the rules for computing local time change. Next come - // tzh_timecnt one-byte values of type unsigned char; each one tells which - // of the different types of ``local time'' types described in the file is - // associated with the same-indexed transition time. These values serve as - // indices into an array of ttinfo structures that appears next in the file; - // these structures are defined as follows: - // - // struct ttinfo { - // long tt_gmtoff; - // int tt_isdst; - // unsigned int tt_abbrind; - // }; - // - // Each structure is written as a four-byte value for tt_gmtoff of type - // long, in a standard byte order, followed by a one-byte value for tt_isdst - // and a one-byte value for tt_abbrind. In each structure, tt_gmtoff gives - // the number of seconds to be added to UTC, tt_isdst tells whether tm_isdst - // should be set by localtime(3) and tt_abbrind serves as an index into the - // array of time zone abbreviation characters that follow the ttinfo struc- - // ture(s) in the file. - // - // Then there are tzh_leapcnt pairs of four-byte values, written in standard - // byte order; the first value of each pair gives the time (as returned by - // time(3)) at which a leap second occurs; the second gives the total number - // of leap seconds to be applied after the given time. The pairs of values - // are sorted in ascending order by time.b - // - // Then there are tzh_ttisstdcnt standard/wall indicators, each stored as a - // one-byte value; they tell whether the transition times associated with - // local time types were specified as standard time or wall clock time, and - // are used when a time zone file is used in handling POSIX-style time zone - // environment variables. - // - // Finally there are tzh_ttisgmtcnt UTC/local indicators, each stored as a - // one-byte value; they tell whether the transition times associated with - // local time types were specified as UTC or local time, and are used when a - // time zone file is used in handling POSIX-style time zone environment - // variables. - // - // localtime uses the first standard-time ttinfo structure in the file (or - // simply the first ttinfo structure in the absence of a standard-time - // structure) if either tzh_timecnt is zero or the time argument is less - // than the first transition time recorded in the file. - // - // SEE ALSO - // ctime(3), time2posix(3), zic(8) - // - // BSD September 13, 1994 BSD - // - // - // - // TIME(3) BSD Library Functions Manual TIME(3) - // - // NAME - // time -- get time of day - // - // LIBRARY - // Standard C Library (libc, -lc) - // - // SYNOPSIS - // #include <time.h> - // - // time_t - // time(time_t *tloc); - // - // DESCRIPTION - // The time() function returns the value of time in seconds since 0 hours, 0 - // minutes, 0 seconds, January 1, 1970, Coordinated Universal Time, without - // including leap seconds. If an error occurs, time() returns the value - // (time_t)-1. - // - // The return value is also stored in *tloc, provided that tloc is non-null. - // - // ERRORS - // The time() function may fail for any of the reasons described in - // gettimeofday(2). - // - // SEE ALSO - // gettimeofday(2), ctime(3) - // - // STANDARDS - // The time function conforms to IEEE Std 1003.1-2001 (``POSIX.1''). - // - // BUGS - // Neither ISO/IEC 9899:1999 (``ISO C99'') nor IEEE Std 1003.1-2001 - // (``POSIX.1'') requires time() to set errno on failure; thus, it is impos- - // sible for an application to distinguish the valid time value -1 (repre- - // senting the last UTC second of 1969) from the error return value. - // - // Systems conforming to earlier versions of the C and POSIX standards - // (including older versions of FreeBSD) did not set *tloc in the error - // case. - // - // HISTORY - // A time() function appeared in Version 6 AT&T UNIX. - // - // BSD July 18, 2003 BSD - // - // - static private void TZif_GenerateAdjustmentRules(out AdjustmentRule[] rules, TimeSpan baseUtcOffset, DateTime[] dts, Byte[] typeOfLocalTime, - TZifType[] transitionType, Boolean[] StandardTime, Boolean[] GmtTime, string futureTransitionsPosixFormat) - { - rules = null; - - if (dts.Length > 0) - { - int index = 0; - List<AdjustmentRule> rulesList = new List<AdjustmentRule>(); - - while (index <= dts.Length) - { - TZif_GenerateAdjustmentRule(ref index, baseUtcOffset, rulesList, dts, typeOfLocalTime, transitionType, StandardTime, GmtTime, futureTransitionsPosixFormat); - } - - rules = rulesList.ToArray(); - if (rules != null && rules.Length == 0) - { - rules = null; - } - } - } - - static private void TZif_GenerateAdjustmentRule(ref int index, TimeSpan timeZoneBaseUtcOffset, List<AdjustmentRule> rulesList, DateTime[] dts, - Byte[] typeOfLocalTime, TZifType[] transitionTypes, Boolean[] StandardTime, Boolean[] GmtTime, string futureTransitionsPosixFormat) - { - // To generate AdjustmentRules, use the following approach: - // The first AdjustmentRule will go from DateTime.MinValue to the first transition time greater than DateTime.MinValue. - // Each middle AdjustmentRule wil go from dts[index-1] to dts[index]. - // The last AdjustmentRule will go from dts[dts.Length-1] to Datetime.MaxValue. - - // 0. Skip any DateTime.MinValue transition times. In newer versions of the tzfile, there - // is a "big bang" transition time, which is before the year 0001. Since any times before year 0001 - // cannot be represented by DateTime, there is no reason to make AdjustmentRules for these unrepresentable time periods. - // 1. If there are no DateTime.MinValue times, the first AdjustmentRule goes from DateTime.MinValue - // to the first transition and uses the first standard transitionType (or the first transitionType if none of them are standard) - // 2. Create an AdjustmentRule for each transition, i.e. from dts[index - 1] to dts[index]. - // This rule uses the transitionType[index - 1] and the whole AdjustmentRule only describes a single offset - either - // all daylight savings, or all stanard time. - // 3. After all the transitions are filled out, the last AdjustmentRule is created from either: - // a. a POSIX-style timezone description ("futureTransitionsPosixFormat"), if there is one or - // b. continue the last transition offset until DateTime.Max - - while (index < dts.Length && dts[index] == DateTime.MinValue) - { - index++; - } - - if (index == 0) - { - TZifType transitionType = TZif_GetEarlyDateTransitionType(transitionTypes); - DateTime endTransitionDate = dts[index]; - - TimeSpan transitionOffset = TZif_CalculateTransitionOffsetFromBase(transitionType.UtcOffset, timeZoneBaseUtcOffset); - TimeSpan daylightDelta = transitionType.IsDst ? transitionOffset : TimeSpan.Zero; - TimeSpan baseUtcDelta = transitionType.IsDst ? TimeSpan.Zero : transitionOffset; - - AdjustmentRule r = AdjustmentRule.CreateAdjustmentRule( - DateTime.MinValue, - endTransitionDate.AddTicks(-1), - daylightDelta, - default(TransitionTime), - default(TransitionTime), - baseUtcDelta, - noDaylightTransitions: true); - rulesList.Add(r); - } - else if (index < dts.Length) - { - DateTime startTransitionDate = dts[index - 1]; - TZifType startTransitionType = transitionTypes[typeOfLocalTime[index - 1]]; - - DateTime endTransitionDate = dts[index]; - - TimeSpan transitionOffset = TZif_CalculateTransitionOffsetFromBase(startTransitionType.UtcOffset, timeZoneBaseUtcOffset); - TimeSpan daylightDelta = startTransitionType.IsDst ? transitionOffset : TimeSpan.Zero; - TimeSpan baseUtcDelta = startTransitionType.IsDst ? TimeSpan.Zero : transitionOffset; - - TransitionTime dstStart; - if (startTransitionType.IsDst) - { - // the TransitionTime fields are not used when AdjustmentRule.NoDaylightTransitions == true. - // However, there are some cases in the past where DST = true, and the daylight savings offset - // now equals what the current BaseUtcOffset is. In that case, the AdjustmentRule.DaylightOffset - // is going to be TimeSpan.Zero. But we still need to return 'true' from AdjustmentRule.HasDaylightSaving. - // To ensure we always return true from HasDaylightSaving, make a "special" dstStart that will make the logic - // in HasDaylightSaving return true. - dstStart = TransitionTime.CreateFixedDateRule(DateTime.MinValue.AddMilliseconds(2), 1, 1); - } - else - { - dstStart = default(TransitionTime); - } - - AdjustmentRule r = AdjustmentRule.CreateAdjustmentRule( - startTransitionDate, - endTransitionDate.AddTicks(-1), - daylightDelta, - dstStart, - default(TransitionTime), - baseUtcDelta, - noDaylightTransitions: true); - rulesList.Add(r); - } - else - { - // create the AdjustmentRule that will be used for all DateTimes after the last transition - - // NOTE: index == dts.Length - DateTime startTransitionDate = dts[index - 1]; - - if (!string.IsNullOrEmpty(futureTransitionsPosixFormat)) - { - AdjustmentRule r = TZif_CreateAdjustmentRuleForPosixFormat(futureTransitionsPosixFormat, startTransitionDate, timeZoneBaseUtcOffset); - if (r != null) - { - rulesList.Add(r); - } - } - else - { - // just use the last transition as the rule which will be used until the end of time - - TZifType transitionType = transitionTypes[typeOfLocalTime[index - 1]]; - TimeSpan transitionOffset = TZif_CalculateTransitionOffsetFromBase(transitionType.UtcOffset, timeZoneBaseUtcOffset); - TimeSpan daylightDelta = transitionType.IsDst ? transitionOffset : TimeSpan.Zero; - TimeSpan baseUtcDelta = transitionType.IsDst ? TimeSpan.Zero : transitionOffset; - - AdjustmentRule r = AdjustmentRule.CreateAdjustmentRule( - startTransitionDate, - DateTime.MaxValue, - daylightDelta, - default(TransitionTime), - default(TransitionTime), - baseUtcDelta, - noDaylightTransitions: true); - rulesList.Add(r); - } - } - - index++; - } - - private static TimeSpan TZif_CalculateTransitionOffsetFromBase(TimeSpan transitionOffset, TimeSpan timeZoneBaseUtcOffset) - { - TimeSpan result = transitionOffset - timeZoneBaseUtcOffset; - - // TZif supports seconds-level granularity with offsets but TimeZoneInfo only supports minutes since it aligns - // with DateTimeOffset, SQL Server, and the W3C XML Specification - if (result.Ticks % TimeSpan.TicksPerMinute != 0) - { - result = new TimeSpan(result.Hours, result.Minutes, 0); - } - - return result; - } - /// <summary> - /// Gets the first standard-time transition type, or simply the first transition type - /// if there are no standard transition types. - /// </summary>> - /// <remarks> - /// from 'man tzfile': - /// localtime(3) uses the first standard-time ttinfo structure in the file - /// (or simply the first ttinfo structure in the absence of a standard-time - /// structure) if either tzh_timecnt is zero or the time argument is less - /// than the first transition time recorded in the file. - /// </remarks> - private static TZifType TZif_GetEarlyDateTransitionType(TZifType[] transitionTypes) - { - for (int i = 0; i < transitionTypes.Length; i++) - { - TZifType transitionType = transitionTypes[i]; - if (!transitionType.IsDst) - { - return transitionType; - } - } - - if (transitionTypes.Length > 0) - { - return transitionTypes[0]; - } - - throw new InvalidTimeZoneException(Environment.GetResourceString("InvalidTimeZone_NoTTInfoStructures")); - } - - /// <summary> - /// Creates an AdjustmentRule given the POSIX TZ environment variable string. + /// Helper function that validates the TimeSpan is within +/- 14.0 hours /// </summary> - /// <remarks> - /// See http://www.gnu.org/software/libc/manual/html_node/TZ-Variable.html for the format and semantics of this POSX string. - /// </remarks> - private static AdjustmentRule TZif_CreateAdjustmentRuleForPosixFormat(string posixFormat, DateTime startTransitionDate, TimeSpan timeZoneBaseUtcOffset) - { - string standardName; - string standardOffset; - string daylightSavingsName; - string daylightSavingsOffset; - string start; - string startTime; - string end; - string endTime; - - if (TZif_ParsePosixFormat(posixFormat, out standardName, out standardOffset, out daylightSavingsName, - out daylightSavingsOffset, out start, out startTime, out end, out endTime)) - { - // a valid posixFormat has at least standardName and standardOffset - - TimeSpan? parsedBaseOffset = TZif_ParseOffsetString(standardOffset); - if (parsedBaseOffset.HasValue) - { - TimeSpan baseOffset = parsedBaseOffset.Value.Negate(); // offsets are backwards in POSIX notation - baseOffset = TZif_CalculateTransitionOffsetFromBase(baseOffset, timeZoneBaseUtcOffset); - - // having a daylightSavingsName means there is a DST rule - if (!string.IsNullOrEmpty(daylightSavingsName)) - { - TimeSpan? parsedDaylightSavings = TZif_ParseOffsetString(daylightSavingsOffset); - TimeSpan daylightSavingsTimeSpan; - if (!parsedDaylightSavings.HasValue) - { - // default DST to 1 hour if it isn't specified - daylightSavingsTimeSpan = new TimeSpan(1, 0, 0); - } - else - { - daylightSavingsTimeSpan = parsedDaylightSavings.Value.Negate(); // offsets are backwards in POSIX notation - daylightSavingsTimeSpan = TZif_CalculateTransitionOffsetFromBase(daylightSavingsTimeSpan, timeZoneBaseUtcOffset); - daylightSavingsTimeSpan = TZif_CalculateTransitionOffsetFromBase(daylightSavingsTimeSpan, baseOffset); - } - - TransitionTime dstStart = TZif_CreateTransitionTimeFromPosixRule(start, startTime); - TransitionTime dstEnd = TZif_CreateTransitionTimeFromPosixRule(end, endTime); - - return AdjustmentRule.CreateAdjustmentRule( - startTransitionDate, - DateTime.MaxValue, - daylightSavingsTimeSpan, - dstStart, - dstEnd, - baseOffset, - noDaylightTransitions: false); - } - else - { - // if there is no daylightSavingsName, the whole AdjustmentRule should be with no transitions - just the baseOffset - return AdjustmentRule.CreateAdjustmentRule( - startTransitionDate, - DateTime.MaxValue, - TimeSpan.Zero, - default(TransitionTime), - default(TransitionTime), - baseOffset, - noDaylightTransitions: true); - } - } - } - - return null; - } - - private static TimeSpan? TZif_ParseOffsetString(string offset) - { - TimeSpan? result = null; - - if (!string.IsNullOrEmpty(offset)) - { - bool negative = offset[0] == '-'; - if (negative || offset[0] == '+') - { - offset = offset.Substring(1); - } - - // Try parsing just hours first. - // Note, TimeSpan.TryParseExact "%h" can't be used here because some time zones using values - // like "26" or "144" and TimeSpan parsing would turn that into 26 or 144 *days* instead of hours. - int hours; - if (int.TryParse(offset, out hours)) - { - result = new TimeSpan(hours, 0, 0); - } - else - { - TimeSpan parsedTimeSpan; - if (TimeSpan.TryParseExact(offset, "g", CultureInfo.InvariantCulture, out parsedTimeSpan)) - { - result = parsedTimeSpan; - } - } - - if (result.HasValue && negative) - { - result = result.Value.Negate(); - } - } - - return result; - } - - private static TransitionTime TZif_CreateTransitionTimeFromPosixRule(string date, string time) - { - if (string.IsNullOrEmpty(date)) - { - return default(TransitionTime); - } - - if (date[0] == 'M') - { - // Mm.w.d - // This specifies day d of week w of month m. The day d must be between 0(Sunday) and 6.The week w must be between 1 and 5; - // week 1 is the first week in which day d occurs, and week 5 specifies the last d day in the month. The month m should be between 1 and 12. - - int month; - int week; - DayOfWeek day; - if (!TZif_ParseMDateRule(date, out month, out week, out day)) - { - throw new InvalidTimeZoneException(Environment.GetResourceString("InvalidTimeZone_UnparseablePosixMDateString", date)); - } - - DateTime timeOfDay; - TimeSpan? timeOffset = TZif_ParseOffsetString(time); - if (timeOffset.HasValue) - { - // This logic isn't correct and can't be corrected until https://github.com/dotnet/corefx/issues/2618 is fixed. - // Some time zones use time values like, "26", "144", or "-2". - // This allows the week to sometimes be week 4 and sometimes week 5 in the month. - // For now, strip off any 'days' in the offset, and just get the time of day correct - timeOffset = new TimeSpan(timeOffset.Value.Hours, timeOffset.Value.Minutes, timeOffset.Value.Seconds); - if (timeOffset.Value < TimeSpan.Zero) - { - timeOfDay = new DateTime(1, 1, 2, 0, 0, 0); - } - else - { - timeOfDay = new DateTime(1, 1, 1, 0, 0, 0); - } - - timeOfDay += timeOffset.Value; - } - else - { - // default to 2AM. - timeOfDay = new DateTime(1, 1, 1, 2, 0, 0); - } - - return TransitionTime.CreateFloatingDateRule(timeOfDay, month, week, day); - } - else - { - // Jn - // This specifies the Julian day, with n between 1 and 365.February 29 is never counted, even in leap years. - - // n - // This specifies the Julian day, with n between 0 and 365.February 29 is counted in leap years. - - // These two rules cannot be expressed with the current AdjustmentRules - // One of them *could* be supported if we relaxed the TransitionTime validation rules, and allowed - // "IsFixedDateRule = true, Month = 0, Day = n" to mean the nth day of the year, picking one of the rules above - - throw new InvalidTimeZoneException(Environment.GetResourceString("InvalidTimeZone_JulianDayNotSupported")); - } - } + [Pure] + internal static bool UtcOffsetOutOfRange(TimeSpan offset) => + offset.TotalHours < -14.0 || offset.TotalHours > 14.0; /// <summary> - /// Parses a string like Mm.w.d into month, week and DayOfWeek values. + /// Helper function that performs all of the validation checks for the + /// factory methods and deserialization callback. /// </summary> - /// <returns> - /// true if the parsing succeeded; otherwise, false. - /// </returns> - private static bool TZif_ParseMDateRule(string dateRule, out int month, out int week, out DayOfWeek dayOfWeek) + private static void ValidateTimeZoneInfo(string id, TimeSpan baseUtcOffset, AdjustmentRule[] adjustmentRules, out bool adjustmentRulesSupportDst) { - month = 0; - week = 0; - dayOfWeek = default(DayOfWeek); - - if (dateRule[0] == 'M') + if (id == null) { - int firstDotIndex = dateRule.IndexOf('.'); - if (firstDotIndex > 0) - { - int secondDotIndex = dateRule.IndexOf('.', firstDotIndex + 1); - if (secondDotIndex > 0) - { - string monthString = dateRule.Substring(1, firstDotIndex - 1); - string weekString = dateRule.Substring(firstDotIndex + 1, secondDotIndex - firstDotIndex - 1); - string dayString = dateRule.Substring(secondDotIndex + 1); - - if (int.TryParse(monthString, out month)) - { - if (int.TryParse(weekString, out week)) - { - int day; - if (int.TryParse(dayString, out day)) - { - dayOfWeek = (DayOfWeek)day; - return true; - } - } - } - } - } - } - - return false; - } - - private static bool TZif_ParsePosixFormat( - string posixFormat, - out string standardName, - out string standardOffset, - out string daylightSavingsName, - out string daylightSavingsOffset, - out string start, - out string startTime, - out string end, - out string endTime) - { - standardName = null; - standardOffset = null; - daylightSavingsName = null; - daylightSavingsOffset = null; - start = null; - startTime = null; - end = null; - endTime = null; - - int index = 0; - standardName = TZif_ParsePosixName(posixFormat, ref index); - standardOffset = TZif_ParsePosixOffset(posixFormat, ref index); - - daylightSavingsName = TZif_ParsePosixName(posixFormat, ref index); - if (!string.IsNullOrEmpty(daylightSavingsName)) - { - daylightSavingsOffset = TZif_ParsePosixOffset(posixFormat, ref index); - - if (index < posixFormat.Length && posixFormat[index] == ',') - { - index++; - TZif_ParsePosixDateTime(posixFormat, ref index, out start, out startTime); - - if (index < posixFormat.Length && posixFormat[index] == ',') - { - index++; - TZif_ParsePosixDateTime(posixFormat, ref index, out end, out endTime); - } - } - } - - return !string.IsNullOrEmpty(standardName) && !string.IsNullOrEmpty(standardOffset); - } - - private static string TZif_ParsePosixName(string posixFormat, ref int index) - { - return TZif_ParsePosixString(posixFormat, ref index, c => char.IsDigit(c) || c == '+' || c == '-' || c == ','); - } - - private static string TZif_ParsePosixOffset(string posixFormat, ref int index) - { - return TZif_ParsePosixString(posixFormat, ref index, c => !char.IsDigit(c) && c != '+' && c != '-' && c != ':'); - } - - private static void TZif_ParsePosixDateTime(string posixFormat, ref int index, out string date, out string time) - { - time = null; - - date = TZif_ParsePosixDate(posixFormat, ref index); - if (index < posixFormat.Length && posixFormat[index] == '/') - { - index++; - time = TZif_ParsePosixTime(posixFormat, ref index); - } - } - - private static string TZif_ParsePosixDate(string posixFormat, ref int index) - { - return TZif_ParsePosixString(posixFormat, ref index, c => c == '/' || c == ','); - } - - private static string TZif_ParsePosixTime(string posixFormat, ref int index) - { - return TZif_ParsePosixString(posixFormat, ref index, c => c == ','); - } - - private static string TZif_ParsePosixString(string posixFormat, ref int index, Func<char, bool> breakCondition) - { - int startIndex = index; - for (; index < posixFormat.Length; index++) - { - char current = posixFormat[index]; - if (breakCondition(current)) - { - break; - } - } - - return posixFormat.Substring(startIndex, index - startIndex); - } - - // Returns the Substring from zoneAbbreviations starting at index and ending at '\0' - // zoneAbbreviations is expected to be in the form: "PST\0PDT\0PWT\0\PPT" - static private String TZif_GetZoneAbbreviation(String zoneAbbreviations, int index) { - int lastIndex = zoneAbbreviations.IndexOf('\0', index); - if (lastIndex > 0) { - return zoneAbbreviations.Substring(index, lastIndex - index); - } - else { - return zoneAbbreviations.Substring(index); - } - } - - // Converts an array of bytes into an int - always using standard byte order (Big Endian) - // per TZif file standard - static private unsafe int TZif_ToInt32 (byte[]value, int startIndex) { - fixed( byte * pbyte = &value[startIndex]) { - return (*pbyte << 24) | (*(pbyte + 1) << 16) | (*(pbyte + 2) << 8) | (*(pbyte + 3)); - } - } - - // Converts an array of bytes into a long - always using standard byte order (Big Endian) - // per TZif file standard - static private unsafe long TZif_ToInt64(byte[] value, int startIndex) - { - fixed (byte* pbyte = &value[startIndex]) - { - int i1 = (*pbyte << 24) | (*(pbyte + 1) << 16) | (*(pbyte + 2) << 8) | (*(pbyte + 3)); - int i2 = (*(pbyte + 4) << 24) | (*(pbyte + 5) << 16) | (*(pbyte + 6) << 8) | (*(pbyte + 7)); - return (uint)i2 | ((long)i1 << 32); - } - } - - static private long TZif_ToUnixTime(byte[] value, int startIndex, TZVersion version) - { - if (version != TZVersion.V1) - { - return TZif_ToInt64(value, startIndex); - } - else - { - return TZif_ToInt32(value, startIndex); - } - } - - private static DateTime TZif_UnixTimeToDateTime(long unixTime) - { - if (unixTime < DateTimeOffset.UnixMinSeconds) - { - return DateTime.MinValue; - } - - if (unixTime > DateTimeOffset.UnixMaxSeconds) - { - return DateTime.MaxValue; - } - - return DateTimeOffset.FromUnixTimeSeconds(unixTime).UtcDateTime; - } - - static private void TZif_ParseRaw(Byte[] data, out TZifHead t, out DateTime[] dts, out Byte[] typeOfLocalTime, out TZifType[] transitionType, - out String zoneAbbreviations, out Boolean[] StandardTime, out Boolean[] GmtTime, out string futureTransitionsPosixFormat) - { - // initialize the out parameters in case the TZifHead ctor throws - dts = null; - typeOfLocalTime = null; - transitionType = null; - zoneAbbreviations = String.Empty; - StandardTime = null; - GmtTime = null; - futureTransitionsPosixFormat = null; - - // read in the 44-byte TZ header containing the count/length fields - // - int index = 0; - t = new TZifHead(data, index); - index += TZifHead.Length; - - int timeValuesLength = 4; // the first version uses 4-bytes to specify times - if (t.Version != TZVersion.V1) - { - // move index past the V1 information to read the V2 information - index += (int)((timeValuesLength * t.TimeCount) + t.TimeCount + (6 * t.TypeCount) + ((timeValuesLength + 4) * t.LeapCount) + t.IsStdCount + t.IsGmtCount + t.CharCount); - - // read the V2 header - t = new TZifHead(data, index); - index += TZifHead.Length; - timeValuesLength = 8; // the second version uses 8-bytes - } - - // initialize the containers for the rest of the TZ data - dts = new DateTime[t.TimeCount]; - typeOfLocalTime = new Byte[t.TimeCount]; - transitionType = new TZifType[t.TypeCount]; - zoneAbbreviations = String.Empty; - StandardTime = new Boolean[t.TypeCount]; - GmtTime = new Boolean[t.TypeCount]; - - // read in the UTC transition points and convert them to Windows - // - for (int i = 0; i < t.TimeCount; i++) { - long unixTime = TZif_ToUnixTime(data, index, t.Version); - dts[i] = TZif_UnixTimeToDateTime(unixTime); - index += timeValuesLength; - } - - // read in the Type Indices; there is a 1:1 mapping of UTC transition points to Type Indices - // these indices directly map to the array index in the transitionType array below - // - for (int i = 0; i < t.TimeCount; i++) { - typeOfLocalTime[i] = data[index]; - index += 1; - } - - // read in the Type table. Each 6-byte entry represents - // {UtcOffset, IsDst, AbbreviationIndex} - // - // each AbbreviationIndex is a character index into the zoneAbbreviations string below - // - for (int i = 0; i < t.TypeCount; i++) { - transitionType[i] = new TZifType(data, index); - index += 6; - } - - // read in the Abbreviation ASCII string. This string will be in the form: - // "PST\0PDT\0PWT\0\PPT" - // - System.Text.Encoding enc = new System.Text.UTF8Encoding(); - zoneAbbreviations = enc.GetString(data, index, (int)t.CharCount); - index += (int)t.CharCount; - - // skip ahead of the Leap-Seconds Adjustment data. In a future release, consider adding - // support for Leap-Seconds - // - index += (int)(t.LeapCount * (timeValuesLength + 4)); // skip the leap second transition times - - // read in the Standard Time table. There should be a 1:1 mapping between Type-Index and Standard - // Time table entries. - // - // TRUE = transition time is standard time - // FALSE = transition time is wall clock time - // ABSENT = transition time is wall clock time - // - for (int i = 0; i < t.IsStdCount && i < t.TypeCount && index < data.Length; i++) { - StandardTime[i] = (data[index++] != 0); - } - - // read in the GMT Time table. There should be a 1:1 mapping between Type-Index and GMT Time table - // entries. - // - // TRUE = transition time is UTC - // FALSE = transition time is local time - // ABSENT = transition time is local time - // - for (int i = 0; i < t.IsGmtCount && i < t.TypeCount && index < data.Length; i++) { - GmtTime[i] = (data[index++] != 0); - } - - if (t.Version != TZVersion.V1) - { - // read the POSIX-style format, which should be wrapped in newlines with the last newline at the end of the file - if (data[index++] == '\n' && data[data.Length - 1] == '\n') - { - futureTransitionsPosixFormat = enc.GetString(data, index, data.Length - index - 1); - } - } - } -#endif // PLATFORM_UNIX - - // - // UtcOffsetOutOfRange - - // - // Helper function that validates the TimeSpan is within +/- 14.0 hours - // - [Pure] - static internal Boolean UtcOffsetOutOfRange(TimeSpan offset) { - return (offset.TotalHours < -14.0 || offset.TotalHours > 14.0); - } - - - // - // ValidateTimeZoneInfo - - // - // Helper function that performs all of the validation checks for the - // factory methods and deserialization callback - // - // returns a Boolean indicating whether the AdjustmentRule[] supports DST - // - static private void ValidateTimeZoneInfo( - String id, - TimeSpan baseUtcOffset, - AdjustmentRule [] adjustmentRules, - out Boolean adjustmentRulesSupportDst) { - - if (id == null) { throw new ArgumentNullException(nameof(id)); } - if (id.Length == 0) { + if (id.Length == 0) + { throw new ArgumentException(Environment.GetResourceString("Argument_InvalidId", id), nameof(id)); } - if (UtcOffsetOutOfRange(baseUtcOffset)) { + if (UtcOffsetOutOfRange(baseUtcOffset)) + { throw new ArgumentOutOfRangeException(nameof(baseUtcOffset), Environment.GetResourceString("ArgumentOutOfRange_UtcOffset")); } - if (baseUtcOffset.Ticks % TimeSpan.TicksPerMinute != 0) { + if (baseUtcOffset.Ticks % TimeSpan.TicksPerMinute != 0) + { throw new ArgumentException(Environment.GetResourceString("Argument_TimeSpanHasSeconds"), nameof(baseUtcOffset)); } Contract.EndContractBlock(); @@ -4379,15 +1907,18 @@ namespace System { // are sorted in chronological order // - if (adjustmentRules != null && adjustmentRules.Length != 0) { + if (adjustmentRules != null && adjustmentRules.Length != 0) + { adjustmentRulesSupportDst = true; AdjustmentRule prev = null; AdjustmentRule current = null; - for (int i = 0; i < adjustmentRules.Length; i++) { + for (int i = 0; i < adjustmentRules.Length; i++) + { prev = current; current = adjustmentRules[i]; - if (current == null) { + if (current == null) + { throw new InvalidTimeZoneException(Environment.GetResourceString("Argument_AdjustmentRulesNoNulls")); } @@ -4395,1308 +1926,18 @@ namespace System { // adjustmentRulesSupportDst = adjustmentRulesSupportDst || current.SupportsDaylightSavingTime; // FUTURE: test baseUtcOffset + current.StandardDelta - if (UtcOffsetOutOfRange(baseUtcOffset + current.DaylightDelta)) { + if (UtcOffsetOutOfRange(baseUtcOffset + current.DaylightDelta)) + { throw new InvalidTimeZoneException(Environment.GetResourceString("ArgumentOutOfRange_UtcOffsetAndDaylightDelta")); } - if (prev != null && current.DateStart <= prev.DateEnd) { + if (prev != null && current.DateStart <= prev.DateEnd) + { // verify the rules are in chronological order and the DateStart/DateEnd do not overlap throw new InvalidTimeZoneException(Environment.GetResourceString("Argument_AdjustmentRulesOutOfOrder")); } } } } - -/*============================================================ -** -** Class: TimeZoneInfo.AdjustmentRule -** -** -** Purpose: -** This class is used to represent a Dynamic TimeZone. It -** has methods for converting a DateTime to UTC from local time -** and to local time from UTC and methods for getting the -** standard name and daylight name of the time zone. -** -** -============================================================*/ - [Serializable] - [System.Security.Permissions.HostProtection(MayLeakOnAbort = true)] - sealed public class AdjustmentRule : IEquatable<AdjustmentRule>, ISerializable, IDeserializationCallback - { - - // ---- SECTION: members supporting exposed properties -------------* - private readonly DateTime m_dateStart; - private readonly DateTime m_dateEnd; - private readonly TimeSpan m_daylightDelta; - private readonly TransitionTime m_daylightTransitionStart; - private readonly TransitionTime m_daylightTransitionEnd; - private readonly TimeSpan m_baseUtcOffsetDelta; // delta from the default Utc offset (utcOffset = defaultUtcOffset + m_baseUtcOffsetDelta) - private readonly bool m_noDaylightTransitions; - - // ---- SECTION: public properties --------------* - public DateTime DateStart { - get { - return this.m_dateStart; - } - } - - public DateTime DateEnd { - get { - return this.m_dateEnd; - } - } - - public TimeSpan DaylightDelta { - get { - return this.m_daylightDelta; - } - } - - - public TransitionTime DaylightTransitionStart { - get { - return this.m_daylightTransitionStart; - } - } - - - public TransitionTime DaylightTransitionEnd { - get { - return this.m_daylightTransitionEnd; - } - } - - internal TimeSpan BaseUtcOffsetDelta { - get { - return this.m_baseUtcOffsetDelta; - } - } - - /// <summary> - /// Gets a value indicating that this AdjustmentRule fixes the time zone offset - /// from DateStart to DateEnd without any daylight transitions in between. - /// </summary> - internal bool NoDaylightTransitions { - get { - return this.m_noDaylightTransitions; - } - } - - internal bool HasDaylightSaving { - get { - return this.DaylightDelta != TimeSpan.Zero - || - (this.DaylightTransitionStart != default(TransitionTime) - && this.DaylightTransitionStart.TimeOfDay != DateTime.MinValue) - || - (this.DaylightTransitionEnd != default(TransitionTime) - && this.DaylightTransitionEnd.TimeOfDay != DateTime.MinValue.AddMilliseconds(1)); - } - } - - // ---- SECTION: public methods --------------* - - // IEquatable<AdjustmentRule> - public bool Equals(AdjustmentRule other) { - return other != null - && m_dateStart == other.m_dateStart - && m_dateEnd == other.m_dateEnd - && m_daylightDelta == other.m_daylightDelta - && m_baseUtcOffsetDelta == other.m_baseUtcOffsetDelta - && m_daylightTransitionEnd.Equals(other.m_daylightTransitionEnd) - && m_daylightTransitionStart.Equals(other.m_daylightTransitionStart); - } - - - public override int GetHashCode() { - return m_dateStart.GetHashCode(); - } - - - - // -------- SECTION: constructors -----------------* - - private AdjustmentRule( - DateTime dateStart, - DateTime dateEnd, - TimeSpan daylightDelta, - TransitionTime daylightTransitionStart, - TransitionTime daylightTransitionEnd, - TimeSpan baseUtcOffsetDelta, - bool noDaylightTransitions) - { - ValidateAdjustmentRule(dateStart, dateEnd, daylightDelta, - daylightTransitionStart, daylightTransitionEnd, noDaylightTransitions); - - m_dateStart = dateStart; - m_dateEnd = dateEnd; - m_daylightDelta = daylightDelta; - m_daylightTransitionStart = daylightTransitionStart; - m_daylightTransitionEnd = daylightTransitionEnd; - m_baseUtcOffsetDelta = baseUtcOffsetDelta; - m_noDaylightTransitions = noDaylightTransitions; - } - - - // -------- SECTION: factory methods -----------------* - - static public AdjustmentRule CreateAdjustmentRule( - DateTime dateStart, - DateTime dateEnd, - TimeSpan daylightDelta, - TransitionTime daylightTransitionStart, - TransitionTime daylightTransitionEnd) - { - return new AdjustmentRule( - dateStart, - dateEnd, - daylightDelta, - daylightTransitionStart, - daylightTransitionEnd, - baseUtcOffsetDelta: TimeSpan.Zero, - noDaylightTransitions: false); - } - - static internal AdjustmentRule CreateAdjustmentRule( - DateTime dateStart, - DateTime dateEnd, - TimeSpan daylightDelta, - TransitionTime daylightTransitionStart, - TransitionTime daylightTransitionEnd, - TimeSpan baseUtcOffsetDelta, - bool noDaylightTransitions) - { - return new AdjustmentRule( - dateStart, - dateEnd, - daylightDelta, - daylightTransitionStart, - daylightTransitionEnd, - baseUtcOffsetDelta, - noDaylightTransitions); - } - - // ----- SECTION: internal utility methods ----------------* - - // - // When Windows sets the daylight transition start Jan 1st at 12:00 AM, it means the year starts with the daylight saving on. - // We have to special case this value and not adjust it when checking if any date is in the daylight saving period. - // - internal bool IsStartDateMarkerForBeginningOfYear() { - return !NoDaylightTransitions && - DaylightTransitionStart.Month == 1 && DaylightTransitionStart.Day == 1 && DaylightTransitionStart.TimeOfDay.Hour == 0 && - DaylightTransitionStart.TimeOfDay.Minute == 0 && DaylightTransitionStart.TimeOfDay.Second == 0 && - m_dateStart.Year == m_dateEnd.Year; - } - - // - // When Windows sets the daylight transition end Jan 1st at 12:00 AM, it means the year ends with the daylight saving on. - // We have to special case this value and not adjust it when checking if any date is in the daylight saving period. - // - internal bool IsEndDateMarkerForEndOfYear() { - return !NoDaylightTransitions && - DaylightTransitionEnd.Month == 1 && DaylightTransitionEnd.Day == 1 && DaylightTransitionEnd.TimeOfDay.Hour == 0 && - DaylightTransitionEnd.TimeOfDay.Minute == 0 && DaylightTransitionEnd.TimeOfDay.Second == 0 && - m_dateStart.Year == m_dateEnd.Year; - } - - // - // ValidateAdjustmentRule - - // - // Helper function that performs all of the validation checks for the - // factory methods and deserialization callback - // - static private void ValidateAdjustmentRule( - DateTime dateStart, - DateTime dateEnd, - TimeSpan daylightDelta, - TransitionTime daylightTransitionStart, - TransitionTime daylightTransitionEnd, - bool noDaylightTransitions) { - - - if (dateStart.Kind != DateTimeKind.Unspecified && dateStart.Kind != DateTimeKind.Utc) { - throw new ArgumentException(Environment.GetResourceString("Argument_DateTimeKindMustBeUnspecifiedOrUtc"), nameof(dateStart)); - } - - if (dateEnd.Kind != DateTimeKind.Unspecified && dateEnd.Kind != DateTimeKind.Utc) { - throw new ArgumentException(Environment.GetResourceString("Argument_DateTimeKindMustBeUnspecifiedOrUtc"), nameof(dateEnd)); - } - - if (daylightTransitionStart.Equals(daylightTransitionEnd) && !noDaylightTransitions) { - throw new ArgumentException(Environment.GetResourceString("Argument_TransitionTimesAreIdentical"), - nameof(daylightTransitionEnd)); - } - - - if (dateStart > dateEnd) { - throw new ArgumentException(Environment.GetResourceString("Argument_OutOfOrderDateTimes"), nameof(dateStart)); - } - - // This cannot use UtcOffsetOutOfRange to account for the scenario where Samoa moved across the International Date Line, - // which caused their current BaseUtcOffset to be +13. But on the other side of the line it was UTC-11 (+1 for daylight). - // So when trying to describe DaylightDeltas for those times, the DaylightDelta needs - // to be -23 (what it takes to go from UTC+13 to UTC-10) - if (daylightDelta.TotalHours < -23.0 || daylightDelta.TotalHours > 14.0) { - throw new ArgumentOutOfRangeException(nameof(daylightDelta), daylightDelta, - Environment.GetResourceString("ArgumentOutOfRange_UtcOffset")); - } - - if (daylightDelta.Ticks % TimeSpan.TicksPerMinute != 0) { - throw new ArgumentException(Environment.GetResourceString("Argument_TimeSpanHasSeconds"), - nameof(daylightDelta)); - } - - if (dateStart != DateTime.MinValue && dateStart.Kind == DateTimeKind.Unspecified && dateStart.TimeOfDay != TimeSpan.Zero) { - throw new ArgumentException(Environment.GetResourceString("Argument_DateTimeHasTimeOfDay"), - nameof(dateStart)); - } - - if (dateEnd != DateTime.MaxValue && dateEnd.Kind == DateTimeKind.Unspecified && dateEnd.TimeOfDay != TimeSpan.Zero) { - throw new ArgumentException(Environment.GetResourceString("Argument_DateTimeHasTimeOfDay"), - nameof(dateEnd)); - } - Contract.EndContractBlock(); - } - - - - // ----- SECTION: private serialization instance methods ----------------* - - void IDeserializationCallback.OnDeserialization(Object sender) { - // OnDeserialization is called after each instance of this class is deserialized. - // This callback method performs AdjustmentRule validation after being deserialized. - - try { - ValidateAdjustmentRule(m_dateStart, m_dateEnd, m_daylightDelta, - m_daylightTransitionStart, m_daylightTransitionEnd, m_noDaylightTransitions); - } - catch (ArgumentException e) { - throw new SerializationException(Environment.GetResourceString("Serialization_InvalidData"), e); - } - } - - void ISerializable.GetObjectData(SerializationInfo info, StreamingContext context) { - if (info == null) { - throw new ArgumentNullException(nameof(info)); - } - Contract.EndContractBlock(); - - info.AddValue("DateStart", m_dateStart); - info.AddValue("DateEnd", m_dateEnd); - info.AddValue("DaylightDelta", m_daylightDelta); - info.AddValue("DaylightTransitionStart", m_daylightTransitionStart); - info.AddValue("DaylightTransitionEnd", m_daylightTransitionEnd); - info.AddValue("BaseUtcOffsetDelta", m_baseUtcOffsetDelta); - info.AddValue("NoDaylightTransitions", m_noDaylightTransitions); - } - - AdjustmentRule(SerializationInfo info, StreamingContext context) { - if (info == null) { - throw new ArgumentNullException(nameof(info)); - } - - m_dateStart = (DateTime)info.GetValue("DateStart", typeof(DateTime)); - m_dateEnd = (DateTime)info.GetValue("DateEnd", typeof(DateTime)); - m_daylightDelta = (TimeSpan)info.GetValue("DaylightDelta", typeof(TimeSpan)); - m_daylightTransitionStart = (TransitionTime)info.GetValue("DaylightTransitionStart", typeof(TransitionTime)); - m_daylightTransitionEnd = (TransitionTime)info.GetValue("DaylightTransitionEnd", typeof(TransitionTime)); - - object o = info.GetValueNoThrow("BaseUtcOffsetDelta", typeof(TimeSpan)); - if (o != null) { - m_baseUtcOffsetDelta = (TimeSpan) o; - } - - o = info.GetValueNoThrow("NoDaylightTransitions", typeof(bool)); - if (o != null) { - m_noDaylightTransitions = (bool)o; - } - } - } - - -/*============================================================ -** -** Class: TimeZoneInfo.TransitionTime -** -** -** Purpose: -** This class is used to represent a Dynamic TimeZone. It -** has methods for converting a DateTime to UTC from local time -** and to local time from UTC and methods for getting the -** standard name and daylight name of the time zone. -** -** -============================================================*/ - [Serializable] - [System.Security.Permissions.HostProtection(MayLeakOnAbort = true)] - public struct TransitionTime : IEquatable<TransitionTime>, ISerializable, IDeserializationCallback - { - // ---- SECTION: members supporting exposed properties -------------* - private readonly DateTime m_timeOfDay; - private readonly byte m_month; - private readonly byte m_week; - private readonly byte m_day; - private readonly DayOfWeek m_dayOfWeek; - private readonly Boolean m_isFixedDateRule; - - - // ---- SECTION: public properties --------------* - public DateTime TimeOfDay { - get { - return m_timeOfDay; - } - } - - public Int32 Month { - get { - return (int)m_month; - } - } - - - public Int32 Week { - get { - return (int)m_week; - } - } - - public Int32 Day { - get { - return (int)m_day; - } - } - - public DayOfWeek DayOfWeek { - get { - return m_dayOfWeek; - } - } - - public Boolean IsFixedDateRule { - get { - return m_isFixedDateRule; - } - } - - // ---- SECTION: public methods --------------* - [Pure] - public override bool Equals(Object obj) { - if (obj is TransitionTime) { - return Equals((TransitionTime)obj); - } - return false; - } - - public static bool operator ==(TransitionTime t1, TransitionTime t2) { - return t1.Equals(t2); - } - - public static bool operator !=(TransitionTime t1, TransitionTime t2) { - return (!t1.Equals(t2)); - } - - [Pure] - public bool Equals(TransitionTime other) { - - bool equal = (this.m_isFixedDateRule == other.m_isFixedDateRule - && this.m_timeOfDay == other.m_timeOfDay - && this.m_month == other.m_month); - - if (equal) { - if (other.m_isFixedDateRule) { - equal = (this.m_day == other.m_day); - } - else { - equal = (this.m_week == other.m_week - && this.m_dayOfWeek == other.m_dayOfWeek); - } - } - return equal; - } - - - public override int GetHashCode() { - return ((int)m_month ^ (int)m_week << 8); - } - - - // -------- SECTION: constructors -----------------* - - private TransitionTime( - DateTime timeOfDay, - Int32 month, - Int32 week, - Int32 day, - DayOfWeek dayOfWeek, - Boolean isFixedDateRule) - { - ValidateTransitionTime(timeOfDay, month, week, day, dayOfWeek); - - m_timeOfDay = timeOfDay; - m_month = (byte)month; - m_week = (byte)week; - m_day = (byte)day; - m_dayOfWeek = dayOfWeek; - m_isFixedDateRule = isFixedDateRule; - } - - - // -------- SECTION: factory methods -----------------* - - - static public TransitionTime CreateFixedDateRule( - DateTime timeOfDay, - Int32 month, - Int32 day) { - - return new TransitionTime(timeOfDay, month, 1, day, DayOfWeek.Sunday, isFixedDateRule: true); - } - - - static public TransitionTime CreateFloatingDateRule( - DateTime timeOfDay, - Int32 month, - Int32 week, - DayOfWeek dayOfWeek) { - - return new TransitionTime(timeOfDay, month, week, 1, dayOfWeek, isFixedDateRule: false); - } - - - // ----- SECTION: internal utility methods ----------------* - - // - // ValidateTransitionTime - - // - // Helper function that validates a TransitionTime instance - // - static private void ValidateTransitionTime( - DateTime timeOfDay, - Int32 month, - Int32 week, - Int32 day, - DayOfWeek dayOfWeek) { - - if (timeOfDay.Kind != DateTimeKind.Unspecified) { - throw new ArgumentException(Environment.GetResourceString("Argument_DateTimeKindMustBeUnspecified"), nameof(timeOfDay)); - } - - // Month range 1-12 - if (month < 1 || month > 12) { - throw new ArgumentOutOfRangeException(nameof(month), Environment.GetResourceString("ArgumentOutOfRange_MonthParam")); - } - - // Day range 1-31 - if (day < 1 || day > 31) { - throw new ArgumentOutOfRangeException(nameof(day), Environment.GetResourceString("ArgumentOutOfRange_DayParam")); - } - - // Week range 1-5 - if (week < 1 || week > 5) { - throw new ArgumentOutOfRangeException(nameof(week), Environment.GetResourceString("ArgumentOutOfRange_Week")); - } - - // DayOfWeek range 0-6 - if ((int)dayOfWeek < 0 || (int)dayOfWeek > 6) { - throw new ArgumentOutOfRangeException(nameof(dayOfWeek), Environment.GetResourceString("ArgumentOutOfRange_DayOfWeek")); - } - Contract.EndContractBlock(); - - if (timeOfDay.Year != 1 || timeOfDay.Month != 1 - || timeOfDay.Day != 1 || (timeOfDay.Ticks % TimeSpan.TicksPerMillisecond != 0)) { - throw new ArgumentException(Environment.GetResourceString("Argument_DateTimeHasTicks"), nameof(timeOfDay)); - } - } - - void IDeserializationCallback.OnDeserialization(Object sender) { - // OnDeserialization is called after each instance of this class is deserialized. - // This callback method performs TransitionTime validation after being deserialized. - - try { - ValidateTransitionTime(m_timeOfDay, (Int32)m_month, (Int32)m_week, (Int32)m_day, m_dayOfWeek); - } - catch (ArgumentException e) { - throw new SerializationException(Environment.GetResourceString("Serialization_InvalidData"), e); - } - } - - - void ISerializable.GetObjectData(SerializationInfo info, StreamingContext context) { - if (info == null) { - throw new ArgumentNullException(nameof(info)); - } - Contract.EndContractBlock(); - - info.AddValue("TimeOfDay", m_timeOfDay); - info.AddValue("Month", m_month); - info.AddValue("Week", m_week); - info.AddValue("Day", m_day); - info.AddValue("DayOfWeek", m_dayOfWeek); - info.AddValue("IsFixedDateRule", m_isFixedDateRule); - } - - TransitionTime(SerializationInfo info, StreamingContext context) { - if (info == null) { - throw new ArgumentNullException(nameof(info)); - } - - m_timeOfDay = (DateTime)info.GetValue("TimeOfDay", typeof(DateTime)); - m_month = (byte)info.GetValue("Month", typeof(byte)); - m_week = (byte)info.GetValue("Week", typeof(byte)); - m_day = (byte)info.GetValue("Day", typeof(byte)); - m_dayOfWeek = (DayOfWeek)info.GetValue("DayOfWeek", typeof(DayOfWeek)); - m_isFixedDateRule = (Boolean)info.GetValue("IsFixedDateRule", typeof(Boolean)); - } - } - - -/*============================================================ -** -** Class: TimeZoneInfo.StringSerializer -** -** -** Purpose: -** This class is used to serialize and deserialize TimeZoneInfo -** objects based on the custom string serialization format -** -** -============================================================*/ - sealed private class StringSerializer { - - // ---- SECTION: private members -------------* - private enum State { - Escaped = 0, - NotEscaped = 1, - StartOfToken = 2, - EndOfLine = 3 - } - - private String m_serializedText; - private int m_currentTokenStartIndex; - private State m_state; - - // the majority of the strings contained in the OS time zones fit in 64 chars - private const int initialCapacityForString = 64; - private const char esc = '\\'; - private const char sep = ';'; - private const char lhs = '['; - private const char rhs = ']'; - private const string escString = "\\"; - private const string sepString = ";"; - private const string lhsString = "["; - private const string rhsString = "]"; - private const string escapedEsc = "\\\\"; - private const string escapedSep = "\\;"; - private const string escapedLhs = "\\["; - private const string escapedRhs = "\\]"; - private const string dateTimeFormat = "MM:dd:yyyy"; - private const string timeOfDayFormat = "HH:mm:ss.FFF"; - - - // ---- SECTION: public static methods --------------* - - // - // GetSerializedString - - // - // static method that creates the custom serialized string - // representation of a TimeZoneInfo instance - // - static public String GetSerializedString(TimeZoneInfo zone) { - StringBuilder serializedText = StringBuilderCache.Acquire(); - - // - // <m_id>;<m_baseUtcOffset>;<m_displayName>;<m_standardDisplayName>;<m_daylightDispayName> - // - serializedText.Append(SerializeSubstitute(zone.Id)); - serializedText.Append(sep); - serializedText.Append(SerializeSubstitute( - zone.BaseUtcOffset.TotalMinutes.ToString(CultureInfo.InvariantCulture))); - serializedText.Append(sep); - serializedText.Append(SerializeSubstitute(zone.DisplayName)); - serializedText.Append(sep); - serializedText.Append(SerializeSubstitute(zone.StandardName)); - serializedText.Append(sep); - serializedText.Append(SerializeSubstitute(zone.DaylightName)); - serializedText.Append(sep); - - AdjustmentRule[] rules = zone.GetAdjustmentRules(); - - if (rules != null && rules.Length > 0) { - for (int i = 0; i < rules.Length; i++) { - AdjustmentRule rule = rules[i]; - - serializedText.Append(lhs); - serializedText.Append(SerializeSubstitute(rule.DateStart.ToString( - dateTimeFormat, DateTimeFormatInfo.InvariantInfo))); - serializedText.Append(sep); - serializedText.Append(SerializeSubstitute(rule.DateEnd.ToString( - dateTimeFormat, DateTimeFormatInfo.InvariantInfo))); - serializedText.Append(sep); - serializedText.Append(SerializeSubstitute(rule.DaylightDelta.TotalMinutes.ToString(CultureInfo.InvariantCulture))); - serializedText.Append(sep); - // serialize the TransitionTime's - SerializeTransitionTime(rule.DaylightTransitionStart, serializedText); - serializedText.Append(sep); - SerializeTransitionTime(rule.DaylightTransitionEnd, serializedText); - serializedText.Append(sep); - if (rule.BaseUtcOffsetDelta != TimeSpan.Zero) { // Serialize it only when BaseUtcOffsetDelta has a value to reduce the impact of adding rule.BaseUtcOffsetDelta - serializedText.Append(SerializeSubstitute(rule.BaseUtcOffsetDelta.TotalMinutes.ToString(CultureInfo.InvariantCulture))); - serializedText.Append(sep); - } - if (rule.NoDaylightTransitions) { // Serialize it only when NoDaylightTransitions is true to reduce the impact of adding rule.NoDaylightTransitions - serializedText.Append(SerializeSubstitute("1")); - serializedText.Append(sep); - } - serializedText.Append(rhs); - } - } - serializedText.Append(sep); - return StringBuilderCache.GetStringAndRelease(serializedText); - } - - - // - // GetDeserializedTimeZoneInfo - - // - // static method that instantiates a TimeZoneInfo from a custom serialized - // string - // - static public TimeZoneInfo GetDeserializedTimeZoneInfo(String source) { - StringSerializer s = new StringSerializer(source); - - String id = s.GetNextStringValue(false); - TimeSpan baseUtcOffset = s.GetNextTimeSpanValue(false); - String displayName = s.GetNextStringValue(false); - String standardName = s.GetNextStringValue(false); - String daylightName = s.GetNextStringValue(false); - AdjustmentRule[] rules = s.GetNextAdjustmentRuleArrayValue(false); - - try { - return new TimeZoneInfo(id, baseUtcOffset, displayName, standardName, daylightName, rules, disableDaylightSavingTime: false); - } - catch (ArgumentException ex) { - throw new SerializationException(Environment.GetResourceString("Serialization_InvalidData"), ex); - } - catch (InvalidTimeZoneException ex) { - throw new SerializationException(Environment.GetResourceString("Serialization_InvalidData"), ex); - } - } - - // ---- SECTION: public instance methods --------------* - - - // -------- SECTION: constructors -----------------* - - // - // StringSerializer - - // - // private constructor - used by GetDeserializedTimeZoneInfo() - // - private StringSerializer(String str) { - m_serializedText = str; - m_state = State.StartOfToken; - } - - - - // ----- SECTION: internal static utility methods ----------------* - - // - // SerializeSubstitute - - // - // returns a new string with all of the reserved sub-strings escaped - // - // ";" -> "\;" - // "[" -> "\[" - // "]" -> "\]" - // "\" -> "\\" - // - static private String SerializeSubstitute(String text) { - text = text.Replace(escString, escapedEsc); - text = text.Replace(lhsString, escapedLhs); - text = text.Replace(rhsString, escapedRhs); - return text.Replace(sepString, escapedSep); - } - - - // - // SerializeTransitionTime - - // - // Helper method to serialize a TimeZoneInfo.TransitionTime object - // - static private void SerializeTransitionTime(TransitionTime time, StringBuilder serializedText) { - serializedText.Append(lhs); - Int32 fixedDate = (time.IsFixedDateRule ? 1 : 0); - serializedText.Append(fixedDate.ToString(CultureInfo.InvariantCulture)); - serializedText.Append(sep); - - if (time.IsFixedDateRule) { - serializedText.Append(SerializeSubstitute(time.TimeOfDay.ToString(timeOfDayFormat, DateTimeFormatInfo.InvariantInfo))); - serializedText.Append(sep); - serializedText.Append(SerializeSubstitute(time.Month.ToString(CultureInfo.InvariantCulture))); - serializedText.Append(sep); - serializedText.Append(SerializeSubstitute(time.Day.ToString(CultureInfo.InvariantCulture))); - serializedText.Append(sep); - } - else { - serializedText.Append(SerializeSubstitute(time.TimeOfDay.ToString(timeOfDayFormat, DateTimeFormatInfo.InvariantInfo))); - serializedText.Append(sep); - serializedText.Append(SerializeSubstitute(time.Month.ToString(CultureInfo.InvariantCulture))); - serializedText.Append(sep); - serializedText.Append(SerializeSubstitute(time.Week.ToString(CultureInfo.InvariantCulture))); - serializedText.Append(sep); - serializedText.Append(SerializeSubstitute(((int)time.DayOfWeek).ToString(CultureInfo.InvariantCulture))); - serializedText.Append(sep); - } - serializedText.Append(rhs); - } - - // - // VerifyIsEscapableCharacter - - // - // Helper function to determine if the passed in string token is allowed to be preceeded by an escape sequence token - // - static private void VerifyIsEscapableCharacter(char c) { - if (c != esc && c != sep && c != lhs && c != rhs) { - throw new SerializationException(Environment.GetResourceString("Serialization_InvalidEscapeSequence", c)); - } - } - - // ----- SECTION: internal instance utility methods ----------------* - - // - // SkipVersionNextDataFields - - // - // Helper function that reads past "v.Next" data fields. Receives a "depth" parameter indicating the - // current relative nested bracket depth that m_currentTokenStartIndex is at. The function ends - // successfully when "depth" returns to zero (0). - // - // - private void SkipVersionNextDataFields(Int32 depth /* starting depth in the nested brackets ('[', ']')*/) { - if (m_currentTokenStartIndex < 0 || m_currentTokenStartIndex >= m_serializedText.Length) { - throw new SerializationException(Environment.GetResourceString("Serialization_InvalidData")); - } - State tokenState = State.NotEscaped; - - // walk the serialized text, building up the token as we go... - for (int i = m_currentTokenStartIndex; i < m_serializedText.Length; i++) { - if (tokenState == State.Escaped) { - VerifyIsEscapableCharacter(m_serializedText[i]); - tokenState = State.NotEscaped; - } - else if (tokenState == State.NotEscaped) { - switch (m_serializedText[i]) { - case esc: - tokenState = State.Escaped; - break; - - case lhs: - depth++; - break; - case rhs: - depth--; - if (depth == 0) { - m_currentTokenStartIndex = i + 1; - if (m_currentTokenStartIndex >= m_serializedText.Length) { - m_state = State.EndOfLine; - } - else { - m_state = State.StartOfToken; - } - return; - } - break; - - case '\0': - // invalid character - throw new SerializationException(Environment.GetResourceString("Serialization_InvalidData")); - - default: - break; - } - } - } - - throw new SerializationException(Environment.GetResourceString("Serialization_InvalidData")); - } - - - // - // GetNextStringValue - - // - // Helper function that reads a string token from the serialized text. The function - // updates the m_currentTokenStartIndex to point to the next token on exit. Also m_state - // is set to either State.StartOfToken or State.EndOfLine on exit. - // - // The function takes a parameter "canEndWithoutSeparator". - // - // * When set to 'false' the function requires the string token end with a ";". - // * When set to 'true' the function requires that the string token end with either - // ";", State.EndOfLine, or "]". In the case that "]" is the terminal case the - // m_currentTokenStartIndex is left pointing at index "]" to allow the caller to update - // its depth logic. - // - private String GetNextStringValue(Boolean canEndWithoutSeparator) { - - // first verify the internal state of the object - if (m_state == State.EndOfLine) { - if (canEndWithoutSeparator) { - return null; - } - else { - throw new SerializationException(Environment.GetResourceString("Serialization_InvalidData")); - } - } - if (m_currentTokenStartIndex < 0 || m_currentTokenStartIndex >= m_serializedText.Length) { - throw new SerializationException(Environment.GetResourceString("Serialization_InvalidData")); - } - State tokenState = State.NotEscaped; - StringBuilder token = StringBuilderCache.Acquire(initialCapacityForString); - - // walk the serialized text, building up the token as we go... - for (int i = m_currentTokenStartIndex; i < m_serializedText.Length; i++) { - if (tokenState == State.Escaped) { - VerifyIsEscapableCharacter(m_serializedText[i]); - token.Append(m_serializedText[i]); - tokenState = State.NotEscaped; - } - else if (tokenState == State.NotEscaped) { - switch (m_serializedText[i]) { - case esc: - tokenState = State.Escaped; - break; - - case lhs: - // '[' is an unexpected character - throw new SerializationException(Environment.GetResourceString("Serialization_InvalidData")); - - case rhs: - if (canEndWithoutSeparator) { - // if ';' is not a required terminal then treat ']' as a terminal - // leave m_currentTokenStartIndex pointing to ']' so our callers can handle - // this special case - m_currentTokenStartIndex = i; - m_state = State.StartOfToken; - return token.ToString(); - } - else { - // ']' is an unexpected character - throw new SerializationException(Environment.GetResourceString("Serialization_InvalidData")); - } - - case sep: - m_currentTokenStartIndex = i + 1; - if (m_currentTokenStartIndex >= m_serializedText.Length) { - m_state = State.EndOfLine; - } - else { - m_state = State.StartOfToken; - } - return StringBuilderCache.GetStringAndRelease(token); - - case '\0': - // invalid character - throw new SerializationException(Environment.GetResourceString("Serialization_InvalidData")); - - default: - token.Append(m_serializedText[i]); - break; - } - } - } - // - // we are at the end of the line - // - if (tokenState == State.Escaped) { - // we are at the end of the serialized text but we are in an escaped state - throw new SerializationException(Environment.GetResourceString("Serialization_InvalidEscapeSequence", String.Empty)); - } - - if (!canEndWithoutSeparator) { - throw new SerializationException(Environment.GetResourceString("Serialization_InvalidData")); - } - m_currentTokenStartIndex = m_serializedText.Length; - m_state = State.EndOfLine; - return StringBuilderCache.GetStringAndRelease(token); - } - - // - // GetNextDateTimeValue - - // - // Helper function to read a DateTime token. Takes a boolean "canEndWithoutSeparator" - // and a "format" string. - // - private DateTime GetNextDateTimeValue(Boolean canEndWithoutSeparator, string format) { - String token = GetNextStringValue(canEndWithoutSeparator); - DateTime time; - if (!DateTime.TryParseExact(token, format, DateTimeFormatInfo.InvariantInfo, DateTimeStyles.None, out time)) { - throw new SerializationException(Environment.GetResourceString("Serialization_InvalidData")); - } - return time; - } - - // - // GetNextTimeSpanValue - - // - // Helper function to read a DateTime token. Takes a boolean "canEndWithoutSeparator". - // - private TimeSpan GetNextTimeSpanValue(Boolean canEndWithoutSeparator) { - Int32 token = GetNextInt32Value(canEndWithoutSeparator); - - try { - return new TimeSpan(0 /* hours */, token /* minutes */, 0 /* seconds */); - } - catch (ArgumentOutOfRangeException e) { - throw new SerializationException(Environment.GetResourceString("Serialization_InvalidData"), e); - } - } - - - // - // GetNextInt32Value - - // - // Helper function to read an Int32 token. Takes a boolean "canEndWithoutSeparator". - // - private Int32 GetNextInt32Value(Boolean canEndWithoutSeparator) { - String token = GetNextStringValue(canEndWithoutSeparator); - Int32 value; - if (!Int32.TryParse(token, NumberStyles.AllowLeadingSign /* "[sign]digits" */, CultureInfo.InvariantCulture, out value)) { - throw new SerializationException(Environment.GetResourceString("Serialization_InvalidData")); - } - return value; - } - - - // - // GetNextAdjustmentRuleArrayValue - - // - // Helper function to read an AdjustmentRule[] token. Takes a boolean "canEndWithoutSeparator". - // - private AdjustmentRule[] GetNextAdjustmentRuleArrayValue(Boolean canEndWithoutSeparator) { - List<AdjustmentRule> rules = new List<AdjustmentRule>(1); - int count = 0; - - // individual AdjustmentRule array elements do not require semicolons - AdjustmentRule rule = GetNextAdjustmentRuleValue(true); - while (rule != null) { - rules.Add(rule); - count++; - - rule = GetNextAdjustmentRuleValue(true); - } - - if (!canEndWithoutSeparator) { - // the AdjustmentRule array must end with a separator - if (m_state == State.EndOfLine) { - throw new SerializationException(Environment.GetResourceString("Serialization_InvalidData")); - } - if (m_currentTokenStartIndex < 0 || m_currentTokenStartIndex >= m_serializedText.Length) { - throw new SerializationException(Environment.GetResourceString("Serialization_InvalidData")); - } - } - - return (count != 0 ? rules.ToArray() : null); - } - - // - // GetNextAdjustmentRuleValue - - // - // Helper function to read an AdjustmentRule token. Takes a boolean "canEndWithoutSeparator". - // - private AdjustmentRule GetNextAdjustmentRuleValue(Boolean canEndWithoutSeparator) { - // first verify the internal state of the object - if (m_state == State.EndOfLine) { - if (canEndWithoutSeparator) { - return null; - } - else { - throw new SerializationException(Environment.GetResourceString("Serialization_InvalidData")); - } - } - - if (m_currentTokenStartIndex < 0 || m_currentTokenStartIndex >= m_serializedText.Length) { - throw new SerializationException(Environment.GetResourceString("Serialization_InvalidData")); - } - - // check to see if the very first token we see is the separator - if (m_serializedText[m_currentTokenStartIndex] == sep) { - return null; - } - - // verify the current token is a left-hand-side marker ("[") - if (m_serializedText[m_currentTokenStartIndex] != lhs) { - throw new SerializationException(Environment.GetResourceString("Serialization_InvalidData")); - } - m_currentTokenStartIndex++; - - DateTime dateStart = GetNextDateTimeValue(false, dateTimeFormat); - DateTime dateEnd = GetNextDateTimeValue(false, dateTimeFormat); - TimeSpan daylightDelta = GetNextTimeSpanValue(false); - TransitionTime daylightStart = GetNextTransitionTimeValue(false); - TransitionTime daylightEnd = GetNextTransitionTimeValue(false); - TimeSpan baseUtcOffsetDelta = TimeSpan.Zero; - Int32 noDaylightTransitions = 0; - - // verify that the string is now at the right-hand-side marker ("]") ... - - if (m_state == State.EndOfLine || m_currentTokenStartIndex >= m_serializedText.Length) { - throw new SerializationException(Environment.GetResourceString("Serialization_InvalidData")); - } - - // Check if we have baseUtcOffsetDelta in the serialized string and then deserialize it - if ((m_serializedText[m_currentTokenStartIndex] >= '0' && m_serializedText[m_currentTokenStartIndex] <= '9') || - m_serializedText[m_currentTokenStartIndex] == '-' || m_serializedText[m_currentTokenStartIndex] == '+') { - baseUtcOffsetDelta = GetNextTimeSpanValue(false); - } - - // Check if we have NoDaylightTransitions in the serialized string and then deserialize it - if ((m_serializedText[m_currentTokenStartIndex] >= '0' && m_serializedText[m_currentTokenStartIndex] <= '1')) { - noDaylightTransitions = GetNextInt32Value(false); - } - - if (m_state == State.EndOfLine || m_currentTokenStartIndex >= m_serializedText.Length) { - throw new SerializationException(Environment.GetResourceString("Serialization_InvalidData")); - } - - if (m_serializedText[m_currentTokenStartIndex] != rhs) { - // skip ahead of any "v.Next" data at the end of the AdjustmentRule - // - // FUTURE: if the serialization format is extended in the future then this - // code section will need to be changed to read the new fields rather - // than just skipping the data at the end of the [AdjustmentRule]. - SkipVersionNextDataFields(1); - } - else { - m_currentTokenStartIndex++; - } - - // create the AdjustmentRule from the deserialized fields ... - - AdjustmentRule rule; - try { - rule = AdjustmentRule.CreateAdjustmentRule(dateStart, dateEnd, daylightDelta, daylightStart, daylightEnd, baseUtcOffsetDelta, noDaylightTransitions > 0); - } - catch (ArgumentException e) { - throw new SerializationException(Environment.GetResourceString("Serialization_InvalidData"), e); - } - - // finally set the state to either EndOfLine or StartOfToken for the next caller - if (m_currentTokenStartIndex >= m_serializedText.Length) { - m_state = State.EndOfLine; - } - else { - m_state = State.StartOfToken; - } - return rule; - } - - - // - // GetNextTransitionTimeValue - - // - // Helper function to read a TransitionTime token. Takes a boolean "canEndWithoutSeparator". - // - private TransitionTime GetNextTransitionTimeValue(Boolean canEndWithoutSeparator) { - - // first verify the internal state of the object - - if (m_state == State.EndOfLine - || (m_currentTokenStartIndex < m_serializedText.Length - && m_serializedText[m_currentTokenStartIndex] == rhs)) { - // - // we are at the end of the line or we are starting at a "]" character - // - throw new SerializationException(Environment.GetResourceString("Serialization_InvalidData")); - } - - if (m_currentTokenStartIndex < 0 || m_currentTokenStartIndex >= m_serializedText.Length) { - throw new SerializationException(Environment.GetResourceString("Serialization_InvalidData")); - } - - // verify the current token is a left-hand-side marker ("[") - - if (m_serializedText[m_currentTokenStartIndex] != lhs) { - throw new SerializationException(Environment.GetResourceString("Serialization_InvalidData")); - } - m_currentTokenStartIndex++; - - Int32 isFixedDate = GetNextInt32Value(false); - - if (isFixedDate != 0 && isFixedDate != 1) { - throw new SerializationException(Environment.GetResourceString("Serialization_InvalidData")); - } - - TransitionTime transition; - - DateTime timeOfDay = GetNextDateTimeValue(false, timeOfDayFormat); - timeOfDay = new DateTime(1, 1, 1, timeOfDay.Hour,timeOfDay.Minute,timeOfDay.Second, timeOfDay.Millisecond); - - Int32 month = GetNextInt32Value(false); - - if (isFixedDate == 1) { - Int32 day = GetNextInt32Value(false); - - try { - transition = TransitionTime.CreateFixedDateRule(timeOfDay, month, day); - } - catch (ArgumentException e) { - throw new SerializationException(Environment.GetResourceString("Serialization_InvalidData"), e); - } - } - else { - Int32 week = GetNextInt32Value(false); - Int32 dayOfWeek = GetNextInt32Value(false); - - try { - transition = TransitionTime.CreateFloatingDateRule(timeOfDay, month, week, (DayOfWeek)dayOfWeek); - } - catch (ArgumentException e) { - throw new SerializationException(Environment.GetResourceString("Serialization_InvalidData"), e); - } - - } - - // verify that the string is now at the right-hand-side marker ("]") ... - - if (m_state == State.EndOfLine || m_currentTokenStartIndex >= m_serializedText.Length) { - throw new SerializationException(Environment.GetResourceString("Serialization_InvalidData")); - } - - if (m_serializedText[m_currentTokenStartIndex] != rhs) { - // skip ahead of any "v.Next" data at the end of the AdjustmentRule - // - // FUTURE: if the serialization format is extended in the future then this - // code section will need to be changed to read the new fields rather - // than just skipping the data at the end of the [TransitionTime]. - SkipVersionNextDataFields(1); - } - else { - m_currentTokenStartIndex++; - } - - // check to see if the string is now at the separator (";") ... - Boolean sepFound = false; - if (m_currentTokenStartIndex < m_serializedText.Length - && m_serializedText[m_currentTokenStartIndex] == sep) { - // handle the case where we ended on a ";" - m_currentTokenStartIndex++; - sepFound = true; - } - - if (!sepFound && !canEndWithoutSeparator) { - // we MUST end on a separator - throw new SerializationException(Environment.GetResourceString("Serialization_InvalidData")); - } - - - // finally set the state to either EndOfLine or StartOfToken for the next caller - if (m_currentTokenStartIndex >= m_serializedText.Length) { - m_state = State.EndOfLine; - } - else { - m_state = State.StartOfToken; - } - return transition; - } - } - -#if PLATFORM_UNIX - private struct TZifType - { - private const int c_len = 6; - public static int Length - { - get - { - return c_len; - } - } - - public TimeSpan UtcOffset; - public Boolean IsDst; - public Byte AbbreviationIndex; - - public TZifType(Byte[] data, Int32 index) - { - if (data == null || data.Length < index + c_len) - { - throw new ArgumentException(Environment.GetResourceString("Argument_TimeZoneInfoInvalidTZif"), nameof(data)); - } - Contract.EndContractBlock(); - UtcOffset = new TimeSpan(0, 0, TZif_ToInt32(data, index + 00)); - IsDst = (data[index + 4] != 0); - AbbreviationIndex = data[index + 5]; - } - } - - private struct TZifHead - { - private const int c_len = 44; - public static int Length - { - get - { - return c_len; - } - } - - public TZifHead(Byte[] data, Int32 index) - { - if (data == null || data.Length < c_len) - { - throw new ArgumentException("bad data", nameof(data)); - } - Contract.EndContractBlock(); - - Magic = (uint)TZif_ToInt32(data, index + 00); - - if (Magic != 0x545A6966) - { - // 0x545A6966 = {0x54, 0x5A, 0x69, 0x66} = "TZif" - throw new ArgumentException(Environment.GetResourceString("Argument_TimeZoneInfoBadTZif"), nameof(data)); - } - - byte version = data[index + 04]; - Version = version == '2' ? TZVersion.V2 : - version == '3' ? TZVersion.V3 : - TZVersion.V1; // default/fallback to V1 to guard against future, unsupported version numbers - - // skip the 15 byte reserved field - - // don't use the BitConverter class which parses data - // based on the Endianess of the machine architecture. - // this data is expected to always be in "standard byte order", - // regardless of the machine it is being processed on. - - IsGmtCount = (uint)TZif_ToInt32(data, index + 20); - IsStdCount = (uint)TZif_ToInt32(data, index + 24); - LeapCount = (uint)TZif_ToInt32(data, index + 28); - TimeCount = (uint)TZif_ToInt32(data, index + 32); - TypeCount = (uint)TZif_ToInt32(data, index + 36); - CharCount = (uint)TZif_ToInt32(data, index + 40); - } - - public UInt32 Magic; // TZ_MAGIC "TZif" - public TZVersion Version; // 1 byte for a \0 or 2 or 3 - // public Byte[15] Reserved; // reserved for future use - public UInt32 IsGmtCount; // number of transition time flags - public UInt32 IsStdCount; // number of transition time flags - public UInt32 LeapCount; // number of leap seconds - public UInt32 TimeCount; // number of transition times - public UInt32 TypeCount; // number of local time types - public UInt32 CharCount; // number of abbreviated characters - } - - private enum TZVersion : byte - { - V1 = 0, - V2, - V3, - // when adding more versions, ensure all the logic using TZVersion is still correct - } -#endif // PLATFORM_UNIX - - } // TimezoneInfo -} // namespace System + } +} |