-
Notifications
You must be signed in to change notification settings - Fork 704
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add createFromInterface() for DateTime objects
Closes GH-257. git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@352009 c90b9560-bf6c-de11-be94-00142212c4b1
- Loading branch information
Showing
3 changed files
with
172 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,85 @@ | ||
<?xml version="1.0" encoding="utf-8"?> | ||
<!-- $Revision$ --> | ||
|
||
<refentry xml:id="datetime.createfrominterface" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> | ||
<refnamediv> | ||
<refname>DateTime::createFromInterface</refname> | ||
<refpurpose>Returns new DateTime object encapsulating the given DateTimeInterface object</refpurpose> | ||
</refnamediv> | ||
|
||
<refsect1 role="description"> | ||
&reftitle.description; | ||
<methodsynopsis role="oop"> | ||
<modifier>public</modifier> <modifier>static</modifier> <type>DateTime</type><methodname>DateTime::createFromInterface</methodname> | ||
<methodparam><type>DateTimeInterface</type><parameter>object</parameter></methodparam> | ||
</methodsynopsis> | ||
</refsect1> | ||
|
||
<refsect1 role="parameters"> | ||
&reftitle.parameters; | ||
<para> | ||
<variablelist> | ||
<varlistentry> | ||
<term><parameter>object</parameter></term> | ||
<listitem> | ||
<para> | ||
The <classname>DateTimeInterface</classname> object that needs | ||
to be converted to a mutable version. This object is not modified, but | ||
instead a new <classname>DateTime</classname> object is | ||
created containing the same date, time, and timezone information. | ||
</para> | ||
</listitem> | ||
</varlistentry> | ||
</variablelist> | ||
</para> | ||
</refsect1> | ||
|
||
<refsect1 role="returnvalues"> | ||
&reftitle.returnvalues; | ||
<para> | ||
Returns a new <classname>DateTime</classname> instance. | ||
</para> | ||
</refsect1> | ||
|
||
<refsect1 role="examples"> | ||
&reftitle.examples; | ||
<para> | ||
<example> | ||
<title>Creating a mutable date time object</title> | ||
<programlisting role="php"> | ||
<![CDATA[ | ||
<?php | ||
$date = new DateTimeImmutable("2014-06-20 11:45 Europe/London"); | ||
$mutable = DateTime::createFromInterface($date); | ||
$date = new DateTime("2014-06-20 11:45 Europe/London"); | ||
$also_mutable = DateTime::createFromInterface($date); | ||
?> | ||
]]> | ||
</programlisting> | ||
</example> | ||
</para> | ||
</refsect1> | ||
</refentry> | ||
|
||
<!-- Keep this comment at the end of the file | ||
Local variables: | ||
mode: sgml | ||
sgml-omittag:t | ||
sgml-shorttag:t | ||
sgml-minimize-attributes:nil | ||
sgml-always-quote-attributes:t | ||
sgml-indent-step:1 | ||
sgml-indent-data:t | ||
indent-tabs-mode:nil | ||
sgml-parent-document:nil | ||
sgml-default-dtd-file:"~/.phpdoc/manual.ced" | ||
sgml-exposed-tags:nil | ||
sgml-local-catalogs:nil | ||
sgml-local-ecat-files:nil | ||
End: | ||
vim600: syn=xml fen fdm=syntax fdl=2 si | ||
vim: et tw=78 syn=sgml | ||
vi: ts=1 sw=1 | ||
--> |
85 changes: 85 additions & 0 deletions
85
reference/datetime/datetimeimmutable/createfrominterface.xml
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,85 @@ | ||
<?xml version="1.0" encoding="utf-8"?> | ||
<!-- $Revision$ --> | ||
|
||
<refentry xml:id="datetimeimmutable.createfrominterface" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> | ||
<refnamediv> | ||
<refname>DateTimeImmutable::createFromInterface</refname> | ||
<refpurpose>Returns new DateTimeImmutable object encapsulating the given DateTimeInterface object</refpurpose> | ||
</refnamediv> | ||
|
||
<refsect1 role="description"> | ||
&reftitle.description; | ||
<methodsynopsis role="oop"> | ||
<modifier>public</modifier> <modifier>static</modifier> <type>DateTimeImmutable</type><methodname>DateTimeImmutable::createFromInterface</methodname> | ||
<methodparam><type>DateTimeInterface</type><parameter>object</parameter></methodparam> | ||
</methodsynopsis> | ||
</refsect1> | ||
|
||
<refsect1 role="parameters"> | ||
&reftitle.parameters; | ||
<para> | ||
<variablelist> | ||
<varlistentry> | ||
<term><parameter>object</parameter></term> | ||
<listitem> | ||
<para> | ||
The <classname>DateTimeInterface</classname> object that needs | ||
to be converted to an immutable version. This object is not modified, but | ||
instead a new <classname>DateTimeImmutable</classname> object is | ||
created containing the same date, time, and timezone information. | ||
</para> | ||
</listitem> | ||
</varlistentry> | ||
</variablelist> | ||
</para> | ||
</refsect1> | ||
|
||
<refsect1 role="returnvalues"> | ||
&reftitle.returnvalues; | ||
<para> | ||
Returns a new <classname>DateTimeImmutable</classname> instance. | ||
</para> | ||
</refsect1> | ||
|
||
<refsect1 role="examples"> | ||
&reftitle.examples; | ||
<para> | ||
<example> | ||
<title>Creating an immutable date time object</title> | ||
<programlisting role="php"> | ||
<![CDATA[ | ||
<?php | ||
$date = new DateTime("2014-06-20 11:45 Europe/London"); | ||
$immutable = DateTimeImmutable::createFromInterface($date); | ||
$date = new DateTimeImmutable("2014-06-20 11:45 Europe/London"); | ||
$also_immutable = DateTimeImmutable::createFromInterface($date); | ||
?> | ||
]]> | ||
</programlisting> | ||
</example> | ||
</para> | ||
</refsect1> | ||
</refentry> | ||
|
||
<!-- Keep this comment at the end of the file | ||
Local variables: | ||
mode: sgml | ||
sgml-omittag:t | ||
sgml-shorttag:t | ||
sgml-minimize-attributes:nil | ||
sgml-always-quote-attributes:t | ||
sgml-indent-step:1 | ||
sgml-indent-data:t | ||
indent-tabs-mode:nil | ||
sgml-parent-document:nil | ||
sgml-default-dtd-file:"~/.phpdoc/manual.ced" | ||
sgml-exposed-tags:nil | ||
sgml-local-catalogs:nil | ||
sgml-local-ecat-files:nil | ||
End: | ||
vim600: syn=xml fen fdm=syntax fdl=2 si | ||
vim: et tw=78 syn=sgml | ||
vi: ts=1 sw=1 | ||
--> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters