diff --git a/cpp/src/phonenumbers/phonenumberutil.h b/cpp/src/phonenumbers/phonenumberutil.h index 9f9360efa..19e5ae347 100644 --- a/cpp/src/phonenumbers/phonenumberutil.h +++ b/cpp/src/phonenumbers/phonenumberutil.h @@ -69,14 +69,15 @@ class PhoneNumberUtil : public Singleton { static const char kRegionCodeForNonGeoEntity[]; // INTERNATIONAL and NATIONAL formats are consistent with the definition - // in ITU-T Recommendation E. 123. For example, the number of the Google - // Zürich office will be written as "+41 44 668 1800" in INTERNATIONAL - // format, and as "044 668 1800" in NATIONAL format. E164 format is as per - // INTERNATIONAL format but with no formatting applied e.g. "+41446681800". - // RFC3966 is as per INTERNATIONAL format, but with all spaces and other - // separating symbols replaced with a hyphen, and with any phone number - // extension appended with ";ext=". It also will have a prefix of "tel:" - // added, e.g. "tel:+41-44-668-1800". + // in ITU-T Recommendation E.123. However we follow local conventions such as + // using '-' instead of whitespace as separators. For example, the number of + // the Google Switzerland office will be written as "+41 44 668 1800" in + // INTERNATIONAL format, and as "044 668 1800" in NATIONAL format. E164 + // format is as per INTERNATIONAL format but with no formatting applied e.g. + // "+41446681800". RFC3966 is as per INTERNATIONAL format, but with all spaces + // and other separating symbols replaced with a hyphen, and with any phone + // number extension appended with ";ext=". It also will have a prefix of + // "tel:" added, e.g. "tel:+41-44-668-1800". enum PhoneNumberFormat { E164, INTERNATIONAL, diff --git a/java/libphonenumber/src/com/google/i18n/phonenumbers/PhoneNumberUtil.java b/java/libphonenumber/src/com/google/i18n/phonenumbers/PhoneNumberUtil.java index bc8a53eb0..87eadc374 100644 --- a/java/libphonenumber/src/com/google/i18n/phonenumbers/PhoneNumberUtil.java +++ b/java/libphonenumber/src/com/google/i18n/phonenumbers/PhoneNumberUtil.java @@ -380,12 +380,13 @@ public class PhoneNumberUtil { /** * INTERNATIONAL and NATIONAL formats are consistent with the definition in ITU-T Recommendation - * E123. For example, the number of the Google Switzerland office will be written as - * "+41 44 668 1800" in INTERNATIONAL format, and as "044 668 1800" in NATIONAL format. - * E164 format is as per INTERNATIONAL format but with no formatting applied, e.g. - * "+41446681800". RFC3966 is as per INTERNATIONAL format, but with all spaces and other - * separating symbols replaced with a hyphen, and with any phone number extension appended with - * ";ext=". It also will have a prefix of "tel:" added, e.g. "tel:+41-44-668-1800". + * E.123. However we follow local conventions such as using '-' instead of whitespace as + * separators. For example, the number of the Google Switzerland office will be written as + * "+41 44 668 1800" in INTERNATIONAL format, and as "044 668 1800" in NATIONAL format. E164 + * format is as per INTERNATIONAL format but with no formatting applied, e.g. "+41446681800". + * RFC3966 is as per INTERNATIONAL format, but with all spaces and other separating symbols + * replaced with a hyphen, and with any phone number extension appended with ";ext=". It also + * will have a prefix of "tel:" added, e.g. "tel:+41-44-668-1800". * * Note: If you are considering storing the number in a neutral format, you are highly advised to * use the PhoneNumber class. diff --git a/javascript/i18n/phonenumbers/phonenumberutil.js b/javascript/i18n/phonenumbers/phonenumberutil.js index cceaf08dd..cf03c57d7 100644 --- a/javascript/i18n/phonenumbers/phonenumberutil.js +++ b/javascript/i18n/phonenumbers/phonenumberutil.js @@ -883,14 +883,15 @@ i18n.phonenumbers.PhoneNumberUtil.REGION_CODE_FOR_NON_GEO_ENTITY = '001'; /** * INTERNATIONAL and NATIONAL formats are consistent with the definition in - * ITU-T Recommendation E123. For example, the number of the Google Switzerland - * office will be written as '+41 44 668 1800' in INTERNATIONAL format, and as - * '044 668 1800' in NATIONAL format. E164 format is as per INTERNATIONAL format - * but with no formatting applied, e.g. '+41446681800'. RFC3966 is as per - * INTERNATIONAL format, but with all spaces and other separating symbols - * replaced with a hyphen, and with any phone number extension appended with - * ';ext='. It also will have a prefix of 'tel:' added, e.g. - * 'tel:+41-44-668-1800'. + * ITU-T Recommendation E123. However we follow local conventions such as + * using '-' instead of whitespace as separators. For example, the number of the + * Google Switzerland office will be written as '+41 44 668 1800' in + * INTERNATIONAL format, and as '044 668 1800' in NATIONAL format. E164 format + * is as per INTERNATIONAL format but with no formatting applied, e.g. + * '+41446681800'. RFC3966 is as per INTERNATIONAL format, but with all spaces + * and other separating symbols replaced with a hyphen, and with any phone + * number extension appended with ';ext='. It also will have a prefix of 'tel:' + * added, e.g. 'tel:+41-44-668-1800'. * * Note: If you are considering storing the number in a neutral format, you are * highly advised to use the PhoneNumber class.