Enhance and clarify existing examples.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@298432 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Daniel Convissor 2010-04-24 14:30:17 +00:00
parent 96dc0a070e
commit 403d34a5c5
9 changed files with 86 additions and 98 deletions

View file

@ -58,26 +58,28 @@
<programlisting role="php">
<![CDATA[
<?php
$date = new DateTime("18-July-2008 16:30:30");
echo $date->format("d-m-Y H:i:s").'<br />';
$date = new DateTime('2000-01-01');
$date->add(new DateInterval('P10D'));
echo $date->format('Y-m-d H:i:s') . "\n";
date_add($date, new DateInterval("P5D"));
echo '<br />'.$date->format("d-m-Y").' : 5 Days';
$date = new DateTime('2000-01-01');
$date->add(new DateInterval('PT10H30S'));
echo $date->format('Y-m-d H:i:s') . "\n";
date_add($date, new DateInterval("P5M"));
echo '<br />'.$date->format("d-m-Y").' : 5 Months';
date_add($date, new DateInterval("P5Y"));
echo '<br />'.$date->format("d-m-Y").' : 5 Years';
date_add($date, new DateInterval("P5Y5M5D"));
echo '<br />'.$date->format("d-m-Y").' : 5 Days, 5 Months, 5 Years';
date_add($date, new DateInterval("P5YT5H"));
echo '<br />'.$date->format("d-m-Y H:i:s").' : 5 Years, 5 Hours';
$date = new DateTime('2000-01-01');
$date->add(new DateInterval('P7Y5M4DT4H3M2S'));
echo $date->format('Y-m-d H:i:s') . "\n";
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
2000-01-11 00:00:00
2000-01-01 10:00:30
2007-06-05 04:03:02
]]>
</screen>
</example>
</refsect1>

View file

@ -49,11 +49,8 @@
<programlisting role="php">
<![CDATA[
<?php
date_default_timezone_set('Europe/London');
$datetime = date_create('2008-08-03 14:52:10');
echo date_format($datetime, 'jS, F Y') . "\n";
echo date_format($datetime, DATE_ATOM);
$date = date_create('2000-01-01');
echo date_format($date, 'Y-m-d H:i:s');
?>
]]>
</programlisting>
@ -63,20 +60,15 @@ echo date_format($datetime, DATE_ATOM);
<programlisting role="php">
<![CDATA[
<?php
date_default_timezone_set('Europe/London');
$datetime = new DateTime('2008-08-03 14:52:10');
echo $datetime->format('jS, F Y') . "\n";
echo $datetime->format(DATE_ATOM);
?>
$date = new DateTime('2000-01-01');
echo $date->format('Y-m-d H:i:s');
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
3rd, August 2008
2008-08-03T14:52:10+01:00
2000-01-01 00:00:00
]]>
</screen>
</example>

View file

@ -40,13 +40,11 @@
<programlisting role="php">
<![CDATA[
<?php
date_default_timezone_set('Europe/London');
$winter = new DateTime('2008-12-25', new DateTimeZone('Europe/London'));
$summer = new DateTime('2008-07-14', new DateTimeZone('Europe/London'));
$winter = new DateTime('2008-12-25 14:25:41');
$summer = new DateTime('2008-07-14 14:25:41');
echo $winter->getOffset(); // Winter offset: 0
echo $summer->getOffset(); // Summer offset: 3600 = 1 hour
echo $winter->getOffset() . "\n"; // "0"
echo $summer->getOffset() . "\n"; // "3600" (= 1 hour)
?>
]]>
</programlisting>

View file

@ -36,19 +36,13 @@
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Setting and getting DateTimeZone objects</title>
<title><function>DateTime::getTimezone</function> example</title>
<programlisting role="php">
<![CDATA[
<?php
date_default_timezone_set('Europe/London');
$datetime = new DateTime('2008-08-03 12:35:23');
echo $datetime->getTimezone()->getName() . "\n";
$datetime = new DateTime('2008-08-03 12:35:23');
$la_time = new DateTimeZone('America/Los_Angeles');
$datetime->setTimezone($la_time);
echo $datetime->getTimezone()->getName();
$date = new DateTime(null, new DateTimeZone('Europe/London'));
$tz = $date->getTimezone();
echo $tz->getName();
?>
]]>
</programlisting>
@ -56,7 +50,6 @@ echo $datetime->getTimezone()->getName();
<screen>
<![CDATA[
Europe/London
America/Los_Angeles
]]>
</screen>
</example>

View file

@ -70,9 +70,9 @@
<programlisting role="php">
<![CDATA[
<?php
$date = new DateTime("2006-12-12");
$date->modify("+1 day");
echo $date->format("Y-m-d");
$date = new DateTime('2006-12-12');
$date->modify('+1 day');
echo $date->format('Y-m-d');
?>
]]>
</programlisting>

View file

