closure 1.2.701 → 1.3.0

data/closure-library/closure/goog/i18n/timezone.js

@@ -1,341 +0,0 @@
-// Copyright 2008 The Closure Library Authors. All Rights Reserved.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//      http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS-IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-/**
- * @fileoverview Functions to provide timezone information for use with
- * date/time format.
- */
-
-goog.provide('goog.i18n.TimeZone');
-
-goog.require('goog.array');
-goog.require('goog.date.DateLike');
-goog.require('goog.string');
-
-
-
-/**
- * TimeZone class implemented a time zone resolution and name information
- * source for client applications. The time zone object is initiated from
- * a time zone information object. Application can initiate a time zone
- * statically, or it may choose to initiate from a data obtained from server.
- * Each time zone information array is small, but the whole set of data
- * is too much for client application to download. If end user is allowed to
- * change time zone setting, dynamic retrieval should be the method to use.
- * In case only time zone offset is known, there is a decent fallback
- * that only use the time zone offset to create a TimeZone object.
- * A whole set of time zone information array was available under
- * http://go/js_locale_data. It is generated based on CLDR and
- * Olson time zone data base (through pytz), and will be updated timely.
- *
- * @constructor
- */
-goog.i18n.TimeZone = function() {
-  /**
-   * The standard time zone id.
-   * @type {string}
-   * @private
-   */
-  this.timeZoneId_;
-
-
-  /**
-   * The standard, non-daylight time zone offset, in minutes WEST of UTC.
-   * @type {number}
-   * @private
-   */
-  this.standardOffset_;
-
-
-  /**
-   * An array of strings that can have 2 or 4 elements.  The first two elements
-   * are the long and short names for standard time in this time zone, and the
-   * last two elements (if present) are the long and short names for daylight
-   * time in this time zone.
-   * @type {Array.<string>}
-   * @private
-   */
-  this.tzNames_;
-
-
-  /**
-   * This array specifies the Daylight Saving Time transitions for this time
-   * zone.  This is a flat array of numbers which are interpreted in pairs:
-   * [time1, adjustment1, time2, adjustment2, ...] where each time is a DST
-   * transition point given as a number of hours since 00:00 UTC, January 1,
-   * 1970, and each adjustment is the adjustment to apply for times after the
-   * DST transition, given as minutes EAST of UTC.
-   * @type {Array.<number>}
-   * @private
-   */
-  this.transitions_;
-};
-
-
-/**
- * The number of milliseconds in an hour.
- * @type {number}
- * @private
- */
-goog.i18n.TimeZone.MILLISECONDS_PER_HOUR_ = 3600 * 1000;
-
-
-/**
- * Indices into the array of time zone names.
- * @enum {number}
- */
-goog.i18n.TimeZone.NameType = {
-  STD_SHORT_NAME: 0,
-  STD_LONG_NAME: 1,
-  DLT_SHORT_NAME: 2,
-  DLT_LONG_NAME: 3
-};
-
-
-/**
- * This factory method creates a time zone instance.  It takes either an object
- * containing complete time zone information, or a single number representing a
- * constant time zone offset.  If the latter form is used, DST functionality is
- * not available.
- *
- * @param {number|Object} timeZoneData If this parameter is a number, it should
- *     indicate minutes WEST of UTC to be used as a constant time zone offset.
- *     Otherwise, it should be an object with these four fields:
- *     <ul>
- *     <li>id: A string ID for the time zone.
- *     <li>std_offset: The standard time zone offset in minutes EAST of UTC.
- *     <li>names: An array of four names (standard short name, standard long
- *           name, daylight short name, daylight long, name)
- *     <li>transitions: An array of numbers which are interpreted in pairs:
- *           [time1, adjustment1, time2, adjustment2, ...] where each time is
- *           a DST transition point given as a number of hours since 00:00 UTC,
- *           January 1, 1970, and each adjustment is the adjustment to apply
- *           for times after the DST transition, given as minutes EAST of UTC.
- *     </ul>
- * @return {goog.i18n.TimeZone} A goog.i18n.TimeZone object for the given
- *     time zone data.
- */
-goog.i18n.TimeZone.createTimeZone = function(timeZoneData) {
-  if (typeof timeZoneData == 'number') {
-    return goog.i18n.TimeZone.createSimpleTimeZone_(timeZoneData);
-  }
-  var tz = new goog.i18n.TimeZone();
-  tz.timeZoneId_ = timeZoneData['id'];
-  tz.standardOffset_ = -timeZoneData['std_offset'];
-  tz.tzNames_ = timeZoneData['names'];
-  tz.transitions_ = timeZoneData['transitions'];
-  return tz;
-};
-
-
-/**
- * This factory method creates a time zone object with a constant offset.
- * @param {number} timeZoneOffsetInMinutes Offset in minutes WEST of UTC.
- * @return {goog.i18n.TimeZone} A time zone object with the given constant
- *     offset.  Note that the time zone ID of this object will use the POSIX
- *     convention, which has a reversed sign ("Etc/GMT+8" means UTC-8 or PST).
- * @private
- */
-goog.i18n.TimeZone.createSimpleTimeZone_ = function(timeZoneOffsetInMinutes) {
-  var tz = new goog.i18n.TimeZone();
-  tz.standardOffset_ = timeZoneOffsetInMinutes;
-  tz.timeZoneId_ =
-      goog.i18n.TimeZone.composePosixTimeZoneID_(timeZoneOffsetInMinutes);
-  var str = goog.i18n.TimeZone.composeUTCString_(timeZoneOffsetInMinutes);
-  tz.tzNames_ = [str, str];
-  tz.transitions_ = [];
-  return tz;
-};
-
-
-/**
- * Generate a GMT-relative string for a constant time zone offset.
- * @param {number} offset The time zone offset in minutes WEST of UTC.
- * @return {string} The GMT string for this offset, which will indicate
- *     hours EAST of UTC.
- * @private
- */
-goog.i18n.TimeZone.composeGMTString_ = function(offset) {
-  var parts = ['GMT'];
-  parts.push(offset <= 0 ? '+' : '-');
-  offset = Math.abs(offset);
-  parts.push(goog.string.padNumber(Math.floor(offset / 60) % 100, 2),
-             ':', goog.string.padNumber(offset % 60, 2));
-  return parts.join('');
-};
-
-
-/**
- * Generate a POSIX time zone ID for a constant time zone offset.
- * @param {number} offset The time zone offset in minutes WEST of UTC.
- * @return {string} The POSIX time zone ID for this offset, which will indicate
- *     hours WEST of UTC.
- * @private
- */
-goog.i18n.TimeZone.composePosixTimeZoneID_ = function(offset) {
-  if (offset == 0) {
-    return 'Etc/GMT';
-  }
-  var parts = ['Etc/GMT', offset < 0 ? '-' : '+'];
-  offset = Math.abs(offset);
-  parts.push(Math.floor(offset / 60) % 100);
-  offset = offset % 60;
-  if (offset != 0) {
-    parts.push(':', goog.string.padNumber(offset, 2));
-  }
-  return parts.join('');
-};
-
-
-/**
- * Generate a UTC-relative string for a constant time zone offset.
- * @param {number} offset The time zone offset in minutes WEST of UTC.
- * @return {string} The UTC string for this offset, which will indicate
- *     hours EAST of UTC.
- * @private
- */
-goog.i18n.TimeZone.composeUTCString_ = function(offset) {
-  if (offset == 0) {
-    return 'UTC';
-  }
-  var parts = ['UTC', offset < 0 ? '+' : '-'];
-  offset = Math.abs(offset);
-  parts.push(Math.floor(offset / 60) % 100);
-  offset = offset % 60;
-  if (offset != 0) {
-    parts.push(':', offset);
-  }
-  return parts.join('');
-};
-
-
-/**
- * Convert the contents of time zone object to a timeZoneData object, suitable
- * for passing to goog.i18n.TimeZone.createTimeZone.
- * @return {Object} A timeZoneData object (see the documentation for
- *     goog.i18n.TimeZone.createTimeZone).
- */
-goog.i18n.TimeZone.prototype.getTimeZoneData = function() {
-  return {
-    'id': this.timeZoneId_,
-    'std_offset': -this.standardOffset_,  // note createTimeZone flips the sign
-    'names': goog.array.clone(this.tzNames_),  // avoid aliasing the array
-    'transitions': goog.array.clone(this.transitions_)  // avoid aliasing
-  };
-};
-
-
-/**
- * Return the DST adjustment to the time zone offset for a given time.
- * While Daylight Saving Time is in effect, this number is positive.
- * Otherwise, it is zero.
- * @param {goog.date.DateLike} date The time to check.
- * @return {number} The DST adjustment in minutes EAST of UTC.
- */
-goog.i18n.TimeZone.prototype.getDaylightAdjustment = function(date) {
-  var timeInMs = Date.UTC(date.getUTCFullYear(), date.getUTCMonth(),
-                          date.getUTCDate(), date.getUTCHours(),
-                          date.getUTCMinutes());
-  var timeInHours = timeInMs / goog.i18n.TimeZone.MILLISECONDS_PER_HOUR_;
-  var index = 0;
-  while (index < this.transitions_.length &&
-         timeInHours >= this.transitions_[index]) {
-    index += 2;
-  }
-  return (index == 0) ? 0 : this.transitions_[index - 1];
-};
-
-
-/**
- * Return the GMT representation of this time zone object.
- * @param {goog.date.DateLike} date The date for which time to retrieve
- *     GMT string.
- * @return {string} GMT representation string.
- */
-goog.i18n.TimeZone.prototype.getGMTString = function(date) {
-  return goog.i18n.TimeZone.composeGMTString_(this.getOffset(date));
-};
-
-
-/**
- * Get the long time zone name for a given date/time.
- * @param {goog.date.DateLike} date The time for which to retrieve
- *     the long time zone name.
- * @return {string} The long time zone name.
- */
-goog.i18n.TimeZone.prototype.getLongName = function(date) {
-  return this.tzNames_[this.isDaylightTime(date) ?
-      goog.i18n.TimeZone.NameType.DLT_LONG_NAME :
-      goog.i18n.TimeZone.NameType.STD_LONG_NAME];
-};
-
-
-/**
- * Get the time zone offset in minutes WEST of UTC for a given date/time.
- * @param {goog.date.DateLike} date The time for which to retrieve
- *     the time zone offset.
- * @return {number} The time zone offset in minutes WEST of UTC.
- */
-goog.i18n.TimeZone.prototype.getOffset = function(date) {
-  return this.standardOffset_ - this.getDaylightAdjustment(date);
-};
-
-
-/**
- * Get the RFC representation of the time zone for a given date/time.
- * @param {goog.date.DateLike} date The time for which to retrieve the
- *     RFC time zone string.
- * @return {string} The RFC time zone string.
- */
-goog.i18n.TimeZone.prototype.getRFCTimeZoneString = function(date) {
-  var offset = -this.getOffset(date);
-  var parts = [offset < 0 ? '-' : '+'];
-  offset = Math.abs(offset);
-  parts.push(goog.string.padNumber(Math.floor(offset / 60) % 100, 2),
-             goog.string.padNumber(offset % 60, 2));
-  return parts.join('');
-};
-
-
-/**
- * Get the short time zone name for given date/time.
- * @param {goog.date.DateLike} date The time for which to retrieve
- *     the short time zone name.
- * @return {string} The short time zone name.
- */
-goog.i18n.TimeZone.prototype.getShortName = function(date) {
-  return this.tzNames_[this.isDaylightTime(date) ?
-      goog.i18n.TimeZone.NameType.DLT_SHORT_NAME :
-      goog.i18n.TimeZone.NameType.STD_SHORT_NAME];
-};
-
-
-/**
- * Return the time zone ID for this time zone.
- * @return {string} The time zone ID.
- */
-goog.i18n.TimeZone.prototype.getTimeZoneId = function() {
-  return this.timeZoneId_;
-};
-
-
-/**
- * Check if Daylight Saving Time is in effect at a given time in this time zone.
- * @param {goog.date.DateLike} date The time to check.
- * @return {boolean} True if Daylight Saving Time is in effect.
- */
-goog.i18n.TimeZone.prototype.isDaylightTime = function(date) {
-  return this.getDaylightAdjustment(date) > 0;
-};
-

