octicon-mirror(24/)
php/yii2
octicon-rss(16/)
1
0
octicon-repo-forked(16/)Fork 0
mirror of https://github.com/yiisoft/yii2.git synced 2025-11-10 02:13:17 +08:00
octicon-code(16/) Code octicon-issue-opened(16/) Issues octicon-package(16/) Packages octicon-project(16/) Projects octicon-tag(16/) Releases octicon-book(16/) Wiki octicon-pulse(16/) Activity

improved formatter documentation

Browse Source
This commit is contained in:
octicon-git-branch(16/)
octicon-tag(16/)
Carsten Brandt
2017-06-06 11:43:34 +02:00
gitea-unlock(16/)
parent cf9787ddef
commit b056dff031
octicon-diff(16/tw-mr-1) 1 changed files with 22 additions and 6 deletions
gitea-whitespace(16/)
gitea-join(16/)
octicon-kebab-horizontal(16/)
Download Patch File Download Diff File Expand all files Collapse all files

28
framework/i18n/Formatter.php
View File

@@ -86,6 +86,9 @@ class Formatter extends Component
* *
* It defaults to `UTC` so you only have to adjust this value if you store datetime values in another time zone in your database. * It defaults to `UTC` so you only have to adjust this value if you store datetime values in another time zone in your database.
* *
* Note that a UNIX timestamp is always in UTC by its definition. That means that specifying a default time zone different from
* UTC has no effect on date values given as UNIX timestamp.
*
* @since 2.0.1 * @since 2.0.1
*/ */
public $defaultTimeZone = 'UTC'; public $defaultTimeZone = 'UTC';
@@ -466,10 +469,15 @@ class Formatter extends Component
* @param int|string|DateTime $value the value to be formatted. The following * @param int|string|DateTime $value the value to be formatted. The following
* types of value are supported: * types of value are supported:
* *
* - an integer representing a UNIX timestamp * - an integer representing a UNIX timestamp. A UNIX timestamp is always in UTC by its definition.
* - a string that can be [parsed to create a DateTime object](http://php.net/manual/en/datetime.formats.php). * - a string that can be [parsed to create a DateTime object](http://php.net/manual/en/datetime.formats.php).
* The timestamp is assumed to be in [[defaultTimeZone]] unless a time zone is explicitly given. * The timestamp is assumed to be in [[defaultTimeZone]] unless a time zone is explicitly given.
* - a PHP [DateTime](http://php.net/manual/en/class.datetime.php) object * - a PHP [DateTime](http://php.net/manual/en/class.datetime.php) object. You may set the time zone
* for the DateTime object to specify the source time zone.
*
* The formatter will convert date values according to [[timeZone]] before formatting it.
* If no timezone conversion should be performed, you need to set [[defaultTimeZone]] and [[timeZone]] to the same value.
* Also no conversion will be performed on values that have no time information, e.g. `"2017-06-05"`.
* *
* @param string $format the format used to convert the value into a date string. * @param string $format the format used to convert the value into a date string.
* If null, [[dateFormat]] will be used. * If null, [[dateFormat]] will be used.
@@ -498,10 +506,14 @@ class Formatter extends Component
* @param int|string|DateTime $value the value to be formatted. The following * @param int|string|DateTime $value the value to be formatted. The following
* types of value are supported: * types of value are supported:
* *
* - an integer representing a UNIX timestamp * - an integer representing a UNIX timestamp. A UNIX timestamp is always in UTC by its definition.
* - a string that can be [parsed to create a DateTime object](http://php.net/manual/en/datetime.formats.php). * - a string that can be [parsed to create a DateTime object](http://php.net/manual/en/datetime.formats.php).
* The timestamp is assumed to be in [[defaultTimeZone]] unless a time zone is explicitly given. * The timestamp is assumed to be in [[defaultTimeZone]] unless a time zone is explicitly given.
* - a PHP [DateTime](http://php.net/manual/en/class.datetime.php) object * - a PHP [DateTime](http://php.net/manual/en/class.datetime.php) object. You may set the time zone
* for the DateTime object to specify the source time zone.
*
* The formatter will convert date values according to [[timeZone]] before formatting it.
* If no timezone conversion should be performed, you need to set [[defaultTimeZone]] and [[timeZone]] to the same value.
* *
* @param string $format the format used to convert the value into a date string. * @param string $format the format used to convert the value into a date string.
* If null, [[timeFormat]] will be used. * If null, [[timeFormat]] will be used.
@@ -530,10 +542,14 @@ class Formatter extends Component
* @param int|string|DateTime $value the value to be formatted. The following * @param int|string|DateTime $value the value to be formatted. The following
* types of value are supported: * types of value are supported:
* *
* - an integer representing a UNIX timestamp * - an integer representing a UNIX timestamp. A UNIX timestamp is always in UTC by its definition.
* - a string that can be [parsed to create a DateTime object](http://php.net/manual/en/datetime.formats.php). * - a string that can be [parsed to create a DateTime object](http://php.net/manual/en/datetime.formats.php).
* The timestamp is assumed to be in [[defaultTimeZone]] unless a time zone is explicitly given. * The timestamp is assumed to be in [[defaultTimeZone]] unless a time zone is explicitly given.
* - a PHP [DateTime](http://php.net/manual/en/class.datetime.php) object * - a PHP [DateTime](http://php.net/manual/en/class.datetime.php) object. You may set the time zone
* for the DateTime object to specify the source time zone.
*
* The formatter will convert date values according to [[timeZone]] before formatting it.
* If no timezone conversion should be performed, you need to set [[defaultTimeZone]] and [[timeZone]] to the same value.
* *
* @param string $format the format used to convert the value into a date string. * @param string $format the format used to convert the value into a date string.
* If null, [[dateFormat]] will be used. * If null, [[dateFormat]] will be used.