If you need a date format not shown above, then use a self-defined format composed from the ISO format token specifiers below. The following examples illustrate the usage of constants from the table below to create self-defined ISO formats. The format length is unlimited. Also, multiple usage of format constants is allowed.
The accepted format specifiers can be changed from ISO Format to
PHP's date format if you are more comfortable with it. However, not
all formats defined in the ISO norm are supported with
PHP's date format specifiers. Use the
Zend_Date::setOptions(array('format_type' => 'php')) method to
switch Zend_Date methods from supporting ISO
format specifiers to PHP date() type
specifiers (see Self-Defined OUTPUT
Formats Using PHP's date() Format Specifiers below).
Example 172. Self-Defined ISO Formats
<?php
$locale = new Zend_Locale('de_AT');
$date = new Zend_Date(1234567890, false, $locale);
print $date->toString("'Era:GGGG='GGGG, ' Date:yy.MMMM.dd'yy.MMMM.dd");
Table 61. Constants for ISO 8601 Date Output
| Constant | Description | Corresponds best to | Result |
|---|---|---|---|
| G | Epoch, localized, abbreviated | Zend_Date::ERA |
AD |
| GG | Epoch, localized, abbreviated | Zend_Date::ERA |
AD |
GGG |
Epoch, localized, abbreviated | Zend_Date::ERA |
AD |
GGGG |
Epoch, localized, complete | Zend_Date::ERA_NAME |
anno domini |
GGGGG |
Epoch, localized, abbreviated | Zend_Date::ERA |
a |
| y | Year, at least one digit | Zend_Date::YEAR |
9 |
| yy | Year, at least two digit | Zend_Date::YEAR_SHORT |
09 |
| yyy | Year, at least three digit | Zend_Date::YEAR |
2009 |
| yyyy | Year, at least four digit | Zend_Date::YEAR |
2009 |
| yyyyy | Year, at least five digit | Zend_Date::YEAR |
02009 |
| Y | Year according to ISO 8601, at least one digit | Zend_Date::YEAR_8601 |
9 |
| YY | Year according to ISO 8601, at least two digit | Zend_Date::YEAR_SHORT_8601 |
09 |
YYY |
Year according to ISO 8601, at least three digit | Zend_Date::YEAR_8601 |
2009 |
YYYY |
Year according to ISO 8601, at least four digit | Zend_Date::YEAR_8601 |
2009 |
YYYYY |
Year according to ISO 8601, at least five digit | Zend_Date::YEAR_8601 |
02009 |
| M | Month, one or two digit | Zend_Date::MONTH_SHORT |
2 |
| MM | Month, two digit | Zend_Date::MONTH |
02 |
MMM |
Month, localized, abbreviated | Zend_Date::MONTH_NAME_SHORT |
Feb |
MMMM |
Month, localized, complete | Zend_Date::MONTH_NAME |
February |
MMMMM |
Month, localized, abbreviated, one digit | Zend_Date::MONTH_NAME_NARROW |
F |
| w | Week, one or two digit | Zend_Date::WEEK |
5 |
| ww | Week, two digit | Zend_Date::WEEK |
05 |
| d | Day of the month, one or two digit | Zend_Date::DAY_SHORT |
9 |
| dd | Day of the month, two digit | Zend_Date::DAY |
09 |
| D | Day of the year, one, two or three digit | Zend_Date::DAY_OF_YEAR |
7 |
| DD | Day of the year, two or three digit | Zend_Date::DAY_OF_YEAR |
07 |
DDD |
Day of the year, three digit | Zend_Date::DAY_OF_YEAR |
007 |
| E | Day of the week, localized, abbreviated, one char | Zend_Date::WEEKDAY_NARROW |
M |
| EE | Day of the week, localized, abbreviated, two or more chars | Zend_Date::WEEKDAY_NAME |
Mo |
EEE |
Day of the week, localized, abbreviated, three chars | Zend_Date::WEEKDAY_SHORT |
Mon |
EEEE |
Day of the week, localized, complete | Zend_Date::WEEKDAY |
Monday |
EEEEE |
Day of the week, localized, abbreviated, one digit | Zend_Date::WEEKDAY_NARROW |
M |
| e | Number of the day, one digit | Zend_Date::WEEKDAY_DIGIT |
4 |
| ee | Number of the day, two digit | Zend_Date::WEEKDAY_NARROW |
04 |
| a | Time of day, localized | Zend_Date::MERIDIEM |
vorm. |
| h | Hour, (1-12), one or two digit | Zend_Date::HOUR_SHORT_AM |
2 |
| hh | Hour, (01-12), two digit | Zend_Date::HOUR_AM |
02 |
| H | Hour, (0-23), one or two digit | Zend_Date::HOUR_SHORT |
2 |
| HH | Hour, (00-23), two digit | Zend_Date::HOUR |
02 |
| m | Minute, (0-59), one or two digit | Zend_Date::MINUTE_SHORT |
2 |
| mm | Minute, (00-59), two digit | Zend_Date::MINUTE |
02 |
| s | Second, (0-59), one or two digit | Zend_Date::SECOND_SHORT |
2 |
| ss | Second, (00-59), two digit | Zend_Date::SECOND |
02 |
| S | Millisecond | Zend_Date::MILLISECOND |
20536 |
| z | Time zone, localized, abbreviated | Zend_Date::TIMEZONE |
CET |
| zz | Time zone, localized, abbreviated | Zend_Date::TIMEZONE |
CET |
| zzz | Time zone, localized, abbreviated | Zend_Date::TIMEZONE |
CET |
| zzzz | Time zone, localized, complete | Zend_Date::TIMEZONE_NAME |
Europe/Paris |
| Z | Difference of time zone | Zend_Date::GMT_DIFF |
+0100 |
| ZZ | Difference of time zone | Zend_Date::GMT_DIFF |
+0100 |
ZZZ |
Difference of time zone | Zend_Date::GMT_DIFF |
+0100 |
ZZZZ |
Difference of time zone, separated | Zend_Date::GMT_DIFF_SEP |
+01:00 |
| A | Milliseconds from the actual day | Zend_Date::MILLISECOND |
20563 |
Note
Note that the default ISO format differs from PHP's format which can be irritating if you have not used in previous. Especially the format specifiers for Year and Minute are often not used in the intended way.
For year there are two specifiers available which are often mistaken. The Y specifier for the ISO year and the y specifier for the real year. The difference is small but significant. Y calculates the ISO year, which is often used for calendar formats. See for example the 31. December 2007. The real year is 2007, but it is the first day of the first week in the week 1 of the year 2008. So, if you are using 'dd.MM.yyyy' you will get '31.December.2007' but if you use 'dd.MM.YYYY' you will get '31.December.2008'. As you see this is no bug but a expected behaviour depending on the used specifiers.
For minute the difference is not so big. ISO uses the specifier m for the minute, unlike PHP which uses i. So if you are getting no minute in your format check if you have used the right specifier.