data/closure-library/closure/goog/i18n/timezone_test.html

@@ -1,163 +0,0 @@
-<!DOCTYPE html>
-<html>
-<!--
-Copyright 2006 The Closure Library Authors. All Rights Reserved.
-
-Use of this source code is governed by the Apache License, Version 2.0.
-See the COPYING file for details.
--->
-<head>
-<meta http-equiv="X-UA-Compatible" content="IE=edge">
-<title>Closure Unit Tests - goog.i18n.TimeZone</title>
-<script src="../base.js"></script>
-<script>
-  goog.require('goog.i18n.TimeZone');
-  goog.require('goog.testing.jsunit');
-</script>
-</head>
-<body>
-<script>
-  // Where could such data be found
-  // In js_i18n_data in http://go/i18n_dir, we have a bunch of files with names
-  // like TimeZoneConstant__<locale>.js
-  // We strongly discourage you to use them directly as those data can make
-  // your client code bloated. You should try to provide this data from server
-  // in a selective manner. In typical scenario, user's time zone is retrieved
-  // and only data for that time zone should be provided.
-  // This piece of data is in JSON format. It requires double quote.
-  var americaLosAngelesData = {
-    'transitions': [
-      2770, 60, 7137, 0, 11506, 60, 16041, 0, 20410, 60, 24777, 0, 29146, 60,
-      33513, 0, 35194, 60, 42249, 0, 45106, 60, 50985, 0, 55354, 60, 59889, 0,
-      64090, 60, 68625, 0, 72994, 60, 77361, 0, 81730, 60, 86097, 0, 90466, 60,
-      94833, 0, 99202, 60, 103569, 0, 107938, 60, 112473, 0, 116674, 60, 121209,
-      0, 125578, 60, 129945, 0, 134314, 60, 138681, 0, 143050, 60, 147417, 0,
-      151282, 60, 156153, 0, 160018, 60, 165057, 0, 168754, 60, 173793, 0,
-      177490, 60, 182529, 0, 186394, 60, 191265, 0, 195130, 60, 200001, 0,
-      203866, 60, 208905, 0, 212602, 60, 217641, 0, 221338, 60, 226377, 0,
-      230242, 60, 235113, 0, 238978, 60, 243849, 0, 247714, 60, 252585, 0,
-      256450, 60, 261489, 0, 265186, 60, 270225, 0, 273922, 60, 278961, 0,
-      282826, 60, 287697, 0, 291562, 60, 296433, 0, 300298, 60, 305337, 0,
-      309034, 60, 314073, 0, 317770, 60, 322809, 0, 326002, 60, 331713, 0,
-      334738, 60, 340449, 0, 343474, 60, 349185, 0, 352378, 60, 358089, 0,
-      361114, 60, 366825, 0, 369850, 60, 375561, 0, 378586, 60, 384297, 0,
-      387322, 60, 393033, 0, 396058, 60, 401769, 0, 404962, 60, 410673, 0,
-      413698, 60, 419409, 0, 422434, 60, 428145, 0, 431170, 60, 436881, 0,
-      439906, 60, 445617, 0, 448810, 60, 454521, 0, 457546, 60, 463257, 0,
-      466282, 60, 471993, 0, 475018, 60, 480729, 0, 483754, 60, 489465, 0,
-      492490, 60, 498201, 0, 501394, 60, 507105, 0, 510130, 60, 515841, 0,
-      518866, 60, 524577, 0, 527602, 60, 533313, 0, 536338, 60, 542049, 0,
-      545242, 60, 550953, 0, 553978, 60, 559689, 0, 562714, 60, 568425, 0,
-      571450, 60, 577161, 0, 580186, 60, 585897, 0, 588922, 60, 594633, 0
-    ],
-    'names': ['PST', 'Pacific Standard Time', 'PDT', 'Pacific Daylight Time'],
-    'id': 'America/Los_Angeles',
-    'std_offset': -480
-  };
-
-  function testIsDaylightTime() {
-    var usPacific = goog.i18n.TimeZone.createTimeZone(americaLosAngelesData);
-    var dt = new Date(2007, 7 - 1, 1);
-    assertTrue(usPacific.isDaylightTime(dt));
-    // 2007/03/11 2:00am has daylight change. We set time through UTC so that
-    // this test won't be affected by browser's local time handling.
-    dt = new Date(2007, 3 - 1, 11);
-    // The date above is created with a timezone of the computer it is run on.
-    // Therefore the UTC day has to be set explicitly to be sure that the date
-    // is correct for timezones east of Greenwich  where 2007/3/11 0:00 is still
-    // 2007/03/10 in UTC.
-    dt.setUTCDate(11);
-    dt.setUTCHours(2 + 8);
-    dt.setMinutes(1);
-    assertTrue(usPacific.isDaylightTime(dt));
-    dt.setUTCHours(1 + 8);
-    dt.setMinutes(59)
-    assertTrue(!usPacific.isDaylightTime(dt));
-
-    dt = new Date(2007, 11 - 1, 4);
-    // Set the UTC day explicitly to make it work in timezones east of
-    // Greenwich.
-    dt.setUTCDate(4);
-    dt.setUTCHours(2+7);
-    dt.setMinutes(1);
-    assertTrue(!usPacific.isDaylightTime(dt));
-
-    // there seems to be a browser bug. local time 1:59am should still be PDT.
-    dt.setUTCHours(0 + 7);
-    dt.setMinutes(59)
-    assertTrue(usPacific.isDaylightTime(dt));
-  }
-
-  function testGetters() {
-    var date = new Date();
-    var usPacific = goog.i18n.TimeZone.createTimeZone(americaLosAngelesData);
-    if (usPacific.isDaylightTime(date)) {
-      assertEquals(420, usPacific.getOffset(date));
-    } else {
-      assertEquals(480, usPacific.getOffset(date));
-    }
-    assertEquals('America/Los_Angeles', usPacific.getTimeZoneId());
-    assertObjectEquals(americaLosAngelesData, usPacific.getTimeZoneData());
-  }
-
-  function testNames() {
-    var usPacific = goog.i18n.TimeZone.createTimeZone(americaLosAngelesData);
-    var dt = new Date(2007, 7 - 1, 1);
-    assertTrue(usPacific.isDaylightTime(dt));
-    assertEquals('PDT', usPacific.getShortName(dt));
-    assertEquals('Pacific Daylight Time', usPacific.getLongName(dt));
-
-    dt = new Date(2007, 12 - 1, 1);
-    assertTrue(!usPacific.isDaylightTime(dt));
-    assertEquals('PST', usPacific.getShortName(dt));
-    assertEquals('Pacific Standard Time', usPacific.getLongName(dt));
-  }
-
-  function testSimpleTimeZonePositive() {
-    var date = new Date();
-    var simpleTimeZone = goog.i18n.TimeZone.createTimeZone(480);
-    assertEquals(480, simpleTimeZone.getOffset(date));
-    assertEquals('GMT-08:00', simpleTimeZone.getGMTString(date));
-    assertEquals('Etc/GMT+8', simpleTimeZone.getTimeZoneId());
-    assertEquals('UTC-8', simpleTimeZone.getLongName(date));
-    assertEquals('UTC-8', simpleTimeZone.getShortName(date));
-    assertEquals('-0800', simpleTimeZone.getRFCTimeZoneString(date));
-    assertEquals(false, simpleTimeZone.isDaylightTime(date));
-
-    simpleTimeZone = goog.i18n.TimeZone.createTimeZone(630);
-    assertEquals(630, simpleTimeZone.getOffset(date));
-    assertEquals('GMT-10:30', simpleTimeZone.getGMTString(date));
-    assertEquals('Etc/GMT+10:30', simpleTimeZone.getTimeZoneId());
-    assertEquals('UTC-10:30', simpleTimeZone.getLongName(date));
-    assertEquals('UTC-10:30', simpleTimeZone.getShortName(date));
-    assertEquals('-1030', simpleTimeZone.getRFCTimeZoneString(date));
-    assertEquals(false, simpleTimeZone.isDaylightTime(date));
-  }
-
-  function testSimpleTimeZoneNegative() {
-    var date = new Date();
-    var simpleTimeZone = goog.i18n.TimeZone.createTimeZone(-480);
-    assertEquals(-480, simpleTimeZone.getOffset(date));
-    assertEquals('GMT+08:00', simpleTimeZone.getGMTString(date));
-    assertEquals('Etc/GMT-8', simpleTimeZone.getTimeZoneId());
-    assertEquals('UTC+8', simpleTimeZone.getLongName(date));
-    assertEquals('UTC+8', simpleTimeZone.getShortName(date));
-    assertEquals('+0800', simpleTimeZone.getRFCTimeZoneString(date));
-    assertEquals(false, simpleTimeZone.isDaylightTime(date));
-  }
-
-  function testSimpleTimeZoneZero() {
-    var date = new Date();
-    var simpleTimeZone = goog.i18n.TimeZone.createTimeZone(0);
-    assertEquals(0, simpleTimeZone.getOffset(date));
-    assertEquals('GMT+00:00', simpleTimeZone.getGMTString(date));
-    assertEquals('Etc/GMT', simpleTimeZone.getTimeZoneId());
-    assertEquals('UTC', simpleTimeZone.getLongName(date));
-    assertEquals('UTC', simpleTimeZone.getShortName(date));
-    assertEquals('+0000', simpleTimeZone.getRFCTimeZoneString(date));
-    assertEquals(false, simpleTimeZone.isDaylightTime(date));
-  }
-
-</script>
-</body>
-</html>