mcs/class/corlib/System/TimeZoneInfo.cs

   1
   2 /*
   3  * System.TimeZoneInfo
   4  *
   5  * Author(s)
   6  *      Stephane Delcroix <stephane@delcroix.org>
   7  *
   8  * Copyright 2011 Xamarin Inc.
   9  *
  10  * Permission is hereby granted, free of charge, to any person obtaining
  11  * a copy of this software and associated documentation files (the
  12  * "Software"), to deal in the Software without restriction, including
  13  * without limitation the rights to use, copy, modify, merge, publish,
  14  * distribute, sublicense, and/or sell copies of the Software, and to
  15  * permit persons to whom the Software is furnished to do so, subject to
  16  * the following conditions:
  17  *
  18  * The above copyright notice and this permission notice shall be
  19  * included in all copies or substantial portions of the Software.
  20  *
  21  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  22  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  23  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  24  * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
  25  * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
  26  * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
  27  * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  28  */
  29
  30 using System;
  31 using System.Runtime.CompilerServices;
  32 using System.Threading;
  33 using System.Collections.Generic;
  34 using System.Collections.ObjectModel;
  35 using System.Runtime.Serialization;
  36 using System.Runtime.InteropServices;
  37 using System.Text;
  38 using System.Globalization;
  39 using System.IO;
  40
  41 using Microsoft.Win32;
  42
  43 namespace System
  44 {
  45         partial class TimeZoneInfo
  46         {
  47                 TimeSpan baseUtcOffset;
  48                 public TimeSpan BaseUtcOffset {
  49                         get { return baseUtcOffset; }
  50                 }
  51
  52                 string daylightDisplayName;
  53                 public string DaylightName {
  54                         get {
  55                                 return supportsDaylightSavingTime
  56                                         ? daylightDisplayName
  57                                         : string.Empty;
  58                         }
  59                 }
  60
  61                 string displayName;
  62                 public string DisplayName {
  63                         get { return displayName; }
  64                 }
  65
  66                 string id;
  67                 public string Id {
  68                         get { return id; }
  69                 }
  70
  71                 static TimeZoneInfo local;
  72                 public static TimeZoneInfo Local {
  73                         get {
  74                                 var l = local;
  75                                 if (l == null) {
  76                                         l = CreateLocal ();
  77                                         if (l == null)
  78                                                 throw new TimeZoneNotFoundException ();
  79
  80                                         if (Interlocked.CompareExchange (ref local, l, null) != null)
  81                                                 l = local;
  82                                 }
  83
  84                                 return l;
  85                         }
  86                 }
  87
  88                 /*
  89                         TimeZone transitions are stored when there is a change on the base offset.
  90                 */
  91                 private List<KeyValuePair<DateTime, TimeType>> transitions;
  92
  93                 private static bool readlinkNotFound;
  94
  95                 [DllImport ("libc")]
  96                 private static extern int readlink (string path, byte[] buffer, int buflen);
  97
  98                 private static string readlink (string path)
  99                 {
 100                         if (readlinkNotFound)
 101                                 return null;
 102
 103                         byte[] buf = new byte [512];
 104                         int ret;
 105
 106                         try {
 107                                 ret = readlink (path, buf, buf.Length);
 108                         } catch (DllNotFoundException) {
 109                                 readlinkNotFound = true;
 110                                 return null;
 111                         } catch (EntryPointNotFoundException) {
 112                                 readlinkNotFound = true;
 113                                 return null;
 114                         }
 115
 116                         if (ret == -1) return null;
 117                         char[] cbuf = new char [512];
 118                         int chars = System.Text.Encoding.Default.GetChars (buf, 0, ret, cbuf, 0);
 119                         return new String (cbuf, 0, chars);
 120                 }
 121
 122                 private static bool TryGetNameFromPath (string path, out string name)
 123                 {
 124                         name = null;
 125                         var linkPath = readlink (path);
 126                         if (linkPath != null) {
 127                                 if (Path.IsPathRooted(linkPath))
 128                                         path = linkPath;
 129                                 else
 130                                         path = Path.Combine(Path.GetDirectoryName(path), linkPath);
 131                         }
 132
 133                         path = Path.GetFullPath (path);
 134
 135                         if (string.IsNullOrEmpty (TimeZoneDirectory))
 136                                 return false;
 137
 138                         var baseDir = TimeZoneDirectory;
 139                         if (baseDir [baseDir.Length-1] != Path.DirectorySeparatorChar)
 140                                 baseDir += Path.DirectorySeparatorChar;
 141
 142                         if (!path.StartsWith (baseDir, StringComparison.InvariantCulture))
 143                                 return false;
 144
 145                         name = path.Substring (baseDir.Length);
 146                         if (name == "localtime")
 147                                 name = "Local";
 148
 149                         return true;
 150                 }
 151
 152 #if !MONODROID && !MONOTOUCH && !XAMMAC
 153                 static TimeZoneInfo CreateLocal ()
 154                 {
 155 #if WIN_PLATFORM
 156                         if (IsWindows && LocalZoneKey != null) {
 157                                 string name = (string)LocalZoneKey.GetValue ("TimeZoneKeyName");
 158                                 if (name == null)
 159                                         name = (string)LocalZoneKey.GetValue ("StandardName"); // windows xp
 160                                 name = TrimSpecial (name);
 161                                 if (name != null)
 162                                         return TimeZoneInfo.FindSystemTimeZoneById (name);
 163                         } else if (IsWindows) {
 164                                 return GetLocalTimeZoneInfoWinRTFallback ();
 165                         }
 166 #endif
 167
 168                         var tz = Environment.GetEnvironmentVariable ("TZ");
 169                         if (tz != null) {
 170                                 if (tz == String.Empty)
 171                                         return Utc;
 172                                 try {
 173                                         return FindSystemTimeZoneByFileName (tz, Path.Combine (TimeZoneDirectory, tz));
 174                                 } catch {
 175                                         return Utc;
 176                                 }
 177                         }
 178
 179                         var tzFilePaths = new string [] {
 180                                 "/etc/localtime",
 181                                 Path.Combine (TimeZoneDirectory, "localtime")};
 182
 183                         foreach (var tzFilePath in tzFilePaths) {
 184                                 try {
 185                                         string tzName = null;
 186                                         if (!TryGetNameFromPath (tzFilePath, out tzName))
 187                                                 tzName = "Local";
 188                                         return FindSystemTimeZoneByFileName (tzName, tzFilePath);
 189                                 } catch (TimeZoneNotFoundException) {
 190                                         continue;
 191                                 }
 192                         }
 193
 194                         return Utc;
 195                 }
 196
 197                 static TimeZoneInfo FindSystemTimeZoneByIdCore (string id)
 198                 {
 199 #if LIBC
 200                         string filepath = Path.Combine (TimeZoneDirectory, id);
 201                         return FindSystemTimeZoneByFileName (id, filepath);
 202 #else
 203                         throw new NotImplementedException ();
 204 #endif
 205                 }
 206
 207                 static void GetSystemTimeZonesCore (List<TimeZoneInfo> systemTimeZones)
 208                 {
 209 #if WIN_PLATFORM
 210                         if (TimeZoneKey != null) {
 211                                 foreach (string id in TimeZoneKey.GetSubKeyNames ()) {
 212                                         try {
 213                                                 systemTimeZones.Add (FindSystemTimeZoneById (id));
 214                                         } catch {}
 215                                 }
 216
 217                                 return;
 218                         } else if (IsWindows) {
 219                                 systemTimeZones.AddRange (GetSystemTimeZonesWinRTFallback ());
 220                                 return;
 221                         }
 222 #endif
 223
 224 #if LIBC
 225                         string[] continents = new string [] {"Africa", "America", "Antarctica", "Arctic", "Asia", "Atlantic", "Australia", "Brazil", "Canada", "Chile", "Europe", "Indian", "Mexico", "Mideast", "Pacific", "US"};
 226                         foreach (string continent in continents) {
 227                                 try {
 228                                         foreach (string zonepath in Directory.GetFiles (Path.Combine (TimeZoneDirectory, continent))) {
 229                                                 try {
 230                                                         string id = String.Format ("{0}/{1}", continent, Path.GetFileName (zonepath));
 231                                                         systemTimeZones.Add (FindSystemTimeZoneById (id));
 232                                                 } catch (ArgumentNullException) {
 233                                                 } catch (TimeZoneNotFoundException) {
 234                                                 } catch (InvalidTimeZoneException) {
 235                                                 } catch (Exception) {
 236                                                         throw;
 237                                                 }
 238                                         }
 239                                 } catch {}
 240                         }
 241 #else
 242                         throw new NotImplementedException ("This method is not implemented for this platform");
 243 #endif
 244                 }
 245 #endif // !MONODROID && !MONOTOUCH && !XAMMAC
 246
 247                 string standardDisplayName;
 248                 public string StandardName {
 249                         get { return standardDisplayName; }
 250                 }
 251
 252                 bool supportsDaylightSavingTime;
 253                 public bool SupportsDaylightSavingTime {
 254                         get  { return supportsDaylightSavingTime; }
 255                 }
 256
 257                 static TimeZoneInfo utc;
 258                 public static TimeZoneInfo Utc {
 259                         get {
 260                                 if (utc == null)
 261                                         utc = CreateCustomTimeZone ("UTC", new TimeSpan (0), "UTC", "UTC");
 262                                 return utc;
 263                         }
 264                 }
 265 #if LIBC
 266                 static string timeZoneDirectory;
 267                 static string TimeZoneDirectory {
 268                         get {
 269                                 if (timeZoneDirectory == null)
 270                                         timeZoneDirectory = "/usr/share/zoneinfo";
 271                                 return timeZoneDirectory;
 272                         }
 273                         set {
 274                                 ClearCachedData ();
 275                                 timeZoneDirectory = value;
 276                         }
 277                 }
 278 #endif
 279                 private AdjustmentRule [] adjustmentRules;
 280
 281 #if (!MOBILE || !FULL_AOT_DESKTOP || WIN_PLATFORM) && !XAMMAC_4_5
 282                 /// <summary>
 283                 /// Determine whether windows of not (taken Stephane Delcroix's code)
 284                 /// </summary>
 285                 private static bool IsWindows
 286                 {
 287                         get {
 288                                 int platform = (int) Environment.OSVersion.Platform;
 289                                 return ((platform != 4) && (platform != 6) && (platform != 128));
 290                         }
 291                 }
 292
 293                 /// <summary>
 294                 /// Needed to trim misc garbage in MS registry keys
 295                 /// </summary>
 296                 private static string TrimSpecial (string str)
 297                 {
 298                         if (str == null)
 299                                 return str;
 300                         var Istart = 0;
 301                         while (Istart < str.Length && !char.IsLetterOrDigit(str[Istart])) Istart++;
 302                         var Iend = str.Length - 1;
 303                         while (Iend > Istart && !char.IsLetterOrDigit(str[Iend]) && str[Iend] != ')') // zone name can include parentheses like "Central Standard Time (Mexico)"
 304                                 Iend--;
 305
 306                         return str.Substring (Istart, Iend-Istart+1);
 307                 }
 308
 309 #if !FULL_AOT_DESKTOP || WIN_PLATFORM
 310                 static RegistryKey timeZoneKey;
 311                 static RegistryKey TimeZoneKey {
 312                         get {
 313                                 if (timeZoneKey != null)
 314                                         return timeZoneKey;
 315                                 if (!IsWindows)
 316                                         return null;
 317
 318                                 try {
 319                                         return timeZoneKey = Registry.LocalMachine.OpenSubKey (
 320                                                 "SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\Time Zones",
 321                                                 false);
 322                                 } catch {
 323                                         return null;
 324                                 }
 325                         }
 326                 }
 327
 328                 static RegistryKey localZoneKey;
 329                 static RegistryKey LocalZoneKey {
 330                         get {
 331                                 if (localZoneKey != null)
 332                                         return localZoneKey;
 333
 334                                 if (!IsWindows)
 335                                         return null;
 336
 337                                 try {
 338                                         return localZoneKey = Registry.LocalMachine.OpenSubKey (
 339                                                 "SYSTEM\\CurrentControlSet\\Control\\TimeZoneInformation", false);
 340                                 } catch {
 341                                         return null;
 342                                 }
 343                         }
 344                 }
 345 #endif
 346 #endif // !MOBILE || !FULL_AOT_DESKTOP || WIN_PLATFORM
 347
 348                 private static bool TryAddTicks (DateTime date, long ticks, out DateTime result, DateTimeKind kind = DateTimeKind.Unspecified)
 349                 {
 350                         var resultTicks = date.Ticks + ticks;
 351                         if (resultTicks < DateTime.MinValue.Ticks) {
 352                                 result = DateTime.SpecifyKind (DateTime.MinValue, kind);
 353                                 return false;
 354                         }
 355
 356                         if (resultTicks > DateTime.MaxValue.Ticks) {
 357                                 result = DateTime.SpecifyKind (DateTime.MaxValue, kind);
 358                                 return false;
 359                         }
 360
 361                         result = new DateTime (resultTicks, kind);
 362                         return true;
 363                 }
 364
 365                 public static void ClearCachedData ()
 366                 {
 367                         local = null;
 368                         utc = null;
 369                         systemTimeZones = null;
 370                 }
 371
 372                 public static DateTime ConvertTime (DateTime dateTime, TimeZoneInfo destinationTimeZone)
 373                 {
 374                         return ConvertTime (dateTime, dateTime.Kind == DateTimeKind.Utc ? TimeZoneInfo.Utc : TimeZoneInfo.Local, destinationTimeZone);
 375                 }
 376
 377                 public static DateTime ConvertTime (DateTime dateTime, TimeZoneInfo sourceTimeZone, TimeZoneInfo destinationTimeZone)
 378                 {
 379                         if (sourceTimeZone == null)
 380                                 throw new ArgumentNullException ("sourceTimeZone");
 381
 382                         if (destinationTimeZone == null)
 383                                 throw new ArgumentNullException ("destinationTimeZone");
 384
 385                         if (dateTime.Kind == DateTimeKind.Local && sourceTimeZone != TimeZoneInfo.Local)
 386                                 throw new ArgumentException ("Kind property of dateTime is Local but the sourceTimeZone does not equal TimeZoneInfo.Local");
 387
 388                         if (dateTime.Kind == DateTimeKind.Utc && sourceTimeZone != TimeZoneInfo.Utc)
 389                                 throw new ArgumentException ("Kind property of dateTime is Utc but the sourceTimeZone does not equal TimeZoneInfo.Utc");
 390
 391                         if (sourceTimeZone.IsInvalidTime (dateTime))
 392                                 throw new ArgumentException ("dateTime parameter is an invalid time");
 393
 394                         if (dateTime.Kind == DateTimeKind.Local && sourceTimeZone == TimeZoneInfo.Local && destinationTimeZone == TimeZoneInfo.Local)
 395                                 return dateTime;
 396
 397                         DateTime utc = ConvertTimeToUtc (dateTime, sourceTimeZone);
 398
 399                         if (destinationTimeZone != TimeZoneInfo.Utc) {
 400                                 utc = ConvertTimeFromUtc (utc, destinationTimeZone);
 401                                 if (dateTime.Kind == DateTimeKind.Unspecified)
 402                                         return DateTime.SpecifyKind (utc, DateTimeKind.Unspecified);
 403                         }
 404
 405                         return utc;
 406                 }
 407
 408                 public static DateTimeOffset ConvertTime(DateTimeOffset dateTimeOffset, TimeZoneInfo destinationTimeZone)
 409                 {
 410                         if (destinationTimeZone == null)
 411                                 throw new ArgumentNullException("destinationTimeZone");
 412
 413                         var utcDateTime = dateTimeOffset.UtcDateTime;
 414
 415                         bool isDst;
 416                         var utcOffset =  destinationTimeZone.GetUtcOffset(utcDateTime, out isDst);
 417
 418                         return new DateTimeOffset(DateTime.SpecifyKind(utcDateTime, DateTimeKind.Unspecified) + utcOffset, utcOffset);
 419                 }
 420
 421                 public static DateTime ConvertTimeBySystemTimeZoneId (DateTime dateTime, string destinationTimeZoneId)
 422                 {
 423                         return ConvertTime (dateTime, FindSystemTimeZoneById (destinationTimeZoneId));
 424                 }
 425
 426                 public static DateTime ConvertTimeBySystemTimeZoneId (DateTime dateTime, string sourceTimeZoneId, string destinationTimeZoneId)
 427                 {
 428                         TimeZoneInfo source_tz;
 429                         if (dateTime.Kind == DateTimeKind.Utc && sourceTimeZoneId == TimeZoneInfo.Utc.Id) {
 430                                 source_tz = Utc;
 431                         } else {
 432                                 source_tz = FindSystemTimeZoneById (sourceTimeZoneId);
 433                         }
 434
 435                         return ConvertTime (dateTime, source_tz, FindSystemTimeZoneById (destinationTimeZoneId));
 436                 }
 437
 438                 public static DateTimeOffset ConvertTimeBySystemTimeZoneId (DateTimeOffset dateTimeOffset, string destinationTimeZoneId)
 439                 {
 440                         return ConvertTime (dateTimeOffset, FindSystemTimeZoneById (destinationTimeZoneId));
 441                 }
 442
 443                 private DateTime ConvertTimeFromUtc (DateTime dateTime)
 444                 {
 445                         if (dateTime.Kind == DateTimeKind.Local)
 446                                 throw new ArgumentException ("Kind property of dateTime is Local");
 447
 448                         if (this == TimeZoneInfo.Utc)
 449                                 return DateTime.SpecifyKind (dateTime, DateTimeKind.Utc);
 450
 451                         var utcOffset = GetUtcOffset (dateTime);
 452
 453                         var kind = (this == TimeZoneInfo.Local)? DateTimeKind.Local : DateTimeKind.Unspecified;
 454
 455                         DateTime result;
 456                         if (!TryAddTicks (dateTime, utcOffset.Ticks, out result, kind))
 457                                 return DateTime.SpecifyKind (DateTime.MaxValue, kind);
 458
 459                         return result;
 460                 }
 461
 462                 public static DateTime ConvertTimeFromUtc (DateTime dateTime, TimeZoneInfo destinationTimeZone)
 463                 {
 464                         if (destinationTimeZone == null)
 465                                 throw new ArgumentNullException ("destinationTimeZone");
 466
 467                         return destinationTimeZone.ConvertTimeFromUtc (dateTime);
 468                 }
 469
 470                 public static DateTime ConvertTimeToUtc (DateTime dateTime)
 471                 {
 472                         if (dateTime.Kind == DateTimeKind.Utc)
 473                                 return dateTime;
 474
 475                         return ConvertTimeToUtc (dateTime, TimeZoneInfo.Local);
 476                 }
 477
 478                 static internal DateTime ConvertTimeToUtc(DateTime dateTime, TimeZoneInfoOptions flags)
 479                 {
 480                         return ConvertTimeToUtc (dateTime, TimeZoneInfo.Local, flags);
 481                 }
 482
 483                 public static DateTime ConvertTimeToUtc (DateTime dateTime, TimeZoneInfo sourceTimeZone)
 484                 {
 485                         return ConvertTimeToUtc (dateTime, sourceTimeZone, TimeZoneInfoOptions.None);
 486                 }
 487
 488                 static DateTime ConvertTimeToUtc (DateTime dateTime, TimeZoneInfo sourceTimeZone, TimeZoneInfoOptions flags)
 489                 {
 490                         if ((flags & TimeZoneInfoOptions.NoThrowOnInvalidTime) == 0) {
 491                                 if (sourceTimeZone == null)
 492                                         throw new ArgumentNullException ("sourceTimeZone");
 493
 494                                 if (dateTime.Kind == DateTimeKind.Utc && sourceTimeZone != TimeZoneInfo.Utc)
 495                                         throw new ArgumentException ("Kind property of dateTime is Utc but the sourceTimeZone does not equal TimeZoneInfo.Utc");
 496
 497                                 if (dateTime.Kind == DateTimeKind.Local && sourceTimeZone != TimeZoneInfo.Local)
 498                                         throw new ArgumentException ("Kind property of dateTime is Local but the sourceTimeZone does not equal TimeZoneInfo.Local");
 499
 500                                 if (sourceTimeZone.IsInvalidTime (dateTime))
 501                                         throw new ArgumentException ("dateTime parameter is an invalid time");
 502                         }
 503
 504                         if (dateTime.Kind == DateTimeKind.Utc)
 505                                 return dateTime;
 506
 507                         bool isDst;
 508                         var utcOffset = sourceTimeZone.GetUtcOffset (dateTime, out isDst);
 509
 510                         DateTime utcDateTime;
 511                         TryAddTicks (dateTime, -utcOffset.Ticks, out utcDateTime, DateTimeKind.Utc);
 512                         return utcDateTime;
 513                 }
 514
 515                 static internal TimeSpan GetDateTimeNowUtcOffsetFromUtc(DateTime time, out Boolean isAmbiguousLocalDst)
 516                 {
 517                         bool isDaylightSavings;
 518                         return GetUtcOffsetFromUtc(time, TimeZoneInfo.Local, out isDaylightSavings, out isAmbiguousLocalDst);
 519                 }
 520
 521                 public static TimeZoneInfo CreateCustomTimeZone (string id, TimeSpan baseUtcOffset, string displayName, string standardDisplayName)
 522                 {
 523                         return CreateCustomTimeZone (id, baseUtcOffset, displayName, standardDisplayName, null, null, true);
 524                 }
 525
 526                 public static TimeZoneInfo CreateCustomTimeZone (string id, TimeSpan baseUtcOffset, string displayName, string standardDisplayName, string daylightDisplayName, TimeZoneInfo.AdjustmentRule [] adjustmentRules)
 527                 {
 528                         return CreateCustomTimeZone (id, baseUtcOffset, displayName, standardDisplayName, daylightDisplayName, adjustmentRules, false);
 529                 }
 530
 531                 public static TimeZoneInfo CreateCustomTimeZone ( string id, TimeSpan baseUtcOffset, string displayName, string standardDisplayName, string daylightDisplayName, TimeZoneInfo.AdjustmentRule [] adjustmentRules, bool disableDaylightSavingTime)
 532                 {
 533                         return new TimeZoneInfo (id, baseUtcOffset, displayName, standardDisplayName, daylightDisplayName, adjustmentRules, disableDaylightSavingTime);
 534                 }
 535
 536                 public override bool Equals (object obj)
 537                 {
 538                         return Equals (obj as TimeZoneInfo);
 539                 }
 540
 541                 public bool Equals (TimeZoneInfo other)
 542                 {
 543                         if (other == null)
 544                                 return false;
 545
 546                         return other.Id == this.Id && HasSameRules (other);
 547                 }
 548
 549                 public static TimeZoneInfo FindSystemTimeZoneById (string id)
 550                 {
 551                         //FIXME: this method should check for cached values in systemTimeZones
 552                         if (id == null)
 553                                 throw new ArgumentNullException ("id");
 554 #if WIN_PLATFORM
 555                         if (TimeZoneKey != null)
 556                         {
 557                                 if (id == "Coordinated Universal Time")
 558                                         id = "UTC"; //windows xp exception for "StandardName" property
 559                                 RegistryKey key = TimeZoneKey.OpenSubKey (id, false);
 560                                 if (key == null)
 561                                         throw new TimeZoneNotFoundException ();
 562                                 return FromRegistryKey(id, key);
 563                         } else if (IsWindows) {
 564                                 return FindSystemTimeZoneByIdWinRTFallback (id);
 565                         }
 566 #endif
 567                         // Local requires special logic that already exists in the Local property (bug #326)
 568                         if (id == "Local")
 569                                 return Local;
 570
 571                         return FindSystemTimeZoneByIdCore (id);
 572                 }
 573
 574 #if LIBC
 575                 private static TimeZoneInfo FindSystemTimeZoneByFileName (string id, string filepath)
 576                 {
 577                         FileStream stream = null;
 578                         try {
 579                                 stream = File.OpenRead (filepath);
 580                         } catch (Exception ex) {
 581                                 throw new TimeZoneNotFoundException ("Couldn't read time zone file " + filepath, ex);
 582                         }
 583                         try {
 584                                 return BuildFromStream (id, stream);
 585                         } finally {
 586                                 if (stream != null)
 587                                         stream.Dispose();
 588                         }
 589                 }
 590 #endif
 591
 592 #if WIN_PLATFORM
 593                 private static TimeZoneInfo FromRegistryKey (string id, RegistryKey key)
 594                 {
 595                         byte [] reg_tzi = (byte []) key.GetValue ("TZI");
 596
 597                         if (reg_tzi == null)
 598                                 throw new InvalidTimeZoneException ();
 599
 600                         int bias = BitConverter.ToInt32 (reg_tzi, 0);
 601                         TimeSpan baseUtcOffset = new TimeSpan (0, -bias, 0);
 602
 603                         string display_name = (string) key.GetValue ("Display");
 604                         string standard_name = (string) key.GetValue ("Std");
 605                         string daylight_name = (string) key.GetValue ("Dlt");
 606
 607                         List<AdjustmentRule> adjustmentRules = new List<AdjustmentRule> ();
 608
 609                         RegistryKey dst_key = key.OpenSubKey ("Dynamic DST", false);
 610                         if (dst_key != null) {
 611                                 int first_year = (int) dst_key.GetValue ("FirstEntry");
 612                                 int last_year = (int) dst_key.GetValue ("LastEntry");
 613                                 int year;
 614
 615                                 for (year=first_year; year<=last_year; year++) {
 616                                         byte [] dst_tzi = (byte []) dst_key.GetValue (year.ToString ());
 617                                         if (dst_tzi != null) {
 618                                                 int start_year = year == first_year ? 1 : year;
 619                                                 int end_year = year == last_year ? 9999 : year;
 620                                                 ParseRegTzi(adjustmentRules, start_year, end_year, dst_tzi);
 621                                         }
 622                                 }
 623                         }
 624                         else
 625                                 ParseRegTzi(adjustmentRules, 1, 9999, reg_tzi);
 626
 627                         return CreateCustomTimeZone (id, baseUtcOffset, display_name, standard_name, daylight_name, ValidateRules (adjustmentRules));
 628                 }
 629
 630                 private static void ParseRegTzi (List<AdjustmentRule> adjustmentRules, int start_year, int end_year, byte [] buffer)
 631                 {
 632                         //int standard_bias = BitConverter.ToInt32 (buffer, 4); /* not sure how to handle this */
 633                         int daylight_bias = BitConverter.ToInt32 (buffer, 8);
 634
 635                         int standard_year = BitConverter.ToInt16 (buffer, 12);
 636                         int standard_month = BitConverter.ToInt16 (buffer, 14);
 637                         int standard_dayofweek = BitConverter.ToInt16 (buffer, 16);
 638                         int standard_day = BitConverter.ToInt16 (buffer, 18);
 639                         int standard_hour = BitConverter.ToInt16 (buffer, 20);
 640                         int standard_minute = BitConverter.ToInt16 (buffer, 22);
 641                         int standard_second = BitConverter.ToInt16 (buffer, 24);
 642                         int standard_millisecond = BitConverter.ToInt16 (buffer, 26);
 643
 644                         int daylight_year = BitConverter.ToInt16 (buffer, 28);
 645                         int daylight_month = BitConverter.ToInt16 (buffer, 30);
 646                         int daylight_dayofweek = BitConverter.ToInt16 (buffer, 32);
 647                         int daylight_day = BitConverter.ToInt16 (buffer, 34);
 648                         int daylight_hour = BitConverter.ToInt16 (buffer, 36);
 649                         int daylight_minute = BitConverter.ToInt16 (buffer, 38);
 650                         int daylight_second = BitConverter.ToInt16 (buffer, 40);
 651                         int daylight_millisecond = BitConverter.ToInt16 (buffer, 42);
 652
 653                         if (standard_month == 0 || daylight_month == 0)
 654                                 return;
 655
 656                         DateTime start_date;
 657                         DateTime start_timeofday = new DateTime (1, 1, 1, daylight_hour, daylight_minute, daylight_second, daylight_millisecond);
 658                         TransitionTime start_transition_time;
 659
 660                         if (daylight_year == 0) {
 661                                 start_date = new DateTime (start_year, 1, 1);
 662                                 start_transition_time = TransitionTime.CreateFloatingDateRule (
 663                                         start_timeofday, daylight_month, daylight_day,
 664                                         (DayOfWeek) daylight_dayofweek);
 665                         }
 666                         else {
 667                                 start_date = new DateTime (daylight_year, daylight_month, daylight_day,
 668                                         daylight_hour, daylight_minute, daylight_second, daylight_millisecond);
 669                                 start_transition_time = TransitionTime.CreateFixedDateRule (
 670                                         start_timeofday, daylight_month, daylight_day);
 671                         }
 672
 673                         DateTime end_date;
 674                         DateTime end_timeofday = new DateTime (1, 1, 1, standard_hour, standard_minute, standard_second, standard_millisecond);
 675                         TransitionTime end_transition_time;
 676
 677                         if (standard_year == 0) {
 678                                 end_date = new DateTime (end_year, 12, 31);
 679                                 end_transition_time = TransitionTime.CreateFloatingDateRule (
 680                                         end_timeofday, standard_month, standard_day,
 681                                         (DayOfWeek) standard_dayofweek);
 682                         }
 683                         else {
 684                                 end_date = new DateTime (standard_year, standard_month, standard_day,
 685                                         standard_hour, standard_minute, standard_second, standard_millisecond);
 686                                 end_transition_time = TransitionTime.CreateFixedDateRule (
 687                                         end_timeofday, standard_month, standard_day);
 688                         }
 689
 690                         TimeSpan daylight_delta = new TimeSpan(0, -daylight_bias, 0);
 691
 692                         adjustmentRules.Add (AdjustmentRule.CreateAdjustmentRule (
 693                                 start_date, end_date, daylight_delta,
 694                                 start_transition_time, end_transition_time));
 695                 }
 696 #endif
 697
 698                 public AdjustmentRule [] GetAdjustmentRules ()
 699                 {
 700                         if (!supportsDaylightSavingTime || adjustmentRules == null)
 701                                 return new AdjustmentRule [0];
 702                         else
 703                                 return (AdjustmentRule []) adjustmentRules.Clone ();
 704                 }
 705
 706                 public TimeSpan [] GetAmbiguousTimeOffsets (DateTime dateTime)
 707                 {
 708                         if (!IsAmbiguousTime (dateTime))
 709                                 throw new ArgumentException ("dateTime is not an ambiguous time");
 710
 711                         AdjustmentRule rule = GetApplicableRule (dateTime);
 712                         if (rule != null)
 713                                 return new TimeSpan[] {baseUtcOffset, baseUtcOffset + rule.DaylightDelta};
 714                         else
 715                                 return new TimeSpan[] {baseUtcOffset, baseUtcOffset};
 716                 }
 717
 718                 public TimeSpan [] GetAmbiguousTimeOffsets (DateTimeOffset dateTimeOffset)
 719                 {
 720                         if (!IsAmbiguousTime (dateTimeOffset))
 721                                 throw new ArgumentException ("dateTimeOffset is not an ambiguous time");
 722
 723                         throw new NotImplementedException ();
 724                 }
 725
 726                 public override int GetHashCode ()
 727                 {
 728                         int hash_code = Id.GetHashCode ();
 729                         foreach (AdjustmentRule rule in GetAdjustmentRules ())
 730                                 hash_code ^= rule.GetHashCode ();
 731                         return hash_code;
 732                 }
 733
 734                 void ISerializable.GetObjectData (SerializationInfo info, StreamingContext context)
 735                 {
 736                         if (info == null)
 737                                 throw new ArgumentNullException ("info");
 738                         info.AddValue ("Id", id);
 739                         info.AddValue ("DisplayName", displayName);
 740                         info.AddValue ("StandardName", standardDisplayName);
 741                         info.AddValue ("DaylightName", daylightDisplayName);
 742                         info.AddValue ("BaseUtcOffset", baseUtcOffset);
 743                         info.AddValue ("AdjustmentRules", adjustmentRules);
 744                         info.AddValue ("SupportsDaylightSavingTime", SupportsDaylightSavingTime);
 745                 }
 746
 747                 static ReadOnlyCollection<TimeZoneInfo> systemTimeZones;
 748
 749                 public static ReadOnlyCollection<TimeZoneInfo> GetSystemTimeZones ()
 750                 {
 751                         if (systemTimeZones == null) {
 752                                 var tz = new List<TimeZoneInfo> ();
 753                                 GetSystemTimeZonesCore (tz);
 754                                 Interlocked.CompareExchange (ref systemTimeZones, new ReadOnlyCollection<TimeZoneInfo> (tz), null);
 755                         }
 756
 757                         return systemTimeZones;
 758                 }
 759
 760                 public TimeSpan GetUtcOffset (DateTime dateTime)
 761                 {
 762                         bool isDST;
 763                         return GetUtcOffset (dateTime, out isDST);
 764                 }
 765
 766                 public TimeSpan GetUtcOffset (DateTimeOffset dateTimeOffset)
 767                 {
 768                         bool isDST;
 769                         return GetUtcOffset (dateTimeOffset.UtcDateTime, out isDST);
 770                 }
 771
 772                 private TimeSpan GetUtcOffset (DateTime dateTime, out bool isDST)
 773                 {
 774                         isDST = false;
 775
 776                         TimeZoneInfo tz = this;
 777                         if (dateTime.Kind == DateTimeKind.Utc)
 778                                 tz = TimeZoneInfo.Utc;
 779
 780                         if (dateTime.Kind == DateTimeKind.Local)
 781                                 tz = TimeZoneInfo.Local;
 782
 783                         bool isTzDst;
 784                         var tzOffset = GetUtcOffsetHelper (dateTime, tz, out isTzDst);
 785
 786                         if (tz == this) {
 787                                 isDST = isTzDst;
 788                                 return tzOffset;
 789                         }
 790
 791                         DateTime utcDateTime;
 792                         if (!TryAddTicks (dateTime, -tzOffset.Ticks, out utcDateTime, DateTimeKind.Utc))
 793                                 return BaseUtcOffset;
 794
 795                         return GetUtcOffsetHelper (utcDateTime, this, out isDST);
 796                 }
 797
 798                 // This is an helper method used by the method above, do not use this on its own.
 799                 private static TimeSpan GetUtcOffsetHelper (DateTime dateTime, TimeZoneInfo tz, out bool isDST)
 800                 {
 801                         if (dateTime.Kind == DateTimeKind.Local && tz != TimeZoneInfo.Local)
 802                                 throw new Exception ();
 803
 804                         isDST = false;
 805
 806                         if (tz == TimeZoneInfo.Utc)
 807                                 return TimeSpan.Zero;
 808
 809                         TimeSpan offset;
 810                         if (tz.TryGetTransitionOffset(dateTime, out offset, out isDST))
 811                                 return offset;
 812
 813                         if (dateTime.Kind == DateTimeKind.Utc) {
 814                                 var utcRule = tz.GetApplicableRule (dateTime);
 815                                 if (utcRule != null && tz.IsInDST (utcRule, dateTime)) {
 816                                         isDST = true;
 817                                         return tz.BaseUtcOffset + utcRule.DaylightDelta;
 818                                 }
 819
 820                                 return tz.BaseUtcOffset;
 821                         }
 822
 823                         DateTime stdUtcDateTime;
 824                         if (!TryAddTicks (dateTime, -tz.BaseUtcOffset.Ticks, out stdUtcDateTime, DateTimeKind.Utc))
 825                                 return tz.BaseUtcOffset;
 826
 827                         var tzRule = tz.GetApplicableRule (stdUtcDateTime);
 828
 829                         DateTime dstUtcDateTime = DateTime.MinValue;
 830                         if (tzRule != null) {
 831                                 if (!TryAddTicks (stdUtcDateTime, -tzRule.DaylightDelta.Ticks, out dstUtcDateTime, DateTimeKind.Utc))
 832                                         return tz.BaseUtcOffset;
 833                         }
 834
 835                         if (tzRule != null && tz.IsInDST (tzRule, dateTime)) {
 836                                 // Replicate what .NET does when given a time which falls into the hour which is lost when
 837                                 // DST starts. isDST should always be true but the offset should be BaseUtcOffset without the
 838                                 // DST delta while in that hour.
 839                                 isDST = true;
 840                                 if (tz.IsInDST (tzRule, dstUtcDateTime)) {
 841                                         return tz.BaseUtcOffset + tzRule.DaylightDelta;
 842                                 } else {
 843                                         return tz.BaseUtcOffset;
 844                                 }
 845                         }
 846
 847                         return tz.BaseUtcOffset;
 848                 }
 849
 850                 public bool HasSameRules (TimeZoneInfo other)
 851                 {
 852                         if (other == null)
 853                                 throw new ArgumentNullException ("other");
 854
 855                         if ((this.adjustmentRules == null) != (other.adjustmentRules == null))
 856                                 return false;
 857
 858                         if (this.adjustmentRules == null)
 859                                 return true;
 860
 861                         if (this.BaseUtcOffset != other.BaseUtcOffset)
 862                                 return false;
 863
 864                         if (this.adjustmentRules.Length != other.adjustmentRules.Length)
 865                                 return false;
 866
 867                         for (int i = 0; i < adjustmentRules.Length; i++) {
 868                                 if (! (this.adjustmentRules [i]).Equals (other.adjustmentRules [i]))
 869                                         return false;
 870                         }
 871
 872                         return true;
 873                 }
 874
 875                 public bool IsAmbiguousTime (DateTime dateTime)
 876                 {
 877                         if (dateTime.Kind == DateTimeKind.Local && IsInvalidTime (dateTime))
 878                                 throw new ArgumentException ("Kind is Local and time is Invalid");
 879
 880                         if (this == TimeZoneInfo.Utc)
 881                                 return false;
 882
 883                         if (dateTime.Kind == DateTimeKind.Utc)
 884                                 dateTime = ConvertTimeFromUtc (dateTime);
 885
 886                         if (dateTime.Kind == DateTimeKind.Local && this != TimeZoneInfo.Local)
 887                                 dateTime = ConvertTime (dateTime, TimeZoneInfo.Local, this);
 888
 889                         AdjustmentRule rule = GetApplicableRule (dateTime);
 890                         if (rule != null) {
 891                                 DateTime tpoint = TransitionPoint (rule.DaylightTransitionEnd, dateTime.Year);
 892                                 if (dateTime > tpoint - rule.DaylightDelta && dateTime <= tpoint)
 893                                         return true;
 894                         }
 895
 896                         return false;
 897                 }
 898
 899                 public bool IsAmbiguousTime (DateTimeOffset dateTimeOffset)
 900                 {
 901                         throw new NotImplementedException ();
 902                 }
 903
 904                 private bool IsInDST (AdjustmentRule rule, DateTime dateTime)
 905                 {
 906                         // Check whether we're in the dateTime year's DST period
 907                         if (IsInDSTForYear (rule, dateTime, dateTime.Year))
 908                                 return true;
 909
 910                         // We might be in the dateTime previous year's DST period
 911                         return dateTime.Year > 1 && IsInDSTForYear (rule, dateTime, dateTime.Year - 1);
 912                 }
 913
 914                 bool IsInDSTForYear (AdjustmentRule rule, DateTime dateTime, int year)
 915                 {
 916                         DateTime DST_start = TransitionPoint (rule.DaylightTransitionStart, year);
 917                         DateTime DST_end = TransitionPoint (rule.DaylightTransitionEnd, year + ((rule.DaylightTransitionStart.Month < rule.DaylightTransitionEnd.Month) ? 0 : 1));
 918                         if (dateTime.Kind == DateTimeKind.Utc) {
 919                                 DST_start -= BaseUtcOffset;
 920                                 DST_end -= (BaseUtcOffset + rule.DaylightDelta);
 921                         }
 922                         return (dateTime >= DST_start && dateTime < DST_end);
 923                 }
 924
 925                 public bool IsDaylightSavingTime (DateTime dateTime)
 926                 {
 927                         if (dateTime.Kind == DateTimeKind.Local && IsInvalidTime (dateTime))
 928                                 throw new ArgumentException ("dateTime is invalid and Kind is Local");
 929
 930                         if (this == TimeZoneInfo.Utc)
 931                                 return false;
 932
 933                         if (!SupportsDaylightSavingTime)
 934                                 return false;
 935
 936                         bool isDst;
 937                         GetUtcOffset (dateTime, out isDst);
 938
 939                         return isDst;
 940                 }
 941
 942                 internal bool IsDaylightSavingTime (DateTime dateTime, TimeZoneInfoOptions flags)
 943                 {
 944                         return IsDaylightSavingTime (dateTime);
 945                 }
 946
 947                 public bool IsDaylightSavingTime (DateTimeOffset dateTimeOffset)
 948                 {
 949                         return IsDaylightSavingTime (dateTimeOffset.DateTime);
 950                 }
 951
 952                 internal DaylightTime GetDaylightChanges (int year)
 953                 {
 954                         DateTime start = DateTime.MinValue, end = DateTime.MinValue;
 955                         TimeSpan delta = new TimeSpan ();
 956
 957                         if (transitions != null) {
 958                                 end = DateTime.MaxValue;
 959                                 for (var i =  transitions.Count - 1; i >= 0; i--) {
 960                                         var pair = transitions [i];
 961                                         DateTime ttime = pair.Key;
 962                                         TimeType ttype = pair.Value;
 963
 964                                         if (ttime.Year > year)
 965                                                 continue;
 966                                         if (ttime.Year < year)
 967                                                 break;
 968
 969                                         if (ttype.IsDst) {
 970                                                 // DaylightTime.Delta is relative to the current BaseUtcOffset.
 971                                                 delta =  new TimeSpan (0, 0, ttype.Offset) - BaseUtcOffset;
 972                                                 start = ttime;
 973                                         } else {
 974                                                 end = ttime;
 975                                         }
 976                                 }
 977
 978                                 // DaylightTime.Start is relative to the Standard time.
 979                                 if (!TryAddTicks (start, BaseUtcOffset.Ticks, out start))
 980                                         start = DateTime.MinValue;
 981
 982                                 // DaylightTime.End is relative to the DST time.
 983                                 if (!TryAddTicks (end, BaseUtcOffset.Ticks + delta.Ticks, out end))
 984                                         end = DateTime.MinValue;
 985                         } else {
 986                                 AdjustmentRule first = null, last = null;
 987
 988                                 // Rule start/end dates are either very specific or very broad depending on the platform
 989                                 //   2015-10-04..2016-04-03 - Rule for a time zone in southern hemisphere on non-Windows platforms
 990                                 //   2016-03-27..2016-10-03 - Rule for a time zone in northern hemisphere on non-Windows platforms
 991                                 //   0001-01-01..9999-12-31 - Rule for a time zone on Windows
 992
 993                                 foreach (var rule in GetAdjustmentRules ()) {
 994                                         if (rule.DateStart.Year > year || rule.DateEnd.Year < year)
 995                                                 continue;
 996                                         if (rule.DateStart.Year <= year && (first == null || rule.DateStart.Year > first.DateStart.Year))
 997                                                 first = rule;
 998                                         if (rule.DateEnd.Year >= year && (last == null || rule.DateEnd.Year < last.DateEnd.Year))
 999                                                 last = rule;
1000                                 }
1001
1002                                 if (first == null || last == null)
1003                                         return new DaylightTime (new DateTime (), new DateTime (), new TimeSpan ());
1004
1005                                 start = TransitionPoint (first.DaylightTransitionStart, year);
1006                                 end = TransitionPoint (last.DaylightTransitionEnd, year);
1007                                 delta = first.DaylightDelta;
1008                         }
1009
1010                         if (start == DateTime.MinValue || end == DateTime.MinValue)
1011                                 return new DaylightTime (new DateTime (), new DateTime (), new TimeSpan ());
1012
1013                         return new DaylightTime (start, end, delta);
1014                 }
1015
1016                 public bool IsInvalidTime (DateTime dateTime)
1017                 {
1018                         if (dateTime.Kind == DateTimeKind.Utc)
1019                                 return false;
1020                         if (dateTime.Kind == DateTimeKind.Local && this != Local)
1021                                 return false;
1022
1023                         AdjustmentRule rule = GetApplicableRule (dateTime);
1024                         if (rule != null) {
1025                                 DateTime tpoint = TransitionPoint (rule.DaylightTransitionStart, dateTime.Year);
1026                                 if (dateTime >= tpoint && dateTime < tpoint + rule.DaylightDelta)
1027                                         return true;
1028                         }
1029
1030                         return false;
1031                 }
1032
1033                 void IDeserializationCallback.OnDeserialization (object sender)
1034                 {
1035                         try {
1036                                         TimeZoneInfo.Validate (id, baseUtcOffset, adjustmentRules);
1037                                 } catch (ArgumentException ex) {
1038                                         throw new SerializationException ("invalid serialization data", ex);
1039                                 }
1040                 }
1041
1042                 private static void Validate (string id, TimeSpan baseUtcOffset, AdjustmentRule [] adjustmentRules)
1043                 {
1044                         if (id == null)
1045                                 throw new ArgumentNullException ("id");
1046
1047                         if (id == String.Empty)
1048                                 throw new ArgumentException ("id parameter is an empty string");
1049
1050                         if (baseUtcOffset.Ticks % TimeSpan.TicksPerMinute != 0)
1051                                 throw new ArgumentException ("baseUtcOffset parameter does not represent a whole number of minutes");
1052
1053                         if (baseUtcOffset > new TimeSpan (14, 0, 0) || baseUtcOffset < new TimeSpan (-14, 0, 0))
1054                                 throw new ArgumentOutOfRangeException ("baseUtcOffset parameter is greater than 14 hours or less than -14 hours");
1055
1056 #if STRICT
1057                         if (id.Length > 32)
1058                                 throw new ArgumentException ("id parameter shouldn't be longer than 32 characters");
1059 #endif
1060
1061                         if (adjustmentRules != null && adjustmentRules.Length != 0) {
1062                                 AdjustmentRule prev = null;
1063                                 foreach (AdjustmentRule current in adjustmentRules) {
1064                                         if (current == null)
1065                                                 throw new InvalidTimeZoneException ("one or more elements in adjustmentRules are null");
1066
1067                                         if ((baseUtcOffset + current.DaylightDelta < new TimeSpan (-14, 0, 0)) ||
1068                                                         (baseUtcOffset + current.DaylightDelta > new TimeSpan (14, 0, 0)))
1069                                                 throw new InvalidTimeZoneException ("Sum of baseUtcOffset and DaylightDelta of one or more object in adjustmentRules array is greater than 14 or less than -14 hours;");
1070
1071                                         if (prev != null && prev.DateStart > current.DateStart)
1072                                                 throw new InvalidTimeZoneException ("adjustment rules specified in adjustmentRules parameter are not in chronological order");
1073
1074                                         if (prev != null && prev.DateEnd > current.DateStart)
1075                                                 throw new InvalidTimeZoneException ("some adjustment rules in the adjustmentRules parameter overlap");
1076
1077                                         if (prev != null && prev.DateEnd == current.DateStart)
1078                                                 throw new InvalidTimeZoneException ("a date can have multiple adjustment rules applied to it");
1079
1080                                         prev = current;
1081                                 }
1082                         }
1083                 }
1084
1085                 public override string ToString ()
1086                 {
1087                         return DisplayName;
1088                 }
1089
1090                 private TimeZoneInfo (SerializationInfo info, StreamingContext context)
1091                 {
1092                         if (info == null)
1093                                 throw new ArgumentNullException ("info");
1094                         id = (string) info.GetValue ("Id", typeof (string));
1095                         displayName = (string) info.GetValue ("DisplayName", typeof (string));
1096                         standardDisplayName = (string) info.GetValue ("StandardName", typeof (string));
1097                         daylightDisplayName = (string) info.GetValue ("DaylightName", typeof (string));
1098                         baseUtcOffset = (TimeSpan) info.GetValue ("BaseUtcOffset", typeof (TimeSpan));
1099                         adjustmentRules = (TimeZoneInfo.AdjustmentRule []) info.GetValue ("AdjustmentRules", typeof (TimeZoneInfo.AdjustmentRule []));
1100                         supportsDaylightSavingTime = (bool) info.GetValue ("SupportsDaylightSavingTime", typeof (bool));
1101                 }
1102
1103                 private TimeZoneInfo (string id, TimeSpan baseUtcOffset, string displayName, string standardDisplayName, string daylightDisplayName, TimeZoneInfo.AdjustmentRule [] adjustmentRules, bool disableDaylightSavingTime)
1104                 {
1105                         if (id == null)
1106                                 throw new ArgumentNullException ("id");
1107
1108                         if (id == String.Empty)
1109                                 throw new ArgumentException ("id parameter is an empty string");
1110
1111                         if (baseUtcOffset.Ticks % TimeSpan.TicksPerMinute != 0)
1112                                 throw new ArgumentException ("baseUtcOffset parameter does not represent a whole number of minutes");
1113
1114                         if (baseUtcOffset > new TimeSpan (14, 0, 0) || baseUtcOffset < new TimeSpan (-14, 0, 0))
1115                                 throw new ArgumentOutOfRangeException ("baseUtcOffset parameter is greater than 14 hours or less than -14 hours");
1116
1117 #if STRICT
1118                         if (id.Length > 32)
1119                                 throw new ArgumentException ("id parameter shouldn't be longer than 32 characters");
1120 #endif
1121
1122                         bool supportsDaylightSavingTime = !disableDaylightSavingTime;
1123
1124                         if (adjustmentRules != null && adjustmentRules.Length != 0) {
1125                                 AdjustmentRule prev = null;
1126                                 foreach (AdjustmentRule current in adjustmentRules) {
1127                                         if (current == null)
1128                                                 throw new InvalidTimeZoneException ("one or more elements in adjustmentRules are null");
1129
1130                                         if ((baseUtcOffset + current.DaylightDelta < new TimeSpan (-14, 0, 0)) ||
1131                                                         (baseUtcOffset + current.DaylightDelta > new TimeSpan (14, 0, 0)))
1132                                                 throw new InvalidTimeZoneException ("Sum of baseUtcOffset and DaylightDelta of one or more object in adjustmentRules array is greater than 14 or less than -14 hours;");
1133
1134                                         if (prev != null && prev.DateStart > current.DateStart)
1135                                                 throw new InvalidTimeZoneException ("adjustment rules specified in adjustmentRules parameter are not in chronological order");
1136
1137                                         if (prev != null && prev.DateEnd > current.DateStart)
1138                                                 throw new InvalidTimeZoneException ("some adjustment rules in the adjustmentRules parameter overlap");
1139
1140                                         if (prev != null && prev.DateEnd == current.DateStart)
1141                                                 throw new InvalidTimeZoneException ("a date can have multiple adjustment rules applied to it");
1142
1143                                         prev = current;
1144                                 }
1145                         } else {
1146                                 supportsDaylightSavingTime = false;
1147                         }
1148
1149                         this.id = id;
1150                         this.baseUtcOffset = baseUtcOffset;
1151                         this.displayName = displayName ?? id;
1152                         this.standardDisplayName = standardDisplayName ?? id;
1153                         this.daylightDisplayName = daylightDisplayName;
1154                         this.supportsDaylightSavingTime = supportsDaylightSavingTime;
1155                         this.adjustmentRules = adjustmentRules;
1156                 }
1157
1158                 private AdjustmentRule GetApplicableRule (DateTime dateTime)
1159                 {
1160                         //Applicable rules are in standard time
1161                         DateTime date = dateTime;
1162
1163                         if (dateTime.Kind == DateTimeKind.Local && this != TimeZoneInfo.Local) {
1164                                 if (!TryAddTicks (date.ToUniversalTime (), BaseUtcOffset.Ticks, out date))
1165                                         return null;
1166                         } else if (dateTime.Kind == DateTimeKind.Utc && this != TimeZoneInfo.Utc) {
1167                                 if (!TryAddTicks (date, BaseUtcOffset.Ticks, out date))
1168                                         return null;
1169                         }
1170
1171                         // get the date component of the datetime
1172                         date = date.Date;
1173
1174                         if (adjustmentRules != null) {
1175                                 foreach (AdjustmentRule rule in adjustmentRules) {
1176                                         if (rule.DateStart > date)
1177                                                 return null;
1178                                         if (rule.DateEnd < date)
1179                                                 continue;
1180                                         return rule;
1181                                 }
1182                         }
1183                         return null;
1184                 }
1185
1186                 private bool TryGetTransitionOffset (DateTime dateTime, out TimeSpan offset,out bool isDst)
1187                 {
1188                         offset = BaseUtcOffset;
1189                         isDst = false;
1190
1191                         if (transitions == null)
1192                                 return false;
1193
1194                         //Transitions are in UTC
1195                         DateTime date = dateTime;
1196
1197                         if (dateTime.Kind == DateTimeKind.Local && this != TimeZoneInfo.Local) {
1198                                 if (!TryAddTicks (date.ToUniversalTime (), BaseUtcOffset.Ticks, out date, DateTimeKind.Utc))
1199                                         return false;
1200                         }
1201
1202                         if (dateTime.Kind != DateTimeKind.Utc) {
1203                                 if (!TryAddTicks (date, -BaseUtcOffset.Ticks, out date, DateTimeKind.Utc))
1204                                         return false;
1205                         }
1206
1207                         AdjustmentRule current = GetApplicableRule(date);
1208                         if (current != null) {
1209                                 DateTime tStart = TransitionPoint(current.DaylightTransitionStart, date.Year);
1210                                 DateTime tEnd = TransitionPoint(current.DaylightTransitionEnd, date.Year);
1211                                 if ((date >= tStart) && (date <= tEnd)) {
1212                                         offset = baseUtcOffset + current.DaylightDelta;
1213                                         isDst = true;
1214                                         return true;
1215                                 }
1216                         }
1217                         return false;
1218                 }
1219
1220                 private static DateTime TransitionPoint (TransitionTime transition, int year)
1221                 {
1222                         if (transition.IsFixedDateRule)
1223                                 return new DateTime (year, transition.Month, transition.Day) + transition.TimeOfDay.TimeOfDay;
1224
1225                         DayOfWeek first = (new DateTime (year, transition.Month, 1)).DayOfWeek;
1226                         int day = 1 + (transition.Week - 1) * 7 + (transition.DayOfWeek - first + 7) % 7;
1227                         if (day >  DateTime.DaysInMonth (year, transition.Month))
1228                                 day -= 7;
1229                         if (day < 1)
1230                                 day += 7;
1231                         return new DateTime (year, transition.Month, day) + transition.TimeOfDay.TimeOfDay;
1232                 }
1233
1234                 static AdjustmentRule[] ValidateRules (List<AdjustmentRule> adjustmentRules)
1235                 {
1236                         if (adjustmentRules == null || adjustmentRules.Count == 0)
1237                                 return null;
1238
1239                         AdjustmentRule prev = null;
1240                         foreach (AdjustmentRule current in adjustmentRules.ToArray ()) {
1241                                 if (prev != null && prev.DateEnd > current.DateStart) {
1242                                         adjustmentRules.Remove (current);
1243                                 }
1244                                 prev = current;
1245                         }
1246                         return adjustmentRules.ToArray ();
1247                 }
1248
1249 #if LIBC || MONOTOUCH
1250                 const int BUFFER_SIZE = 16384; //Big enough for any tz file (on Oct 2008, all tz files are under 10k)
1251
1252                 private static TimeZoneInfo BuildFromStream (string id, Stream stream)
1253                 {
1254                         byte [] buffer = new byte [BUFFER_SIZE];
1255                         int length = stream.Read (buffer, 0, BUFFER_SIZE);
1256
1257                         if (!ValidTZFile (buffer, length))
1258                                 throw new InvalidTimeZoneException ("TZ file too big for the buffer");
1259
1260                         try {
1261                                 return ParseTZBuffer (id, buffer, length);
1262                         } catch (InvalidTimeZoneException) {
1263                                 throw;
1264                         } catch (Exception e) {
1265                                 throw new InvalidTimeZoneException ("Time zone information file contains invalid data", e);
1266                         }
1267                 }
1268
1269                 private static bool ValidTZFile (byte [] buffer, int length)
1270                 {
1271                         StringBuilder magic = new StringBuilder ();
1272
1273                         for (int i = 0; i < 4; i++)
1274                                 magic.Append ((char)buffer [i]);
1275
1276                         if (magic.ToString () != "TZif")
1277                                 return false;
1278
1279                         if (length >= BUFFER_SIZE)
1280                                 return false;
1281
1282                         return true;
1283                 }
1284
1285                 static int SwapInt32 (int i)
1286                 {
1287                         return (((i >> 24) & 0xff)
1288                                 | ((i >> 8) & 0xff00)
1289                                 | ((i << 8) & 0xff0000)
1290                                 | (((i & 0xff) << 24)));
1291                 }
1292
1293                 static int ReadBigEndianInt32 (byte [] buffer, int start)
1294                 {
1295                         int i = BitConverter.ToInt32 (buffer, start);
1296                         if (!BitConverter.IsLittleEndian)
1297                                 return i;
1298
1299                         return SwapInt32 (i);
1300                 }
1301
1302                 private static TimeZoneInfo ParseTZBuffer (string id, byte [] buffer, int length)
1303                 {
1304                         //Reading the header. 4 bytes for magic, 16 are reserved
1305                         int ttisgmtcnt = ReadBigEndianInt32 (buffer, 20);
1306                         int ttisstdcnt = ReadBigEndianInt32 (buffer, 24);
1307                         int leapcnt = ReadBigEndianInt32 (buffer, 28);
1308                         int timecnt = ReadBigEndianInt32 (buffer, 32);
1309                         int typecnt = ReadBigEndianInt32 (buffer, 36);
1310                         int charcnt = ReadBigEndianInt32 (buffer, 40);
1311
1312                         if (length < 44 + timecnt * 5 + typecnt * 6 + charcnt + leapcnt * 8 + ttisstdcnt + ttisgmtcnt)
1313                                 throw new InvalidTimeZoneException ();
1314
1315                         Dictionary<int, string> abbreviations = ParseAbbreviations (buffer, 44 + 4 * timecnt + timecnt + 6 * typecnt, charcnt);
1316                         Dictionary<int, TimeType> time_types = ParseTimesTypes (buffer, 44 + 4 * timecnt + timecnt, typecnt, abbreviations);
1317                         List<KeyValuePair<DateTime, TimeType>> transitions = ParseTransitions (buffer, 44, timecnt, time_types);
1318
1319                         if (time_types.Count == 0)
1320                                 throw new InvalidTimeZoneException ();
1321
1322                         if (time_types.Count == 1 && time_types[0].IsDst)
1323                                 throw new InvalidTimeZoneException ();
1324
1325                         TimeSpan baseUtcOffset = new TimeSpan (0);
1326                         TimeSpan dstDelta = new TimeSpan (0);
1327                         string standardDisplayName = null;
1328                         string daylightDisplayName = null;
1329                         bool dst_observed = false;
1330                         DateTime dst_start = DateTime.MinValue;
1331                         List<AdjustmentRule> adjustmentRules = new List<AdjustmentRule> ();
1332                         bool storeTransition = false;
1333
1334                         for (int i = 0; i < transitions.Count; i++) {
1335                                 var pair = transitions [i];
1336                                 DateTime ttime = pair.Key;
1337                                 TimeType ttype = pair.Value;
1338                                 if (!ttype.IsDst) {
1339                                         if (standardDisplayName != ttype.Name)
1340                                                 standardDisplayName = ttype.Name;
1341                                         if (baseUtcOffset.TotalSeconds != ttype.Offset) {
1342                                                 baseUtcOffset = new TimeSpan (0, 0, ttype.Offset);
1343                                                 if (adjustmentRules.Count > 0) // We ignore AdjustmentRules but store transitions.
1344                                                         storeTransition = true;
1345                                                 adjustmentRules = new List<AdjustmentRule> ();
1346                                                 dst_observed = false;
1347                                         }
1348                                         if (dst_observed) {
1349                                                 //FIXME: check additional fields for this:
1350                                                 //most of the transitions are expressed in GMT
1351                                                 dst_start += baseUtcOffset;
1352                                                 DateTime dst_end = ttime + baseUtcOffset + dstDelta;
1353
1354                                                 //some weird timezone (America/Phoenix) have end dates on Jan 1st
1355                                                 if (dst_end.Date == new DateTime (dst_end.Year, 1, 1) && dst_end.Year > dst_start.Year)
1356                                                         dst_end -= new TimeSpan (24, 0, 0);
1357
1358                                                 /*
1359                                                  * AdjustmentRule specifies a DST period that starts and ends within a year.
1360                                                  * When we have a DST period longer than a year, the generated AdjustmentRule may not be usable.
1361                                                  * Thus we fallback to the transitions.
1362                                                  */
1363                                                 if (dst_start.AddYears (1) < dst_end)
1364                                                         storeTransition = true;
1365
1366                                                 DateTime dateStart, dateEnd;
1367                                                 if (dst_start.Month < 7)
1368                                                         dateStart = new DateTime (dst_start.Year, 1, 1);
1369                                                 else
1370                                                         dateStart = new DateTime (dst_start.Year, 7, 1);
1371
1372                                                 if (dst_end.Month >= 7)
1373                                                         dateEnd = new DateTime (dst_end.Year, 12, 31);
1374                                                 else
1375                                                         dateEnd = new DateTime (dst_end.Year, 6, 30);
1376
1377
1378                                                 TransitionTime transition_start = TransitionTime.CreateFixedDateRule (new DateTime (1, 1, 1) + dst_start.TimeOfDay, dst_start.Month, dst_start.Day);
1379                                                 TransitionTime transition_end = TransitionTime.CreateFixedDateRule (new DateTime (1, 1, 1) + dst_end.TimeOfDay, dst_end.Month, dst_end.Day);
1380                                                 if  (transition_start != transition_end) //y, that happened in Argentina in 1943-1946
1381                                                         adjustmentRules.Add (AdjustmentRule.CreateAdjustmentRule (dateStart, dateEnd, dstDelta, transition_start, transition_end));
1382                                         }
1383                                         dst_observed = false;
1384                                 } else {
1385                                         if (daylightDisplayName != ttype.Name)
1386                                                 daylightDisplayName = ttype.Name;
1387                                         if (dstDelta.TotalSeconds != ttype.Offset - baseUtcOffset.TotalSeconds) {
1388                                                 // Round to nearest minute, since it's not possible to create an adjustment rule
1389                                                 // with sub-minute precision ("The TimeSpan parameter cannot be specified more precisely than whole minutes.")
1390                                                 // This happens for instance with Europe/Dublin, which had an offset of 34 minutes and 39 seconds in 1916.
1391                                                 dstDelta = new TimeSpan (0, 0, ttype.Offset) - baseUtcOffset;
1392                                                 if (dstDelta.Ticks % TimeSpan.TicksPerMinute != 0)
1393                                                         dstDelta = TimeSpan.FromMinutes ((long) (dstDelta.TotalMinutes + 0.5f));
1394                                         }
1395
1396                                         dst_start = ttime;
1397                                         dst_observed = true;
1398                                 }
1399                         }
1400
1401                         TimeZoneInfo tz;
1402                         if (adjustmentRules.Count == 0 && !storeTransition) {
1403                                 if (standardDisplayName == null) {
1404                                         var t = time_types [0];
1405                                         standardDisplayName = t.Name;
1406                                         baseUtcOffset = new TimeSpan (0, 0, t.Offset);
1407                                 }
1408                                 tz = CreateCustomTimeZone (id, baseUtcOffset, id, standardDisplayName);
1409                         } else {
1410                                 tz = CreateCustomTimeZone (id, baseUtcOffset, id, standardDisplayName, daylightDisplayName, ValidateRules (adjustmentRules));
1411                         }
1412
1413                         if (storeTransition && transitions.Count > 0) {
1414                                 tz.transitions = transitions;
1415                         }
1416                         tz.supportsDaylightSavingTime = adjustmentRules.Count > 0;
1417
1418                         return tz;
1419                 }
1420
1421                 static Dictionary<int, string> ParseAbbreviations (byte [] buffer, int index, int count)
1422                 {
1423                         var abbrevs = new Dictionary<int, string> ();
1424                         int abbrev_index = 0;
1425                         var sb = new StringBuilder ();
1426                         for (int i = 0; i < count; i++) {
1427                                 char c = (char) buffer [index + i];
1428                                 if (c != '\0')
1429                                         sb.Append (c);
1430                                 else {
1431                                         abbrevs.Add (abbrev_index, sb.ToString ());
1432                                         //Adding all the substrings too, as it seems to be used, at least for Africa/Windhoek
1433                                         //j == sb.Length empty substring also needs to be added #31432
1434                                         for (int j = 1; j <= sb.Length; j++)
1435                                                 abbrevs.Add (abbrev_index + j, sb.ToString (j, sb.Length - j));
1436                                         abbrev_index = i + 1;
1437                                         sb = new StringBuilder ();
1438                                 }
1439                         }
1440                         return abbrevs;
1441                 }
1442
1443                 static Dictionary<int, TimeType> ParseTimesTypes (byte [] buffer, int index, int count, Dictionary<int, string> abbreviations)
1444                 {
1445                         var types = new Dictionary<int, TimeType> (count);
1446                         for (int i = 0; i < count; i++) {
1447                                 int offset = ReadBigEndianInt32 (buffer, index + 6 * i);
1448
1449                                 //
1450                                 // The official tz database contains timezone with GMT offsets
1451                                 // not only in whole hours/minutes but in seconds. This happens for years
1452                                 // before 1901. For example
1453                                 //
1454                                 // NAME                 GMTOFF   RULES  FORMAT  UNTIL
1455                                 // Europe/Madrid        -0:14:44 -      LMT     1901 Jan  1  0:00s
1456                                 //
1457                                 // .NET as of 4.6.2 cannot handle that and uses hours/minutes only, so
1458                                 // we remove seconds to not crash later
1459                                 //
1460                                 offset = (offset / 60) * 60;
1461
1462                                 byte is_dst = buffer [index + 6 * i + 4];
1463                                 byte abbrev = buffer [index + 6 * i + 5];
1464                                 types.Add (i, new TimeType (offset, (is_dst != 0), abbreviations [(int)abbrev]));
1465                         }
1466                         return types;
1467                 }
1468
1469                 static List<KeyValuePair<DateTime, TimeType>> ParseTransitions (byte [] buffer, int index, int count, Dictionary<int, TimeType> time_types)
1470                 {
1471                         var list = new List<KeyValuePair<DateTime, TimeType>> (count);
1472                         for (int i = 0; i < count; i++) {
1473                                 int unixtime = ReadBigEndianInt32 (buffer, index + 4 * i);
1474                                 DateTime ttime = DateTimeFromUnixTime (unixtime);
1475                                 byte ttype = buffer [index + 4 * count + i];
1476                                 list.Add (new KeyValuePair<DateTime, TimeType> (ttime, time_types [(int)ttype]));
1477                         }
1478                         return list;
1479                 }
1480
1481                 static DateTime DateTimeFromUnixTime (long unix_time)
1482                 {
1483                         DateTime date_time = new DateTime (1970, 1, 1);
1484                         return date_time.AddSeconds (unix_time);
1485                 }
1486
1487 #region reference sources
1488                 // Shortcut for TimeZoneInfo.Local.GetUtcOffset
1489                 internal static TimeSpan GetLocalUtcOffset(DateTime dateTime, TimeZoneInfoOptions flags)
1490                 {
1491                         bool dst;
1492                         return Local.GetUtcOffset (dateTime, out dst);
1493                 }
1494
1495                 internal TimeSpan GetUtcOffset(DateTime dateTime, TimeZoneInfoOptions flags)
1496                 {
1497                         bool dst;
1498                         return GetUtcOffset (dateTime, out dst);
1499                 }
1500
1501                 static internal TimeSpan GetUtcOffsetFromUtc (DateTime time, TimeZoneInfo zone, out Boolean isDaylightSavings, out Boolean isAmbiguousLocalDst)
1502                 {
1503                         isDaylightSavings = false;
1504                         isAmbiguousLocalDst = false;
1505                         TimeSpan baseOffset = zone.BaseUtcOffset;
1506
1507                         if (zone.IsAmbiguousTime (time)) {
1508                                 isAmbiguousLocalDst = true;
1509 //                              return baseOffset;
1510                         }
1511
1512                         return zone.GetUtcOffset (time, out isDaylightSavings);
1513                 }
1514 #endregion
1515         }
1516
1517         class TimeType {
1518                 public readonly int Offset;
1519                 public readonly bool IsDst;
1520                 public string Name;
1521
1522                 public TimeType (int offset, bool is_dst, string abbrev)
1523                 {
1524                         this.Offset = offset;
1525                         this.IsDst = is_dst;
1526                         this.Name = abbrev;
1527                 }
1528
1529                 public override string ToString ()
1530                 {
1531                         return "offset: " + Offset + "s, is_dst: " + IsDst + ", zone name: " + Name;
1532                 }
1533 #else
1534         }
1535 #endif
1536         }
1537 }