From e36ffded16c49b15c5f229ee1ea6b63fea60b435 Mon Sep 17 00:00:00 2001 From: funson86 Date: Sun, 26 Oct 2014 22:34:48 +0800 Subject: [PATCH] new translation --- docs/guide-zh-CN/output-formatter.md | 63 ---------------------------- 1 file changed, 63 deletions(-) diff --git a/docs/guide-zh-CN/output-formatter.md b/docs/guide-zh-CN/output-formatter.md index 1866caccb3..2587ce54bf 100644 --- a/docs/guide-zh-CN/output-formatter.md +++ b/docs/guide-zh-CN/output-formatter.md @@ -3,16 +3,11 @@ Yii提供一个格式化类来格式化输出，以使输出数据对终端用户更友好易读， [[yii\i18n\Formatter]] 是一个助手类，作为 [应用组件](structure-application-components.md) 使用，默认名为`formatter`。 -For formatting of outputs Yii provides a formatter class to make data more readable for users. -[[yii\i18n\Formatter]] is a helper class that is registered as an [application component](structure-application-components.md) named `formatter` by default. 它提供一些方法用来格式化数据，如日期/时间、数字或其他常用的本地化格式， 两种方式使用格式器： -It provides a set of methods for data formatting purpose such as date/time values, numbers and other commonly used formats in a localized way. -The formatter can be used in two different ways. 1. 直接使用格式化方法(所有的格式器方法以 `as`做前缀): -1. Using the formatting methods (all formatter methods prefixed with `as`) directly: ```php echo Yii::$app->formatter->asDate('2014-01-01', 'long'); // 输出: January 1, 2014 @@ -39,12 +34,6 @@ The formatter can be used in two different ways. 然后格式器根据当前区域为日期和数字选择正确的格式，包括月份和星期也会转换到当前语言， 日期格式也会被 [[yii\i18n\Formatter::timeZone|timeZone]] 参数影响， 该参数如果没有明确配置会使用应用的 [[yii\base\Application::timeZone|from the application]] 参数。 -All output of the formatter is localized when the [PHP intl extension](http://php.net/manual/en/book.intl.php) is installed. -You can configure the [[yii\i18n\Formatter::locale|locale]] property of the formatter for this. If not configured, the -application [[yii\base\Application::language|language]] is used as the locale. See the [section on internationalization](tutorial-i18n.md) for more details. -The Formatter will then choose the correct format for dates and numbers according to the locale including names of month and -week days translated to the current language. Date formats are also affected by the [[yii\i18n\Formatter::timeZone|timeZone]] -which will also be taken [[yii\base\Application::timeZone|from the application]] if not configured explicitly. 日期格式根据不同区域输出不同的结果，如下例所示： For example the date format call will output different results for different locales: @@ -61,24 +50,15 @@ echo Yii::$app->formatter->asDate('2014-01-01'); // 输出: 1 января 2014 > 注意不管[PHP intl extension](http://php.net/manual/en/book.intl.php)有没有安装，PHP编译的ICU库不同，格式化结果可能不同， > 所以为确保不同环境下得到相同的输出，推荐在每个环境下安装PHP intl扩展以及相同的ICU库， > 可参考： [为国际化设置PHP环境](tutorial-i18n.md#setup-environment). -> Note that formatting may differ between different versions of the ICU library compiled with PHP and also based on the fact whether the -> [PHP intl extension](http://php.net/manual/en/book.intl.php) is installed or not. So to ensure your website works with the same output -> in all environments it is recommended to install the PHP intl extension in all environments and verify that the version of the ICU library -> is the same. See also: [Setting up your PHP environment for internationalization](tutorial-i18n.md#setup-environment). 配置格式器 -Configuring the formatter ------------------------- 可配置[[yii\i18n\Formatter|formatter class]]的属性来调整格式器方法的默认格式， 可以在[应用主体配置](concept-configurations.md#application-configurations) 中配置 `formatter` 组件应用到整个项目， 配置样例如下所示， 更多关于可用属性的详情请参考 [[yii\i18n\Formatter|API documentation of the Formatter class]] 和接下来一小节。 -The default formats used by the formatter methods can be adjusted using the properties of the [[yii\i18n\Formatter|formatter class]]. -You can adjust these values application wide by configuring the `formatter` component in your [application config](concept-configurations.md#application-configurations). -An example configuration is shown in the following. -For more details about the available properties check out the [[yii\i18n\Formatter|API documentation of the Formatter class]] and the following subsections. ```php 'components' => [ @@ -92,7 +72,6 @@ For more details about the available properties check out the [[yii\i18n\Formatt ``` 格式化日期和时间 -Formatting Date and Time values ------------------------------- 格式器类为格式化日期和时间提供了多个方法： @@ -103,27 +82,14 @@ The formatter class provides different methods for formatting date and time valu - [[yii\i18n\Formatter::asDatetime()|datetime]] - 值被格式化成日期和时间，如 `January, 01 2014 14:23`. - [[yii\i18n\Formatter::asTimestamp()|timestamp]] - 值被格式化成 [unix 时间戳](http://en.wikipedia.org/wiki/Unix_time) 如 `1412609982`. - [[yii\i18n\Formatter::asRelativeTime()|relativeTime]] - 值被格式化成和当前时间比较的时间间隔并用人们易读的格式，如`1 hour ago`. -- [[yii\i18n\Formatter::asDate()|date]] - the value is formatted as a date e.g. `January, 01 2014`. -- [[yii\i18n\Formatter::asTime()|time]] - the value is formatted as a time e.g. `14:23`. -- [[yii\i18n\Formatter::asDatetime()|datetime]] - the value is formatted as date and time e.g. `January, 01 2014 14:23`. -- [[yii\i18n\Formatter::asTimestamp()|timestamp]] - the value is formatted as a [unix timestamp](http://en.wikipedia.org/wiki/Unix_time) e.g. `1412609982`. -- [[yii\i18n\Formatter::asRelativeTime()|relativeTime]] - the value is formatted as the time interval between a date - and now in human readable form e.g. `1 hour ago`. 可配置格式器的属性[[yii\i18n\Formatter::$dateFormat|$dateFormat]], [[yii\i18n\Formatter::$timeFormat|$timeFormat]] 和[[yii\i18n\Formatter::$datetimeFormat|$datetimeFormat]]来全局指定[[yii\i18n\Formatter::asDate()|date]], [[yii\i18n\Formatter::asTime()|time]] 和 [[yii\i18n\Formatter::asDatetime()|datetime]] 方法的日期和时间格式。 -The date and time format for the [[yii\i18n\Formatter::asDate()|date]], [[yii\i18n\Formatter::asTime()|time]], and -[[yii\i18n\Formatter::asDatetime()|datetime]] method can be specified globally by configuring the formatters -properties [[yii\i18n\Formatter::$dateFormat|$dateFormat]], [[yii\i18n\Formatter::$timeFormat|$timeFormat]], and -[[yii\i18n\Formatter::$datetimeFormat|$datetimeFormat]]. 格式器默认会使用一个快捷格式，它根据当前启用的区域来解析， 这样日期和时间会格式化成用户国家和语言通用的格式， 有四种不同的快捷格式： -By default the formatter uses a shortcut format that is interpreted differently according to the currently active locale -so that dates and times are formatted in a way that is common for the users country and language. -There are four different shortcut formats available: - `en_GB`区域的 `short` 会打印日期为 `06/10/2014`，时间为 `15:58` - `medium` 会分别打印 `6 Oct 2014` 和 `15:58:42`, @@ -133,10 +99,6 @@ There are four different shortcut formats available: 另外你可使用[ICU 项目](http://site.icu-project.org/) 定义的语法来自定义格式， ICU项目在该URL：下的手册有介绍， 或者可使用PHP [date()](http://php.net/manual/de/function.date.php) 方法的语法字符串并加上前缀`php:`. -Additionally you can specify custom formats using the syntax defined by the -[ICU Project](http://site.icu-project.org/) which is described in the ICU manual under the following URL: -. Alternatively you can use the syntax that can be recognized by the -PHP [date()](http://php.net/manual/de/function.date.php)-function using a string that is prefixed with `php:`. ```php // ICU 格式化 @@ -146,15 +108,10 @@ echo Yii::$app->formatter->asDate('now', 'php:Y-m-d'); // 2014-10-06 ``` ### 时区 -### Time zones 当格式化日期和时间时，Yii会将它们转换为对应的 [[yii\i18n\Formatter::timeZone|configured time zone]] 时区， 输入的值在没有指定时区时候会被当作UTC时间，因此，推荐存储所有的日期和时间为UTC而不是UNIX时间戳，UNIX通常也是UTC。 如果输入值所在的时区不同于UTC，时区应明确指定，如下所示： -When formatting date and time values, Yii will convert them to the [[yii\i18n\Formatter::timeZone|configured time zone]]. -Therefor the input value is assumed to be in UTC unless a time zone is explicitly given. For this reason -it is recommended to store all date and time values in UTC preferably as a UNIX timestamp, which is always UTC by definition. -If the input value is in a time zone different from UTC, the time zone has to be stated explicitly like in the following example: ```php // 假定 Yii::$app->timeZone = 'Europe/Berlin'; @@ -167,15 +124,9 @@ echo Yii::$app->formatter->asTime('2014-10-06 14:41:00 CEST'); // 14:41:00 > 可参考 [ICU manual](http://userguide.icu-project.org/datetime/timezone#TOC-Updating-the-Time-Zone-Data) > 关于更新时区数据库的详情， > 也可参考：[为国际化设置PHP环境](tutorial-i18n.md#setup-environment). -> Note: As time zones are subject to rules made by the governments around the world and may change frequently, it is -> likely that you do not have the latest information in the time zone database installed on your system. -> You may refer to the [ICU manual](http://userguide.icu-project.org/datetime/timezone#TOC-Updating-the-Time-Zone-Data) -> for details on updating the time zone database. -> See also: [Setting up your PHP environment for internationalization](tutorial-i18n.md#setup-environment). 格式化数字 -Formatting Numbers ------------------ 格式器类提供如下方法格式化数值： @@ -187,27 +138,14 @@ For formatting numeric values the formatter class provides the following methods - [[yii\i18n\Formatter::asScientific()|scientific]] - 值被格式化成科学计数型，如`4.2E4`. - [[yii\i18n\Formatter::asCurrency()|currency]] - 值被格式化成货币格式，如 `£420.00`. - [[yii\i18n\Formatter::asSize()|size]] - 字节值被格式化成易读的值，如 `410 kibibytes`. -- [[yii\i18n\Formatter::asShortSize()|shortSize]] - [[yii\i18n\Formatter::asSize()|size]] 的缩写值，如 `410 KiB`. -- [[yii\i18n\Formatter::asInteger()|integer]] - the value is formatted as an integer e.g. `42`. -- [[yii\i18n\Formatter::asDecimal()|decimal]] - the value is formatted as a decimal number considering decimal and thousand separators e.g. `42.123`. -- [[yii\i18n\Formatter::asPercent()|percent]] - the value is formatted as a percent number e.g. `42%`. -- [[yii\i18n\Formatter::asScientific()|scientific]] - the value is formatted as a number in scientific format e.g. `4.2E4`. -- [[yii\i18n\Formatter::asCurrency()|currency]] - the value is formatted as a currency value e.g. `£420.00`. -- [[yii\i18n\Formatter::asSize()|size]] - the value that is a number of bytes is formatted as a human readable size e.g. `410 kibibytes`. -- [[yii\i18n\Formatter::asShortSize()|shortSize]] - is the short version of [[yii\i18n\Formatter::asSize()|size]], e.g. `410 KiB`. 可配置[[yii\i18n\Formatter::decimalSeparator|decimalSeparator]] 和 [[yii\i18n\Formatter::thousandSeparator|thousandSeparator]] 属性来调整数字格式化的格式，默认和当前区域相同。 -The format for number formatting can be adjusted using the [[yii\i18n\Formatter::decimalSeparator|decimalSeparator]] and -[[yii\i18n\Formatter::thousandSeparator|thousandSeparator]] which are set by default according to the locale. 更多高级配置， [[yii\i18n\Formatter::numberFormatterOptions]] 和 [[yii\i18n\Formatter::numberFormatterTextOptions]] 可用于配置内部使用 [Numberformatter class](http://php.net/manual/en/class.numberformatter.php) -For more advanced configuration, [[yii\i18n\Formatter::numberFormatterOptions]] and [[yii\i18n\Formatter::numberFormatterTextOptions]] -can be used to configure the interally used [Numberformatter class](http://php.net/manual/en/class.numberformatter.php) 为调整数字的小数部分的最大值和最小值，可配置如下属性： -For example to adjust the maximum and minimum value of fraction digits you can configure this property like the following: ```php [ @@ -217,7 +155,6 @@ For example to adjust the maximum and minimum value of fraction digits you can c ``` 其他格式器 -Other formatters ---------------- 除了日期、时间和数字格式化外，Yii提供其他用途提供一些实用的格式器：