The {@link PhoneNumberToTimeZonesMapper} is implemented as a singleton. Therefore, calling * this method multiple times will only result in one instance being created. * * @return PhoneNumberToTimeZonesMapper instance */ public static function getInstance(string $className = Map::class): PhoneNumberToTimeZonesMapper { if (!isset(static::$instance)) { static::$instance = new static($className); } return static::$instance; } /** * Returns a String with the ICU unknown time zone. */ public static function getUnknownTimeZone(): string { return static::UNKNOWN_TIMEZONE; } /** * As per {@see getTimeZonesForGeographicalNumber(PhoneNumber)} but explicitly checks * the validity of the number passed in. * * @param $number PhoneNumber the phone number for which we want to get the time zones to which it belongs * @return string[] a list of the corresponding time zones or a single element list with the default * unknown time zone if no other time zone was found or if the number was invalid */ public function getTimeZonesForNumber(PhoneNumber $number): array { $numberType = $this->phoneUtil->getNumberType($number); if ($numberType === PhoneNumberType::UNKNOWN) { return $this->unknownTimeZoneList; } if (!PhoneNumberUtil::getInstance()->isNumberGeographical($numberType, $number->getCountryCode())) { return $this->getCountryLevelTimeZonesforNumber($number); } return $this->getTimeZonesForGeographicalNumber($number); } /** * Returns the list of time zones corresponding to the country calling code of {@code number}. * * @param $number PhoneNumber the phone number to look up * @return string[] the list of corresponding time zones or a single element list with the default * unknown time zone if no other time zone was found */ protected function getCountryLevelTimeZonesforNumber(PhoneNumber $number): array { $timezones = $this->prefixTimeZonesMap->lookupCountryLevelTimeZonesForNumber($number); return (count($timezones) === 0) ? $this->unknownTimeZoneList : $timezones; } /** * Returns a list of time zones to which a phone number belongs. * *

This method assumes the validity of the number passed in has already been checked, and that * the number is geo-localizable. We consider fixed-line and mobile numbers possible candidates * for geo-localization. * * @param $number PhoneNumber a valid phone number for which we want to get the time zones to which it belongs * @return string[] a list of the corresponding time zones or a single element list with the default * unknown time zone if no other time zone was found or if the number was invalid */ public function getTimeZonesForGeographicalNumber(PhoneNumber $number): array { return $this->getTimeZonesForGeocodableNumber($number); } /** * Returns a list of time zones to which a geocodable phone number belongs. * * @param PhoneNumber $number The phone number for which we want to get the time zones to which it belongs * @return string[] the list of corresponding time zones or a single element list with the default * unknown timezone if no other time zone was found or if the number was invalid */ protected function getTimeZonesForGeocodableNumber(PhoneNumber $number): array { $timezones = $this->prefixTimeZonesMap->lookupTimeZonesForNumber($number); return (count($timezones) === 0) ? $this->unknownTimeZoneList : $timezones; } }