| OLD | NEW |
| 1 Intl | 1 Intl |
| 2 ==== | 2 ==== |
| 3 | 3 |
| 4 This package provides internationalization and localization facilities, | 4 This package provides internationalization and localization facilities, |
| 5 including message translation, plurals and genders, date/number formatting | 5 including message translation, plurals and genders, date/number formatting |
| 6 and parsing, and bidirectional text. | 6 and parsing, and bidirectional text. |
| 7 | 7 |
| 8 ## General | 8 ## General |
| 9 The most important library is [intl][intl_lib]. It defines the [Intl][Intl] | 9 The most important library is [intl][intl_lib]. It defines the [Intl][Intl] |
| 10 class, with the default locale and methods for accessing most of the | 10 class, with the default locale and methods for accessing most of the |
| 11 internationalization mechanisms. This library also defines the | 11 internationalization mechanisms. This library also defines the |
| 12 [DateFormat][DateFormat], [NumberFormat][NumberFormat], and | 12 [DateFormat][DateFormat], [NumberFormat][NumberFormat], and |
| 13 [BidiFormatter][BidiFormatter] classes. | 13 [BidiFormatter][BidiFormatter] classes. |
| 14 | 14 |
| 15 ## Current locale | 15 ## Current locale |
| 16 | 16 |
| 17 The package has a single current locale, called [defaultLocale][defaultLocale]. | 17 The package has a single current locale, called [defaultLocale][defaultLocale]. |
| 18 Operations will use that locale unless told to do otherwise. | 18 Operations will use that locale unless told to do otherwise. |
| 19 | 19 |
| 20 To set the global locale, you can explicitly set it, e.g. | 20 You can explicitly set the global locale |
| 21 | 21 |
| 22 Intl.defaultLocale = 'pt_BR'; | 22 Intl.defaultLocale = 'pt_BR'; |
| 23 | 23 |
| 24 or get it from the browser by | 24 or get it from the browser |
| 25 | 25 |
| 26 import "package:intl/intl_browser.dart"; | 26 import "package:intl/intl_browser.dart"; |
| 27 ... | 27 ... |
| 28 findSystemLocale().then(runTheRestOfMyProgram); | 28 findSystemLocale().then(runTheRestOfMyProgram); |
| 29 | 29 |
| 30 To temporarily override the current locale, pass the operation | 30 To override the current locale for a particular operation, pass the operation |
| 31 to [withLocale][withLocale]. | 31 to [withLocale][withLocale]. Note that this includes async tasks |
| 32 spawned from that operation, and that the argument to |
| 33 [withLocale][withLocale] |
| 34 will supercede the [defaultLocale][defaultLocale] while the operation |
| 35 is active. If you are using different locales within an application, |
| 36 the [withLocale][withLocale] operation may be preferable to setting |
| 37 [defaultLocale][defaultLocale]. |
| 32 | 38 |
| 33 Intl.withLocale('fr', () => print(myLocalizedMessage()); | 39 Intl.withLocale('fr', () => print(myLocalizedMessage()); |
| 34 | 40 |
| 35 To override it for a very specific operation you can create a format object in | 41 To specify the locale for an operation you can create a format object in |
| 36 a specific locale, or pass in the locale as a parameter to methods. | 42 a specific locale, or pass in the locale as a parameter to methods. |
| 37 | 43 |
| 38 var format = new DateFormat.yMd("ar"); | 44 var format = new DateFormat.yMd("ar"); |
| 39 var dateString = format.format(new DateTime.now()); | 45 var dateString = format.format(new DateTime.now()); |
| 40 print(myMessage(dateString, locale: 'ar'); | 46 print(myMessage(dateString, locale: 'ar'); |
| 41 | 47 |
| 42 ## Initialization | 48 ## Initialization |
| 43 | 49 |
| 44 All the different types of locale data require an async initialization step | 50 All the different types of locale data require an async initialization step |
| 45 to make | 51 to make |
| (...skipping 245 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 291 [NumberFormat]: https://api.dartlang.org/apidocs/channels/stable/dartdoc-viewer/
intl/intl.NumberFormat | 297 [NumberFormat]: https://api.dartlang.org/apidocs/channels/stable/dartdoc-viewer/
intl/intl.NumberFormat |
| 292 [withLocale]: https://api.dartlang.org/apidocs/channels/stable/dartdoc-viewer/in
tl/intl.Intl#id_withLocale | 298 [withLocale]: https://api.dartlang.org/apidocs/channels/stable/dartdoc-viewer/in
tl/intl.Intl#id_withLocale |
| 293 [defaultLocale]: https://api.dartlang.org/apidocs/channels/stable/dartdoc-viewer
/intl/intl.Intl#id_defaultLocale | 299 [defaultLocale]: https://api.dartlang.org/apidocs/channels/stable/dartdoc-viewer
/intl/intl.Intl#id_defaultLocale |
| 294 [Intl.message]: https://api.dartlang.org/apidocs/channels/stable/dartdoc-viewer/
intl/intl.Intl#id_message | 300 [Intl.message]: https://api.dartlang.org/apidocs/channels/stable/dartdoc-viewer/
intl/intl.Intl#id_message |
| 295 [Intl.plural]: https://api.dartlang.org/apidocs/channels/stable/dartdoc-viewer/i
ntl/intl.Intl#id_plural | 301 [Intl.plural]: https://api.dartlang.org/apidocs/channels/stable/dartdoc-viewer/i
ntl/intl.Intl#id_plural |
| 296 [Intl.gender]: https://api.dartlang.org/apidocs/channels/stable/dartdoc-viewer/i
ntl/intl.Intl#id_gender | 302 [Intl.gender]: https://api.dartlang.org/apidocs/channels/stable/dartdoc-viewer/i
ntl/intl.Intl#id_gender |
| 297 [DateTime]: https://api.dartlang.org/apidocs/channels/stable/dartdoc-viewer/dart
:core.DateTime | 303 [DateTime]: https://api.dartlang.org/apidocs/channels/stable/dartdoc-viewer/dart
:core.DateTime |
| 298 [BidiFormatter]: https://api.dartlang.org/apidocs/channels/stable/dartdoc-viewer
/intl/intl.BidiFormatter | 304 [BidiFormatter]: https://api.dartlang.org/apidocs/channels/stable/dartdoc-viewer
/intl/intl.BidiFormatter |
| 299 [BidiFormatter.RTL]: https://api.dartlang.org/apidocs/channels/stable/dartdoc-vi
ewer/intl/intl.BidiFormatter#id_BidiFormatter-RTL | 305 [BidiFormatter.RTL]: https://api.dartlang.org/apidocs/channels/stable/dartdoc-vi
ewer/intl/intl.BidiFormatter#id_BidiFormatter-RTL |
| 300 [BidiFormatter.LTR]: https://api.dartlang.org/apidocs/channels/stable/dartdoc-vi
ewer/intl/intl.BidiFormatter#id_BidiFormatter-LTR | 306 [BidiFormatter.LTR]: https://api.dartlang.org/apidocs/channels/stable/dartdoc-vi
ewer/intl/intl.BidiFormatter#id_BidiFormatter-LTR |
| OLD | NEW |