1Feb 21, 2024: v8.13.31
2Metadata changes:
3 - Updated phone metadata for region code(s):
4   BM, CZ, EH, GY, JE, LS, MA, NG, NP, OM, SG, TO, US
5 - Updated carrier data for country calling code(s):
6   33 (en), 65 (en), 234 (en), 420 (en), 592 (en), 676 (en), 977 (en)
7 - Updated / refreshed time zone meta data.
8
9Feb 07, 2024: v8.13.30
10Metadata changes:
11 - Updated alternate formatting data for country calling code(s): 34, 385
12 - Updated phone metadata for region code(s):
13   BL, BS, GP, HK, HR, KW, LI, MF, MX, OM, PL, PT, SV, UG, US
14 - New geocoding data for country calling code(s): 1363 (en)
15 - Updated geocoding data for country calling code(s): 52 (en)
16 - Updated carrier data for country calling code(s):
17   47 (en), 48 (en), 84 (en), 256 (en), 351 (en), 423 (en), 590 (en),
18   852 (en, zh)
19 - Updated / refreshed time zone meta data.
20
21Jan 24, 2024: v8.13.29
22Metadata changes:
23 - Updated phone metadata for region code(s):
24   AU, CC, CX, CZ, GF, MH, MQ, TH, YT
25 - Updated carrier data for country calling code(s):
26   61 (en), 420 (en), 692 (en)
27
28Jan 10, 2024: v8.13.28
29Metadata changes:
30 - Updated phone metadata for region code(s):
31   AU, BJ, BM, FR, GY, HK, HR, IR, IT, KE, KR, LR, MQ, NG, PG, SG, US
32 - New geocoding data for country calling code(s): 33 (en, fr), 1645 (en)
33 - Updated geocoding data for country calling code(s): 61 (en), 234 (en)
34 - Updated carrier data for country calling code(s):
35   64 (en), 65 (en), 229 (en), 231 (en), 385 (en), 420 (en), 675 (en),
36   852 (en, zh), 1441 (en)
37 - Updated / refreshed time zone meta data.
38
39Dec 06, 2023: v8.13.27
40Metadata changes:
41 - Updated phone metadata for region code(s):
42   AR, BH, DE, EE, FI, GE, HK, PY, RO, SG, US
43 - Updated geocoding data for country calling code(s): 54 (en), 358 (en, sv)
44 - Updated carrier data for country calling code(s):
45   40 (en), 49 (en), 65 (en), 358 (en), 595 (en), 673 (en), 852 (en, zh),
46   973 (en), 995 (en), 1868 (en)
47 - Updated / refreshed time zone meta data.
48
49Nov 21, 2023: v8.13.26
50Metadata changes:
51 - Updated phone metadata for region code(s): EH, HK, HR, MA, MK, PK, RO, TJ
52 - Updated geocoding data for country calling code(s): 212 (en, fr)
53 - Updated carrier data for country calling code(s):
54   40 (en), 45 (en), 86 (en, zh), 92 (en), 228 (en), 385 (en), 852 (en, zh),
55   992 (en)
56
57Nov 08, 2023: v8.13.25
58Metadata changes:
59 - Updated phone metadata for region code(s):
60   883, BH, BJ, EH, GU, GY, HK, MA, NU, SG, US, VN
61 - New geocoding data for country calling code(s):
62   1227 (en), 1329 (en), 1369 (en), 1730 (en)
63 - Updated carrier data for country calling code(s):
64   65 (en), 84 (en), 212 (en), 229 (en), 592 (en), 683 (en),
65   852 (en, zh, zh_Hant)
66 - Updated / refreshed time zone meta data.
67
68Oct 25, 2023: v8.13.24
69Metadata changes:
70 - Updated phone metadata for region code(s):
71   BW, EE, GT, HK, HR, KZ, MU, PA, RU, UG, US, UZ
72 - Updated carrier data for country calling code(s):
73   230 (en), 502 (en), 852 (en, zh, zh_Hant), 998 (en)
74
75Oct 11, 2023: v8.13.23
76Metadata changes:
77 - Updated phone metadata for region code(s): BW, GE, NU, RE
78 - Updated carrier data for country calling code(s):
79   30 (en), 229 (en), 262 (en)
80
81Sep 27, 2023: v8.13.22
82Metadata changes:
83 - Updated phone metadata for region code(s):
84   881, CO, IL, LI, MK, SA, TR, UG, UY
85 - Updated geocoding data for country calling code(s): 598 (en)
86 - Updated carrier data for country calling code(s):
87   39 (en), 41 (en), 43 (en), 49 (en), 57 (en), 90 (en), 237 (en), 389 (en),
88   423 (en), 853 (en), 966 (en), 972 (en)
89
90Sep 18, 2023: v8.13.21
91Metadata changes:
92 - Updated phone metadata for region code(s): AU, CC, CX, MX, UY
93 - Updated geocoding data for country calling code(s): 52 (en), 61 (en)
94 - Updated carrier data for country calling code(s): 61 (en)
95
96Aug 30, 2023: v8.13.20
97Metadata changes:
98 - Updated phone metadata for region code(s): AR, BD, GY, IL, NZ, OM, RW, TN
99 - Updated carrier data for country calling code(s):
100   46 (en), 56 (en), 216 (en), 250 (en), 592 (en)
101
102Aug 17, 2023: v8.13.19
103Metadata changes:
104 - Updated phone metadata for region code(s):
105   GB, GF, IL, JP, MQ, MY, NO, PL, RE, SJ, TJ, US
106 - Updated short number metadata for region code(s): GL, JP
107 - New geocoding data for country calling code(s): 1983 (en)
108 - Updated geocoding data for country calling code(s): 44 (en), 975 (en)
109 - Updated carrier data for country calling code(s):
110   47 (en), 51 (en), 60 (en), 216 (en), 262 (en), 972 (en), 992 (en)
111 - Updated / refreshed time zone meta data.
112
113Aug 02, 2023: v8.13.18
114Metadata changes:
115 - Updated alternate formatting data for country calling code(s): 84
116 - Updated phone metadata for region code(s):
117   BH, CU, EG, GE, GL, IL, JP, NZ, RE, SG, UG, UZ, VN, YT
118 - Updated short number metadata for region code(s): JP
119 - Updated geocoding data for country calling code(s): 299 (en)
120 - Updated carrier data for country calling code(s):
121   41 (en), 46 (en), 53 (en), 64 (en), 65 (en), 221 (en), 972 (en), 973 (en),
122   995 (en), 998 (en)
123 - Updated / refreshed time zone meta data.
124
125Jul 19, 2023: v8.13.17
126Metadata changes:
127 - Updated phone metadata for region code(s):
128   BL, CU, FR, GF, GP, HK, KR, MF, MQ, MU, PK, RE, SO, YT
129 - Updated geocoding data for country calling code(s): 53 (en)
130 - Updated carrier data for country calling code(s):
131   81 (en), 82 (en, ko), 262 (en), 371 (en)
132 - Updated / refreshed time zone meta data.
133
134Jul 06, 2023: v8.13.16
135Metadata changes:
136 - Updated phone metadata for region code(s):
137   AM, BW, EE, JM, KG, PM, SG, SV, TJ
138 - Updated geocoding data for country calling code(s): 267 (en)
139 - Updated carrier data for country calling code(s):
140   46 (en), 65 (en), 81 (en), 503 (en), 992 (en), 996 (en)
141
142Jun 20, 2023: v8.13.15
143Metadata changes:
144 - Updated phone metadata for region code(s): BE, BF, IL, MN, NE, OM, SO, SV
145 - Updated carrier data for country calling code(s):
146   226 (en), 227 (en), 252 (en), 351 (en), 968 (en), 972 (en)
147
148Jun 08, 2023: v8.13.14
149Metadata changes:
150 - Updated phone metadata for region code(s):
151   BD, EE, ET, IR, MM, MN, NZ, OM, QA
152 - Updated short number metadata for region code(s): QA
153 - Updated geocoding data for country calling code(s): 95 (en)
154 - Updated carrier data for country calling code(s):
155   33 (en), 51 (en), 98 (en, fa), 372 (en)
156
157May 26, 2023: v8.13.13
158Metadata changes:
159 - Updated phone metadata for region code(s):
160   AU, BJ, CC, CX, GB, IL, LR, MU, NO
161 - Updated short number metadata for region code(s): CZ
162 - Updated geocoding data for country calling code(s): 61 (en)
163 - Updated carrier data for country calling code(s):
164   32 (en), 229 (en), 230 (en)
165
166May 11, 2023: v8.13.12
167Metadata changes:
168 - Updated phone metadata for region code(s): BE, BJ, ET, KI, MH, US
169 - Updated geocoding data for country calling code(s): 686 (en), 1472 (en)
170 - Updated carrier data for country calling code(s):
171   229 (en), 420 (en), 686 (en), 692 (en)
172
173Apr 26, 2023: v8.13.11
174Metadata changes:
175 - Updated phone metadata for region code(s):
176   BL, CG, GB, GF, GP, MF, RE, SG, TJ, YT
177
178Apr 14, 2023: v8.13.10
179Metadata changes:
180 - Updated phone metadata for region code(s): BE, CA, CL, GE, MM, MU, RE, US
181 - New geocoding data for country calling code(s): 1428 (en)
182 - Updated geocoding data for country calling code(s):
183   86 (en, zh), 95 (en), 1472 (en)
184 - Updated carrier data for country calling code(s):
185   33 (en), 41 (en), 56 (en), 81 (en), 90 (en), 230 (en), 381 (en), 995 (en),
186   998 (en), 1284 (en)
187 - Updated / refreshed time zone meta data.
188
189Mar 28, 2023: v8.13.9
190Metadata changes:
191 - Updated phone metadata for region code(s): BL, GF, GI, GP, HR, MF, MQ
192 - Updated short number metadata for region code(s): JO
193 - Updated carrier data for country calling code(s): 350 (en), 385 (en)
194
195Mar 09, 2023: v8.13.8
196Code changes:
197 - Added a check to PhoneNumberUtil that the value of the `phone-context`
198 parameter of the tel URI follows the correct syntax as defined in
199 [RFC3966](https://www.rfc-editor.org/rfc/rfc3966#section-3).
200Metadata changes:
201 - Updated phone metadata for region code(s):
202   BL, GF, GM, GP, KW, MF, MY, PM, PT
203 - Updated short number metadata for region code(s): CH, DK
204 - Updated carrier data for country calling code(s): 60 (en), 220 (en)
205
206Feb 23, 2023: v8.13.7
207Metadata changes:
208 - Updated phone metadata for region code(s):
209   AG, AI, AS, AU, BB, BM, BS, CC, CN, CX, DM, FR, GD, GG, GU, IM, JE, KN, KY,
210   LC, LI, MG, MK, MP, MQ, MS, RE, RO, SX, TC, TG, TT, US, VC, VG, VI, YT
211 - Updated short number metadata for region code(s): FR
212 - New geocoding data for country calling code(s): 1472 (en), 1557 (en)
213 - Updated geocoding data for country calling code(s): 57 (en)
214 - Updated carrier data for country calling code(s):
215   33 (en), 34 (en), 41 (en), 228 (en), 370 (en), 389 (en), 1246 (en)
216 - Updated / refreshed time zone meta data.
217
218Feb 08, 2023: v8.13.6
219Metadata changes:
220 - Updated phone metadata for region code(s):
221   AG, AI, AS, AU, BB, BM, BS, CA, CC, CF, CX, DM, DO, GD, GE, GU, HN, JM, KN,
222   KY, LA, LC, MP, MS, MV, PR, SI, SX, TC, TT, US, UZ, VC, VG, VI, VN
223 - Updated short number metadata for region code(s): SC
224 - Updated geocoding data for country calling code(s): 504 (en)
225 - Updated carrier data for country calling code(s):
226   32 (en), 44 (en), 61 (en), 62 (en), 236 (en), 372 (en), 386 (en), 960 (en),
227   995 (en), 998 (en), 1246 (en)
228
229Jan 17, 2023: v8.13.5
230Metadata changes:
231 - Updated phone metadata for region code(s): BJ, EE, GI, GP, MN, TD
232 - Updated carrier data for country calling code(s):
233   46 (en), 229 (en), 235 (en), 976 (en)
234
235Jan 05, 2023: v8.13.4
236Metadata changes:
237 - Updated phone metadata for region code(s):
238   BG, BJ, ET, GH, HT, LR, MG, QA, SI, UZ
239 - Updated short number metadata for region code(s): FO
240 - Updated geocoding data for country calling code(s): 251 (en)
241 - Updated carrier data for country calling code(s):
242   45 (en), 48 (en), 231 (en), 233 (en), 261 (en), 298 (en), 383 (en), 386 (en),
243   509 (en), 974 (en), 998 (en)
244
245Dec 21, 2022: v8.13.3
246Metadata changes:
247 - Updated phone metadata for region code(s):
248   882, 883, AT, GP, MX, QA, RE, SG, YE
249 - Updated short number metadata for region code(s): AT, BE
250 - Updated geocoding data for country calling code(s): 52 (en)
251 - Updated carrier data for country calling code(s):
252   44 (en), 65 (en), 420 (en), 882 (en), 967 (en)
253
254Dec 07, 2022: v8.13.2
255Metadata changes:
256 - Updated phone metadata for region code(s):
257   882, AS, AU, BI, BM, BS, CA, CC, CX, ET, GB, GH, GU, GY, MK, MU, NG, SG, SO,
258   TJ, US, UY, VI
259 - New geocoding data for country calling code(s):
260   1350 (en), 1354 (en), 1382 (en), 1683 (en), 1835 (en)
261 - Updated geocoding data for country calling code(s): 1340 (en)
262 - Updated carrier data for country calling code(s):
263   27 (en), 33 (en), 61 (en), 65 (en), 230 (en), 233 (en), 234 (en), 252 (en),
264   260 (en), 370 (en), 592 (en), 882 (en), 992 (en), 1441 (en), 1671 (en)
265 - Updated / refreshed time zone meta data.
266
267Nov 10, 2022: v8.13.1
268Metadata changes:
269 - Updated alternate formatting data for country calling code(s): 7
270 - Updated phone metadata for region code(s): GI, KG, KZ, RU
271 - Updated geocoding data for country calling code(s): 7 (en, ru), 64 (en)
272 - Updated carrier data for country calling code(s):
273   51 (en), 350 (en), 420 (en), 996 (en)
274 - Updated / refreshed time zone meta data.
275
276Oct 28, 2022: v8.13.0
277 - Removal of unused leading_zero_possible proto field in phonemetadata.proto and all generated code. This has not been used for a long time, it was removed from metadata in 2017.
278Metadata changes:
279 - Updated phone metadata for region code(s):
280   883, BW, CI, CN, CY, HN, MA, MK, MV, OM
281 - Updated short number metadata for region code(s): FI
282 - Updated geocoding data for country calling code(s): 504 (en)
283 - Updated carrier data for country calling code(s):
284   7 (en, ru), 46 (en), 47 (en), 48 (en), 357 (en), 359 (en), 389 (en),
285   960 (en)
286
287Oct 11, 2022: v8.12.57
288Metadata changes:
289 - Updated phone metadata for region code(s):
290   BJ, EH, GB, GF, GG, JE, MA, MW, SG, SN, SO, ZM
291 - Updated geocoding data for country calling code(s): 229 (en)
292 - Updated carrier data for country calling code(s):
293   27 (en), 34 (en), 47 (en), 65 (en), 212 (en), 252 (en), 260 (en), 594 (en),
294   974 (en)
295 - Updated / refreshed time zone meta data.
296
297Sep 22, 2022: v8.12.56
298Metadata changes:
299 - Updated phone metadata for region code(s): HR, MK, PT, SG, TT
300 - Updated short number metadata for region code(s): BZ
301 - Updated carrier data for country calling code(s):
302   31 (en), 65 (en), 385 (en), 389 (en)
303
304Sep 08, 2022: v8.12.55
305Metadata changes:
306 - Updated phone metadata for region code(s):
307   AU, CA, CC, CI, CO, CX, DE, HK, KW, LV, MV, PA, PL, TZ, US
308 - Updated short number metadata for region code(s): CO, TZ
309 - New geocoding data for country calling code(s): 1742 (en), 1753 (en)
310 - Updated geocoding data for country calling code(s):
311   57 (en), 225 (en), 960 (en)
312 - New carrier data for country calling code(s): 371 (en)
313 - Updated carrier data for country calling code(s):
314   47 (en), 57 (en), 61 (en), 90 (en), 255 (en), 297 (en), 381 (en), 420 (en),
315   972 (en), 974 (en)
316 - Updated / refreshed time zone meta data.
317
318Aug 18, 2022: v8.12.54
319Metadata changes:
320 - Updated phone metadata for region code(s): BE, BF, GE, HN, MX, PT, US
321 - Updated geocoding data for country calling code(s):
322   52 (en), 61 (en), 351 (en)
323 - Updated carrier data for country calling code(s):
324   226 (en), 351 (en), 420 (en), 992 (en), 995 (en)
325
326Aug 04, 2022: v8.12.53
327Metadata changes:
328 - Updated phone metadata for region code(s):
329   AT, BE, CL, CN, GE, GF, GH, HK, JM, PG, RE, US
330 - Updated short number metadata for region code(s): AT
331 - New geocoding data for country calling code(s): 1943 (en)
332 - Updated carrier data for country calling code(s):
333   34 (en), 56 (en), 57 (en), 86 (en), 233 (en), 972 (en), 992 (en)
334 - Updated / refreshed time zone meta data.
335
336Jul 19, 2022: v8.12.52
337Metadata changes:
338 - Updated alternate formatting data for country calling code(s): 49
339 - Updated phone metadata for region code(s):
340   BW, DE, ET, HK, ML, MN, MQ, NP, PE, QA, SG
341 - Updated geocoding data for country calling code(s): 61 (en)
342 - Updated carrier data for country calling code(s):
343   48 (en), 65 (en), 223 (en), 251 (en), 852 (en, zh), 976 (en), 977 (en)
344 - Updated / refreshed time zone meta data.
345
346Jun 28, 2022: v8.12.51
347Metadata changes:
348 - Updated phone metadata for region code(s):
349   800, BJ, BR, CO, EH, FO, GE, GP, KE, KG, MA, MM, MN, MY, NZ, RE, SI, UG, VN
350 - Updated geocoding data for country calling code(s): 57 (en), 61 (en)
351 - Updated carrier data for country calling code(s):
352   60 (en), 254 (en), 262 (en), 298 (en), 386 (en), 421 (en), 976 (en),
353   995 (en), 996 (en)
354 - Updated / refreshed time zone meta data.
355
356Jun 09, 2022: v8.12.50
357Metadata changes:
358 - Updated alternate formatting data for country calling code(s): 380, 49
359 - Updated phone metadata for region code(s):
360   AR, CL, DE, EH, GB, HK, HR, IR, IT, MA, MH, TT, UA, US
361 - New geocoding data for country calling code(s): 1826 (en)
362 - Updated geocoding data for country calling code(s):
363   34 (en, es), 54 (en), 61 (en)
364 - Updated carrier data for country calling code(s):
365   44 (en), 98 (en, fa), 212 (en), 380 (en, uk), 385 (en), 420 (en),
366   852 (en, zh)
367 - Updated / refreshed time zone meta data.
368New Metadata files:
369 - The phone and short number metadata of all regions are available now in
370   CSV format, at resources/metdata directory. This helps in better
371   readability and maintainance compared to RegEx representation for all
372   numbering metadata. The legacy XML metadata files (like
373   PhoneNumberMetadata.xml) are now auto genarated from this data; so now
374   users can also build tools around CSV representation based on their
375   needs/requirements.
376
377May 25, 2022: v8.12.49
378Metadata changes:
379 - Updated phone metadata for region code(s):
380   CA, CM, GB, IL, JM, JP, MA, MV, PG, US
381 - Updated geocoding data for country calling code(s):
382   33 (en), 44 (en), 212 (en, fr), 1310 (en)
383 - Updated carrier data for country calling code(s): 237 (en), 675 (en)
384 - Updated / refreshed time zone meta data.
385
386May 05, 2022: v8.12.48
387Metadata changes:
388 - Updated phone metadata for region code(s):
389   AG, AI, AS, BB, BM, BR, BS, CA, DM, DO, EE, GD, GF, GP, GU, IS, JM, KN, KY,
390   LC, MN, MP, MS, NL, NP, PM, PR, SI, SX, SY, TC, TT, UG, US, VC, VG, VI, YT
391 - New geocoding data for country calling code(s):
392   1263 (en), 1468 (en), 1584 (en), 1656 (en), 1948 (en)
393 - Updated carrier data for country calling code(s):
394   354 (en), 370 (en), 372 (en), 503 (en), 963 (en), 977 (en)
395 - Updated / refreshed time zone meta data.
396
397Apr 19, 2022: v8.12.47
398Metadata changes:
399 - Updated phone metadata for region code(s):
400   AO, BB, FR, GB, GE, GG, HR, JE, MT, NC, PA, SE
401 - Updated carrier data for country calling code(s):
402   33 (en), 41 (en), 46 (en), 244 (en), 351 (en), 385 (en), 420 (en), 974 (en),
403   995 (en), 1246 (en), 1345 (en)
404
405Mar 31, 2022: v8.12.46
406Metadata changes:
407 - Updated phone metadata for region code(s): BJ, JM, PW, SA
408 - Updated short number metadata for region code(s): HU
409 - Updated carrier data for country calling code(s):
410   36 (en), 51 (en), 61 (en), 90 (en), 229 (en), 254 (en), 680 (en), 966 (en)
411
412Mar 10, 2022: v8.12.45
413Metadata changes:
414 - Updated phone metadata for region code(s): BF, EE, JM, RE, SE, US
415 - New geocoding data for country calling code(s): 1464 (en)
416 - Updated carrier data for country calling code(s):
417   46 (en), 55 (en), 226 (en), 262 (en), 353 (en), 372 (en), 373 (en),
418   1345 (en)
419 - Updated / refreshed time zone meta data.
420
421Feb 23, 2022: v8.12.44
422Metadata changes:
423 - Updated phone metadata for region code(s):
424   AG, AI, AS, BB, BM, BS, CA, CV, DM, DO, GD, GU, JM, KN, KY, LC, MP, MS, PR,
425   SC, SX, TC, TT, US, VC, VG, VI
426 - Updated short number metadata for region code(s): BE, PT, SC, SE, US
427 - Updated geocoding data for country calling code(s):
428   61 (en), 238 (en), 1345 (en)
429 - Updated carrier data for country calling code(s): 238 (en), 248 (en)
430
431Feb 09, 2022: v8.12.43
432Metadata changes:
433 - Updated phone metadata for region code(s):
434   BJ, CL, GA, IS, KR, KW, LI, PA, SG, SL
435 - Updated short number metadata for region code(s): MS
436 - Updated geocoding data for country calling code(s): 56 (en, es)
437 - Updated carrier data for country calling code(s):
438   32 (en), 229 (en), 354 (en), 502 (en), 507 (en)
439
440Jan 27, 2022: v8.12.42
441Metadata changes:
442 - Updated phone metadata for region code(s):
443   BG, BI, CF, DZ, GF, GP, HK, IR, MA, MQ, MW, PK, PL, PM, QA, TJ
444 - Updated short number metadata for region code(s):
445   AG, AI, AS, BB, BM, BS, CA, DM, DO, GD, GU, JM, KN, KY, LC, MP, MS, PR, SX,
446   TC, TT, US, VC, VG, VI
447 - Updated geocoding data for country calling code(s): 61 (en), 213 (en)
448 - Updated carrier data for country calling code(s):
449   45 (en), 48 (en), 57 (en), 98 (en, fa), 236 (en), 243 (en), 257 (en),
450   420 (en), 421 (en), 508 (en), 675 (en), 852 (en, zh), 974 (en), 992 (en)
451
452Jan 11, 2022: v8.12.41
453Metadata changes:
454 - Updated phone metadata for region code(s): EH, IL, KE, LA, MA, OM, SG
455 - Updated short number metadata for region code(s): PY
456 - Updated carrier data for country calling code(s):
457   33 (en), 65 (en), 358 (en), 383 (en), 420 (en), 502 (en), 856 (en), 966 (en),
458   968 (en), 974 (en)
459
460Dec 23, 2021: v8.12.40
461Metadata changes:
462 - Updated phone metadata for region code(s): GP, GY, MK, VU
463 - Updated geocoding data for country calling code(s): 389 (en)
464 - Updated carrier data for country calling code(s): 60 (en), 592 (en)
465
466Dec 07, 2021: v8.12.39
467Metadata changes:
468 - Updated phone metadata for region code(s): CO, EH, HK, MA, MU, ZM
469 - Updated carrier data for country calling code(s):
470   57 (en), 81 (en), 852 (en, zh)
471
472Nov 25, 2021: v8.12.38
473Metadata changes:
474 - Updated phone metadata for region code(s):
475   883, AT, BI, BW, CG, EE, EH, HN, HU, LI, LK, MA, PA, PH, SG, TH, TJ
476 - Updated geocoding data for country calling code(s): 61 (en), 504 (en)
477 - Updated carrier data for country calling code(s):
478   51 (en), 65 (en), 370 (en), 992 (en)
479 - Updated / refreshed time zone meta data.
480
481Nov 11, 2021: v8.12.37
482Metadata changes:
483 - Updated phone metadata for region code(s):
484   AU, BD, CC, CX, GB, IT, LI, MQ, SG, US, VA
485 - Updated geocoding data for country calling code(s): 880 (en)
486 - Updated carrier data for country calling code(s):
487   65 (en), 81 (en), 356 (en), 423 (en)
488
489Oct 26, 2021: v8.12.36
490Metadata changes:
491 - Updated phone metadata for region code(s): AZ, GA, HK, JM, KW, RO, TJ, UY
492 - Updated geocoding data for country calling code(s): 994 (en)
493 - Updated carrier data for country calling code(s):
494   40 (en), 41 (en), 252 (en), 852 (en, zh), 965 (en)
495
496Oct 12, 2021: v8.12.35
497Metadata changes:
498 - Updated phone metadata for region code(s): AU, AZ, CC, CO, CX, EH, HN, MA
499 - Updated carrier data for country calling code(s): 994 (en)
500
501Oct 06, 2021: v8.12.34
502Metadata changes:
503 - Updated phone metadata for region code(s): AR, BD, DE, MX, VI
504 - Updated geocoding data for country calling code(s):
505   55 (en), 420 (en), 880 (en), 1340 (en)
506
507Sep 22, 2021: v8.12.33
508Metadata changes:
509 - Updated phone metadata for region code(s):
510   CG, CZ, GE, GF, GR, KR, MT, PA, TH, UG, UZ
511 - Updated geocoding data for country calling code(s): 420 (en)
512 - Updated carrier data for country calling code(s):
513   46 (en), 420 (en), 966 (en)
514
515Sep 09, 2021: v8.12.32
516Metadata changes:
517 - Updated phone metadata for region code(s): CI, GE, RO, SG, US, YT
518 - New geocoding data for country calling code(s): 1582 (en)
519 - Updated carrier data for country calling code(s):
520   40 (en), 65 (en), 262 (en), 356 (en), 503 (en), 995 (en)
521 - Updated / refreshed time zone meta data.
522
523Aug 24, 2021: v8.12.31
524Metadata changes:
525 - Updated phone metadata for region code(s): CO, EE, GB, PH, US
526 - New geocoding data for country calling code(s): 1771 (en)
527 - Updated geocoding data for country calling code(s): 57 (en), 225 (en)
528 - Updated carrier data for country calling code(s):
529   63 (en), 252 (en), 372 (en), 389 (en)
530 - Updated / refreshed time zone meta data.
531
532Aug 17, 2021: v8.12.30
533Metadata changes:
534 - Updated phone metadata for region code(s): 800, AM, GL, KW, SG, SO, SY
535 - Updated carrier data for country calling code(s):
536   55 (en), 65 (en), 252 (en), 263 (en), 963 (en)
537 - Updated / refreshed time zone meta data.
538
539Aug 06, 2021: v8.12.29
540Code changes:
541 - Updated As-You-Type-Formatter to exclude patterns where some digits would be dropped in the output. This also fixes the bug where an extra country code is added in some cases to the user's output. b/183053929
542Metadata changes:
543 - Updated phone metadata for region code(s): BE, GE, IR, MO, MX, QA, SN
544 - Updated geocoding data for country calling code(s): 52 (en)
545 - Updated carrier data for country calling code(s):
546   32 (en), 221 (en), 995 (en)
547 - Updated / refreshed time zone meta data.
548
549Jul 20, 2021: v8.12.28
550Metadata changes:
551 - Updated phone metadata for region code(s):
552   CO, EH, GF, HK, KZ, MA, MO, MU, MX, NG, OM, PH, RU, SG, TO, UG
553 - Updated geocoding data for country calling code(s): 52 (en)
554 - Updated carrier data for country calling code(s):
555   34 (en), 57 (en), 63 (en), 65 (en), 229 (en), 234 (en), 676 (en),
556   852 (en, zh), 968 (en)
557 - Updated / refreshed time zone meta data.
558
559Jul 07, 2021: v8.12.27
560Metadata changes:
561 - Updated phone metadata for region code(s): BW, MG, MW, PL, RO, TO, ZW
562 - Updated short number metadata for region code(s): BW, HU
563 - Updated carrier data for country calling code(s):
564   36 (en), 48 (en), 261 (en), 263 (en), 676 (en)
565
566Jun 23, 2021: v8.12.26
567Metadata changes:
568 - Updated phone metadata for region code(s): DZ, EH, GB, MA, PH, QA
569 - Updated geocoding data for country calling code(s): 212 (en)
570
571Jun 09, 2021: v8.12.25
572Metadata changes:
573 - Updated phone metadata for region code(s):
574   BZ, GB, GH, HN, JM, LU, TJ, US, VU
575 - New geocoding data for country calling code(s): 1448 (en)
576 - Updated geocoding data for country calling code(s): 678 (en)
577 - Updated carrier data for country calling code(s):
578   233 (en), 678 (en), 1876 (en)
579 - Updated / refreshed time zone meta data.
580
581May 26, 2021: v8.12.24
582Code changes:
583 - Changes formatOutOfCountryCallingNumber to always use preferred intl prefix if present, not just for numbers with a non-unique IDD. This means we will output "8~10" as the prefix if calling formatOutOfCountryCallingNumber instead of "810" for some regions that have this tilde in their prefix [designates that the user should wait before continuing to dial].
584Metadata changes:
585 - Updated phone metadata for region code(s):
586   883, AX, FI, GE, IR, PA, PG, PH, SG, SL, UZ
587 - Updated carrier data for country calling code(s):
588   33 (en), 63 (en), 65 (en), 98 (en, fa), 358 (en), 507 (en), 675 (en),
589   995 (en)
590
591May 11, 2021: v8.12.23
592Metadata changes:
593 - Updated phone metadata for region code(s): BF, CI, RW, SG, UG, US, UZ
594 - Updated short number metadata for region code(s): DZ
595 - New geocoding data for country calling code(s): 1572 (en)
596 - Updated geocoding data for country calling code(s): 225 (en)
597 - Updated carrier data for country calling code(s):
598   65 (en), 225 (en), 226 (en), 250 (en), 256 (en), 998 (en)
599 - Updated / refreshed time zone meta data.
600
601Apr 29, 2021: v8.12.22
602Metadata changes:
603 - Updated phone metadata for region code(s):
604   BL, CA, CD, CI, GP, IR, JP, LI, MF, MY, PH, PT, RE
605 - Updated short number metadata for region code(s): FI, PS
606 - New geocoding data for country calling code(s): 1368 (en)
607 - Updated geocoding data for country calling code(s): 49 (de, en), 52 (es)
608 - Updated carrier data for country calling code(s):
609   46 (en), 60 (en), 63 (en), 225 (en), 229 (en), 243 (en), 252 (en), 262 (en),
610   351 (en), 423 (en), 590 (en)
611 - Updated / refreshed time zone meta data.
612
613Apr 05, 2021: v8.12.21
614Metadata changes:
615 - Updated phone metadata for region code(s):
616   BL, EH, GB, GF, GP, MA, MF, MQ, PF, PM, SG, SS, WF
617 - Updated short number metadata for region code(s): DE
618 - Updated carrier data for country calling code(s):
619   65 (en), 211 (en), 212 (en)
620 - Updated / refreshed time zone meta data.
621
622Mar 16, 2021: v8.12.20
623Metadata changes:
624 - Updated phone metadata for region code(s):
625   AR, CA, CL, CM, EH, IM, JP, LB, MA, MC, MY, SG, US
626 - New geocoding data for country calling code(s):
627   961 (en), 1447 (en), 1474 (en), 1840 (en)
628 - Updated geocoding data for country calling code(s): 1854 (en)
629 - Updated carrier data for country calling code(s):
630   56 (en), 60 (en), 65 (en), 84 (en)
631 - Updated / refreshed time zone meta data.
632
633Mar 01, 2021: v8.12.19
634Metadata changes:
635 - Updated phone metadata for region code(s):
636   882, AU, BJ, BW, CC, CX, EH, KZ, MA, MQ, MU, NO, RE, SG, SJ, SL, TJ, TT, US,
637   YT
638 - New geocoding data for country calling code(s): 1945 (en)
639 - Updated geocoding data for country calling code(s): 61 (en), 267 (en)
640 - Updated carrier data for country calling code(s):
641   7 (en), 41 (en), 65 (en), 221 (en), 229 (en), 230 (en), 232 (en), 262 (en),
642   592 (en), 596 (en), 882 (en), 992 (en), 1868 (en)
643 - Updated / refreshed time zone meta data.
644
645Feb 08, 2021: v8.12.18
646Metadata changes:
647 - Updated alternate formatting data for country calling code(s): 676
648 - Updated phone metadata for region code(s): CI, IR, SG, TO
649 - Updated geocoding data for country calling code(s): 225 (en)
650 - Updated carrier data for country calling code(s):
651   65 (en), 225 (en), 676 (en)
652
653Jan 27, 2021: v8.12.17
654Metadata changes:
655 - Updated phone metadata for region code(s): CI, GR, MO, TR, VU
656 - Updated geocoding data for country calling code(s): 225 (en)
657 - Updated carrier data for country calling code(s): 853 (en)
658
659Jan 12, 2021: v8.12.16
660Metadata changes:
661 - Updated phone metadata for region code(s):
662   870, AL, AR, BA, BW, CO, DE, DM, DO, GB, GI, HK, KW, MK, MO, MY, OM, SG, SL,
663   TH
664 - Updated short number metadata for region code(s): AR
665 - Updated geocoding data for country calling code(s): 44 (en)
666 - Updated carrier data for country calling code(s):
667   41 (en), 46 (en), 57 (en), 60 (en), 61 (en), 65 (en), 66 (en), 227 (en),
668   232 (en), 267 (en), 350 (en), 351 (en), 356 (en), 389 (en), 420 (en),
669   852 (en, zh), 853 (en)
670
671Dec 15, 2020: v8.12.15
672Metadata changes:
673 - Updated phone metadata for region code(s): GN, KE, MU, SG
674 - Updated carrier data for country calling code(s):
675   65 (en), 224 (en), 230 (en), 254 (en)
676
677Dec 02, 2020: v8.12.14
678Metadata changes:
679 - Updated phone metadata for region code(s):
680   BA, BW, CG, CO, EH, FO, HN, IL, KE, MA, NZ, SN, TJ, UY
681 - Updated geocoding data for country calling code(s): 57 (en), 504 (en)
682 - Updated carrier data for country calling code(s):
683   46 (en), 212 (en), 221 (en), 242 (en), 254 (en), 298 (en), 972 (en),
684   992 (en)
685
686Nov 12, 2020: v8.12.13
687Metadata changes:
688 - Updated phone metadata for region code(s):
689   CL, DE, FR, GQ, IL, IR, KG, KW, MU, NG, PW, SN, TZ
690 - Updated carrier data for country calling code(s):
691   7 (en), 33 (en), 221 (en), 230 (en), 234 (en), 240 (en), 255 (en), 680 (en),
692   886 (en), 972 (en)
693
694Oct 29, 2020: v8.12.12
695Metadata changes:
696 - Updated phone metadata for region code(s):
697   AG, AI, AS, BB, BM, BS, CA, CI, DM, DO, GB, GD, GG, GU, IR, JE, JM, JP, KE,
698   KN, KY, LC, MP, MS, NP, PK, PR, SA, SX, TC, TT, US, VC, VG, VI, VN, WS
699 - Updated short number metadata for region code(s): JP
700 - Updated geocoding data for country calling code(s): 81 (en, ja)
701 - New carrier data for country calling code(s): 81 (en)
702 - Updated carrier data for country calling code(s):
703   44 (en), 98 (en, fa), 225 (en), 685 (en), 966 (en)
704 - Updated / refreshed time zone meta data.
705
706Oct 07, 2020: v8.12.11
707Metadata changes:
708 - Updated phone metadata for region code(s): CM, HK, ID, LK, PA, PY, TJ, UZ
709 - Updated carrier data for country calling code(s):
710   94 (en), 852 (en, zh), 992 (en), 998 (en)
711 - Updated / refreshed time zone meta data.
712
713Sep 20, 2020: v8.12.10
714Metadata changes:
715 - Updated phone metadata for region code(s):
716   EH, IL, JO, MA, NG, PA, PG, PY, UY
717 - Updated short number metadata for region code(s): SA
718 - Updated geocoding data for country calling code(s): 598 (en)
719 - Updated carrier data for country calling code(s):
720   212 (en), 234 (en), 507 (en), 595 (en), 675 (en), 972 (en)
721
722Aug 30, 2020: v8.12.9
723Metadata changes:
724 - Updated phone metadata for region code(s): CO, GB, IL, SG
725 - Updated short number metadata for region code(s): SA
726 - Updated geocoding data for country calling code(s): 57 (en)
727 - Updated carrier data for country calling code(s): 65 (en), 972 (en)
728
729Aug 12, 2020: v8.12.8
730Metadata changes:
731 - Updated phone metadata for region code(s): HU, NE, PL, SG, SI, TR
732 - Updated short number metadata for region code(s): ID, NE
733 - Updated carrier data for country calling code(s):
734   65 (en), 226 (en), 227 (en)
735
736Jul 20, 2020: v8.12.7
737Metadata changes:
738 - Updated phone metadata for region code(s): ET, HN, KN, NA, SG, US,
739   HK, IR, LI, MU, TR, VN
740 - New geocoding data for country calling code(s): 1326 (en), 1839 (en)
741 - Updated geocoding data for country calling code(s): 380 (en), 504 (en)
742 - Updated carrier data for country calling code(s):
743   65 (en), 234 (en), 1869 (en), 98 (en, fa), 243 (en), 423 (en), 852 (en, zh)
744 - Updated / refreshed time zone meta data.
745 - Note: You will find commit with same release tag on Jul 02, 2020.
746   As that release blocked immediately, we started over new release with same tag.
747 
748Code changes:
749 - [Java only] Added metadata/ folder to only GitHub devleopment version; this
750   will not be part of the release artifacts untill it is complete and ready
751   for usage. More details in its README file.
752
753
754Jun 17, 2020: v8.12.6
755Code changes:
756 - [Java only] Use protobuf API v2 for PhoneMetadata only, mark old methods as deprecated.
757
758Metadata changes:
759 - Updated phone metadata for region code(s): HN, KE, MY, ZA
760 - Updated carrier data for country calling code(s): 48 (en), 60 (en), 65 (en)
761
762Jun 03, 2020: v8.12.5
763Metadata changes:
764 - Updated phone metadata for region code(s): ES, GB, GG, JE, KR, RE, TJ, UZ
765 - Updated geocoding data for country calling code(s): 81 (en)
766 - Updated carrier data for country calling code(s):
767   34 (en), 82 (en, ko), 262 (en), 992 (en), 998 (en)
768
769May 19, 2020: v8.12.4
770Metadata changes:
771 - Updated phone metadata for region code(s):
772   AU, BR, CC, CX, HK, MM, PH, PL, TN
773 - Updated short number metadata for region code(s): FI, GB, TH
774 - Updated geocoding data for country calling code(s): 1242 (en), 1867 (en)
775 - Updated carrier data for country calling code(s):
776   61 (en), 63 (en), 95 (en), 216 (en), 852 (en, zh)
777
778May 06, 2020: v8.12.3
779Metadata changes:
780 - Updated phone metadata for region code(s):
781   AR, AU, CC, CX, GB, GG, GR, JE, MY, SG, SL, SR, TH
782 - Updated short number metadata for region code(s): AR, AU
783 - Updated geocoding data for country calling code(s): 61 (en), 66 (en, th)
784 - Updated carrier data for country calling code(s):
785   60 (en), 61 (en), 65 (en), 232 (en), 597 (en)
786 - Updated / refreshed time zone meta data.
787
788Apr 22, 2020: v8.12.2
789Metadata changes:
790 - Updated phone metadata for region code(s):
791   AL, AR, AU, CC, CX, ET, GE, GH, JM, JP, LA, MM, NZ, QA, SG, ZA
792 - Updated short number metadata for region code(s): AR
793 - New geocoding data for country calling code(s): 995 (en)
794 - Updated geocoding data for country calling code(s): 54 (en), 64 (en)
795 - Updated carrier data for country calling code(s):
796   64 (en), 65 (en), 95 (en), 995 (en), 1876 (en)
797 - Updated / refreshed time zone meta data.
798
799Mar 30, 2020: v8.12.1
800Metadata changes:
801 - Updated phone metadata for region code(s):
802   AG, AI, AS, BB, BD, BM, BS, BW, CA, CL, DM, DO, GB, GD, GU, IL, IR, JM, JO,
803   KN, KY, KZ, LC, MA, MC, MN, MP, MS, NG, NZ, PE, PH, PR, PW, SG, SS, SX, TC,
804   TT, US, VC, VG, VI, VN
805 - New short number metadata for region code(s): SS
806 - New geocoding data for country calling code(s): 63 (en), 1340 (en)
807 - Updated geocoding data for country calling code(s):
808   7 (en, ru), 44 (en), 56 (en, es), 212 (en, fr), 234 (en), 880 (en),
809   1242 (en), 1345 (en), 1659 (en)
810 - New carrier data for country calling code(s):
811   1340 (en), 1659 (en), 1664 (en), 1670 (en)
812 - Updated carrier data for country calling code(s):
813   7 (en, ru), 51 (en), 56 (en), 63 (en), 84 (en), 98 (en, fa), 211 (en),
814   234 (en), 267 (en), 972 (en), 976 (en), 1246 (en), 1264 (en), 1268 (en),
815   1284 (en), 1345 (en), 1441 (en), 1649 (en), 1684 (en), 1758 (en), 1767 (en),
816   1784 (en), 1868 (en), 1869 (en), 1876 (en)
817 - Updated / refreshed time zone meta data.
818
819Mar 18, 2020: v8.12.0
820Code changes:
821 - [JS only] Updates some closure annotations in `phonenumberutil.js` to indicate non-nullable parameters
822Metadata changes:
823 - Updated phone metadata for region code(s):
824   800, 808, 881, 882, 979, AR, AZ, CL, CN, HK, HN, JO, JP, KE, KP, LA, LR, MK,
825   ML, MN, MV, MY, MZ, NP, NZ, PS, SV, SY, TT, TZ, UZ, YE
826 - Updated short number metadata for region code(s): AC, JO, MK, MN, NP, SV, TZ
827 - New geocoding data for country calling code(s):
828   850 (en), 963 (en), 967 (en), 970 (en)
829 - Updated geocoding data for country calling code(s):
830   60 (en), 389 (en), 504 (en), 962 (en)
831 - New carrier data for country calling code(s):
832   247 (en), 500 (en), 504 (en), 850 (en), 881 (en), 882 (en)
833 - Updated carrier data for country calling code(s):
834   56 (en), 60 (en), 64 (en), 86 (en, zh), 223 (en), 231 (en), 258 (en),
835   267 (en), 389 (en), 503 (en), 852 (en, zh, zh_Hant), 856 (en), 960 (en),
836   962 (en), 963 (en), 964 (en), 970 (en), 992 (en), 994 (en), 998 (en),
837   1868 (en)
838 - Updated / refreshed time zone meta data.
839
840Mar 02, 2020: v8.11.5
841Metadata changes:
842 - Updated alternate formatting data for country calling code(s): 595
843 - Updated phone metadata for region code(s):
844   AD, BE, BQ, BW, CA, CI, CM, CR, EC, EE, EG, FM, FO, GL, GN, IL, KI, LK, LT,
845   ME, MO, MT, MW, NE, NF, NR, OM, PA, PF, PG, PK, PY, RO, RW, SC, SD, SG, SK,
846   SL, SO, TL, TM, TO, TV, UG, VE, VU, WS, ZM
847 - Updated short number metadata for region code(s):
848   GN, KI, LK, LT, OM, PK, RO, RW, SH, TM, TR, WS
849 - New geocoding data for country calling code(s):
850   92 (en), 236 (en), 593 (en), 595 (en), 598 (en), 670 (en), 672 (en),
851   678 (en), 685 (en), 689 (en), 690 (en), 993 (en), 1367 (en)
852 - Updated geocoding data for country calling code(s):
853   43 (en), 58 (en, es), 94 (en), 221 (en), 224 (en), 225 (en), 233 (en),
854   252 (en), 264 (en), 290 (en, fr), 352 (de, en), 370 (en), 374 (en, hy, ru),
855   421 (en), 599 (en), 686 (en)
856 - New carrier data for country calling code(s):
857   246 (en), 266 (en), 290 (en), 291 (en), 377 (en), 378 (en), 672 (en),
858   676 (en), 681 (en), 683 (en), 687 (en), 690 (en), 691 (en), 692 (en)
859 - Updated carrier data for country calling code(s):
860   40 (en), 43 (en), 48 (en), 65 (en), 92 (en), 222 (en), 225 (en), 227 (en),
861   229 (en), 230 (en), 232 (en), 233 (en), 236 (en), 256 (en), 265 (en),
862   267 (en), 268 (en), 298 (en), 370 (en), 372 (en), 376 (en), 381 (en),
863   383 (en), 421 (en), 502 (en), 506 (en), 507 (en), 592 (en), 593 (en),
864   598 (en), 599 (en), 670 (en), 674 (en), 675 (en), 678 (en), 685 (en),
865   686 (en), 853 (en), 968 (en), 972 (en), 993 (en)
866 - Updated / refreshed time zone meta data.
867
868Feb 12, 2020: v8.11.4
869Metadata changes:
870 - Updated phone metadata for region code(s):
871   AZ, BJ, CL, ET, GB, MA, MM, PW, RE, SG
872 - Updated geocoding data for country calling code(s): 680 (en)
873 - Updated carrier data for country calling code(s):
874   56 (en), 95 (en), 229 (en), 262 (en), 680 (en), 994 (en)
875
876Jan 28, 2020: v8.11.3
877Metadata changes:
878 - Updated phone metadata for region code(s): GB, GG, JE, MM, MU, US
879 - New geocoding data for country calling code(s): 1659 (en)
880 - Updated carrier data for country calling code(s): 95 (en)
881 - Updated / refreshed time zone meta data.
882
883Jan 14, 2020: v8.11.2
884Metadata changes:
885 - Updated phone metadata for region code(s):
886   BF, CA, EH, GM, KR, MA, ML, NG, NZ, SE, SG, TJ, TR, TT
887 - New geocoding data for country calling code(s): 1672 (en)
888 - Updated geocoding data for country calling code(s): 220 (en)
889 - Updated carrier data for country calling code(s):
890   65 (en), 212 (en), 220 (en), 226 (en), 234 (en), 992 (en), 1868 (en)
891 - Updated / refreshed time zone meta data.
892
893Dec 10, 2019: v8.11.1
894Metadata changes:
895 - Updated phone metadata for region code(s):
896   AR, DO, DZ, FR, GA, GE, GI, IL, KW, LB, MA, RO, SG, ZA
897 - Updated short number metadata for region code(s): FR
898 - Updated geocoding data for country calling code(s): 33 (en, fr), 54 (en)
899 - Updated carrier data for country calling code(s):
900   27 (en), 33 (en), 36 (en), 65 (en), 213 (en), 961 (en), 972 (en), 995 (en)
901
902Nov 26, 2019: v8.11.0
903Metadata changes:
904 - Updated alternate formatting data for country calling code(s): 91
905 - Updated phone metadata for region code(s):
906   AF, AL, AR, AX, AZ, BA, BE, BH, BI, BL, BN, CK, CO, CU, CV, DK, EH, ET, FI,
907   FR, GA, GB, GF, GH, GI, GP, GR, HR, IE, IN, IR, IS, JO, KG, KM, KR, KW, LI,
908   LY, MA, MD, MF, MM, MQ, NO, PT, QA, RE, SG, TW, YT, ZM, ZW
909 - Updated short number metadata for region code(s):
910   AF, AW, BE, CN, CO, DE, ET, GR, KR, MD, NO, PT, SG, TW
911 - New geocoding data for country calling code(s):
912   386 (en), 673 (en), 679 (en), 682 (en), 971 (en)
913 - Updated geocoding data for country calling code(s):
914   34 (en, es), 46 (en), 47 (en), 91 (en), 216 (en), 218 (en), 241 (en),
915   251 (en), 353 (en), 354 (en), 886 (en, zh), 996 (en)
916 - New carrier data for country calling code(s):
917   46 (en), 82 (en, ko), 218 (en), 501 (en), 682 (en)
918 - Updated carrier data for country calling code(s):
919   30 (en), 31 (en), 32 (en), 34 (en), 39 (en), 41 (en), 44 (en), 45 (en),
920   47 (en), 49 (en), 53 (en), 55 (en), 57 (en), 65 (en), 66 (en), 91 (en),
921   95 (en), 98 (en, fa), 212 (en), 226 (en), 233 (en), 235 (en), 237 (en),
922   241 (en), 242 (en), 243 (en), 262 (en), 297 (en), 350 (en), 351 (en),
923   353 (en), 354 (en), 358 (en), 359 (en), 373 (en), 385 (en), 386 (en),
924   420 (en), 423 (en), 508 (en), 590 (en), 673 (en), 855 (en), 886 (en),
925   966 (en), 973 (en), 974 (en), 994 (en), 996 (en)
926 - Updated / refreshed time zone meta data.
927
928Nov 13, 2019: v8.10.23
929Metadata changes:
930 - Updated phone metadata for region code(s): AL, AR, XK
931 - Updated carrier data for country calling code(s): 383 (en)
932
933Oct 29, 2019: v8.10.22
934Metadata changes:
935 - Updated phone metadata for region code(s): DM, DO, MM, OM, VN, ZM
936 - Updated short number metadata for region code(s): GR
937 - Updated carrier data for country calling code(s):
938   95 (en), 260 (en), 968 (en)
939
940Oct 16, 2019: v8.10.21
941Metadata changes:
942 - Updated phone metadata for region code(s):
943   BF, CI, HN, KW, MM, MY, SG, SI, TJ, ZW
944 - Updated geocoding data for country calling code(s): 52 (en), 95 (en)
945 - Updated carrier data for country calling code(s):
946   60 (en), 65 (en), 225 (en), 226 (en), 386 (en), 992 (en)
947
948Oct 02, 2019: v8.10.20
949Metadata changes:
950 - Updated phone metadata for region code(s):
951   AU, BO, CC, CX, DM, GM, HN, PH, US
952 - New geocoding data for country calling code(s): 1341 (en)
953 - Updated carrier data for country calling code(s): 220 (en)
954 - Updated / refreshed time zone meta data.
955
956Sep 17, 2019: v8.10.19
957Metadata changes:
958 - Updated phone metadata for region code(s): EH, GE, GR, HU, IL, IR, MA, US
959 - Updated short number metadata for region code(s): ET
960 - New geocoding data for country calling code(s): 1689 (en)
961 - Updated carrier data for country calling code(s): 31 (en), 995 (en)
962 - Updated / refreshed time zone meta data.
963
964Sep 03, 2019: v8.10.18
965Metadata changes:
966 - Updated phone metadata for region code(s): BR, HU, KG, KR, MV, SG, VN
967 - Updated short number metadata for region code(s): BR, IL
968 - Updated carrier data for country calling code(s): 65 (en), 996 (en)
969
970Aug 15, 2019: v8.10.17
971Metadata changes:
972 - MX numbering authority has changed dialling patterns to be more
973   uniform i.e additional domestic (01 and 044) and international
974   mobile tokens (1) are abolished now. The parsing and formatting
975   changes were done as part of this release. We recommend to
976   follow the steps mentioned in our announcement for same:
977   https://groups.google.com/forum/#!topic/libphonenumber-discuss/pecTIo_HpVE
978 - Updated phone metadata for region code(s): AM, MM, MX
979 - Updated short number metadata for region code(s): TH
980 - Updated carrier data for country calling code(s):
981   86 (en, zh, zh_Hant), 95 (en), 374 (en, ru)
982For users who depend on JavaScript port:
983 - Please patch in PR #2380 to fix AYTF output that otherwise
984   swallows the entered old mobile token (1) at the last step.
985Code changes:
986 - AsYouTypeFormatter changed to ensure that the output never adds new digits or swallows digits.
987 - MX mobile token no longer returned by getCountryMobileToken
988
989Aug 01, 2019: v8.10.16
990Metadata changes:
991 - Updated alternate formatting data for country calling code(s): 676
992 - Updated phone metadata for region code(s):
993   AU, CC, CL, CX, GB, IL, KW, MK, NE, TJ, TT, TW, VI
994 - Updated carrier data for country calling code(s):
995   56 (en), 61 (en), 65 (en), 227 (en), 972 (en), 992 (en), 1868 (en)
996
997Jul 15, 2019: v8.10.15
998Metadata changes:
999 - Updated alternate formatting data for country calling code(s): 676
1000 - Updated phone metadata for region code(s):
1001   AM, BG, EH, IR, IT, MA, MM, MT, SL, TO, UG, VA, VN
1002 - New geocoding data for country calling code(s): 676 (en)
1003 - Updated geocoding data for country calling code(s):
1004   95 (en), 212 (en, fr), 232 (en), 374 (en, hy, ru)
1005 - Updated carrier data for country calling code(s):
1006   95 (en), 212 (en), 232 (en), 256 (en), 356 (en)
1007
1008Jun 13, 2019: v8.10.14
1009Metadata changes:
1010 - Updated phone metadata for region code(s):
1011   BF, BJ, BR, IM, KE, KZ, MN, MX, PH, RE, VN
1012 - Updated short number metadata for region code(s): FR
1013 - Updated geocoding data for country calling code(s): 55 (en)
1014 - Updated carrier data for country calling code(s):
1015   7 (en, ru), 44 (en), 63 (en), 226 (en), 229 (en), 254 (en), 262 (en),
1016   976 (en)
1017
1018May 29, 2019: v8.10.13
1019Metadata changes:
1020 - Updated phone metadata for region code(s): AU, CC, CI, CX, DE, HK
1021 - Updated carrier data for country calling code(s): 61 (en), 225 (en)
1022
1023May 10, 2019: v8.10.12
1024Metadata changes:
1025 - Updated phone metadata for region code(s): CL, HK, MU, NE
1026 - Updated carrier data for country calling code(s): 230 (en)
1027
1028Apr 30, 2019: v8.10.11
1029Metadata changes:
1030 - Updated phone metadata for region code(s): CU, EH, MA
1031 - Updated short number metadata for region code(s): CU
1032 - Updated geocoding data for country calling code(s): 53 (en)
1033
1034Apr 15, 2019: v8.10.10
1035Metadata changes:
1036 - Updated phone metadata for region code(s):
1037   BW, CL, DE, ET, IN, NG, PF, TW, VN
1038 - Updated short number metadata for region code(s): KI
1039 - Updated geocoding data for country calling code(s):
1040   251 (en), 267 (en), 886 (en, zh, zh_Hant)
1041 - Updated carrier data for country calling code(s): 234 (en), 689 (en)
1042 - Updated / refreshed time zone meta data.
1043
1044Apr 02, 2019: v8.10.9
1045Metadata changes:
1046 - Updated alternate formatting data for country calling code(s): 380, 44, 49
1047 - Updated phone metadata for region code(s): AU, BD, CC, CN, CX, EC, ID, PE
1048 - Updated carrier data for country calling code(s): 51 (en), 593 (en)
1049
1050Mar 19, 2019: v8.10.8
1051* Code changes
1052  - Making the application of alternate formats when finding phone numbers in
1053    text in strict-grouping and exact-match mode depend on the leading digits
1054    for each rule. This was always assumed but never actually done. This means
1055    that the false positive rate will decrease but also that more valid numbers
1056    are skipped. A subsequent CL will update patterns to increase recall.
1057Metadata changes:
1058 - Updated alternate formatting data for country calling code(s):
1059   255, 27, 31, 34, 351, 352, 358, 359, 36, 372, 380, 381, 385, 39, 43, 44, 49,
1060   506, 52, 54, 55, 595, 61, 62, 64, 66, 675, 676, 679, 7, 81, 84, 856, 90, 91,
1061   94, 95, 971, 972, 995
1062 - Updated phone metadata for region code(s):
1063   AC, AU, CC, CN, CX, EH, GE, JM, JP, KE, KG, MA, NO, PH, SJ, UA, UZ, ZW
1064 - Updated short number metadata for region code(s): TW
1065 - New carrier data for country calling code(s): 1658 (en)
1066 - Updated carrier data for country calling code(s):
1067   65 (en), 380 (en, uk), 996 (en), 1876 (en)
1068
1069Mar 06, 2019: v8.10.7
1070Metadata changes:
1071 - Updated phone metadata for region code(s): BD, BH, HN, MM, PH, ZW
1072 - Updated geocoding data for country calling code(s): 90 (en, tr), 95 (en)
1073 - Updated carrier data for country calling code(s): 63 (en), 64 (en)
1074
1075Feb 21, 2019: v8.10.6
1076Metadata changes:
1077 - Updated phone metadata for region code(s):
1078   CN, IR, JM, KE, KR, KZ, LI, VN
1079 - Updated geocoding data for country calling code(s): 86 (en, zh)
1080 - Updated carrier data for country calling code(s):
1081   84 (en), 86 (en, zh, zh_Hant), 423 (en)
1082 - Updated / refreshed time zone meta data.
1083
1084Feb 06, 2019: v8.10.5
1085Metadata changes:
1086 - Updated phone metadata for region code(s):
1087   AE, AG, AI, AM, AR, AS, AT, AU, AZ, BA, BB, BE, BG, BM, BO, BR, BS, BT, BW,
1088   BY, CG, CH, CL, CO, DE, DM, DZ, ES, FI, FR, GB, GD, GE, GR, GU, HN, HR, IE,
1089   IL, IN, IT, JM, JO, JP, KG, KN, KP, KR, KY, LC, LI, LK, LT, LU, MA, MC, MD,
1090   MG, MM, MP, MS, MU, MV, MW, MX, MY, NA, NC, NE, NF, NL, NO, NZ, PE, PH, PL,
1091   PY, RO, RU, SA, SB, SC, SE, SG, SI, SK, SM, SN, SO, SR, SX, TC, TJ, TM, TO,
1092   TR, TT, TZ, UG, UY, VC, VG, VI, VN, XK, ZM, ZW
1093 - Updated short number metadata for region code(s): BR, TH
1094 - Updated geocoding data for country calling code(s): 54 (en), 55 (en, pt)
1095 - Updated carrier data for country calling code(s): 55 (en)
1096 - Updated / refreshed time zone meta data.
1097
1098Jan 24, 2019: v8.10.4
1099Metadata changes:
1100 - Updated phone metadata for region code(s):
1101   AR, AT, BH, BI, CL, CN, CW, CZ, DE, FI, FM, HK, KR, LA, LU, ML, NC, NE, PA,
1102   SB, TT, ZW
1103 - Updated short number metadata for region code(s): AR, KR
1104 - Updated geocoding data for country calling code(s): 54 (en, es), 686 (en)
1105 - Updated carrier data for country calling code(s):
1106   254 (en), 507 (en), 599 (en), 880 (en)
1107
1108Jan 08, 2019: v8.10.3
1109Code changes:
1110 - Better documentation for getLengthOfNationalDestinationCode to emphasise that
1111   not every number has one.
1112 - Removed unused code in the AsYouTypeFormatter: We no longer have numbers in
1113   formatting matching patterns, only \d.
1114Metadata changes:
1115 - Updated phone metadata for region code(s):
1116   EG, GM, HK, LR, MM, NG, SD, UZ, VN, VU
1117 - Updated geocoding data for country calling code(s): 249 (en)
1118 - Updated carrier data for country calling code(s):
1119   84 (en), 95 (en), 220 (en), 231 (en), 852 (en, zh, zh_Hant), 965 (ar)
1120 - Updated / refreshed time zone meta data.
1121
1122Dec 06, 2018: v8.10.2
1123Metadata changes:
1124 - Updated phone metadata for region code(s):
1125   882, AE, AL, AR, BD, BR, CN, ID, IN, JM, LK, MG, MU, MX, OM, SI, UA, ZW
1126 - Updated short number metadata for region code(s): IN, MG, MX, SI
1127 - Updated geocoding data for country calling code(s): 52 (en, es), 261 (en)
1128 - Updated carrier data for country calling code(s):
1129   66 (en), 91 (en), 386 (en), 968 (en)
1130 - Updated / refreshed time zone meta data.
1131
1132Nov 21, 2018: v8.10.1
1133Metadata changes:
1134 - Updated phone metadata for region code(s):
1135   AE, AL, AT, AX, BW, BY, CC, CL, CN, CX, DE, FI, FR, GB, GG, HN, IM, IN, IR,
1136   JE, LA, LI, LT, MM, MN, MY, NZ, PK, SE, SK, SM, UZ, VN, ZM, ZW
1137 - Updated short number metadata for region code(s):
1138   AT, AX, BY, CF, CL, DE, ER, FI, FM, FR, GA, IN, IR, LI, LT, MM, MN, MY, NE,
1139   NZ, OM, PK, SE, SM, UZ, ZA, ZM, ZW
1140 - Updated geocoding data for country calling code(s):
1141   33 (en), 43 (de, en), 49 (en), 52 (en), 60 (en), 64 (en), 91 (en), 263 (en),
1142   358 (en, sv), 370 (en)
1143 - Updated carrier data for country calling code(s):
1144   44 (en), 56 (en), 60 (en), 64 (en), 84 (en), 91 (en), 92 (en), 95 (en),
1145   98 (en, fa), 260 (en), 267 (en), 358 (en), 370 (en), 423 (en), 976 (en),
1146   998 (en)
1147 - Updated / refreshed time zone meta data.
1148
1149Oct 31, 2018: v8.10.0
1150Code changes:
1151 - AsYouTypeFormatter changed to better choose between rules when dialling
1152   locally; previously we used the international rules when the national prefix
1153   was present since this would exclude the local-only rules. However, there are
1154   some numbers that are not internationally diallable that *do* use the
1155   national prefix, and this logic precluded formatting them correctly.
1156Metadata changes:
1157 - Updated phone metadata for region code(s):
1158   AU, BB, BD, BO, CC, CO, CR, CU, CX, EC, EG, ER, ET, FO, GB, GE, GG, GH, GQ,
1159   HR, HU, IE, IL, IM, IN, IQ, JE, KE, KG, KH, KI, KP, KZ, LA, LI, LK, LR, LU,
1160   LY, MC, ME, MK, ML, MM, MU, NE, NF, NG, NO, NP, PE, PF, PG, PH, PL, PS, PY,
1161   RS, RU, SA, SD, SE, SI, SJ, SL, SO, SY, TJ, TM, TR, TW, UA, UG, UY, VA, VE,
1162   VN, VU, YE, ZM
1163 - Updated short number metadata for region code(s):
1164   AU, BB, BD, BO, CC, CO, CR, CU, CX, EC, EG, ER, ET, FO, GB, GE, GG, GH, HR,
1165   HU, IE, IL, IM, IQ, JE, KE, KG, KH, KI, KP, KZ, LA, LK, LU, LY, ME, MK, ML,
1166   MU, NE, NF, NG, NO, NP, PE, PF, PG, PH, PL, PS, PY, RS, RU, SA, SD, SI, SJ,
1167   SL, SO, SY, TJ, TR, TW, UA, UG, UY, VE, YE
1168 - Updated geocoding data for country calling code(s):
1169   7 (en, ru), 44 (en), 47 (en), 58 (en, es), 61 (en), 90 (en, tr), 94 (en),
1170   218 (en), 223 (en), 227 (en), 230 (en), 233 (en), 240 (en), 249 (en),
1171   251 (en), 252 (en), 254 (en), 352 (de, en, fr), 380 (en, uk), 382 (en),
1172   675 (en), 880 (en), 886 (en, zh, zh_Hant), 992 (en), 996 (en)
1173 - Updated carrier data for country calling code(s):
1174   7 (en, ru), 44 (en), 51 (en), 57 (en), 61 (en), 63 (en), 90 (en), 223 (en),
1175   230 (en), 232 (en), 233 (en), 234 (en), 240 (en), 252 (en), 254 (en),
1176   256 (en), 260 (en), 352 (en), 385 (en), 386 (en), 389 (en), 506 (en),
1177   593 (en), 595 (en), 886 (en), 963 (en), 972 (en), 992 (en), 995 (en),
1178   996 (en)
1179 - Updated / refreshed time zone meta data.
1180
1181Oct 16, 2018: v8.9.16
1182Metadata changes:
1183 - Updated phone metadata for region code(s):
1184   AF, AO, BA, BB, BG, BM, BS, BT, CA, CN, DM, DO, GD, GU, HN, ID, IL, JM, KE,
1185   KR, KY, LC, MP, TT, US, VG, VI
1186 - Updated short number metadata for region code(s):
1187   AC, AG, AI, AO, AS, BA, BB, BG, BH, BM, BS, BT, CA, CH, DM, DO, EE, GD, GI,
1188   GU, ID, IS, JM, KN, KY, LC, MP, MS, PR, SX, TC, TH, TT, US, VC, VG, VI
1189 - Updated geocoding data for country calling code(s):
1190   62 (en), 244 (en, pt), 247 (en), 359 (bg, en), 387 (bs, en, sr), 1 (en)
1191 - New carrier data for country calling code(s): 380 (uk)
1192 - Updated carrier data for country calling code(s):
1193   62 (en), 91 (en), 387 (en), 975 (en), 1 (en)
1194 - Updated / refreshed time zone meta data.
1195
1196Oct 03, 2018: v8.9.15
1197Metadata changes:
1198 - Updated phone metadata for region code(s):
1199   AE, AF, AL, AM, AX, AZ, BE, CD, CH, CL, EH, FI, GQ, HN, JO, JP, LB, LR, MW,
1200   NL, OM, RE, RO, SE, TZ, VA, YT, ZA, ZW
1201 - Updated short number metadata for region code(s): AE, AF, AL, AM, AZ
1202 - Updated geocoding data for country calling code(s):
1203   263 (en), 355 (en), 374 (en, hy, ru), 380 (en)
1204 - Updated carrier data for country calling code(s):
1205   32 (en), 84 (en), 240 (en), 374 (en, ru), 994 (en)
1206
1207Sep 18, 2018: v8.9.14
1208Metadata changes:
1209 - Updated phone metadata for region code(s):
1210   AO, EE, HN, IL, IN, MY, SB, UG, VN
1211 - Updated carrier data for country calling code(s):
1212   IN, RO, SB, TZ
1213 - Updated / refreshed time zone meta data.
1214
1215Sep 05, 2018: v8.9.13
1216Metadata changes:
1217 - Updated phone metadata for region code(s):
1218   BD, BE, CZ, KR, MU, NA, NL, PG, VN
1219 - Updated carrier data for country calling code(s):
1220   32 (en), 60 (en), 62 (en), 84 (en), 241 (en), 264 (en), 357 (en), 675 (en),
1221   678 (en), 973 (en)
1222
1223Aug 21, 2018: v8.9.12
1224Code changes:
1225 - Support Russian extension character "доб" as a valid one while parsing
1226   the numbers.
1227Metadata changes:
1228 - Updated phone metadata for region code(s):
1229   AU, BD, CC, CL, CX, FR, GI, IN, MY, NL, SA, US, VN
1230 - Updated short number metadata for region code(s): MY
1231 - New geocoding data for country calling code(s): 1640 (en)
1232 - Updated geocoding data for country calling code(s): 880 (en)
1233 - Updated carrier data for country calling code(s):
1234   33 (en), 84 (en), 91 (en), 350 (en), 880 (en)
1235
1236Jul 25, 2018: v8.9.11
1237Metadata changes:
1238 - Updated phone metadata for region code(s):
1239   AU, CC, CX, HK, IT, KE, KW, MM, NL, LU, VA
1240 - Updated short number metadata for region code(s):
1241   HK
1242 - New geocoding data for country calling code(s): 1975 (en)
1243 - Updated geocoding data for country calling code(s): 39 (en, it)
1244 - Updated carrier data for country calling code(s):
1245   254 (en), 351 (en), 852 (en, zh, zh_Hant)
1246
1247Jul 10, 2018: v8.9.10
1248Metadata changes:
1249 - Updated phone metadata for region code(s): AT, GB, IN, KE, MM, VN
1250 - Updated short number metadata for region code(s): EE, IN, ZW
1251 - Updated geocoding data for country calling code(s): 95 (en)
1252 - Updated carrier data for country calling code(s): 91 (en), 254 (en)
1253 - Updated / refreshed time zone meta data.
1254
1255Jun 26, 2018: v8.9.9
1256Metadata changes:
1257 - Updated phone metadata for region code(s): KG, NU, SE, VN
1258 - Updated short number metadata for region code(s): AL, AR, EE, FR, NU, ZW
1259 - New geocoding data for country calling code(s): 996 (en)
1260 - Updated geocoding data for country calling code(s): 52 (es)
1261 - Updated carrier data for country calling code(s): 58 (en), 996 (en)
1262 - Updated / refreshed time zone meta data.
1263
1264Jun 13, 2018: v8.9.8
1265Metadata changes:
1266 - Updated phone metadata for region code(s):
1267   AG, AI, AS, BB, BL, BM, BS, CA, CI, DM, DO, GD, GF, GP, GU, IL, JM, KN, KY,
1268   LC, MF, MP, MQ, MS, PR, SE, SX, TC, TT, US, VC, VG, VI, VN
1269 - Updated short number metadata for region code(s):
1270   AL, AU, FR, KE, NZ, TH, UA, ZA
1271 - New geocoding data for country calling code(s): 385 (en), 880 (en)
1272 - Updated geocoding data for country calling code(s): 27 (en), 225 (en)
1273 - Updated carrier data for country calling code(s):
1274   84 (en), 225 (en), 380 (en), 385 (en), 886 (en), 972 (en)
1275
1276May 29, 2018: v8.9.7
1277Metadata changes:
1278 - Updated phone metadata for region code(s):
1279   AX, BI, FI, HK, IR, ME, MO, NL, RE, UG, YT
1280 - Updated short number metadata for region code(s): AR, ME, PM, ZA
1281 - New geocoding data for country calling code(s): 60 (en), 380 (uk), 382 (en)
1282 - Updated geocoding data for country calling code(s):
1283   267 (en), 380 (en), 504 (en)
1284 - Updated carrier data for country calling code(s):
1285   257 (en), 262 (en), 380 (en), 852 (en, zh, zh_Hant), 853 (en)
1286
1287May 15, 2018: v8.9.6
1288Metadata changes:
1289 - Updated phone metadata for region code(s): IL, IN, NO, TR
1290 - Updated short number metadata for region code(s): FR, TR
1291 - New geocoding data for country calling code(s): 1445 (en)
1292 - Updated geocoding data for country calling code(s): 1345 (en)
1293 - Updated carrier data for country calling code(s):
1294   91 (en), 972 (en), 1869 (en)
1295
1296May 02, 2018: v8.9.5
1297Metadata changes:
1298 - Updated phone metadata for region code(s):
1299   AD, AR, EC, FR, HK, IN, KG, LA, ML, PA, SD, SL, TH, TN, US, VI, WS
1300 - Updated short number metadata for region code(s): HK, WS
1301 - New geocoding data for country calling code(s): 1820 (en)
1302 - Updated geocoding data for country calling code(s): 54 (en, es)
1303 - Updated carrier data for country calling code(s):
1304   30 (en), 91 (en), 93 (fa), 223 (en), 232 (en), 249 (en), 374 (ru), 685 (en),
1305   852 (en, zh, zh_Hant), 995 (en), 996 (en), 1649 (en)
1306
1307Apr 17, 2018: v8.9.4
1308Code changes:
1309 - Update formatNumberForMobileDialing() to return international format instead of national format for Uzbek phone numbers.
1310Metadata changes:
1311 - Updated phone metadata for region code(s):
1312   AG, AM, BR, CN, EC, GE, IN, IS, MX, MY, NE, PA, PY, SZ, TO, VC, ZW
1313 - Updated short number metadata for region code(s): BD
1314 - Updated geocoding data for country calling code(s): 268 (en)
1315 - Updated carrier data for country calling code(s):
1316   91 (en), 354 (en), 507 (en), 593 (en), 595 (en), 995 (en), 1268 (en),
1317   1284 (en)
1318
1319Apr 04, 2018: v8.9.3
1320Metadata changes:
1321 - Updated phone metadata for region code(s):
1322   AF, AM, BE, BF, CG, DE, EH, GP, IN, IR, KE, MA, ML, MV, TG, TR, TV
1323 - Updated short number metadata for region code(s): BE
1324 - New carrier data for country calling code(s): 688 (en)
1325 - Updated carrier data for country calling code(s):
1326   91 (en), 93 (en), 212 (en), 223 (en), 226 (en), 254 (en), 385 (en)
1327
1328Mar 13, 2018: v8.9.2
1329Metadata changes:
1330 - Updated phone metadata for region code(s): CA, IN, KG, PA, SL
1331 - Updated carrier data for country calling code(s):
1332   91 (en), 232 (en), 996 (en)
1333
1334Mar 06, 2018: v8.9.1
1335Metadata changes:
1336 - Updated phone metadata for region code(s): CL, FR, HK, IN, MU, MY
1337 - Updated carrier data for country calling code(s):
1338   91 (en), 225 (en), 230 (en)
1339
1340Feb 20, 2018: v8.9.0
1341Code changes:
1342 - Ported ShortNumberInfo to Javascript.
1343Metadata changes:
1344 - Updated phone metadata for region code(s):
1345   BD, BJ, CI, CN, IN, KW, SD, TG, TR, US
1346 - New geocoding data for country calling code(s): 1279 (en)
1347 - Updated carrier data for country calling code(s):
1348   90 (en), 91 (en), 225 (en), 228 (en), 229 (en), 249 (en), 976 (en)
1349 - Updated / refreshed time zone meta data.
1350
1351Feb 06, 2018: v8.8.11
1352Metadata changes:
1353 - New phone metadata for region code(s): XK
1354 - Updated phone metadata for region code(s): BE, CV, ET, GW, HK, IN, MW, TT
1355 - New short number metadata for region code(s): XK
1356 - Updated short number metadata for region code(s): IS, ZA
1357 - New geocoding data for country calling code(s): 383 (en, sq, sr)
1358 - New carrier data for country calling code(s): 383 (en)
1359 - Updated carrier data for country calling code(s):
1360   32 (en), 91 (en), 238 (en), 245 (en), 251 (en)
1361
1362Jan 23, 2018: v8.8.10
1363Metadata changes:
1364 - Updated phone metadata for region code(s):
1365   BJ, DE, HK, IN, IR, MM, MY, PW, SA, SI
1366 - New geocoding data for country calling code(s): 680 (en)
1367 - Updated geocoding data for country calling code(s): 966 (ar, en)
1368 - New carrier data for country calling code(s): 34 (en), 680 (en)
1369 - Updated carrier data for country calling code(s):
1370   41 (en), 91 (en), 95 (en), 98 (en, fa), 229 (en), 250 (en), 381 (en),
1371   386 (en), 852 (en, zh, zh_Hant)
1372
1373Jan 09, 2018: v8.8.9
1374Metadata changes:
1375 - Updated phone metadata for region code(s):
1376   AG, AI, AS, AX, BA, BB, BL, BM, BS, CA, CC, CN, CX, DM, DO, FI, FJ, GD, GF,
1377   GP, GR, GU, HK, ID, IN, IS, JM, KN, KY, LC, MF, MK, MP, MQ, MS, NL, NP, NZ,
1378   PM, PR, RE, RO, SX, TC, TG, TT, US, VC, VG, VI, YT, ZM, ZW
1379 - Updated short number metadata for region code(s): GB, GG, JE, ZW
1380 - New geocoding data for country calling code(s): 387 (bs, en, hr, sr)
1381 - Updated geocoding data for country calling code(s):
1382   31 (en, nl), 61 (en), 263 (en), 381 (sr)
1383 - New carrier data for country calling code(s): 502 (en)
1384 - Updated carrier data for country calling code(s):
1385   30 (en), 40 (en), 86 (en, zh, zh_Hant), 91 (en), 228 (en), 262 (en),
1386   354 (en), 355 (en), 359 (en), 386 (en), 387 (en), 389 (en), 508 (en),
1387   590 (en), 594 (en), 596 (en), 977 (en)
1388
1389Dec 06, 2017: v8.8.8
1390Metadata changes:
1391 - Updated phone metadata for region code(s): JM, MY
1392 - Updated short number metadata for region code(s): US, ZA
1393 - Updated carrier data for country calling code(s):
1394   86 (en, zh, zh_Hant), 98 (en, fa)
1395
1396Nov 28, 2017: v8.8.7
1397Build changes:
1398 - C++ library can now be built as 32- and 64-bit RPMs (#643).
1399Metadata changes:
1400 - Updated phone metadata for region code(s):
1401   AX, CC, CX, EH, FI, GU, HK, IN, IR, MA, SM, ZM
1402 - Updated short number metadata for region code(s): AU, HR
1403 - Updated carrier data for country calling code(s):
1404   7 (en, ru), 27 (en), 91 (en), 212 (en), 852 (en, zh, zh_Hant)
1405
1406Nov 14, 2017: v8.8.6
1407Metadata changes:
1408 - Updated alternate formatting data for country calling code(s):
1409   34, 62, 91, 94, 971, 972
1410 - Updated phone metadata for region code(s):
1411   AE, AR, AU, BB, BN, BR, BW, BY, BZ, CC, CL, CW, CX, DE, EC, EG, ET, GB, GE,
1412   GG, GP, HK, HR, ID, IE, IL, IN, JO, KH, LK, LU, LV, LY, MG, MO, MR, MY, NL,
1413   NR, OM, PH, PK, PM, PS, RE, RU, RW, SA, SE, SG, SH, SK, SM, TH, TJ, UZ, VN,
1414   ZM, ZW
1415 - New geocoding data for country calling code(s): 61 (en)
1416 - Updated geocoding data for country calling code(s): 20 (en)
1417 - New carrier data for country calling code(s): 674 (en)
1418 - Updated carrier data for country calling code(s):
1419   61 (en), 91 (en), 234 (en), 593 (en), 1246 (en)
1420 - Updated / refreshed time zone meta data.
1421
1422Oct 30, 2017: v8.8.5
1423Metadata changes:
1424 - Updated phone metadata for region code(s): AW, CA, CN, MV, NL, TR, UG
1425 - Updated short number metadata for region code(s): TR
1426 - Updated carrier data for country calling code(s):
1427   86 (en, zh, zh_Hant), 297 (en)
1428
1429Oct 16, 2017: v8.8.4
1430Build changes:
1431 - C++ geocoding build tools now use readdir, since readdir_r is deprecated.
1432 - Update the protobuf-java dependency used to build the C++ metadata from 2.5.0
1433   to 3.0.0. This is an internal change and does not affect the users of the
1434   library.
1435Metadata changes:
1436 - Updated phone metadata for region code(s): AL, BS, FJ, JM, PH, US
1437 - Updated short number metadata for region code(s): KZ
1438 - New geocoding data for country calling code(s): 1726 (en)
1439 - Updated geocoding data for country calling code(s): 1242 (en)
1440 - Updated carrier data for country calling code(s):
1441   20 (en), 679 (en), 1242 (en)
1442
1443Oct 03, 2017: v8.8.3
1444Metadata changes:
1445 - Updated phone metadata for region code(s): BS, FJ, IR, KR
1446 - Updated short number metadata for region code(s): KR
1447 - Updated carrier data for country calling code(s):
1448   380 (en), 381 (en), 679 (en), 1242 (en)
1449
1450Sep 19, 2017: v8.8.2
1451Metadata changes:
1452 - Updated phone metadata for region code(s):
1453   CA, CR, EG, FI, HN, IS, KM, KR, LU, MV, PA, TW, UG, US, VN
1454 - Updated short number metadata for region code(s): IE, IR, KE, TR
1455 - New geocoding data for country calling code(s): 1223 (en)
1456 - Updated geocoding data for country calling code(s): 84 (en, vi)
1457 - Updated carrier data for country calling code(s): 20 (en)
1458
1459Sep 05, 2017: v8.8.1
1460Metadata changes:
1461 - Updated phone metadata for region code(s):
1462   AL, AR, AT, AU, AX, AZ, BO, BR, CN, CO, DE, EG, FI, GB, GL, GW, ID, IE, IL,
1463   IM, IN, JP, KI, KR, KW, LB, LI, LU, MV, MW, NA, NE, NG, PK, PY, SE, SI, SK,
1464   SO, SR, TJ, TW, UA, UG, US, VN, ZW
1465 - Updated short number metadata for region code(s): KR
1466 - New geocoding data for country calling code(s): 380 (en), 1838 (en)
1467 - Updated geocoding data for country calling code(s): 84 (en, vi), 686 (en)
1468 - Updated carrier data for country calling code(s):
1469   60 (en), 380 (en), 597 (en), 686 (en)
1470
1471Aug 21, 2017: v8.8.0
1472Code changes:
1473 - Improve parsing logic to be smarter about national-prefix detection &
1474   stripping based on possible-lengths (IS_POSSIBLE_LOCAL_ONLY and
1475   INVALID_LENGTH). Enables e.g. adding Iran short-codes starting with "096"
1476   without the need to hack IR's national prefix parsing config.
1477 - Logging changes: Don't log client-provided phone numbers.
1478 - Add constants for C++ PhoneNumberUtil enums' max values.
1479Metadata changes:
1480 - Updated phone metadata for region code(s):
1481   AX, BF, BG, DM, EG, FI, IN, IR, KY, KZ, LC, MT, NI, PL, RU, SZ, TH, US, VC
1482 - Updated short number metadata for region code(s): BA, IR, PL, RU, TH, ZA
1483 - New geocoding data for country calling code(s): 52 (es), 1986 (en)
1484 - Updated geocoding data for country calling code(s): 52 (en), 268 (en)
1485 - New carrier data for country calling code(s): 1345 (en)
1486 - Updated carrier data for country calling code(s):
1487   20 (en), 226 (en), 268 (en), 356 (en), 505 (en), 1441 (en), 1758 (en),
1488   1767 (en), 1784 (en)
1489
1490Aug 02, 2017: v8.7.1
1491Code changes:
1492 - Documentation fix for getNumberType
1493Metadata changes:
1494 - Updated phone metadata for region code(s):
1495   AG, AM, BJ, BO, CL, EE, EG, GD, HK, IN, KE, KW, LK, US
1496 - Updated short number metadata for region code(s): BJ, EE, EG, IN, KW
1497 - New geocoding data for country calling code(s): 1564 (en)
1498 - New carrier data for country calling code(s): 1268 (en)
1499 - Updated carrier data for country calling code(s):
1500   56 (en), 254 (en), 374 (en), 852 (en, zh, zh_Hant), 1473 (en)
1501 - Updated / refreshed time zone meta data.
1502
1503Jul 18, 2017: v8.7.0
1504Code changes:
1505 - New method getSupportedCallingCodes() API to return all the calling codes
1506   that the library considers valid, both for geographical and non-geographical
1507   entities.
1508 - Added isSmsServiceForRegion(PhoneNumber, RegionCode) API in C++ and Java
1509   short number info libraries. An SMS service is where the primary or only
1510   intended usage is to receive and/or send text messages (SMSs). This includes
1511   MMS as MMS numbers downgrade to SMS if the other party isn't MMS-capable. The
1512   is_sms_service metadata is also serialized for the first time.  JS is not
1513   affected because it doesn't have short numbers.
1514 - Documentation update for private variables VALID_PUNCTUATION and
1515   SINGLE_INTERNATIONAL_PREFIX, also renaming the latter from
1516   UNIQUE_INTERNATIONAL_PREFIX.
1517 - [Java only] Changing public APIs that take in strings representing phone
1518   numbers or parts of phone numbers to take in CharSequence instead. Updating
1519   some of the internal methods to do the same. This affects ShortNumberInfo and
1520   PhoneNumberUtil, namely the following methods:
1521   - parse & parseAndKeepRawInput
1522   - formatWithCarrierCode & formatWithPreferredCarrierCode
1523   - isNumberMatch
1524   - isPossibleNumber
1525   - isAlphaNumber
1526   - normalizeDigitsOnly & normalizeDiallableCharsOnly
1527 - [C++ only] Removing most of the "using std::*" statements in
1528   phonenumberutil.h file, leaving only using std::string. Changing the .cc and
1529   test files to prefix "std::" where this was missing.
1530Metadata changes:
1531 - New alternate formatting data for country calling code(s): 856
1532 - Updated phone metadata for region code(s):
1533   BF, FI, GG, HK, IM, JE, KG, LA, MX, MY, PS, SA, VN, ZW
1534 - New short number metadata for region code(s): PS
1535 - Updated short number metadata for region code(s): TR, ZA
1536 - New geocoding data for country calling code(s): 52 (en), 976 (en)
1537 - Updated geocoding data for country calling code(s):
1538   84 (en, vi), 223 (en), 358 (en, fi, sv)
1539 - Updated carrier data for country calling code(s):
1540   40 (en), 44 (en), 91 (en), 226 (en), 966 (en), 996 (en)
1541 - Updated / refreshed time zone meta data.
1542
1543Jul 04, 2017: v8.6.0
1544Code changes:
1545 - Removing leading_zero_possible from the metadata and all the places it is
1546   referenced in the build and prod code. Will be removed from the metadata
1547   proto itself in a subsequent release. This should not affect users of the
1548   library - the only place it was used was FormatInOriginalFormat, and only
1549   initially to try and avoid modifying the input number by removing/adding
1550   digits inadvertently. Now this is checked at the end of the method anyway.
1551   However slight formatting differences with this method on invalid numbers
1552   starting with 0s may be noticed in some countries.
1553 - Bug fix for Javascript: getNationalSignificantNumber used to print the string
1554   "null" for empty phone number objects, now it returns an empty string.
1555 - Updated the documentation for the isNumberGeographical API.
1556 - Small comment improvements for parse() method to point users at
1557   parseAndKeepRawInput().
1558 - Added a new enum for CountryCodeSource called UNSPECIFIED. This is used as a
1559   default value, and will be returned if someone calls parse() and then
1560   getCountryCodeSource() on the result. If users want an actual value for this
1561   then they should call parseAndKeepRawInput() instead; the values that were
1562   previously returned after calling this method will not change.
1563 - Deletion of the possible number pattern in the phonemetadata.proto file and
1564   all generated code. This has not been used for a long time.
1565Metadata changes:
1566 - Updated phone metadata for region code(s): AU, IL, IM, IN, KE, MM, PM, UA
1567 - Updated geocoding data for country calling code(s): 95 (en)
1568 - New carrier data for country calling code(s): 508 (en)
1569 - Updated carrier data for country calling code(s):
1570   95 (en), 254 (en), 972 (en)
1571
1572Jun 20, 2017: v8.5.2
1573Metadata changes:
1574 - New alternate formatting data for country calling code(s): 64
1575 - Updated phone metadata for region code(s):
1576   AL, AX, BR, CM, FI, GE, GI, IE, IN, IR, JO, LA, LR, MK, NZ, PK, SI, TL, UA
1577 - Updated short number metadata for region code(s): IR, TH, ZA
1578 - New carrier data for country calling code(s): 503 (en)
1579 - Updated carrier data for country calling code(s):
1580   91 (en), 213 (en), 386 (en), 389 (en), 509 (en), 995 (en)
1581
1582Jun 06, 2017: v8.5.1
1583Metadata changes:
1584 - Updated phone metadata for region code(s):
1585   BA, BL, GB, GF, GP, GU, KW, MF, PG, PL, RE, VN, YT, ZW
1586 - Updated short number metadata for region code(s): IR, PG
1587 - Updated geocoding data for country calling code(s):
1588   84 (en, vi), 263 (en), 675 (en)
1589 - New carrier data for country calling code(s): 262 (en), 590 (en), 594 (en)
1590 - Updated carrier data for country calling code(s):
1591   48 (en), 387 (en), 675 (en), 1 (en)
1592
1593May 23, 2017: v8.5.0
1594Code changes:
1595 - Add canBeInternationallyDialled() public API in Java and C++ PhoneNumberUtil.
1596   This was already in JS.
1597Build changes:
1598 - When compiling binary metadata from XML metadata, we no longer set the
1599   national number pattern  to "NA" for non-existent data.
1600Metadata changes:
1601 - Updated phone metadata for region code(s): BF, GB, IL, IM, MQ, SL, US, VN
1602 - Updated short number metadata for region code(s): BO, BR
1603 - Updated geocoding data for country calling code(s): 1 (en), 84 (en, vi)
1604 - New carrier data for country calling code(s): 596 (en)
1605 - Updated carrier data for country calling code(s): 232 (en), 972 (en)
1606
1607May 10, 2017: v8.4.3
1608Metadata changes:
1609 - Updated phone metadata for region code(s):
1610   AX, BF, CG, FI, GG, GH, GI, IM, IR, JE, JM, VN
1611 - Updated short number metadata for region code(s): AX, BR, FI, GI, HK
1612 - Updated geocoding data for country calling code(s): 84 (en), 233 (en)
1613 - Updated carrier data for country calling code(s):
1614   233 (en), 358 (en), 1876 (en)
1615
1616Apr 25, 2017: v8.4.2
1617Code changes:
1618 - Small fix for possible out-of-bounds exception on RFC3966 input where no
1619   phone context was actually provided.
1620Metadata changes:
1621 - Updated phone metadata for region code(s): BF, ET, IN, KE, LU, VN
1622 - Updated short number metadata for region code(s): KE
1623 - Updated carrier data for country calling code(s):
1624   84 (en), 91 (en), 226 (en), 251 (en), 254 (en), 352 (en)
1625
1626Apr 11, 2017: v8.4.1
1627Code changes:
1628 - Changing isPossibleWithReason to return the enums INVALID_LENGTH and
1629   IS_POSSIBLE_LOCAL_ONLY, where these apply. isPossibleNumber continues to
1630   consider IS_POSSIBLE or IS_POSSIBLE_LOCAL_ONLY numbers as possible to dial.
1631   Announcement: https://groups.google.com/d/msg/libphonenumber-discuss/sPhYzdzFCmg/6tYsS1f6DgAJ
1632 - Doc updates for getRegionCodeForNumber to clarify that it does not
1633   work for short-codes or invalid numbers.
1634Metadata changes:
1635 - Updated phone metadata for region code(s):
1636   AF, AL, CI, CL, DE, HT, IL, MP, VN
1637 - Updated short number metadata for region code(s): CZ, DE
1638 - Updated geocoding data for country calling code(s): 84 (en, vi)
1639 - Updated carrier data for country calling code(s):
1640   84 (en), 93 (en), 225 (en), 509 (en), 972 (en)
1641 - Updated / refreshed time zone meta data.
1642
1643Mar 28, 2017: v8.4.0
1644Code changes:
1645 - Doc changes to update references to ISO country codes to CLDR region codes,
1646   which are what we actually use. Notice in some of the mapper files the
1647   country code is still the ISO one, because it's used as part of a description
1648   of a language only (e.g. zh-TW vs zh-CN). Edited the language comments there
1649   since they can be two *or* three letters (c.f. fil for filipino). Also edited
1650   the comment for leadingDigits at the territory level in the
1651   phonemetadata.proto file.
1652 - New API methods: isPossibleNumberForType and
1653   isPossibleNumberForTypeWithReason, along with getSupportedTypesForRegion and
1654   getSupportedTypesForNonGeoEntity. These allow you to query which types (e.g.
1655   Mobile) exist for a particular region, and work out if a number is possible
1656   for that type (this is a simple length check) rather than for the region as a
1657   whole.
1658Metadata changes:
1659 - Updated phone metadata for region code(s): BF, FJ, GB, HK, HT, IN, RO
1660 - Updated short number metadata for region code(s): BR, IN, RO, TR
1661 - Updated geocoding data for country calling code(s): 82 (hi, iw, tr)
1662 - Updated carrier data for country calling code(s):
1663   226 (en), 509 (en), 593 (en), 679 (en)
1664
1665Mar 14, 2017: v8.3.3
1666Code changes:
1667 - Doc fix for PhoneNumberOfflineGeocoder to explain the cases where an empty
1668   string might be returned.
1669Metadata changes:
1670 - Updated phone metadata for region code(s):
1671   AG, AI, AS, BB, BF, BM, BQ, BS, BW, CA, DM, DO, ES, GD, GU, HK, HR, IN, JM,
1672   JO, KN, KY, LC, ME, MP, MS, MX, PH, PR, SR, SX, TC, TH, TT, US, VC, VG, VI
1673 - Updated short number metadata for region code(s): ES, HR
1674 - Updated geocoding data for country calling code(s):
1675   34 (en, es), 84 (vi), 91 (en)
1676 - New carrier data for country calling code(s): 264 (en)
1677 - Updated carrier data for country calling code(s):
1678   55 (en), 63 (en), 66 (en), 91 (en), 233 (en), 599 (en)
1679
1680Feb 28, 2017: v8.3.2
1681Metadata changes:
1682 - Updated phone metadata for region code(s): BS, CI, HT, IL, IN, IS, KE, SK
1683 - Updated short number metadata for region code(s): KE
1684 - Updated geocoding data for country calling code(s): 254 (en)
1685 - Updated carrier data for country calling code(s):
1686   91 (en), 225 (en), 254 (en), 354 (en), 509 (en), 1242 (en)
1687
1688Feb 20, 2017: v8.3.1
1689Code changes:
1690 - Making getNationalSignificantNumber more robust in the face of malicious
1691   input. This now ignores the number_of_leading_zeros if they are less than
1692   zero.
1693Metadata changes:
1694 - New alternate formatting data for country calling code(s): 39
1695 - Updated phone metadata for region code(s): BS, VN
1696 - Updated geocoding data for country calling code(s):
1697   62 (en, id), 84 (en), 374 (en, hy)
1698 - Updated carrier data for country calling code(s): 7 (ru), 91 (en), 1242 (en)
1699 - Updated / refreshed time zone meta data.
1700
1701Feb 14, 2017: v8.3.0
1702Code changes:
1703 - Added two new enum values to ValidationResult - IS_POSSIBLE_LOCAL_ONLY and
1704   INVALID_LENGTH. Added more documentation to the existing values; see the
1705   javadoc for when these are going to be used. Note that the API for
1706   IsPossibleNumberWithReason has not yet been changed to return these values.
1707   IS_POSSIBLE_LOCAL_ONLY will be returned for some values which currently
1708   return IS_POSSIBLE, and INVALID_LENGTH will be returned for some values which
1709   currently return TOO_LONG.
1710 - Fix for isNumberMatch to ignore the numberOfLeadingZeros field when comparing
1711   numbers unless hasItalianLeadingZero is true, and to consider default values
1712   to match the same value when explicitly set for these two fields. This fix
1713   shouldn't be needed for anyone correctly creating phone numbers using "parse"
1714   as recommended.
1715 - C++ only: Fix for ExactlySameAs when comparing phone numbers to include
1716   comparison of the number_of_leading_zeros field.
1717 - C++ only: Updating maximum length for NSN to be 17 (matches Java and JS)
1718Metadata changes:
1719 - Updated phone metadata for region code(s): IN, MU, RE, TG, TJ, TT, US
1720 - New geocoding data for country calling code(s):
1721   218 (en), 972 (iw), 1283 (en), 1442 (en), 1458 (en), 1470 (en), 1475 (en),
1722   1531 (en), 1534 (en), 1539 (en), 1680 (en), 1681 (en), 1762 (en)
1723 - Updated geocoding data for country calling code(s):
1724   1206 (en), 1253 (en), 1360 (en), 1425 (en), 1509 (en)
1725 - Updated carrier data for country calling code(s):
1726   57 (en), 91 (en), 297 (en), 992 (en), 1868 (en)
1727
1728Feb 02, 2017: v8.2.0
1729Code changes:
1730 - Made normalizeDiallableCharsOnly() API in PhoneNumberUtil (Java) public. This
1731   method is already public in the C++ implementation. It has also now been
1732   added to the Javascript implementation.
1733Metadata changes:
1734 - Updated alternate formatting data for country calling code(s): 91
1735 - Updated phone metadata for region code(s):
1736   AU, AX, BY, BZ, FR, GY, IN, MC, NA, SJ, TG, TT, VN
1737 - Updated short number metadata for region code(s): HR, TG
1738 - Armenia geocoding data that is in Armenian language is moved to right language
1739   code (hy).
1740 - Updated geocoding data for country calling code(s): 91 (en), 374 (en, ru)
1741 - Updated carrier data for country calling code(s): 91 (en)
1742
1743Jan 25, 2017: v8.1.0
1744Code changes:
1745 - Introduced new isCarrierSpecificForRegion() API in ShortNumberInfo class.
1746   This determines whether the provided short code is carrier-specific or
1747   not when dialed from the given region.
1748Metadata changes:
1749 - New alternate formatting data for country calling code(s): 52
1750 - Updated alternate formatting data for country calling code(s): 62
1751 - Updated phone metadata for region code(s):
1752   AR, DJ, GB, GG, GH, ID, IM, IN, JE, MA, MQ, MZ, RO, ZA
1753 - Updated short number metadata for region code(s): ZA
1754 - Updated geocoding data for country calling code(s): 27 (en)
1755 - Updated carrier data for country calling code(s):
1756   91 (en), 93 (en, fa), 233 (en), 253 (en), 258 (en)
1757
1758Jan 11, 2017: v8.0.1
1759Metadata changes:
1760 - Updated phone metadata for region code(s):
1761   BR, CI, CL, CN, CR, DE, FR, GB, GW, HN, IL, IN, KM, KZ, NG, PG, SC, SK, SO,
1762   TT, UA, ZA
1763 - Updated short number metadata for region code(s): BH, BR, SK
1764 - New geocoding data for country calling code(s): 675 (en)
1765 - Updated geocoding data for country calling code(s):
1766   7 (en, ru), 86 (en, zh), 252 (en), 374 (en), 504 (en)
1767 - New carrier data for country calling code(s): 7 (ru), 44 (en), 269 (en)
1768 - Updated carrier data for country calling code(s):
1769   7 (en), 62 (en), 86 (en, zh, zh_Hant), 91 (en), 225 (en), 234 (en), 245 (en),
1770   252 (en)
1771
1772Dec 07, 2016: v8.0.0
1773Code changes:
1774 - Deleted deprecated methods in ShortNumberInfo that work on strings, instead
1775   of phone number objects. These have been marked deprecated for months. Any
1776   users of these methods should call PhoneNumberUtil.parse first to create a
1777   PhoneNumber object, and pass this in.
1778 - Support semicolon as extension character while parsing phone numbers. This
1779   is not applicable when you are trying to find the phone numbers.
1780 - Updated JavaScript to throw an error rather than a string. As a result, users
1781   doing custom behavior depending on the value of the error must now compare
1782   to the value of e.message.
1783Metadata changes:
1784 - Updated phone metadata for region code(s):
1785   AM, BD, BR, CI, ES, IN, KI, KR, LI, MC, MM, TZ
1786 - Updated short number metadata for region code(s): KI, MV, MY
1787 - New geocoding data for country calling code(s): 227 (en), 240 (en), 255 (en)
1788 - Updated geocoding data for country calling code(s): 95 (en), 686 (en)
1789 - New carrier data for country calling code(s): 423 (en)
1790 - Updated carrier data for country calling code(s):
1791   90 (en), 91 (en), 95 (en), 255 (en), 374 (en, ru)
1792
1793Nov 23, 2016: v7.7.5
1794Code changes:
1795 - Removing all references to possible_number_pattern other than the proto
1796   buffer itself (and derived files, or hand-crafted files based on it.) This
1797   information is no longer present in the binary.
1798 - Refactored metadata loading and removed synchronization for all kinds of
1799   metadata. Clients may experience quicker loading of alternate formats and
1800   short number metadata, but no change is required for callers of the library.
1801 - Reduced visibility of `public` internal API
1802   `PhoneNumberUtil.createInstance(MetadataSource)` to `private`. MetadataSource
1803   and all its implementations are non-public so this should not affect public
1804   usage of the library.
1805Metadata changes:
1806 - Updated phone metadata for region code(s):
1807   BB, BD, ES, HN, IN, KR, KW, MC, NL, PH, PK, SH, TW, VG, ZW
1808 - Updated short number metadata for region code(s):
1809   AF, AG, AM, AR, AW, AZ, BD, BM, BQ, BW, CD, CI, CM, CO, CW, DZ, GD, GE, GN,
1810   GT, GY, HN, HT, IE, IN, IQ, JM, JO, KE, KG, KH, KW, LV, NO, SG, SV, UY
1811 - Updated geocoding data for country calling code(s): 504 (en)
1812 - New carrier data for country calling code(s): 886 (en), 1284 (en)
1813 - Updated carrier data for country calling code(s): 63 (en), 92 (en)
1814
1815Nov 09, 2016: v7.7.4
1816GitHub project changes:
1817 - Changed tag to vX.Y.Z from libphonenumber-X.Y.Z; this may affect ports and
1818   derived projects.
1819Metadata structure changes in XML file:
1820 - Mobile and Fixed-Line blocks are no longer assumed to inherit missing data
1821   from the GeneralDesc, but are treated like every other phone number type.
1822   This means that for the non-geographical country codes, like +800, the
1823   example number has been moved from generalDesc to the relevant number types,
1824   and the code in getExampleNumberForNonGeoEntity has been changed to look at
1825   these sub-types for an example number.
1826   This also means that the "NA" and "-1" blocks present in the metadata to
1827   indicate that no mobile or fixed-line numbers appear for the entity have been
1828   removed.
1829   There should no longer be an exampleNumber at the generalDesc level, but it
1830   should be present at every PhoneNumberDesc with data.
1831Code changes:
1832 - Using new possibleLengthInfo to decide whether a short number is the right
1833   length or not. This could result in more specific results; whereas before, a
1834   number from length 3 to length 6 may have been deemed possible, now we may
1835   exclude a number of length 5.
1836 - Add hash (#) as a diallable character. Numbers with # in them will no longer
1837   have formatting applied in formatInOriginalFormat, and
1838   normalizeDiallableCharsOnly now retains the # symbol.
1839 - getExampleNumberForNonGeoEntity has been changed to look at the specific
1840   number types, not just the generalDesc, for the example numbers; this is a
1841   necessary change after the metadata structure change detailed above.
1842Metadata changes:
1843 - Updated phone metadata for region code(s): AD, AE, IN, IR, MU, MV, NG, PG
1844 - Updated short number metadata for region code(s): NL, SN
1845 - New geocoding data for country calling code(s):
1846   960 (en), 1249 (en), 1343 (en), 1579 (en), 1581 (en)
1847 - Updated geocoding data for country calling code(s):
1848   1782 (en), 1867 (en), 1902 (en)
1849 - Updated carrier data for country calling code(s):
1850   91 (en), 234 (en), 971 (en)
1851
1852Oct 26, 2016: libphonenumber-7.7.3
1853Internal changes:
1854 - Fixed Phonemetadata.java not to merge from a NumberFormat's unset bool
1855   national_prefix_optional_when_formatting.
1856 - Added MetadataFilter, an internal API which is under development and subject
1857   to backwards-incompatible changes without notice or guarantees.
1858Metadata changes:
1859 - Updated phone metadata for region code(s):
1860   882, AG, AI, AS, BB, BM, BR, BS, CA, DM, DO, GD, GU, HU, IN, JM, KN, KY, KZ,
1861   LC, MP, MS, PR, SX, TC, TR, TT, UG, US, VC, VG, VI
1862 - Updated short number metadata for region code(s): UY
1863 - New geocoding data for country calling code(s): 1463 (en), 358 (sv)
1864 - Removed geocoding data for country calling code(s): 358 (se)
1865 - Updated geocoding data for country calling code(s): 7 (en, ru)
1866 - Updated carrier data for country calling code(s):
1867   91 (en), 256 (en), 1876 (en)
1868
1869Oct 06, 2016: libphonenumber-7.7.2
1870Code changes:
1871 - Stop setting empty preferred_domestic_carrier_code, and if we are passed such
1872   a number then treat the empty field as if unset.
1873Metadata changes:
1874 - Updated phone metadata for region code(s): CL, FR, KE, MU, NG
1875 - Updated short number metadata for region code(s):
1876   EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, OM, PA, PE, PF, PG, PH,
1877   PK, PL, PM, PR, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG,
1878   SH, SI, SJ, SK, SL, SM, SN, SO, SR, ST, SV, SX, SY, SZ, TC, TD, TG, TH, TJ,
1879   TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, US, UY, UZ, VA, VC, VE, VG, VI,
1880   VN, VU, WF, WS, YE, YT, ZA, ZM, ZW
1881 - Updated geocoding data for country calling code(s): 56 (en, es)
1882 - Updated carrier data for country calling code(s):
1883   230 (en), 234 (en), 254 (en)
1884
1885Sep 27, 2016: libphonenumber-7.7.1
1886Build changes:
1887 - OSGi support added to Manifest information when building jar (#1300)
1888 - BuildMetadataJsonFromXml changed to output possible lengths for JS build
1889 - Fix geocoding file generation to handle language codes that are not just
1890   two letters long properly and to process filenames in the same order.
1891Code changes:
1892 - Switching the internal implementation of isPossible and related functions
1893   to use the new possibleLengths metadata. This affects a lot of countries,
1894   making isPossible more restrictive as more precise data is available. It
1895   also affects parsing ambiguous and invalid numbers, as we decide whether
1896   to strip a possible national prefix (1) or country code based on the length
1897   of the number and whether it is possible before or after this.
1898 - Formatting, naming (LOGGER -> logger) and comment tweaks to follow style
1899   guide
1900 - Removal of unneeded canBeGeocoded method in the
1901   PhoneNumberToTimeZonesMapper.java, using phoneNumberUtil instead
1902Metadata changes:
1903 - Updated phone metadata for region code(s):
1904   800, 808, 870, 878, 881, 882, 883, 888, 979, AG, AM, BD, BF, CL, CO, EC, ET,
1905   GB, GG, GH, IN, LR, MD, MQ, SH, SN, TA, TH, TR
1906 - Updated short number metadata for region code(s):
1907   AC, AD, AE, AF, AG, AI, AL, AM, AO, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD,
1908   BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BW, BY, BZ, CA, CC,
1909   CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ,
1910   DK, DM, DO, DZ, MD
1911 - New carrier data for country calling code(s): 593 (en)
1912 - Updated carrier data for country calling code(s):
1913   49 (en), 56 (en), 66 (en), 90 (en), 91 (en), 226 (en), 231 (en), 373 (en),
1914   852 (zh_Hant)
1915
1916Sep 19, 2016: libphonenumber-7.7.0
1917Code changes:
1918 - Removed the dependency on protobuf (protobuf-javanano) from the Java library,
1919   resurrecting
1920   java/libphonenumber/src/com/google/i18n/phonenumbers/Phonemetadata.java
1921   which was present until libphonenumber-7.1.1.
1922   Does not affect the C++ or JavaScript libraries.
1923
1924Sep 07, 2016: libphonenumber-7.6.1
1925Code changes:
1926 - Phonemetadata.java has two more fields to represent possible lengths of phone
1927   numbers. Changed BuildMetadataFromXml (and the resultant jar) to alter the way
1928   that metadata about possible-lengths information is consumed when constructing
1929   metadata to populate these.
1930   Discussion list email:
1931   https://groups.google.com/forum/#!topic/libphonenumber-discuss/75TOpTFVi08
1932Metadata changes:
1933 - Updated phone metadata for region code(s):
1934   AG, AM, AX, BY, CD, FI, IN, KR, MA, NA, NL, PK, SY
1935 - Updated short number metadata for region code(s): BR, GB, NL, NZ
1936 - New geocoding data for country calling code(s):
1937   82 (pl, pt, ro, ru, sl, sr, uk, vi)
1938 - Updated carrier data for country calling code(s):
1939   27 (en), 91 (en), 243 (en), 963 (en)
1940
1941Aug 24, 2016: libphonenumber-7.6.0
1942Code changes:
1943 - Refactored metadata loading and closed all streams after loading.
1944 - Made isNumberGeographical public, and changed the geocoder to
1945   use this when checking whether to give a detailed answer or country-level
1946   only.
1947Build changes:
1948 - Use protobuf-javanano 3.0.0-alpha-7 from Maven Central.
1949Metadata changes:
1950 - Updated phone metadata for region code(s): EH, ET, JM, MA, SK, SN, SY, ZM
1951 - Updated short number metadata for region code(s): ZA
1952 - Updated geocoding data for country calling code(s): 212 (en)
1953 - New carrier data for country calling code(s):
1954   86 (zh, zh_Hant), 852 (zh, zh_Hant), 963 (en)
1955 - Updated carrier data for country calling code(s):
1956   86 (en), 212 (en), 251 (en), 421 (en)
1957 - Deleted unsupported SingleFilePhoneNumberMetadataProto
1958
1959Aug 10, 2016: libphonenumber-7.5.2
1960Metadata changes:
1961 - Updated phone metadata for region code(s): CO, IN, ME
1962 - Updated short number metadata for region code(s): IN
1963 - New carrier data for country calling code(s): 382 (en)
1964 - Updated carrier data for country calling code(s): 91 (en)
1965
1966Jul 27, 2016: libphonenumber-7.5.1
1967Metadata changes:
1968 - Updated alternate formatting data for country calling code(s): 595
1969 - Updated phone metadata for region code(s): BD, BG, CI, IN, PY, TJ
1970 - Updated short number metadata for region code(s): IN
1971 - New geocoding data for country calling code(s):
1972   82 (bg, ca, el, es, fi, hi, hu, iw, ja, tr)
1973 - Updated geocoding data for country calling code(s): 44 (en)
1974 - New carrier data for country calling code(s): 374 (ru)
1975 - Updated carrier data for country calling code(s):
1976   91 (en), 374 (en), 992 (en)
1977
1978Jul 22, 2016: libphonenumber-7.5.0
1979Code changes:
1980 - Simplify concurrent metadata loading in MultiFileMetadataSourceImpl and
1981   reduce points of contention.
1982
1983Jul 14, 2016: libphonenumber-7.4.5
1984Metadata changes:
1985 - Updated phone metadata for region code(s): CN, HN, IN, KW, LV, TC
1986 - Updated short number metadata for region code(s): AE, BR, GB, ZA
1987 - New geocoding data for country calling code(s): 93 (fa), 992 (en)
1988 - Updated geocoding data for country calling code(s):
1989   91 (en), 98 (en, fa), 371 (en), 504 (en), 1 (en)
1990 - Updated carrier data for country calling code(s): 91 (en)
1991
1992Jun 29, 2016: libphonenumber-7.4.4
1993Metadata changes:
1994 - Updated phone metadata for region code(s): AZ, BH, HN, IN, US
1995 - Updated short number metadata for region code(s): BR, IN, SK
1996 - New geocoding data for country calling code(s): 994 (en),
1997 - Updated geocoding data for country calling code(s): 504 (en), 1 (en)
1998 - Updated carrier data for country calling code(s):
1999   91 (en), 973 (en), 994 (en)
2000
2001Jun 15, 2016: libphonenumber-7.4.3
2002Metadata changes:
2003 - Updated phone metadata for region code(s):
2004   HK, HN, IN, KN, KW, SK, SN, TH, TZ
2005 - Updated short number metadata for region code(s): AR, NO
2006 - New geocoding data for country calling code(s): 93 (en), 504 (en)
2007 - New carrier data for country calling code(s): 93 (fa), 98 (fa)
2008 - Updated carrier data for country calling code(s):
2009   66 (en), 91 (en), 255 (en), 421 (en)
2010
2011Jun 01, 2016: libphonenumber-7.4.2
2012Code changes:
2013 - Make C++ code forward compatible with an upcoming RE2 change.
2014Metadata changes:
2015 - Updated phone metadata for region code(s): AE, BZ, GU, IN, KR
2016 - Updated short number metadata for region code(s): BR
2017 - New geocoding data for country calling code(s): 501 (en)
2018 - Updated carrier data for country calling code(s):
2019   91 (en), 971 (en), 1671 (en)
2020
2021May 18, 2016: libphonenumber-7.4.1
2022Metadata changes:
2023 - Updated phone metadata for region code(s): FR, IL, KR
2024 - Updated carrier data for country calling code(s): 972 (en)
2025
2026May 11, 2016: libphonenumber-7.4.0
2027Maven changes:
2028 - Repackage protobuf runtime dependency to prevent conflicts with clients'
2029   protobuf dependencies. Backwards-compatible, so no changes needed for clients
2030   who could use the previous release, but enables those with their own protobuf
2031   dependencies to use this and future releases without workarounds.
2032
2033May 03, 2016: libphonenumber-7.3.2
2034Metadata changes:
2035 - Updated phone metadata for region code(s):
2036   AU, BR, ET, IN, KH, ML, NO, SB, TJ, US
2037 - Updated short number metadata for region code(s): CA, ML, US
2038 - New geocoding data for country calling code(s): 223 (en)
2039 - Updated geocoding data for country calling code(s):
2040   27 (en), 55 (en, pt), 1 (en)
2041 - Updated carrier data for country calling code(s):
2042   61 (en), 91 (en), 223 (en), 251 (en), 677 (en), 992 (en)
2043
2044Apr 20, 2016: libphonenumber-7.3.1
2045Metadata changes:
2046 - Updated phone metadata for region code(s): DE, DJ, IL, IN, KH
2047 - Updated short number metadata for region code(s): BR
2048 - Updated carrier data for country calling code(s):
2049   91 (en), 855 (en), 972 (en)
2050
2051Apr 05, 2016: libphonenumber-7.3.0
2052Code changes:
2053 - Added java/pending_code_changes.txt for contributors to track code changes
2054   between releases.
2055 - Reduced minimum required version of cmake to 2.8.
2056 - Added cmake installation instructions for Mac.
2057 - Added getExampleNumberForType that doesn't take in a region, and
2058   getInvalidExampleNumber
2059 - Improvements to javadoc for parse method
2060 - Update isNumberGeographical to return true for geographical mobile numbers.
2061Metadata changes:
2062 - Updated phone metadata for region code(s):
2063   BJ, BZ, CI, ET, GQ, KE, KW, ML, NO, OM, VN
2064 - Updated short number metadata for region code(s): KE
2065 - Updated geocoding data for country calling code(s):
2066   84 (en), 251 (en), 254 (en)
2067 - Updated carrier data for country calling code(s):
2068   84 (en), 225 (en), 229 (en), 254 (en), 968 (en)
2069
2070Mar 21, 2016: libphonenumber-7.2.8
2071Metadata changes:
2072 - Updated phone metadata for region code(s): CL, CN, FO, KE, SE, SO
2073 - Updated short number metadata for region code(s): FO
2074 - Updated geocoding data for country calling code(s): 86 (en, zh)
2075 - Updated carrier data for country calling code(s):
2076   86 (en), 252 (en), 254 (en)
2077
2078Mar 09, 2016: libphonenumber-7.2.7
2079Code changes:
2080 - Update nationalPrefixOptionalWhenFormatting documentation.
2081Metadata changes:
2082 - Updated phone metadata for region code(s): CN, IN, MO, TK
2083 - Updated short number metadata for region code(s): FR
2084 - Updated carrier data for country calling code(s): 853 (en)
2085 - Updated / refreshed time zone meta data.
2086
2087Feb 25, 2016: libphonenumber-7.2.6
2088Metadata changes:
2089 - Updated phone metadata for region code(s): DJ, MA, NA, US
2090 - Updated short number metadata for region code(s): KR
2091 - New geocoding data for country calling code(s): 1380 (en)
2092 - Updated geocoding data for country calling code(s): 212 (en)
2093
2094Feb 10, 2016: libphonenumber-7.2.5
2095Code changes:
2096 - Fix two places in demo where NPEs can occur on bad input.
2097 - Fix an IllegalStateException when getMetadataForNonGeographicalRegion is
2098   called with a country calling code which isn't a non-geographic entity.
2099Metadata changes:
2100 - Updated phone metadata for region code(s):
2101   AG, AI, AS, BB, BM, BS, CA, DM, DO, ET, GD, GU, JM, KN, KY, LC, MP, MS, PR,
2102   SE, SK, SX, TC, TT, US, VC, VG, VI
2103 - Updated geocoding data for country calling code(s): 46 (en)
2104 - Updated carrier data for country calling code(s): 251 (en)
2105
2106Jan 28, 2016: libphonenumber-7.2.4
2107 - First release to automatically remove obsolete geocoding files
2108Metadata changes:
2109 - Updated phone metadata for region code(s):
2110   BW, CA, CI, CK, GM, IN, NA, NG, PG, TD, TM
2111 - Updated short number metadata for region code(s): PT
2112 - New geocoding data for country calling code(s): 1825 (en)
2113 - Removed geocoding data for country calling code(s):
2114   1726 (en), 1730 (en), 1838 (en), 1851 (en), 1888 (en), 225 (fr), 242 (fr),
2115   269 (fr), 238(pt), 55 (pt)
2116 - Updated carrier data for country calling code(s):
2117   91 (en), 225 (en), 234 (en), 235 (en), 675 (en), 993 (en)
2118
2119Jan 08, 2016: libphonenumber-7.2.3
2120Backwards-incompatible code changes:
2121 - Removed deprecated ShortNumberUtil.java
2122Other code changes:
2123 - Updated the demo:
2124   added short number support;
2125   added permalink;
2126   added direct link to file an issue
2127Metadata changes:
2128 - Updated phone metadata for region code(s):
2129   AU, BR, CC, CR, CW, CX, ET, HN, KR, SI, TV, WF
2130 - Updated short number metadata for region code(s): FR, HR, HU, IT, KR, LV, TV
2131 - New geocoding data for country calling code(s): 688 (en)
2132 - Updated carrier data for country calling code(s):
2133   61 (en), 251 (en), 506 (en), 599 (en)
2134
2135Dec 15, 2015: libphonenumber-7.2.2
2136Metadata changes:
2137 - Updated phone metadata for region code(s):
2138   AT, BD, BR, CC, CX, CY, FI, ID, IS, KI, MM, TN, VC
2139 - Updated short number metadata for region code(s):
2140   AT, BG, CY, CZ, DE, DK, EE, FI, GB, GR, ID, IE, IS, LT, LU, MT, NL, PL, RO,
2141   SI, SK
2142 - New geocoding data for country calling code(s): 95 (en)
2143 - Updated carrier data for country calling code(s):
2144   216 (en), 354 (en), 357 (en), 686 (en)
2145
2146Nov 11, 2015: libphonenumber-7.2.1
2147 - Fix to libphonenumber-7.2.0
2148Metadata changes: None
2149
2150Nov 10, 2015: libphonenumber-7.2.0
2151* Broken, do not use *
2152Code changes:
2153 - Phonemetadata now generated as nanoproto
2154Metadata changes:
2155 - Updated phone metadata for region code(s):
2156   BI, BT, IL, MN, MO, NP, RU, SK, VG
2157 - Updated short number metadata for region code(s): BT, DK
2158 - New geocoding data for country calling code(s): 972 (en), 975 (en)
2159 - New carrier data for country calling code(s): 853 (en)
2160 - Updated carrier data for country calling code(s):
2161   45 (en), 257 (en), 421 (en), 964 (en), 972 (en), 975 (en), 976 (en)
2162 - Updated / refreshed time zone meta data.
2163
2164Oct 29, 2015: libphonenumber-7.1.1
2165Metadata changes:
2166 - Updated phone metadata for region code(s):
2167   AT, BB, BR, GW, ID, MD, OM, SO, TT
2168 - Updated short number metadata for region code(s): BB, NO
2169 - New geocoding data for country calling code(s): 968 (en)
2170 - Updated geocoding data for country calling code(s): 245 (en, pt)
2171 - Updated carrier data for country calling code(s):
2172   62 (en), 245 (en), 252 (en), 373 (en), 968 (en), 1246 (en)
2173
2174Oct 08, 2015: libphonenumber-7.1.0
2175API changes:
2176 - New MetadataSource implementation that reads from a single metadata file with
2177   all regions' phone number metadata.
2178Metadata changes:
2179 - Updated phone metadata for region code(s): BR, BS, HT, IR, KW, MC, PA, VU
2180 - Updated carrier data for country calling code(s):
2181   98 (en), 678 (en), 880 (en)
2182
2183Sep 16, 2015: libphonenumber-7.0.11
2184Metadata changes:
2185 - Updated phone metadata for region code(s):
2186   IN, KE, LR, MM, MR, NA, NE, PT, RO, SO, TZ, US
2187 - New short number metadata for region code(s): CF, CG, ER, KP, NE, SO
2188 - Updated short number metadata for region code(s): CD, NO, PT
2189 - New geocoding data for country calling code(s): 1854 (en)
2190 - Updated geocoding data for country calling code(s): 264 (en)
2191 - Updated carrier data for country calling code(s):
2192   40 (en), 91 (en), 95 (en), 227 (en), 231 (en), 252 (en), 254 (en), 255 (en),
2193   509 (en)
2194
2195Aug 31, 2015: libphonenumber-7.0.10
2196Metadata changes:
2197 - Updated phone metadata for region code(s):
2198   AU, BY, CR, DZ, EH, ES, HK, HT, IN, JO, MN, MU, ST, TD, TT, ZW
2199 - Updated short number metadata for region code(s): HK, KR
2200 - Updated geocoding data for country calling code(s): 263 (en)
2201 - New carrier data for country calling code(s): 509 (en), 976 (en)
2202 - Updated carrier data for country calling code(s):
2203   41 (en), 61 (en), 91 (en), 230 (en), 235 (en), 239 (en)
2204
2205Aug 03, 2015: libphonenumber-7.0.9
2206Metadata changes:
2207 - Updated phone metadata for region code(s): AR, IN, MX, PL, SZ, YT, ZW
2208 - Updated short number metadata for region code(s): MX, ZW
2209 - Updated carrier data for country calling code(s): 91 (en), 263 (en)
2210
2211Jul 14, 2015: libphonenumber-7.0.8
2212Metadata changes:
2213 - Updated phone metadata for region code(s):
2214   AC, BS, BW, CL, DE, DZ, HN, HR, IL, IN, IT, JO, KY, MA, NP, PL, SH, SL, TM,
2215   UA, VA
2216 - Updated short number metadata for region code(s): HR
2217 - Updated geocoding data for country calling code(s): 56 (en, es)
2218 - Updated carrier data for country calling code(s):
2219   49 (en), 212 (en), 232 (en), 267 (en), 380 (en), 385 (en), 962 (en),
2220   972 (en), 977 (en), 993 (en)
2221- Updated / refreshed time zone meta data.
2222
2223Jun 24, 2015: libphonenumber-7.0.7
2224Metadata changes:
2225 - Updated phone metadata for region code(s):
2226   AC, BF, BG, CG, CM, FR, IL, IN, JP, KW, LB, LI, SB, SD, SH, TT
2227 - Updated short number metadata for region code(s): GY, SB
2228 - New geocoding data for country calling code(s): 592 (en)
2229 - Updated geocoding data for country calling code(s):
2230   86 (en, zh), 226 (en), 290 (en, fr)
2231 - New carrier data for country calling code(s): 592 (en), 689 (en)
2232 - Updated carrier data for country calling code(s):
2233   7 (en), 60 (en), 91 (en), 237 (en), 242 (en), 249 (en), 359 (en), 961 (en),
2234   1868 (en)
2235- Updated / refreshed time zone meta data.
2236
2237May 29, 2015: libphonenumber-7.0.6
2238Metadata changes:
2239 - Updated phone metadata for region code(s):
2240   BB, BR, CR, ID, IL, JO, KW, LK, LU, MD, MM, MV, MY, PH, PK, SC, SE
2241 - Updated short number metadata for region code(s): BE, LK, US
2242 - Updated carrier data for country calling code(s):
2243   60 (en), 63 (en), 92 (en), 94 (en), 95 (en), 248 (en), 373 (en), 960 (en),
2244   972 (en), 1246 (en)
2245
2246Apr 24, 2015: libphonenumber-7.0.5
2247* Metadata changes:
2248 - Updated phone metadata for region code(s):
2249   AF, AS, BD, BE, CA, CI, ID, IN, JM, KH, LI, LU, MU, NE, PL
2250 - Updated short number metadata for region code(s): BE, LI
2251 - Updated geocoding data for country calling code(s):
2252   62 (en), 86 (en, zh), 358 (en, fi, se)
2253 - Updated carrier data for country calling code(s):
2254   32 (en), 93 (en), 225 (en), 227 (en), 855 (en), 1684 (en), 1876 (en)
2255
2256Mar 25, 2015: libphonenumber-7.0.4
2257* Metadata changes:
2258 - Updated phone metadata for region code(s): CA, HU, IL, JO, LU, SG, SL, US
2259 - Updated short number metadata for region code(s): BI
2260 - New geocoding data for country calling code(s):
2261   1220 (en), 1628 (en), 1629 (en)
2262 - Updated carrier data for country calling code(s):
2263   65 (en), 232 (en), 972 (en)
2264
2265Mar 02, 2015: libphonenumber-7.0.3
2266* Metadata changes:
2267 - Updated phone metadata for region code(s):
2268   AR, BH, BY, CI, CN, GH, KR, KW, LU, ME, NZ, SB, WS
2269 - New geocoding data for country calling code(s): 64 (en)
2270 - Updated geocoding data for country calling code(s):
2271   86 (en, zh), 1418 (en), 1438 (en), 1450 (en), 1514 (en), 1819 (en)
2272 - Updated carrier data for country calling code(s):
2273   225 (en), 233 (en), 677 (en), 973 (en)
2274
2275Jan 09, 2015: libphonenumber-7.0.2
2276* Metadata changes:
2277 - Updated phone metadata for region code(s):
2278   BD, BH, EH, GH, IN, JM, LU, MA, MY, NF, NG, PK, SB, TT, TZ
2279 - Updated geocoding data for country calling code(s): 91 (en), 352 (en, fr)
2280 - New carrier data for country calling code(s): 1876 (en)
2281 - Updated carrier data for country calling code(s):
2282   60 (en), 91 (en), 92 (en), 212 (en), 233 (en), 234 (en), 352 (en), 677 (en)
2283
2284Nov 25, 2014: libphonenumber-7.0.1
2285* Metadata changes:
2286 - New alternate formatting data for country calling code(s): 676
2287 - Updated phone metadata for region code(s):
2288   BI, CM, ID, IR, KR, LA, NP, TG, TH, TO
2289 - New geocoding data for country calling code(s): 237 (en)
2290 - Updated geocoding data for country calling code(s): 98 (en, fa)
2291 - Updated carrier data for country calling code(s):
2292   237 (en), 257 (en), 856 (en), 977 (en)
2293
2294Oct 29, 2014: libphonenumber-7.0
2295* Code changes:
2296 - New APIs for ShortNumberInfo. The old APIs have been deprecated and will be
2297   removed in an upcoming release.
2298* Metadata changes:
2299 - Updated phone metadata for region code(s):
2300   AR, AU, CC, CI, CX, DZ, EE, IN, KZ, MC, SB, TJ, TT
2301 - Updated short number metadata for region code(s): MC
2302 - Updated geocoding data for country calling code(s): 34 (en, es), 54 (en)
2303 - Updated carrier data for country calling code(s):
2304   7 (en), 61 (en), 91 (en), 225 (en), 677 (en), 967 (en), 992 (en), 1868 (en)
2305
2306Oct 13, 2014: libphonenumber-6.3.1
2307* Metadata changes:
2308 - Updated phone metadata for region code(s):
2309   AC, AU, CR, DE, IL, MR, NO, SA, SR, UG
2310 - Updated short number metadata for region code(s): CR
2311 - Updated carrier data for country calling code(s):
2312   61 (en), 256 (en), 506 (en), 597 (en), 966 (en), 972 (en)
2313
2314Sep 25, 2014: libphonenumber-6.3
2315* Code changes:
2316  - Changing the offline geocoder to not return any country at all if the number
2317    could belong to multiple countries
2318  - Removing obsolete code that treated countries with no metadata as valid.
2319* Metadata changes:
2320 - New alternate formatting data for country calling code(s): 54, 91
2321 - Updated phone metadata for region code(s):
2322   AM, AR, BR, CA, CL, IL, IN, IR, IS, KE, NI, PF, SB, SN, TH, TN, US
2323 - New geocoding data for country calling code(s):
2324   1782 (en), 1929 (en), 1930 (en), 1938 (en)
2325 - Updated geocoding data for country calling code(s): 98 (en, fa)
2326 - New carrier data for country calling code(s): 354 (en)
2327 - Updated carrier data for country calling code(s):
2328   27 (en), 56 (en), 66 (en), 91 (en), 92 (en), 98 (en), 216 (en), 221 (en),
2329   254 (en), 374 (en), 505 (en), 677 (en), 972 (en)
2330
2331Aug 21, 2014: libphonenumber-6.2.2
2332* Metadata changes:
2333 - Updated phone metadata for region code(s): BN, CL, CO, DK, IN, SB, SO
2334 - Updated short number metadata for region code(s): FR, SA, US
2335 - Updated carrier data for country calling code(s):
2336   27 (en), 57 (en), 91 (en), 252 (en), 677 (en)
2337
2338Jul 28, 2014: libphonenumber-6.2.1
2339* Metadata changes:
2340 - Updated phone metadata for region code(s): BW, LB, MD, PA, PF, VI, ZM
2341 - New carrier data for country calling code(s): 507 (en), 961 (en)
2342 - Updated carrier data for country calling code(s): 267 (en), 373 (en)
2343
2344Jun 30, 2014: libphonenumber-6.2
2345* Code changes:
2346 - Better exclusion of dates when matching phone numbers from text.
2347 - Handle phone input in RFC3966 with missing tel: prefix
2348
2349* Metadata changes:
2350 - New alternate formatting data for country calling code(s): 95
2351 - Updated phone metadata for region code(s):
2352   AF, CN, EH, FJ, IN, JP, KE, KG, KW, MA, MM, PG, PK, SN, SO
2353 - New short number metadata for region code(s): SN
2354 - Updated short number metadata for region code(s): FR, KE
2355 - Updated geocoding data for country calling code(s): 254 (en)
2356 - New carrier data for country calling code(s): 95 (en)
2357 - Updated carrier data for country calling code(s):
2358   92 (en), 93 (en), 212 (en), 221 (en), 254 (en), 675 (en), 679 (en), 965 (en),
2359   996 (en)
2360
2361Jun 06, 2014: libphonenumber-6.1.1
2362* Metadata changes:
2363 - Updated phone metadata for region code(s):
2364   AF, AG, AI, AS, BB, BF, BM, BS, CA, CN, CR, DM, DO, DZ, FR, GD, GU, IN, JM,
2365   KH, KN, KW, KY, LC, MN, MP, MS, NG, NI, PH, PR, SX, TC, TT, US, VC, VG, VI
2366 - Updated short number metadata for region code(s): AL
2367 - New geocoding data for country calling code(s): 1346 (en), 1959 (en)
2368 - Updated geocoding data for country calling code(s):
2369   33 (en, fr), 352 (de, en, fr), 355 (en)
2370 - New carrier data for country calling code(s): 505 (en)
2371 - Updated carrier data for country calling code(s):
2372   63 (en), 91 (en), 93 (en), 234 (en)
2373
2374May 08, 2014: libphonenumber-6.1
2375* Code changes:
2376 - Adding MetadataLoader support to allow custom metadata loading from
2377   alternative sources (should have no visible impact to users).
2378 - Fixing bug where digits could be lost in as-you-type formatting and
2379   formatting patterns incorrectly applied.
2380
2381* Metadata changes:
2382 - Updated phone metadata for region code(s):
2383   AR, BF, BR, BS, CL, CN, CO, CR, DE, DM, EC, EG, FR, GA, GD, GH, HU, ID, IL,
2384   IN, JP, KH, KI, KN, LA, LC, LR, ML, MU, MX, MZ, NA, NE, PF, PL, RU, SM, TH,
2385   TW, UZ, VA, VC
2386 - Updated short number metadata for region code(s): BI, CR, PL, TH
2387 - New geocoding data for country calling code(s): 32 (de), 1242 (en)
2388 - Updated geocoding data for country calling code(s):
2389   32 (en, nl), 55 (en), 56 (en, es), 86 (en, zh)
2390 - New carrier data for country calling code(s):
2391   1758 (en), 1784 (en), 1869 (en)
2392 - Updated carrier data for country calling code(s):
2393   66 (en), 86 (en), 227 (en), 231 (en), 233 (en), 258 (en), 1473 (en),
2394   1767 (en)
2395
2396Feb 25, 2014: libphonenumber-6.0
2397* Code changes:
2398 - Better support for detecting phone numbers in text that are beside each other
2399 - Change to how Japanese numbers beginning with "00" are modelled, with the
2400   side-effect that the maximum possible number length has been extended by 1.
2401 - Handle StringIndexOutOfBoundsException in the AsYouTypeFormatter when the
2402   national prefix that was extracted was not found in the prefix. This affected
2403   countries with very long carrier codes, such as Korea.
2404 - Removal of some of the author attributions - contributions to be tracked in
2405   CONTRIBUTORS file.
2406* Metadata changes:
2407 - Updated phone metadata for region code(s): AS, BR, KW, LU
2408 - New carrier data for country calling code(s): 1684 (en)
2409 - Updated carrier data for country calling code(s): 352 (en)
2410
2411Feb 07, 2014: libphonenumber-5.9.4
2412* Metadata changes:
2413 - Updated phone metadata for region code(s):
2414   883, BF, BJ, BW, CL, CR, DZ, FR, GD, IN, JP, MD, NG, NZ, PK, PL, SY, UY, VU
2415 - Updated short number metadata for region code(s): LV, MD
2416 - New carrier data for country calling code(s): 373 (en), 1473 (en)
2417 - Updated carrier data for country calling code(s):
2418   48 (en), 49 (en), 91 (en), 92 (en), 213 (en), 226 (en), 229 (en), 234 (en),
2419   267 (en), 389 (en), 506 (en), 598 (en)
2420
2421Jan 21, 2014: libphonenumber-5.9.3
2422* Metadata changes:
2423 - Updated phone metadata for region code(s):
2424   BF, BH, BR, CN, GR, IN, MY, PA, TN, US
2425 - Updated short number metadata for region code(s): CN
2426 - New geocoding data for country calling code(s): 1364 (en), 1725 (en)
2427 - Updated geocoding data for country calling code(s): 86 (en)
2428 - Updated carrier data for country calling code(s):
2429   55 (en), 226 (en), 973 (en)
2430
2431Dec 20, 2013: libphonenumber-5.9.2
2432* Metadata changes:
2433 - New alternate formatting data for country calling code(s): 255, 27, 381, 506
2434 - Updated alternate formatting data for country calling code(s): 43
2435 - Updated phone metadata for region code(s):
2436   AG, AI, AS, BB, BF, BM, BS, CA, CR, DM, DO, EC, GD, GU, JM, KN, KY, LC, MP,
2437   MS, PR, SO, SX, TC, TT, US, VC, VG, VI
2438 - Updated carrier data for country calling code(s): 226 (en)
2439
2440Dec 13, 2013: libphonenumber-5.9.1
2441* Metadata changes:
2442 - New alternate formatting data for country calling code(s): 505, 679
2443 - Updated phone metadata for region code(s):
2444   BF, CI, EG, EH, FJ, IN, KI, MA, MT, NG, NI, SI, SN, SR, TT
2445 - Updated short number metadata for region code(s): KI
2446 - Updated geocoding data for country calling code(s):
2447   27 (en), 226 (en), 1 (en)
2448 - New carrier data for country calling code(s): 356 (en), 677 (en)
2449 - Updated carrier data for country calling code(s):
2450   212 (en), 221 (en), 225 (en), 226 (en), 234 (en), 597 (en), 1 (en)
2451
2452Nov 12, 2013: libphonenumber-5.9
2453* Code changes:
2454 - Adding support for numbers with multiple Italian leading zeros, by adding a field
2455   to the phone number proto to allow an arbitrary number of leading zeros, and
2456   supporting this when parsing, validating and formatting.
2457 - Adding more functionality to ShortNumberInfo -> such as getExpectedCostForRegion.
2458 - Fix for parsing short numbers that start with the national prefix.
2459 - Updating formatNumberForMobileDialing to work with short numbers.
2460 - Stop finding Israeli 4-digit "star" numbers in text when no star is in fact present.
2461 - Bug fix for finding phone numbers where the area code was also part of the country
2462   calling code.
2463
2464* Metadata changes:
2465 - Updated phone metadata for region code(s):
2466   AU, BQ, BY, CI, CO, CW, GN, HN, IN, JO, KI, KW, MG, MK, MM, NA, PK, TC, TM,
2467   UG
2468 - New short number metadata for region code(s): CD, GN
2469 - Updated short number metadata for region code(s):
2470   AF, AG, AI, AM, AR, AS, AW, AZ, BD, BH, BI, BM, BO, BQ, BT, BW, BY, CA, CH,
2471   CI, CM, CO, CW, DZ, FJ, GD, GE, GH, GT, GY, HN, HT, ID, IE, IM, IN, IQ, JM,
2472   JO, KE, KG, KH, KI, KW, KZ, LR, SV
2473 - New geocoding data for country calling code(s):
2474   257 (en), 389 (en), 599 (en), 686 (en), 962 (en)
2475 - Updated geocoding data for country calling code(s):
2476   264 (en), 375 (be, en, ru)
2477 - New carrier data for country calling code(s):
2478   375 (be, ru), 389 (en), 599 (en), 965 (ar)
2479 - Updated carrier data for country calling code(s):
2480   57 (en), 61 (en), 92 (en), 225 (en), 256 (en), 257 (en), 261 (en), 375 (en),
2481   686 (en), 962 (en), 965 (en)
2482
2483Oct 10, 2013: libphonenumber-5.8.8
2484* Metadata changes:
2485 - New alternate formatting data for country calling code(s):
2486   350, 358, 36, 66, 84, 94, 995
2487 - Updated alternate formatting data for country calling code(s):
2488   31, 359, 372, 49, 62, 7
2489 - Updated phone metadata for region code(s):
2490   AR, BD, BE, BF, BR, CO, CR, FI, GI, GM, IS, MU
2491 - Updated short number metadata for region code(s): AR, BE, ES, GI, PG, US
2492 - Updated geocoding data for country calling code(s): 220 (en)
2493 - Updated carrier data for country calling code(s):
2494   20 (en), 220 (en), 224 (en), 230 (en), 852 (en)
2495
2496Oct 8, 2013: libphonenumber-5.8.7
2497* Code changes:
2498  - New method in the PhoneNumberUtil API - isMobileNumberPortableRegion.
2499  - Carrier mapper: Updated API and added a getSafeDisplayName method that only returns the carrier
2500                    if it's safe to display to the user.
2501
2502Oct 7, 2013:
2503* Code changes:
2504  - Added PhoneNumberToTimeZonesMapper including unittests to the geocoder maven project.
2505  - Added build rules for generating the binary time zones mapping file from the text file.
2506  - Modified PhoneNumberParserServlet.java (the appengine demo) to incorporate time zone mapping.
2507* Metadata changes:
2508  - Added the time zone mapping file.
2509
2510Sep 30, 2013:
2511* Code changes:
2512  - Added PhoneNumberToCarrierMapper including unittests.
2513  - Added build rules for generating binary carrier mapping files from text files.
2514  - Modified PhoneNumberParserServlet.java (the appengine demo) to incorporate carrier mapping.
2515* Metadata changes:
2516  - Added carrier mapping files for some NANPA countries, EG, SS, MA, DZ, TN, GM, SN, MR, ML, GN,
2517    CI, BF, NE, TG, BJ, MU, LR, SL, GH, NG, TD, CF, CM, CV, ST, GQ, GA, CG, CD, AO, GW, SC, SD, RW,
2518    ET, SO, DJ, KE, TZ, UG, BI, MZ, ZM, MG, ZW, MW, BW, SZ, ZA, AW, FO, GL, GR, NL, BE, FR, GI, PT,
2519    LU, IE, AL, CY, FI, BG, HU, LT, EE, AM, BY, AD, UA, RS, HR, SI, BA, IT, RO, CH, CZ, SK, AT, DK,
2520    NO, PL, DE, BZ, CR, PE, CU, AR, BR, CL, CO, VE, BO, PY, SR, UY, MY, AU, ID, PH, NZ, SG, TH, TL,
2521    BN, PG, TO, VU, FJ, WS, KI, RU, VN, HK, KH, LA, CN, BD, TR, IN, PK, AF, LK, MV, JO, IQ, KW, SA,
2522    YE, OM, PS, AE, IL, BH, QA, BT, NP, IR, TJ, TM, AZ, GE, KG and UZ in English.
2523
2524Sep 23, 2013: libphonenumber-5.8.6
2525* Code changes:
2526  - Restructured the geocoder binary generation code, moving the classes under tools/ from
2527    geocoding/ to buildtools/ and renaming AreaCode to PhonePrefix.
2528
2529Sep 23, 2013: libphonenumber-5.8.5
2530* Code changes:
2531  - Restructured the geocoder, moving the utility classes to a new module internal/prefixmapper.
2532
2533Sep 20, 2013: libphonenumber-5.8.4
2534* Metadata changes:
2535 - Adding a token to indicate which countries have mobile portability.
2536
2537Sep 20, 2013: libphonenumber-5.8.3
2538* Code changes:
2539  - PhoneNumberOfflineGeocoder: Moved utility functionality to PrefixFileReader.
2540  - Bug fix: Argentinian (and other countries with mobile tokens) mobile numbers now geocode
2541             correctly.
2542
2543Sep 19, 2013: libphonenumber-5.8.2
2544* Code changes:
2545  - New method in the PhoneNumberUtil API - getCountryMobileToken.
2546
2547Sep 19, 2013: libphonenumber-5.8.1
2548* Metadata changes:
2549 - New alternate formatting data for country calling code(s): 675
2550 - Updated phone metadata for region code(s):
2551   AO, AU, BF, BW, CA, CH, CI, CN, DE, FR, MA, MR, MU, NI, PG, SA, SE, US, VI
2552 - New short number metadata for region code(s): IQ
2553 - Updated short number metadata for region code(s):
2554   AU, BR, DO, EG, FR, GH, ID, IL, JM, KE, KZ, LR, MW, NG, NI, SA, SE, SL, TZ, US, UZ
2555 - New geocoding data for country calling code(s):
2556   966 (ar, en), 1 (en)
2557
2558Sep 2, 2013: libphonenumber-5.8
2559* Code changes:
2560 - Renamed ShortNumberUtil to ShortNumberInfo -> the former class is now deprecated and will be
2561   deleted in a later release. At the moment it just delegates to ShortNumberInfo.
2562 - New methods in the ShortNumberInfo API - isCarrierSpecific, singleton interface,
2563   isPossibleShortNumber, isValidShortNumber, getShortNumberCost. Note this is an experimental API
2564   at the moment and subject to change.
2565 - Bug fixes:
2566    -- AsYouTypeFormatting: 3-digit numbers can be formatted as a group where appropriate
2567    -- AsYouTypeFormatting: Countries with an optional national prefix were considered before to
2568       have always entered it, resulting in bugs where numbers without the national prefix were
2569       not properly formatted.
2570    -- Numbers in Chile that overlap with emergency numbers are no longer marked as connecting to
2571       them
2572    -- Not requiring the NDC to be alone for countries where there is no national prefix in strict
2573       grouping when extracting phone numbers
2574* Metadata changes:
2575 - New alternate formatting data for country calling code(s):
2576   30, 31, 385, 58, 62, 63, 971, 972
2577 - Updated alternate formatting data for country calling code(s): 43, 44, 49
2578 - Moved emergency phone number data to the ShortNumberMetadata.xml file
2579 - Updated phone metadata for region code(s):
2580   AT, EG, ML, NC, NL, SA
2581 - New short number metadata for region code(s):
2582   AR, CL, CO, ES, MX, NC
2583 - Emergency metadata fixes for region code(s):
2584   GA, JM, MH, VE
2585
2586Aug 09, 2013: libphonenumber-5.7.2
2587* Metadata changes:
2588 - New alternate formatting data for country calling code(s):
2589   352, 359, 372, 373, 375, 595, 7, 855
2590 - Updated phone metadata for region code(s):
2591   AR, BF, BH, BR, BY, CH, CM, CN, GE, GW, HN, JM, KH, LT, LU, MU, NP, RO, SO
2592 - New short number metadata for region code(s): BR
2593 - Updated short number metadata for region code(s):
2594   CH, FJ, GB, GG, IM, IT, JE, SH
2595
2596Aug 8, 2013: libphonenumber-5.7.1
2597* Metadata/code changes:
2598 - Change to the way the metadata is built; now only parts of the proto that are relevant will be
2599   generated. This means short-code data won't be generated for the normal protos, and fixed-line
2600   data won't be generated for short-number protos. This cuts the metadata binary size approximately
2601   in half.
2602
2603Jul 17, 2013: libphonenumber-5.7
2604* Code changes:
2605 - Improve phone number extraction recall.
2606 - Add support for loading short number metadata.
2607
2608Jul 16, 2013: libphonenumber-5.6.2
2609* Metadata changes:
2610 - Updated alternate formatting data for country calling code(s): 49, 61
2611 - New metadata for region code(s): TA
2612 - Updated metadata for region code(s):
2613   BF, BH, BI, BJ, BR, CR, EH, GA, GE, GN, GU, IL, IN, IR, KH, KW, KZ, MA, MT,
2614   NA, NE, NL, PH, RO, SH, SO, TK
2615 - New geocoding data for country calling code(s): 47 (en), 82 (ar)
2616 - Updated geocoding data for country calling code(s):
2617   49 (en), 98 (en, fa), 241 (en)
2618
2619Jul 12, 2013: libphonenumber-5.6.1
2620* Code changes:
2621 - Rename all instances of PhoneNumberMetadata to PhoneNumberMetadata for consistency.
2622
2623Jun 05, 2013: libphonenumber-5.6
2624* Code changes:
2625 - Fix for as-you-type-formatting bug affecting countries with no national prefix
2626   formatting rule, such as China.
2627* Metadata changes:
2628 - New alternate formatting data for country calling code(s): 351
2629 - Updated alternate formatting data for country calling code(s): 49
2630 - Updated metadata for region code(s):
2631   AS, BG, BH, BJ, BL, CD, CI, DE, DZ, EH, FJ, GF, GP, IN, KH, KZ, MA, MD, MF,
2632   ML, MY, NG, PT, PY, TC, TJ, TT
2633
2634May 08, 2013: libphonenumber-5.5
2635* Code changes:
2636 - Changed internal initialization code and made more fields final.
2637   Note that we now throw an exception if an attempt is made to set the
2638   metadata more than once (which should only happen during testing).
2639 - Fix problem with formatNumberForMobileDialing for HU and CL.
2640* Metadata changes:
2641 - Updated alternate formatting data for country calling code(s): 49
2642 - Updated metadata for region code(s):
2643   AM, BF, BR, CR, DE, MA, MG, MM, SA, TL, UA
2644 - Updated geocoding data for country calling code(s): 374 (am, en, ru)
2645
2646Apr 19, 2013: libphonenumber-5.4.2
2647* Metadata changes:
2648 - Updated metadata for region code(s): BF, GA, IN, KR, MV, PH, SO, UA, US
2649
2650Mar 25, 2013: libphonenumber-5.4.1
2651* Metadata changes:
2652 - Updated metadata for region code(s): BF, BH, CR, EC, IR, MG, PF, TD, TN
2653 - New geocoding data for country calling code(s): 374 (am, ru)
2654 - Updated geocoding data for country calling code(s):
2655   98 (en, fa), 358 (en, se), 374 (en)
2656
2657Mar 07, 2013: libphonenumber-5.4
2658* Code changes:
2659 - Switch formatNumberForMobileDialing to prefer national format to international format when the
2660   number is dialed from the same region the phone number is from.
2661
2662* Metadata changes:
2663 - Updated metadata for region code(s):
2664   BF, CD, CN, CZ, GN, IR, JP, KR, KW, LR, NZ, TT, UG, ZW
2665 - New geocoding data for country calling code(s): 82 (cs)
2666 - Updated geocoding data for country calling code(s):
2667   82 (en, fr, ko, zh, zh_Hant), 98 (en, fa), 263 (en)
2668
2669Feb 11, 2013: libphonenumber-5.3.2
2670* Metadata changes:
2671 - Updated metadata for region code(s):
2672   BD, BE, BY, CA, EH, GR, IE, IN, IS, LI, MA, MU, PT, SE, SG, TL
2673 - New geocoding data for country calling code(s):
2674   375 (be, en, ru), 1 (en)
2675
2676Jan 25, 2013: libphonenumber-5.3.1
2677* Metadata changes:
2678 - Updated metadata for region code(s): CN, DK, EH, GN, KH, KW, MA, MY, PA
2679
2680Jan 08, 2013: libphonenumber-5.3
2681* Code changes:
2682 - Handling UAN numbers in Argentina better when dialling them locally from a
2683   mobile
2684* Metadata changes:
2685 - Updated metadata for region code(s):
2686   BE, BW, CL, CN, CO, EH, KW, MA, ML, NG, PL, SY, ZA, ZM
2687 - New geocoding data for country calling code(s): 32 (en, fr, nl)
2688 - Updated geocoding data for country calling code(s): 27 (en), 86 (en, zh)
2689
2690Dec 06, 2012: libphonenumber-5.2.2
2691* Metadata changes:
2692 - New metadata for region code(s): EH
2693 - Updated metadata for region code(s): BR, CL, CR, IN, MA, PG, PK, RO
2694 - New geocoding data for country calling code(s): 241 (en)
2695
2696Nov 26, 2012: libphonenumber-5.2.1
2697* Metadata changes:
2698 - Updated metadata for region code(s):
2699   AE, AW, BF, CN, DE, JO, KE, KH, LT, MM, MU, NG, RW, SR, TR, VU
2700 - New geocoding data for country calling code(s): 359 (bg, en)
2701
2702Oct 10, 2012: libphonenumber-5.2
2703* Code changes:
2704 - Adds isNumberGeographical() method.
2705 - Adds getRegionCodesForCountryCode() method.
2706 - Fixing issue with getSupportedGlobalNetworkCallingCodes()
2707   [https://github.com/google/libphonenumber/issues/202]
2708 - Ensures that returned collections are unmodifiable where necessary
2709   [there is a very slight risk that this may break existing users who were relying on being able
2710   to modify these collections, but doing so would be breaking lots of other assumptions that this
2711   library makes - if you need to modify any affected collections you must copy them first]
2712* Metadata changes:
2713 - Updated metadata for region code(s): DE, GR, HR, OM, SB, ZA
2714 - Removed metadata for region code: AN (Netherlands Antilles)
2715 - Updated geocoding data for country calling code(s): 30 (el, en)
2716
2717Sep 27, 2012: libphonenumber-5.1.4
2718* Metadata changes:
2719 - Updated metadata for region code(s): AU, EC, KH, LB, TN, US
2720
2721Sep 17, 2012: libphonenumber-5.1.3
2722* Metadata changes:
2723 - Updated metadata for region code(s): EG, LA, LB, LI, PY
2724 - Updated metadata for non-geographical calling codes: 800, 808, 888, 979
2725 - Updated geocoding data for country calling code(s): 98 (en), 1 (en)
2726
2727Sep 11, 2012: libphonenumber-5.1.2
2728* Bug fix:
2729 - Fixing regression in AsYouTypeFormatter where it no longer worked for numbers entered in national
2730   format for countries with no national prefix, e.g. Spain.
2731
2732Sep 5, 2012: libphonenumber-5.1.1
2733* Code changes:
2734  - Added better logging/exception handling for catching cases where metadata is invalid/missing.
2735
2736Sep 3, 2012: libphonenumber-5.1
2737* Code changes:
2738 - Inserting a space after the national prefix in the AsYouTypeFormatter when formatting numbers in
2739   national format, if the formatting rules for that country dictate that a space is appropriate.
2740 - Format emergency numbers and short-codes as a block in the AsYouTypeFormatter.
2741* Metadata changes:
2742 - Updated metadata for region code(s): BF, BG, DZ, GA, IT, JP, KW, PF
2743
2744Aug 20, 2012: libphonenumber-5.0.3
2745* Metadata changes:
2746 - New alternate formatting data for country calling code(s): 43
2747 - Updated metadata for region code(s): AT, BF, JO, NG, RU, SL
2748 - New geocoding data for country calling code(s): 62 (en, id), 98 (fa)
2749
2750Aug 07, 2012: libphonenumber-5.0.2
2751* Metadata changes:
2752 - Updated metadata for region code(s):
2753   BF, CN, DJ, IL, JO, KH, KZ, MA, MT, MV, MY, NC, NG, SD, SK, SN, TL, UZ
2754 - New geocoding data for country calling code(s): 7 (ru), 98 (en)
2755 - Updated geocoding data for country calling code(s): 7 (en)
2756
2757July 26th, 2012: libphonenumber-5.0.1
2758* Metadata changes
2759 - CL, DE ,IN, KR, US
2760 - New geocoding data for country calling codes 40, 57, 66, 82, 91.
2761 - Fixed comments for 353 (IE).
2762
2763July 12th, 2012: libphonenumber-5.0
2764* Code changes:
2765 - Support for alternate formats when finding phone numbers.
2766 - Allowing two-digit numbers to be parsed if they are entered in national-format with no
2767   punctuation
2768* Metadata changes
2769 - IL, GA
2770* Other
2771 - Reflowed this file to 100 char width to make it unambiguous as to what the standard should be.
2772
2773July 6th, 2012: libphonenumber-4.9.1
2774* Metadata changes
2775 - AR, BA, BF, CR, DE, EC, ES, KZ, MK, NC, NG, PF, SB, UZ, non-geo entity 882
2776 - Geocoding data updates for country calling codes 54 (AR) and 81 (JP), new data for 234 (NG)
2777
2778June 21st, 2012: libphonenumber-4.9
2779* Bug fix
2780 - formatInOriginalFormat fixed not to add a star sign if it was not present originally.
2781* Metadata changes
2782 - BF, CZ, ES, KW
2783 - Non-geographical entities with calling code 882 (BebbiCell, Maritime Communications, Oration
2784   Technologies, Telespazio and Thuraya)
2785 - Geocoding data updates for country calling codes 221, 224, 226, 242, 244, 245
2786* Functionality changes:
2787 - Minimum allowed length for a national significant number (NSN) when parsing changed from 3 to 2.
2788 - Support parsing of RFC3966-formatted strings with an isdn-subaddress or extra parameters
2789   specified.
2790 - Allow soft hyphen to appear in phone numbers (\u00AD)
2791* Testing changes:
2792 - Add extra unit tests for non-geographical phone number entities
2793 - ExampleNumbersTest testEmergency tests now uses ShortNumberUtil
2794
2795June 14th, 2012: libphonenumber-4.8.5
2796* Metadata update only:
2797 - AC, CR, DE, DK, IL, IN, IS, KH, LI, LR, MA, MD, MK, PA, SA, SG, SS
2798
2799June 6th, 2012: libphonenumber-4.8.4
2800* Metadata update only:
2801 - AE, RO
2802 - Non-geographical entity with calling code 881 (Iridium)
2803
2804May 30th, 2012: libphonenumber-4.8.3
2805* Metadata update only:
2806 - AN, ET, KW, MN, SX, TC, TL
2807
2808May 16th, 2012: libphonenumber-4.8.2
2809* Metadata update only:
2810 - BH, CR, EE, JO, KW, LA, QA, SI, TH
2811 - Non-geographical entity with calling code 878 (VISIONng)
2812
2813May 8th, 2012: libphonenumber-4.8.1
2814* Metadata update only:
2815 - CA, CI, EG, HK, IN, IR, LB, MA, ME, MM
2816 - Non-geographical entity with calling code 870 (Inmarsat)
2817 - Geocoding updates for country calling codes 1 for new area codes
2818
2819April 24th, 2012: libphonenumber-4.8
2820* Functionality changes
2821 - RFC format now outputs a number starting with "tel:"
2822 - Parsing support for numbers in RFC format that contain the country info in the "phone-context"
2823   part
2824 - Support for obtaining area codes for Italy, Vatican City, San Marino
2825* Metadata changes
2826 - AM, AO, AR, BE, BF, CD, EG, GH, GM, GN, IN, IR, IT, JO, LA, LC, MD, MS, NO, PA, PK, SI, SJ, SO,
2827   SY, TC, TN, UZ, VN, ZW
2828 - Geocoding updates for country calling codes 1, 20, 233, 31, 33, 352, 374, 54, 56, 86
2829* Refactoring of matching functions, including moving them to PhoneNumberMatcher.
2830
2831March 16th, 2012: libphonenumber-4.7
2832* Bug fixes
2833 - Now return "too long" for input that is longer than 250 chars when parsing
2834* Metadata changes
2835 - AC,AM,AT,AZ,BF,BR,BY,BZ,CR,CU,DE,DJ,EE,EG,ET,GA,GH,HK,HN,ID,IN,JP,KE,KG,KH,KR,KW,KY,LB,LU,MA,MD,
2836   MK,NA,NE,NZ,SA,SB,SC,SE,SL,SN,UZ
2837* Refactoring of test classes so that tests requiring the test metadata to be loaded have a common
2838  base class which handles this.
2839
2840February 9th, 2012: libphonenumber-4.6
2841* Bug fixes
2842 - Fix for formatByPattern to enable RFC formatting to work
2843 - Fix for RFC formatting to work even when the international formatting rule starts with
2844   punctuation
2845 - Logging consistency changes - some warnings are no longer printed, others have become only
2846   WARNINGS
2847 - Fix for isValidNumberForRegion potentially throwing a NPE
2848 - Parsing Israeli * numbers written in international format now works
2849 - PhoneNumberMatcher doesn't match timestamps as phone-numbers
2850* Metadata changes
2851 - Updates for AN, AX, BF, BJ, BR, BS, DJ, FI, IN, LV, MW, RS, SC, VN
2852 - New countries supported: SS (South Sudan), CW (Curaçao) and BQ (Bonaire, Sint Eustatius and Saba)
2853* Refactoring of the private formatting functions in PhoneNumberUtil to ensure names are more
2854  descriptive and to reduce code duplication.
2855
2856January 19th, 2012: libphonenumber-4.5
2857* Code changes
2858 - Support for non-geographical country calling codes (e.g. +800).
2859 - Modify formatInOriginalFormat to not insert/remove/modify digits in the original number passed
2860   in.
2861 - Fix formatOutOfCountryKeepingAlphaChars to not throw a NPE.
2862
2863* Metadata changes
2864 - Updates for AR, BH, CI, CN, CR, DE, GA, IL, JO, JP, KE, KZ, LB, LK, LT, MV, MW, MZ, NA, NL, NZ,
2865   PL, RO, SA, SV, TM, UG, US
2866 - New country calling codes: 800, 808, 883, 888, 979
2867 - Geocoding data updates: AR, US
2868
2869December 9th, 2011: libphonenumber-4.4
2870* Code changes
2871 - Support for Voicemail numbers
2872 - Support prefixes "xt" and "xtn" to indicate extensions of phone numbers
2873 - Change formatInOriginalFormat to use raw_input for numbers with incorrect leading zeroes, instead
2874   of all invalid numbers.
2875
2876* Metadata changes
2877 - Updates for AR, BD, CH, CI, IL, IR, IS, IT, JP, KW, LR, MM, NG, SA, SC, UZ
2878
2879November 24th, 2011: libphonenumber-4.3
2880* Code changes
2881 - Fix the problems with AYTF crashing for longer numbers entered with +CountryCode, and incorrectly
2882   removing national prefix for some numbers.
2883 - Improve PhoneNumberMatcher to not match numbers ending with '%'.
2884 - Fix formatNumberForMobileDialing to handle Israeli star numbers, Peruvian and Colombian numbers.
2885 - Modify formatInOriginalFormat to use the raw input if we don't have a formatting pattern for a
2886   number.
2887 - Simple offline geocoding function which takes into account the user's region.
2888
2889* Metadata changes
2890 - Updates for CR, GN, JP, KE, PL, SG, SR, SX, TH, TK
2891
2892November 10th, 2011: libphonenumber-4.2
2893* Code changes
2894 - Providing an "exact match" isEmergencyNumber method
2895 - Improvement to PhoneNumberMatcher: requires national prefix to be present when matching
2896   national-format numbers, unless matching for a region where it is explicitly marked in the
2897   metadata that they may be omitted. Applies to leniency level VALID and higher.
2898 - Change formatNumberForMobileDialing not to modify the phoneNumber passed in.
2899
2900* Metadata changes
2901 - Emergency numbers added for all remaining countries
2902 - Collected data on which numbers we format with a national prefix are commonly written without one
2903   and added this
2904 - Updates for AR, AT, BH, CZ, GR, IR, KM, LT, MX, PT, SE, SO, UG
2905 - Addition of SX (Sint Maarten)
2906
2907October 19th, 2011: libphonenumber-4.1
2908* Code changes
2909 - Update code and metadata for countries with IDD "8~10" to accept phone numbers where the "~" is
2910   omitted.
2911 - Modify formatInOriginalFormat to use raw_input (when present) when the number is considered as
2912   invalid by the library.
2913 - Add ShortNumberUtil to deal with international short phone numbers, such as short codes and
2914   emergency numbers.
2915 - Increase the maximum phone-number length accepted when parsing (now set to
2916   16).
2917
2918* Metadata changes
2919 - Updates: BF, BN, CN, DE, DK, DO, FR, IN, KI, KW, MC, MD, ML, PA, QA, SB, UK, WS
2920 - Emergency number information also added to: AE, AF, AL, AM, AR, AT, AU, BA,
2921   BB, BD, BE, BG, BH, BO, BR, BY, CA, CH, CL, CN, CO, CR, CY, CZ, DE, DJ, DK,
2922   DO, DZ, EC, EE, EG, ES, FI, FJ, FO, FR, GB, GE, GF, GH, GI, GL, GR, GT, GY,
2923   HK, HN, HR, HU, ID, IE, IL, IN, IR, IS, IT, JM, JO, JP, KR, KW, KY, KZ, LB,
2924   LK, LT, LU, LV, MA, MC, MD, ME, MK, ML, MM, MN, MO, MT, MU, MV, MX, MY, NG,
2925   NI, NL, NO, NP, OM, PA, PE, PH, PK, PL, PM, PT, PY, QA, RO, RS, RU, RW, SA,
2926   SB, SD, SE, SG, SI, SK, SL, SM, SR, SV, SY, TD, TH, TJ, TM, TN, TR, TT, TW,
2927   UA, UG, US, UY, UZ, VA, VE, VN, VU, ZA, ZM, ZW
2928
2929October 6th, 2011: libphonenumber-4.0
2930* Code changes
2931 - New function formatNumberForMobileDialing, which attempts to format a number in such a way that
2932   the call can be connected from a mobile phone. If this is impossible, for example for numbers
2933   that cannot be internationally dialled, then an empty string is returned.
2934 - Fallback functionality to English for non-CJK languages for geocoding
2935
2936* Metadata changes
2937 - Collecting data for emergency numbers
2938 - Updates: AR, AU, BR, CN, CZ, EG, GD, IE, IL, JM, KW, KH, SD, SO, TR, UG, UZ
2939 - Geocoding data changes: AO, AR, AT, BJ, BR, CD, CG, CI, CL, CN, CV, DE, ES,
2940   FR, GR, GW, HU, KM, MR, MZ, NL, PL, PT, SE, ST, SZ
2941
2942September 13th, 2011: libphonenumber-3.9
2943* Code changes
2944 - Enable AsYouTypeFormatter to handle long IDD and NDD.
2945 - Allow the presence of an IDD following a +.
2946 - Fix formatting of phone numbers which contain only 0s in the national number.
2947 - Refactored some code in geocoding including AreaCodeMap and the storage strategies.
2948
2949* Metadata changes
2950 - Updates: AM, BE, BH, BJ, BR, BT, BZ, CI, CL, CN, DE, DK, DM, DZ, EC, EG, FJ,
2951   GR, HR, HT, IN, IQ, IS, JM, KE, KG, KH, KR, LA, LB, LR, MA, MD, ML, MO, MX,
2952   MY, NE, NG, PG, PH, PK, PY, QA, SA, SD, SG, SN, TD, TG, TH, TN, TT, UG, YE,
2953   ZA, ZM
2954 - New geocoding data for: AC, CG, CU, CV, EG, ET, FI, FI, FI, GL, JP, KM, MA,
2955   MA, MU, MU, MU, MZ, RS, SH, SH, SL, SO, ST, TG, TG, TG, UG, ZM
2956 - Updated geocoding data for: AR, DE
2957
2958August 11th, 2011: libphonenumber-3.8
2959* Code changes
2960 - Fix to demo to not throw null-ptr exceptions for invalid NANPA numbers
2961 - Fixed AYTF to not accept plus signs in the middle of input
2962 - PhoneNumberMatcher improvements - added STRICT_GROUPING and EXACT_GROUPING levels, numbers
2963   followed/preceded by a currency symbol will not match, multiple numbers separated by phone-number
2964   punctuation will now match. ", " is no longer accepted as an extension symbol when matching, only
2965   when parsing. "x" is only accepted as a carrier code or extension marker, not otherwise.
2966 - Changes to handling of leading zeroes - these will not be silently ignored anymore, but will be
2967   stored as part of the number.
2968 - PhoneNumberOfflineGeocoder - new method to get the description of a number that assumes the
2969   validity of the number has already been checked and will not re-verify it.
2970 - Split geocoding US binary data into multiple files.
2971
2972* Metadata changes
2973 - Updates: AR, AT, AU, AZ, BE, BF, BH, BY, CA, CN, CO, CR, HT, HU, IT, KG, KH,
2974   LB, LI, ME, NC, RS, SE, TT, US, VG, ZA
2975 - New geocoding data for: AL, AM, AO, BF, BJ, BW, CD, CI, CZ, DZ, EE, GH, GM,
2976   GN, GR, GW, HU, IS, KE, LK, LS, LT, LU, LV, MD, MG, MR, NA, PE, QN, SD, SK,
2977   SN, SZ, TN, VE, VN, ZA, ZW
2978 - Updated geocoding data for: GB, PT, US
2979 - Revised sorting of geocoding data
2980
2981July 5th, 2011
2982* Code changes
2983 - Refactored AreaCodeMap to minimize binary and memory footprint by using 2 different strategies.
2984 - Refactored BuildMetadataFromXml.java and added unittests.
2985
2986* Metadata changes
2987 - Regenerate binaries for all existing area code mapping data with smaller sizes.
2988 - Added city-level area code data mapping for US and Canada.
2989
2990June 29th, 2011
2991* Code changes
2992 - Fixed issue 38, issue 39, issue 41 and issue 43
2993
2994* Metadata changes
2995 - Added phone number area mapping files for
2996   - JP in Japanese
2997   - FR in French
2998   - TW in English, Simplified and Traditional Chinese
2999   - RU in English
3000   - IT in English and Italian
3001   - PT in Portuguese
3002   - TR in English and Turkish
3003   - CH in English, German, French and Italian
3004 - Updates: CR, GE, IT, JP, KW, MH, MP, MU, PE, PM, RW, TG, TJ, TK
3005
3006June 14th, 2011
3007* Code changes
3008 - Added PhoneNumberOfflineGeocoder, supporting classes and their unittests.
3009 - Added GenerateAreaCodeData to transform phone number area mapping files from text files to binary
3010   files.
3011 - Modified PhoneNumberParserServlet.java and phonenumberparser.jsp to incorporate
3012   PhoneNumberOfflineGeocoding in the appengine demo.
3013
3014* Metadata changes
3015 - Added phone number area mapping files for NANPA countries and GB in English, NL in Dutch, AR, CL
3016   and ES in Spanish, AT and DE in German, SE in Swedish, BR in Portuguese, KR in English, Korean,
3017   Simplified and Traditional Chinese, and CN in Simplified Chinese.
3018
3019June 10th, 2011
3020* Code changes:
3021 - Fixes for PhoneNumberMatcher to be more restrictive in valid mode and not match numbers
3022   surrounded by Latin characters. This ensures, for example, the string abc123456789acg will not be
3023   marked as a phone numbers.
3024 - Enable PhoneNumberUtil to handle all digits, rather than a subset
3025 - Fix for AYTF issue36 and improvement for US AYTF behaviour.
3026* Metadata changes:
3027 - Updates: BG, EG, ES, GH, PF, SC, SY, VA
3028
3029May 24th, 2011
3030* Code changes:
3031 - Phonenumber now implements Serializable.
3032 - findNumbers doesn't accept numbers with mis-matched brackets as phone-numbers
3033 - An offline phone number geocoder has been added. The current implementation just returns the
3034   region name for the phone number; more detailed geocoding will be added later.
3035* Metadata changes:
3036 - New countries: GF, KP, NC, PA, PF, PW, PY, SB, SR, TO, UY, VU
3037 - Updates: CY, CZ, ES, GB, GQ, JM, MQ, TN, VI
3038
3039May 9th, 2011
3040* Code changes:
3041 - Fixed potential for a null-ptr exception in getExampleNumber
3042 - Potential speed improvement with replacement of StringBuffer with StringBuilder
3043* Metadata changes
3044 - Changed way that international formats are specified to make it easier to do so
3045 - New countries: AX, CC, CX, WF
3046 - Updates: AM, AR, AU, AW, CN, CO, CR, DM, EC, ET, FI, FJ, GH, IN, JP, KE, KM,
3047   KN, LR, MD, MQ, MX, NP, PH, SC, SE, SM, SN, SY, UG, US, VC, VI, ZM
3048
3049Apr 26th, 2011
3050* Code changes:
3051 - Improved PhoneNumberMatcher for cases with other numbers before or after the phone number.
3052 - Improved AsYouTypeFormatter not to use formatting rules containing non-formatting characters
3053   (e.g. '*' in Israeli star numbers).
3054* Metadata changes:
3055 - New countries: FJ, FM, GY, NF, NI, NR, TV.
3056 - Updates: AM, AZ, BF, BW, BZ, CI, CR, GB, GP, HK, JM, KH, LB, LY, MV, PE, PK, SZ, TJ, US.
3057* Minor documentation updates
3058
3059Apr 11th, 2011
3060* Bug fixes:
3061 - Adding date exclusion pattern in PhoneNumberMatcher.
3062 - Fixing bug with selecting a suitable region for numbers with leading zeros where mutiple regions
3063   for that country code are possible.
3064* Metadata changes:
3065 - Updates: AG, AI, AS, BB, BM, BS, CA, DM, DO, ET, FO, GD, GE, GU, IN, JM, KN, KY, LC, MN, MP, MR,
3066   MS, NO, PR, TC, TR, TT, US, VC, VG, VI
3067 - New countries: CK, FK, GT, IO, KI, SJ, SV
3068* Documentation updates and some small refactoring to AsYouTypeFormatter
3069
3070Mar 31st, 2011
3071* New functionality:
3072 - Can parse and format numbers in RFC-3966 format.
3073 - Added isAlphaNumber to check to see if a number is a "vanity" or "alpha" number
3074 - Can format a number made up of alpha-characters in an "out-of-country" format (e.g. 0011 1
3075   800-SIX-FLAG to dial an American alpha-number from Australia).
3076* Code changes:
3077 - Renamed private vars, private methods and fixed comments to try and differentiate between country
3078   (calling) codes and region codes.
3079 == Non-backwards-compatible API changes: ==
3080 - Renamed getSupportedCountries to getSupportedRegions, as this more accurately reflects that the
3081   library is based around region codes.
3082 - getNationalSignificantNumber is no longer a static method, but is instead an instance method.
3083* Metadata changes:
3084 - Bug-fixes and updates for AU, AZ, EE, FI, IN, JO, KW, KZ, MV, RU, RR, VA
3085 - New country: ME
3086
3087Mar 22nd, 2011
3088* Metadata changes:
3089 - New mobile-number pattern for AU
3090
3091Mar 10th, 2011
3092* New functionality:
3093 - New function to format a number with the preferred domestic carrier code used when parsing,
3094   falling back to a default calling code otherwise (formatNationalNumberWithPreferredCarrierCode).
3095 - We now store the preferred domestic carrier code used when the user calls parseAndKeepRawInput
3096 - New functionality to extract phone-numbers from text (findNumbers). This is just the first
3097   version - it does not extract ALPHA numbers such as 0800 CALL ME, or numbers where alternate
3098   endings are specified (such as 03-331 6005/6006).
3099* Code changes:
3100 - Tidying up the test file to use several pre-defined phone number constants
3101 - Fixing several lint errors
3102 - Added javadoc to formatNationalNumberWithCarrierCode
3103 - Fixed bug where a null pointer exception was thrown when getAsYouTypeFormatter was called with an
3104   invalid region code
3105 - Improved AsYouTypeFormatter to deal with countries with variable-length patterns such as LU
3106* Metadata changes:
3107 - Bug-fixes and updates for the following countries: BF, BO, BR, CL, CO, CR, DK, FO, GE, KR, KW,
3108   LA, LU, MU, SC, SH, TR, VE
3109 - New country: SH
3110
3111Mar 10th, 2011
3112* Code changes:
3113  - releasing the code to run the demo on localhost or appengine.
3114
3115Mar 7th, 2011
3116* Metadata changes:
3117 - Adding support for AC
3118
3119Feb 11th, 2011
3120* Metadata changes:
3121 - Update UAN number ranges for IM and JE.
3122
3123Feb 9th, 2011
3124* Code changes:
3125  - Better isNumberMatch method. This will now recognise numbers starting with a national prefix as
3126    an NSN_MATCH, instead of SHORT_NSN_MATCH.
3127    == Note Non-backwards-compatible API change here! ==
3128      This will no longer throw a NumberParseException - instead we will return NOT_A_NUMBER if one
3129      or other of the numbers provided do not match.
3130  - New number-type UAN now supported in the code. This represents Company Numbers or Universally
3131    Accessible Numbers.
3132* Metadata changes:
3133  - Bug-fixes and updates for the following countries: AG, AZ, BA, BE, CA, CU, ES, FI, GB, GD, GG,
3134    IE, IL, IM, IN, IR, IT, JE, JP, KR, KW, NG, NZ, PK, PS, PT, RU, SE, SG, SY, US
3135  - New countries: CO, LU, LY, MC, SM
3136  - Addition of "Personal Number" ranges to all NANPA countries
3137
3138Jan 31st, 2011
3139* Code changes:
3140  - Introducing equals() and hashCode() methods for the Phonenumber.PhoneNumber class
3141
3142Jan 28th, 2011
3143* Code changes:
3144  - Fixing critical bug with non-Android-compatible code. isEmpty() was being used and CANON_EQ in
3145    reg-ex matches.
3146
3147Jan 20th, 2011
3148* Code improvements:
3149  - Handle null phone-numbers when parsing by throwing a NumberParseException.
3150  - Handle extension written with an accented "o", as per Spanish, when parsing.
3151  - Handle U+30FC dashes as phone-number punctuation.
3152  - Allow "ZZ" or null regions to be specified for numbers starting with a full-width "+" symbol, or
3153    with other characters (such as whitespace) before the leading +.
3154  - new getLengthOfNationalDestinationCode function
3155* Metadata changes:
3156  - New types of numbers introduced: UAN (universal or "company" numbers) and short codes. Note that
3157    "generalDesc" patterns do not encompass short-codes.  No code-support for these has been
3158    introduced as of yet. We are also now enabling the collection of data for information such as
3159    area-code-optional, and no-international-dialling ranges.
3160  - Data updates as per ITU notifications/bug fixes for the following countries: AM, BH, CD, CG, CR,
3161    DE, DJ, EE, GB, GN, HU, IE, JO, JP, LB, LR, MA, MK, MN, MR, NA, PG, SC, SG, SO, SZ, VN, ZA, ZW
3162  - Data added for the following countries: BZ, CU, EC, FO, GI, HN, HT, LK, MT, MV, NU, PS, SD
3163  - Indentation fixes in reg-exes for the following countries: BG, GB
3164  - Allow nationalPrefixForParsing to be specified for countries with no national prefix, to handle
3165    possible carrier prefixes
3166
3167Jan 3rd, 2011
3168* Metadata changes:
3169  - Updates to JE
3170  - Updated comments for GB/GG/IM/JE
3171
3172November 25th, 2010
3173* Metadata changes:
3174  - Updates to existing countries: AD, AG, AI, AN, AS, BB, BG, BM, BS, BW, CA, DM, DO, GD, GH, GM,
3175    GU, IN, JM, KN, KY, KZ, LB, LC, MP, MS, PR, SY, TC, TT, TZ, US, VC, VG, VI.
3176  - Reorganize reg-exes for better readability.
3177  - Updated comments.
3178
3179October 22nd, 2010
3180* Metadata changes:
3181  - Updates to existing countries: AE, GB, GG, IM, JE
3182
3183October 15th, 2010
3184* Code improvements:
3185  - Allowed parsing of numbers that start with "++" or a full-width "+" symbol
3186  - Allowed reg-exes for national and possible number patterns to have white space in them in the
3187    source XML file
3188  - Added a more useful toString method for the phone number proto class
3189* Metadata changes:
3190  - Updates to existing countries: AF, BF, BO, ES, GB, GG, IM, IS, JE, JE, JP, KR, PE, PT, RU, SE,
3191    TT, ZW
3192* Bug fixes:
3193  - Parsing empty strings with invalid region codes no longer throws a null pointer exception
3194
3195September 4th, 2010
3196* Code improvement:
3197  - Added new phone number type: pager
3198* Metadata change:
3199  - update to existing country: GG, IM, JE, RS, RU
3200* Bug fixes:
3201  - ArrayOutOfBoundException in AsYouTypeFormatter.getRememberedPosition()
3202  - AsYouTypeFormatter for UK childline number
3203
3204September 1st, 2010
3205* Bug fix on KZ metadata.
3206
3207August 17th, 2010
3208* Code improvement:
3209  - Refactored BuildMetadataProtoFromXml.java into BuildMetadataFromXml.java and
3210    BuildMetadataProtoFromXml.java
3211  - Added BuildMetadataProtoFromXml.java and JSArrayBuilder.java
3212  - Refactored CountryCodeToRegionCodeMap and CountryCodeToRegionCodeMapForTesting into separate
3213    files.
3214
3215August 16th, 2010
3216* Bug fixes
3217  - AsYouTypeFormatter for formatting Chinese geographical numbers entered in national format.
3218  - AsYouTypeFormatter for formatting Chinese 400/800 numbers entered in national format.
3219* Metadata change:
3220  - new countries: AM, AN, BH, GL, IS
3221  - adding national prefix 1 to all NANPA countries.
3222  - update to existing countries: BF, FR, UK, PK, RE
3223
3224August 4th, 2010
3225* Further improve startup performance
3226  - Preload no country specific metadata at startup.
3227  - Stop creating the file containing mapping from country calling code to region code and loading
3228    it at startup; instead, do the initialization in PhoneNumberUtil.
3229
3230July 31th, 2010
3231
3232* Improve startup performance
3233  - Separate generated metadata binary file to one file per region
3234  - Preload US at start up, and load other region at the time when needed
3235  - Create a file containing mapping from country calling code to region code, and load it at
3236    startup
3237  - Same change also applied to unittests
3238
3239July 30th, 2010
3240* Metadata change:
3241  - new country: TL
3242  - update to existing country: AZ, CN, FR, GH, JO, LA, PG, PK, QA, SZ, UA, VN
3243
3244* Code improvement
3245  - China local number formatting for AsYouTypeFormatter
3246  - improve extension parsing to handle number in the form of +1 (645) 123 1234 ext. 910#
3247