Package com.google.i18n.phonenumbers

Class PhoneNumberToTimeZonesMapper

java.lang.Object

com.google.i18n.phonenumbers.PhoneNumberToTimeZonesMapper

public class PhoneNumberToTimeZonesMapper
extends Object

An offline mapper from phone numbers to time zones.

Method Summary

Modifier and Type	Method	Description
static PhoneNumberToTimeZonesMapper	getInstance()	Gets a PhoneNumberToTimeZonesMapper instance.
List<String>	getTimeZonesForGeographicalNumber(com.google.i18n.phonenumbers.Phonenumber.PhoneNumber number)	Returns a list of time zones to which a phone number belongs.
List<String>	getTimeZonesForNumber(com.google.i18n.phonenumbers.Phonenumber.PhoneNumber number)	As per getTimeZonesForGeographicalNumber(PhoneNumber) but explicitly checks the validity of the number passed in.
static String	getUnknownTimeZone()	Returns a String with the ICU unknown time zone.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

getInstance

public static PhoneNumberToTimeZonesMapper getInstance()

Gets a PhoneNumberToTimeZonesMapper instance.

The PhoneNumberToTimeZonesMapper is implemented as a singleton. Therefore, calling this method multiple times will only result in one instance being created.

Returns:

a PhoneNumberToTimeZonesMapper instance

getTimeZonesForGeographicalNumber

public List<String> getTimeZonesForGeographicalNumber(com.google.i18n.phonenumbers.Phonenumber.PhoneNumber number)

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.

Parameters:

number - a valid phone number for which we want to get the time zones to which it belongs

Returns:

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

getTimeZonesForNumber

public List<String> getTimeZonesForNumber(com.google.i18n.phonenumbers.Phonenumber.PhoneNumber number)

As per getTimeZonesForGeographicalNumber(PhoneNumber) but explicitly checks the validity of the number passed in.

Parameters:

number - the phone number for which we want to get the time zones to which it belongs

Returns:

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

getUnknownTimeZone

public static String getUnknownTimeZone()

Returns a String with the ICU unknown time zone.