hphp/runtime/base/timezone.h

   1 /*
   2    +----------------------------------------------------------------------+
   3    | HipHop for PHP                                                       |
   4    +----------------------------------------------------------------------+
   5    | Copyright (c) 2010-present Facebook, Inc. (http://www.facebook.com)  |
   6    +----------------------------------------------------------------------+
   7    | This source file is subject to version 3.01 of the PHP license,      |
   8    | that is bundled with this package in the file LICENSE, and is        |
   9    | available through the world-wide-web at the following url:           |
  10    | http://www.php.net/license/3_01.txt                                  |
  11    | If you did not receive a copy of the PHP license and are unable to   |
  12    | obtain it through the world-wide-web, please send a note to          |
  13    | license@php.net so we can mail you a copy immediately.               |
  14    +----------------------------------------------------------------------+
  15 */
  16
  17 #ifndef incl_HPHP_TIMEZONE_H_
  18 #define incl_HPHP_TIMEZONE_H_
  19
  20 #include "hphp/runtime/base/resource-data.h"
  21 #include "hphp/runtime/base/type-string.h"
  22 #include "hphp/runtime/ext/std/ext_std_misc.h"
  23
  24 #include <map>
  25 #include <memory>
  26
  27 extern "C" {
  28 #include <timelib.h>
  29 }
  30
  31 namespace HPHP {
  32
  33 struct Array;
  34
  35 ///////////////////////////////////////////////////////////////////////////////
  36
  37 /**
  38  * Handles all timezone related functions.
  39  */
  40 struct TimeZone : SweepableResourceData {
  41   DECLARE_RESOURCE_ALLOCATION(TimeZone);
  42
  43   /**
  44    * Get/set current timezone that controls how local time is interpreted.
  45    */
  46   static String CurrentName();              // current timezone's name
  47   static req::ptr<TimeZone> Current();      // current timezone
  48   static bool SetCurrent(const char* name); // returns false if invalid
  49
  50   /**
  51    * TimeZone database queries.
  52    */
  53   static bool IsValid(const char* name);
  54   static Array GetAbbreviations();
  55   static String AbbreviationToName(String abbr, int utcoffset = -1,
  56                                    int isdst = 1);
  57
  58 public:
  59   /**
  60    * Constructing a timezone object by name or a raw pointer (internal).
  61    */
  62   TimeZone();
  63   explicit TimeZone(const String& name);
  64   explicit TimeZone(timelib_tzinfo *tzi);
  65
  66   static StaticString& classnameof() {
  67     static StaticString result("TimeZone");
  68     return result;
  69   }
  70   // overriding ResourceData
  71   const String& o_getClassNameHook() const override { return classnameof(); }
  72
  73   /**
  74    * Whether this represents a valid timezone.
  75    */
  76   bool isValid() const { return get();}
  77
  78   /**
  79    * Get timezone's name or abbreviation.
  80    */
  81   String name() const;
  82   String abbr(int type = 0) const;
  83
  84   /**
  85    * Get offset from UTC at the specified timestamp under this timezone.
  86    */
  87   int offset(int64_t timestamp) const;
  88
  89   /**
  90    * Test whether it was running under DST at specified timestamp.
  91    */
  92   bool dst(int64_t timestamp) const;
  93
  94   /**
  95    * Query transition times for DST.
  96    */
  97   Array transitions(int64_t timestamp_begin = k_PHP_INT_MIN,
  98                     int64_t timestamp_end = k_PHP_INT_MAX) const;
  99
 100   /**
 101    * Get information about a timezone
 102    */
 103   Array getLocation() const;
 104
 105   /**
 106    * Timezone Database version
 107    */
 108   static String getVersion() {
 109     const timelib_tzdb* db = GetDatabase();
 110     return String(db->version, CopyString);
 111   }
 112
 113   /**
 114    * Make a copy of this timezone object, so it can be changed independently.
 115    */
 116   req::ptr<TimeZone> cloneTimeZone() const;
 117
 118 protected:
 119   friend struct DateTime;
 120   friend struct TimeStamp;
 121   friend struct DateInterval;
 122
 123   /**
 124    * Returns raw pointer. For internal use only.
 125    */
 126   timelib_tzinfo *get() const { return m_tzi; }
 127
 128 private:
 129   static const timelib_tzdb *GetDatabase();
 130
 131   /**
 132    * Look up cache and if found return it, otherwise, read it from database.
 133    */
 134   static timelib_tzinfo* GetTimeZoneInfoRaw(char* name, const timelib_tzdb* db);
 135
 136   timelib_tzinfo* m_tzi;
 137 };
 138
 139 ///////////////////////////////////////////////////////////////////////////////
 140
 141 void timezone_init();
 142 const timelib_tzdb* timezone_get_tzdb();
 143 extern const timelib_tzdb* (*timezone_raw_get_tzdb)();
 144
 145 ///////////////////////////////////////////////////////////////////////////////
 146 }
 147
 148 #endif // incl_HPHP_TIMEZONE_H_