This is an old revision of the document!

PHP RFC: IntlTimeZone::getWindowsID()


ICU adds new methods from time to time. Specifically, the methods TimeZone::getWindowsID and TimeZone::getIDForWindowsID were added with ICU4C 52.


Add support for these two new methods as static methods on the PHP IntlTimeZone class using the following prototypes:

class IntlTimeZone {
  /* Converts a system timezone such as "America/Los_Angeles" to a
   * Windows Timezone identifier.
   * @param string $systemID - System Timezone Identifier, such as "America/Los_Angeles"
   * @returns string - Windows Timezone Identifier, i.e. "Pacific Standard Time"
  public static function getWindowsID(string $systemID): string;
  /* Convers a windows timezone identier such as "Pacific Time Zone" to a
   * System Timezone identifier appropriate to the region requested.
   * .
   * @param string $windowsID - Windows Timezone identifier, such as "Pacific TimeZone"
   * @param string $region - Preferred region for result, or NULL for no preference
   * @returns string - System Timezone identifier, i.e. "America/Los_Angeles"
  public static function getIDForWindowsID(string $windowsID, ?string $region = NULL): string;

function intltz_get_windows_id($id) { return IntlTimeZone::getWindowsID($id); }
function intltz_get_id_for_windows_id($winid, $region = NULL) { return IntlTimeZone::getIDForWindowsID($winid, $region); }

Proposed PHP Version(s)

PHP 7.1

Proposed Voting Choices

Simple 50% +1 majority: “Should this APIs be added to IntlTimeZone?”

Patches and Tests

rfc/intl.timezone.get-windows-id.1458092732.txt.gz · Last modified: 2017/09/22 13:28 (external edit)