PHP RFC: IntlTimeZone::getWindowsID()

• Version: 1.0
• Date: 2016-03-15
• Author: Sara Golemon, pollita@php.net
• Status: Under Discussion
• First Published at: https://wiki.php.net/rfc/intl.timezone.get-windows-id

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); }

PHP 7.1

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

https://github.com/php/php-src/compare/master...sgolemon:intl.timezone.52-updates