====== PHP RFC: IntlTimeZone::getWindowsID() ====== * Version: 1.0 * Date: 2016-03-15 * Author: Sara Golemon, pollita@php.net * Status: Implemented * First Published at: https://wiki.php.net/rfc/intl.timezone.get-windows-id ===== Introduction ===== ICU adds new methods from time to time. Specifically, the methods [[http://icu-project.org/apiref/icu4c/classicu_1_1TimeZone.html#a216766958df6b1931bb7603ae78d114e|TimeZone::getWindowsID]] and [[http://icu-project.org/apiref/icu4c/classicu_1_1TimeZone.html#a0872f72c5c3204de3c61502be568d72d|TimeZone::getIDForWindowsID]] were added with ICU4C 52. ===== Proposal ===== 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", or FALSE on failure */ 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", or FALSE on failure */ 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 ===== Vote ===== Simple 50% +1 majority: "Should this APIs be added to IntlTimeZone?" * Yes * No ===== Patches and Tests ===== https://github.com/php/php-src/compare/master...sgolemon:intl.timezone.52-updates ===== Commits ===== https://github.com/php/php-src/commit/a9568d54858912cd741df183f8eee2493361de7f