archived-doc-es/reference/datetime/datetimeimmutable/settime.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 3a8c3e77df070a046c9d5b56b68926ca2d7e5ee3 Maintainer: Marqitos Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="datetimeimmutable.settime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>DateTimeImmutable::setTime</refname>
  <refpurpose>Establece la hora</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis role="DateTimeImmutable">
   <modifier role="attribute">#[\NoDiscard]</modifier>
   <modifier>public</modifier> <type>DateTimeImmutable</type><methodname>DateTimeImmutable::setTime</methodname>
   <methodparam><type>int</type><parameter>hour</parameter></methodparam>
   <methodparam><type>int</type><parameter>minute</parameter></methodparam>
   <methodparam choice="opt"><type>int</type><parameter>second</parameter><initializer>0</initializer></methodparam>
   <methodparam choice="opt"><type>int</type><parameter>microsecond</parameter><initializer>0</initializer></methodparam>
  </methodsynopsis>
  <para>
   Devuelve un nuevo objeto DateTimeImmutable con la hora establecida a la hora dada.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <variablelist>
   <varlistentry>
    <term><parameter>hour</parameter></term>
    <listitem>
     <para>
      Hora de la hora.
     </para>
    </listitem>
   </varlistentry>
   <varlistentry>
    <term><parameter>minute</parameter></term>
    <listitem>
     <para>
      Minuto de la hora.
     </para>
    </listitem>
   </varlistentry>
   <varlistentry>
    <term><parameter>second</parameter></term>
    <listitem>
     <para>
      Segundo de la hora.
     </para>
    </listitem>
   </varlistentry>
   <varlistentry>
    <term><parameter>microsecond</parameter></term>
    <listitem>
     <para>
      Microsegundo de la hora.
     </para>
    </listitem>
   </varlistentry>
  </variablelist>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   &date.datetimeimmutable.return.modifiedobject;
  </para>
 </refsect1>

 <refsect1 role="changelog">
  &reftitle.changelog;
  <informaltable>
   <tgroup cols="2">
    <thead>
     <row>
      <entry>&Version;</entry>
      <entry>&Description;</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry>8.1.0</entry>
      <entry>El comportamiento con horas dobles existentes (durante la transición
      de DST de retroceso) cambió. Anteriormente, PHP elegiría la segunda ocurrencia
      (después de la transición de DST), en lugar de la primera ocurrencia (antes de
      la transición de DST).</entry>
     </row>
     <row>
      <entry>7.1.0</entry>
      <entry>Se ha añadido el parametro <parameter>microsecond</parameter>.</entry>
     </row>
    </tbody>
   </tgroup>
  </informaltable>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <example>
   <title>Ejemplo de <function>DateTimeImmutable::setTime</function></title>
   <para>&style.oop;</para>
   <programlisting role="php">
<![CDATA[
<?php
$date = new DateTimeImmutable('2001-01-01');

$newDate = $date->setTime(14, 55);
echo $newDate->format('Y-m-d H:i:s') . "\n";

$newDate = $date->setTime(14, 55, 24);
echo $newDate->format('Y-m-d H:i:s') . "\n";
?>
]]>
   </programlisting>
   &example.outputs.similar;
   <screen>
<![CDATA[
2001-01-01 14:55:00
2001-01-01 14:55:24
]]>
   </screen>
  </example>
  <example>
   <title>Valores que exceden los rangos se añaden a sus valores padres</title>
   <programlisting role="php">
<![CDATA[
<?php
$date = new DateTimeImmutable('2001-01-01');

$newDate = $date->setTime(14, 55, 24);
echo $newDate->format('Y-m-d H:i:s') . "\n";

$newDate = $date->setTime(14, 55, 65);
echo $newDate->format('Y-m-d H:i:s') . "\n";

$newDate = $date->setTime(14, 65, 24);
echo $newDate->format('Y-m-d H:i:s') . "\n";

$newDate = $date->setTime(25, 55, 24);
echo $newDate->format('Y-m-d H:i:s') . "\n";
?>
]]>
   </programlisting>
   &example.outputs;
   <screen>
<![CDATA[
2001-01-01 14:55:24
2001-01-01 14:56:05
2001-01-01 15:05:24
2001-01-02 01:55:24
]]>
   </screen>
  </example>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <simplelist>
   <member><function>DateTimeImmutable::setDate</function></member>
   <member><function>DateTimeImmutable::setISODate</function></member>
  </simplelist>
 </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
-->