@ -89,12 +89,9 @@
<programlisting role="php">
<![CDATA[
<?php
date_default_timezone_set('Europe/London');
$datetime = new DateTime('2008-08-03 14:52:10');
$datetime->setDate(2008, 10, 12);
echo $datetime->format(DATE_RFC2822);
$date = new DateTime();
$date->setDate(2022, 3, 4);
echo $date->format('Y-m-d');
?>
]]>
</programlisting>
@ -104,19 +101,16 @@ echo $datetime->format(DATE_RFC2822);
<programlisting role="php">
<![CDATA[
<?php
date_default_timezone_set('Europe/London');
$datetime = date_create('2008-08-03 14:52:10');
date_date_set($datetime, 2008, 10, 12);
echo date_format($datetime, DATE_RFC2822);
$date = date_create();
date_date_set($date, 2022, 3, 4);
echo date_format($date, 'Y-m-d');
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
Sun, 12 Oct 2008 14:52:10 +0100
2022-03-04
]]>
</screen>
</example>

View file

@ -90,28 +90,41 @@
<programlisting role="php">
<![CDATA[
<?php
date_default_timezone_set('Europe/London');
$date = new DateTime();
$datetime = new DateTime();
$date->setISODate(2008, 2);
echo $date->format('Y-m-d') . "\n";
// Offset from start of week 2 (7) = 5
$datetime->setISODate(2008, 2, 5); // Day 5 of week 2 of 2008 is the 11th of January.
$date->setISODate(2008, 2, 1);
echo $date->format('Y-m-d') . "\n";
// Offset from start of week 2 (7) = 10
$datetime->setISODate(2008, 2, 10); // Day 10 of week 2 of 2008 is the 16th of January.
$date->setISODate(2008, 2, 7);
echo $date->format('Y-m-d') . "\n";
// Values exceeding ranges are added to their parent values.
$date->setISODate(2008, 2, 8);
echo $date->format('Y-m-d') . "\n";
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
2008-01-07
2008-01-07
2008-01-13
2008-01-14
]]>
</screen>
</example>
<example>
<title>Finding the month a week is in</title>
<programlisting role="php">
<![CDATA[
<?php
date_default_timezone_set('Europe/London');
$datetime = date_create();
date_isodate_set($datetime, 2008, 6); // Week 6 of 2008 is in February.
$date = new DateTime();
$date->setISODate(2008, 14);
echo $date->format('n'); // 3
?>
]]>
</programlisting>

View file

@ -72,23 +72,19 @@
<programlisting role="php">
<![CDATA[
<?php
date_default_timezone_set('Europe/London');
$date = new DateTime('2000-01-01', new DateTimeZone('Asia/Katmandu'));
echo $date->format('Y-m-d H:i:sP') . "\n";
$datetime = new DateTime('2008-08-03 12:35:23');
echo $datetime->getTimezone()->getName() . "\n";
$datetime = new DateTime('2008-08-03 12:35:23');
$la_time = new DateTimeZone('America/Los_Angeles');
$datetime->setTimezone($la_time);
echo $datetime->getTimezone()->getName();
$date->setTimezone(new DateTimeZone('Pacific/Chatham'));
echo $date->format('Y-m-d H:i:sP') . "\n";
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
Europe/London
America/Los_Angeles
2000-01-01 00:00:00+05:45
2000-01-01 08:00:00+13:45
]]>
</screen>
</example>

View file

@ -58,28 +58,28 @@
<programlisting role="php">
<![CDATA[
<?php
$date = new DateTime('2000-01-20');
$date->sub(new DateInterval('P10D'));
echo $date->format('Y-m-d H:i:s') . "\n";
$date = new DateTime("18-July-2008 16:30:30");
echo $date->format("d-m-Y H:i:s").'<br />';
date_sub($date, new DateInterval("P5D"));
echo '<br />'.$date->format("d-m-Y").' : 5 Days';
date_sub($date, new DateInterval("P5M"));
echo '<br />'.$date->format("d-m-Y").' : 5 Months';
date_sub($date, new DateInterval("P5Y"));
echo '<br />'.$date->format("d-m-Y").' : 5 Years';
date_sub($date, new DateInterval("P5Y5M5D"));
echo '<br />'.$date->format("d-m-Y").' : 5 Days, 5 Months, 5 Years';
date_sub($date, new DateInterval("P5YT5H"));
echo '<br />'.$date->format("d-m-Y H:i:s").' : 5 Years, 5 Hours';
$date = new DateTime('2000-01-20');
$date->sub(new DateInterval('PT10H30S'));
echo $date->format('Y-m-d H:i:s') . "\n";
$date = new DateTime('2000-01-20');
$date->sub(new DateInterval('P7Y5M4DT4H3M2S'));
echo $date->format('Y-m-d H:i:s') . "\n";
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
2000-01-10 00:00:00
2000-01-19 13:59:30
1992-08-15 19:56:58
]]>
</screen>
</example>
</refsect1>