ext/intl: Timezone::getIanaID method addition.

returns the primary IANA zone ID from the provided timezone ID.
Most of the time, timezone ID==IANA ID.
available from icu >= 74.

Author: devnexen

ext/intl/tests/timezone_getIanaID.phpt

@@ -0,0 +1,23 @@
+--TEST--
+IntlTimeZone::getIanaID
+--EXTENSIONS--
+intl
+--SKIPIF--
+<?php if (version_compare(INTL_ICU_VERSION, '74.0') < 0) die('skip for ICU < 74.0'); ?>
+--FILE--
+<?php
+ini_set("intl.error_level", E_WARNING);
+
+var_dump(IntlTimeZone::getIanaID("php\x81"));
+var_dump(IntlTimeZone::getIanaID("Galaxy/Pluto"));
+var_dump(IntlTimeZone::getIanaID('Europe/Dublin'));
+var_dump(IntlTimeZone::getIanaID('Asia/Calcutta'));
+?>
+--EXPECTF--
+Warning: IntlTimeZone::getIanaID(): intltz_get_iana_id: could not convert time zone id to UTF-16 in %s on line %d
+bool(false)
+
+Warning: IntlTimeZone::getIanaID(): intltz_get_iana_id: error obtaining IANA ID in %s on line %d
+bool(false)
+string(13) "Europe/Dublin"
+string(12) "Asia/Kolkata"

ext/intl/timezone/timezone.stub.php

@@ -112,6 +112,14 @@ public function getErrorMessage(): string|false {}
      */
     public static function getGMT(): IntlTimeZone {}
 
+#if U_ICU_VERSION_MAJOR_NUM >= 74
+    /**
+     * @tentative-return-type
+     * @alias intltz_get_iana_id
+     */
+    public static function getIanaID(string $timezoneId): string|false {}
+#endif
+
     /**
      * @tentative-return-type
      * @alias intltz_get_id

ext/intl/timezone/timezone_arginfo.h

@@ -371,6 +371,37 @@ U_CFUNC PHP_FUNCTION(intltz_get_equivalent_id)
 	RETVAL_NEW_STR(u8str);
 }
 
+#if U_ICU_VERSION_MAJOR_NUM >= 74
+U_CFUNC PHP_FUNCTION(intltz_get_iana_id)
+{
+	char	*str_id;
+	size_t	 str_id_len;
+	intl_error_reset(NULL);
+
+	if (zend_parse_parameters(ZEND_NUM_ARGS(), "s",
+			&str_id, &str_id_len) == FAILURE) {
+		RETURN_THROWS();
+	}
+
+	UErrorCode status = UErrorCode();
+	UnicodeString id;
+	if (intl_stringFromChar(id, str_id, str_id_len, &status) == FAILURE) {
+		intl_error_set(NULL, status,
+			"intltz_get_iana_id: could not convert time zone id to UTF-16", 0);
+		RETURN_FALSE;
+	}
+
+	UnicodeString result;
+	TimeZone::getIanaID(id, result, status);
+	INTL_CHECK_STATUS(status, "intltz_get_iana_id: error obtaining IANA ID");
+
+	zend_string *u8str =intl_convert_utf16_to_utf8(result.getBuffer(), result.length(), &status);
+	INTL_CHECK_STATUS(status,
+		"intltz_get_iana_id: could not convert time zone id to UTF-16");
+	RETVAL_NEW_STR(u8str);
+}
+#endif
+
 U_CFUNC PHP_FUNCTION(intltz_get_id)
 {
 	TIMEZONE_METHOD_INIT_VARS;