mirror of
https://github.com/php/doc-es.git
synced 2026-03-23 23:12:09 +01:00
725 lines
31 KiB
XML
725 lines
31 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!-- $Revision$ -->
|
|
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: PhilDaiguille Status: ready -->
|
|
<!-- Reviewed: no -->
|
|
<refentry xml:id="function.strftime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
|
<refnamediv>
|
|
<refname>strftime</refname>
|
|
<refpurpose>Formatea una fecha/hora local con la configuración local</refpurpose>
|
|
</refnamediv>
|
|
|
|
<refsynopsisdiv>
|
|
&warn.deprecated.function-8-1-0.alternatives;
|
|
<simplelist role="alternatives">
|
|
<member><function>date</function></member>
|
|
<member><methodname>IntlDateFormatter::format</methodname></member>
|
|
</simplelist>
|
|
</refsynopsisdiv>
|
|
|
|
<refsect1 role="description">
|
|
&reftitle.description;
|
|
<methodsynopsis>
|
|
<modifier role="attribute">#[\Deprecated]</modifier>
|
|
<type class="union"><type>string</type><type>false</type></type><methodname>strftime</methodname>
|
|
<methodparam><type>string</type><parameter>format</parameter></methodparam>
|
|
<methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>timestamp</parameter><initializer>&null;</initializer></methodparam>
|
|
</methodsynopsis>
|
|
<para>
|
|
Formatea una fecha y/o una hora según la localización local. Los nombres
|
|
de los meses, de los días de la semana pero también de otras cadenas dependientes
|
|
de la localización, respetarán la localización actual definida por la función
|
|
<function>setlocale</function>.
|
|
</para>
|
|
<warning>
|
|
<para>
|
|
Todos los caracteres modificadores no siempre son soportados por
|
|
todas las bibliotecas C. En este caso, no serán soportados por PHP tampoco. Además, todas las plataformas no soportan
|
|
los timestamps negativos, y sus fechas podrían estar limitadas por el
|
|
inicio de la época Unix. Esto significa que
|
|
<literal>%e</literal>, <literal>%T</literal>, <literal>%R</literal> y <literal>%D</literal>
|
|
(y puede que otros) y las fechas anteriores al
|
|
<literal>1 de Enero de 1970</literal> no funcionarán bajo Windows,
|
|
en algunas distribuciones de Linux, y en algunos sistemas operativos.
|
|
Para Windows, una lista completa de las opciones de conversión está disponible
|
|
en el <link xlink:href="&url.strftime.win32;">sitio de <acronym>MSDN</acronym></link>.
|
|
Utilice en su lugar el método <methodname>IntlDateFormatter::format</methodname>.
|
|
</para>
|
|
</warning>
|
|
</refsect1>
|
|
|
|
<refsect1 role="parameters">
|
|
&reftitle.parameters;
|
|
<para>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><parameter>format</parameter></term>
|
|
<listitem>
|
|
<para>
|
|
<table>
|
|
<title>Los siguientes caracteres son reconocidos en el argumento
|
|
<parameter>format</parameter></title>
|
|
<tgroup cols="3">
|
|
<thead>
|
|
<row>
|
|
<entry><parameter>format</parameter></entry>
|
|
<entry>Descripción</entry>
|
|
<entry>Ejemplo de valores devueltos</entry>
|
|
</row>
|
|
</thead>
|
|
<tbody>
|
|
<row>
|
|
<entry align="center"><emphasis>Día</emphasis></entry>
|
|
<entry>---</entry>
|
|
<entry>---</entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%a</literal></entry>
|
|
<entry>Nombre abreviado del día de la semana</entry>
|
|
<entry>De <literal>Sun</literal> a <literal>Sat</literal></entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%A</literal></entry>
|
|
<entry>Nombre completo del día de la semana</entry>
|
|
<entry>De <literal>Sunday</literal> a <literal>Saturday</literal></entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%d</literal></entry>
|
|
<entry>Día del mes en formato numérico, con 2 dígitos (con el cero inicial)</entry>
|
|
<entry>De <literal>01</literal> a <literal>31</literal></entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%e</literal></entry>
|
|
<entry>Día del mes, con un espacio precediendo al primer dígito.
|
|
La implementación de Windows es diferente, véase más abajo para más información.</entry>
|
|
<entry>De <literal> 1</literal> a <literal>31</literal></entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%j</literal></entry>
|
|
<entry>Día del año, con 3 dígitos con cero inicial</entry>
|
|
<entry><literal>001</literal> a <literal>366</literal></entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%u</literal></entry>
|
|
<entry>Representación ISO-8601 del día de la semana</entry>
|
|
<entry>De <literal>1</literal> (para Lunes) a <literal>7</literal> (para Domingo)</entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%w</literal></entry>
|
|
<entry>Representación numérica del día de la semana</entry>
|
|
<entry>De <literal>0</literal> (para Domingo) a <literal>6</literal> (para Sábado)</entry>
|
|
</row>
|
|
<row>
|
|
<entry align="center"><emphasis>Semana</emphasis></entry>
|
|
<entry>---</entry>
|
|
<entry>---</entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%U</literal></entry>
|
|
<entry>Número de la semana del año dado, comenzando por el primer
|
|
Lunes como primera semana</entry>
|
|
<entry><literal>13</literal> (para la 13ª semana completa del año)</entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%V</literal></entry>
|
|
<entry>Número de la semana del año, siguiendo la norma ISO-8601:1988,
|
|
comenzando como primera semana, la semana del año que contiene al menos
|
|
4 días, y donde Lunes es el inicio de la semana</entry>
|
|
<entry>De <literal>01</literal> a <literal>53</literal> (donde 53
|
|
cuenta como semana de solapamiento)</entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%W</literal></entry>
|
|
<entry>Una representación numérica de la semana del año, comenzando
|
|
por el primer Lunes de la primera semana</entry>
|
|
<entry><literal>46</literal> (para la 46ª semana de la semana comenzando
|
|
por un Lunes)</entry>
|
|
</row>
|
|
<row>
|
|
<entry align="center"><emphasis>Mes</emphasis></entry>
|
|
<entry>---</entry>
|
|
<entry>---</entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%b</literal></entry>
|
|
<entry>Nombre del mes, abreviado, según la localización</entry>
|
|
<entry>De <literal>Jan</literal> a <literal>Dec</literal></entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%B</literal></entry>
|
|
<entry>Nombre completo del mes, según la localización</entry>
|
|
<entry>De <literal>January</literal> a <literal>December</literal></entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%h</literal></entry>
|
|
<entry>Nombre del mes abreviado, según la localización (alias de %b)</entry>
|
|
<entry>De <literal>Jan</literal> a <literal>Dec</literal></entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%m</literal></entry>
|
|
<entry>Mes, con 2 dígitos</entry>
|
|
<entry>De <literal>01</literal> (para Enero) a <literal>12</literal> (para Diciembre)</entry>
|
|
</row>
|
|
<row>
|
|
<entry align="center"><emphasis>Año</emphasis></entry>
|
|
<entry>---</entry>
|
|
<entry>---</entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%C</literal></entry>
|
|
<entry>Representación, con 2 dígitos, del siglo (año dividido por 100, reducido a un entero)</entry>
|
|
<entry><literal>19</literal> para el siglo 20</entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%g</literal></entry>
|
|
<entry>Representación, con 2 dígitos, del año, compatible con los estándares ISO-8601:1988 (véase %V)</entry>
|
|
<entry>Ejemplo: <literal>09</literal> para la semana del 6 de enero de 2009</entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%G</literal></entry>
|
|
<entry>La versión completa de 4 dígitos de %g</entry>
|
|
<entry>Ejemplo: <literal>2009</literal> para la semana del 3 de enero de 2009</entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%y</literal></entry>
|
|
<entry>El año, con 2 dígitos</entry>
|
|
<entry>Ejemplo: <literal>09</literal> para 2009, <literal>79</literal> para 1979</entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%Y</literal></entry>
|
|
<entry>El año, con 4 dígitos</entry>
|
|
<entry>Ejemplo: <literal>2038</literal></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="center"><emphasis>Hora</emphasis></entry>
|
|
<entry>---</entry>
|
|
<entry>---</entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%H</literal></entry>
|
|
<entry>La hora, con 2 dígitos, en formato 24 horas</entry>
|
|
<entry>De <literal>00</literal> a <literal>23</literal></entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%k</literal></entry>
|
|
<entry>La hora en formato 24 horas, con un espacio precediendo a
|
|
un solo dígito</entry>
|
|
<entry>De <literal> 0</literal> a <literal>23</literal></entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%I</literal></entry>
|
|
<entry>Hora, con 2 dígitos, en formato 12 horas</entry>
|
|
<entry>De <literal>01</literal> a <literal>12</literal></entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%l</literal> ('L' minúscula)</entry>
|
|
<entry>Hora, en formato 12 horas, con un espacio precediendo a un solo dígito</entry>
|
|
<entry>De <literal> 1</literal> a <literal>12</literal></entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%M</literal></entry>
|
|
<entry>Minuto, con 2 dígitos</entry>
|
|
<entry>De <literal>00</literal> a <literal>59</literal></entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%p</literal></entry>
|
|
<entry>'AM' o 'PM', en mayúsculas, basado en la hora proporcionada</entry>
|
|
<entry>
|
|
Ejemplo: <literal>AM</literal> para 00:31, <literal>PM</literal> para 22:23.
|
|
El resultado exacto depende del sistema operativo, y pueden devolver también variantes en minúsculas,
|
|
o variantes con puntos (como <literal>a.m.</literal>).
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%P</literal></entry>
|
|
<entry>'am' o 'pm', en minúsculas, basado en la hora proporcionada</entry>
|
|
<entry>
|
|
Ejemplo: <literal>am</literal> para 00:31, <literal>pm</literal> para 22:23.
|
|
No soportado por todos los sistemas operativos.
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%r</literal></entry>
|
|
<entry>Idéntico a "%I:%M:%S %p"</entry>
|
|
<entry>Ejemplo: <literal>09:34:17 PM</literal> para 21:34:17</entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%R</literal></entry>
|
|
<entry>Idéntico a "<literal>%H:%M</literal>"</entry>
|
|
<entry>Ejemplo: <literal>00:35</literal> para 12:35 AM, <literal>16:44</literal> para 4:44 PM</entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%S</literal></entry>
|
|
<entry>Segundo, con 2 dígitos</entry>
|
|
<entry>De <literal>00</literal> a <literal>59</literal></entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%T</literal></entry>
|
|
<entry>Idéntico a "<literal>%H:%M:%S</literal>"</entry>
|
|
<entry>Ejemplo: <literal>21:34:17</literal> para 09:34:17 PM</entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%X</literal></entry>
|
|
<entry>Representación de la hora, basada en la localización, sin la fecha</entry>
|
|
<entry>Ejemplo: <literal>03:59:16</literal> o <literal>15:59:16</literal></entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%z</literal></entry>
|
|
<entry>
|
|
El desplazamiento horario. No implementado tal como se describe en Windows.
|
|
Ver más abajo para más información.</entry>
|
|
<entry>Ejemplo: <literal>-0500</literal> para la hora del este de EE.UU.</entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%Z</literal></entry>
|
|
<entry>
|
|
La abreviación del desplazamiento horario. No implementado tal como se describe en
|
|
Windows. Ver más abajo para más información.
|
|
</entry>
|
|
<entry>
|
|
Ejemplo: <literal>EST</literal> para la hora del este
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry align="center"><emphasis>Hora y fecha</emphasis></entry>
|
|
<entry>---</entry>
|
|
<entry>---</entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%c</literal></entry>
|
|
<entry>Fecha y hora preferidas, basadas en la localización</entry>
|
|
<entry>Ejemplo: <literal>Tue Feb 5 00:45:10 2009</literal> para
|
|
el 5 de febrero de 2009 a las 12:45:10 AM</entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%D</literal></entry>
|
|
<entry>Idéntico a "<literal>%m/%d/%y</literal>"</entry>
|
|
<entry>Ejemplo: <literal>02/05/09</literal> para el 5 de febrero de 2009</entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%F</literal></entry>
|
|
<entry>
|
|
Idéntico a "<literal>%Y-%m-%d</literal>"
|
|
(usado habitualmente por las bases de datos)
|
|
</entry>
|
|
<entry>Ejemplo: <literal>2009-02-05</literal> para el 5 de febrero de 2009</entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%s</literal></entry>
|
|
<entry>Timestamp de la época Unix (idéntico a la función <function>time</function>)</entry>
|
|
<entry>Ejemplo: <literal>305815200</literal> para el 10 de septiembre de 1979 08:40:00 AM</entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%x</literal></entry>
|
|
<entry>Representación preferida de la fecha, basada en la localización, sin la hora</entry>
|
|
<entry>Ejemplo: <literal>02/05/09</literal> para el 5 de febrero de 2009</entry>
|
|
</row>
|
|
<row>
|
|
<entry align="center"><emphasis>Varios</emphasis></entry>
|
|
<entry>---</entry>
|
|
<entry>---</entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%n</literal></entry>
|
|
<entry>Una nueva línea ("\n")</entry>
|
|
<entry>---</entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%t</literal></entry>
|
|
<entry>Una tabulación ("\t")</entry>
|
|
<entry>---</entry>
|
|
</row>
|
|
<row>
|
|
<entry><literal>%%</literal></entry>
|
|
<entry>El carácter de porcentaje ("<literal>%</literal>")</entry>
|
|
<entry>---</entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</table>
|
|
</para>
|
|
<warning>
|
|
<simpara>
|
|
A diferencia de la norma <literal>ISO-9899:1999</literal>, Sun Solaris
|
|
comienza con el Domingo a 1. También, el formato <literal>%u</literal>
|
|
no funcionará tal como se describe en este manual.
|
|
</simpara>
|
|
</warning>
|
|
<warning>
|
|
<para>
|
|
<emphasis>Solo Windows:</emphasis>
|
|
</para>
|
|
<para>
|
|
El modificador <literal>%e</literal>
|
|
no es soportado bajo Windows. Para calcular el valor, el modificador
|
|
<literal>%#d</literal> puede ser utilizado en su lugar. El ejemplo de abajo ilustra la
|
|
manera de escribir un código multiplataforma.
|
|
</para>
|
|
<para>
|
|
Los modificadores <literal>%z</literal> y <literal>%Z</literal>
|
|
devuelven ambos el nombre de la zona horaria en lugar del desplazamiento
|
|
o de la abreviación.
|
|
</para>
|
|
</warning>
|
|
<warning>
|
|
<simpara>
|
|
<emphasis>Solo macOS y musl:</emphasis> El modificador <literal>%P</literal>
|
|
no es soportado por la implementación de esta función bajo macOS.
|
|
</simpara>
|
|
</warning>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
&date.timestamp.description;
|
|
|
|
</variablelist>
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1 role="returnvalues">
|
|
&reftitle.returnvalues;
|
|
<para>
|
|
Devuelve una &string; formateada según el argumento <parameter>format</parameter>
|
|
dado, utilizando el argumento <parameter>timestamp</parameter> o la fecha local
|
|
actual si no se proporciona ningún timestamp. Los nombres de los meses, de los días de la
|
|
semana pero también de otras cadenas dependientes de la localización, respetarán
|
|
la localización actual definida por la función <function>setlocale</function>.
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1 role="errors">
|
|
&reftitle.errors;
|
|
&date.timezone.errors.description;
|
|
<para>
|
|
Dado que la salida depende de la biblioteca C subyacente, algunos
|
|
especificadores de conversión no son soportados. Bajo Windows,
|
|
el hecho de proporcionar un especificador de conversión desconocido devolverá
|
|
5 mensajes de nivel <constant>E_WARNING</constant> y devolverá &false;
|
|
al final. Bajo otros sistemas operativos, no recibirá ningún
|
|
mensaje de nivel <constant>E_WARNING</constant> y la salida contendrá los
|
|
especificadores no convertidos.
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1 role="changelog">
|
|
&reftitle.changelog;
|
|
<para>
|
|
<informaltable>
|
|
<tgroup cols="2">
|
|
<thead>
|
|
<row>
|
|
<entry>&Version;</entry>
|
|
<entry>&Description;</entry>
|
|
</row>
|
|
</thead>
|
|
<tbody>
|
|
<row>
|
|
<entry>8.0.0</entry>
|
|
<entry>
|
|
<parameter>timestamp</parameter> ahora es nullable.
|
|
</entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</informaltable>
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1 role="examples">
|
|
&reftitle.examples;
|
|
<para>
|
|
Este ejemplo solo funcionará si tiene las localizaciones respectivas
|
|
instaladas en su sistema.
|
|
<example>
|
|
<title>Ejemplo con <function>strftime</function></title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
setlocale(LC_TIME, "C");
|
|
echo strftime("%A");
|
|
setlocale(LC_TIME, "fi_FI");
|
|
echo strftime(" in Finnish is %A,");
|
|
setlocale(LC_TIME, "fr_FR");
|
|
echo strftime(" in French %A and");
|
|
setlocale(LC_TIME, "de_DE");
|
|
echo strftime(" in German %A.\n");
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
</para>
|
|
<para>
|
|
<example>
|
|
<title>Ejemplo en formato de fecha ISO 8601:1988</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
/* Diciembre 2002 / Enero 2003
|
|
ISOWk L M X J V S D
|
|
----- ----------------------------
|
|
51 16 17 18 19 20 21 22
|
|
52 23 24 25 26 27 28 29
|
|
1 30 31 1 2 3 4 5
|
|
2 6 7 8 9 10 11 12
|
|
3 13 14 15 16 17 18 19 */
|
|
|
|
// Muestra: 12/28/2002 - %V,%G,%Y = 52,2002,2002
|
|
echo "12/28/2002 - %V,%G,%Y = " . strftime("%V,%G,%Y", strtotime("12/28/2002")) . "\n";
|
|
|
|
// Muestra: 12/30/2002 - %V,%G,%Y = 1,2003,2002
|
|
echo "12/30/2002 - %V,%G,%Y = " . strftime("%V,%G,%Y", strtotime("12/30/2002")) . "\n";
|
|
|
|
// Muestra: 1/3/2003 - %V,%G,%Y = 1,2003,2003
|
|
echo "1/3/2003 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/3/2003")) . "\n";
|
|
|
|
// Muestra: 1/10/2003 - %V,%G,%Y = 2,2003,2003
|
|
echo "1/10/2003 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/10/2003")) . "\n";
|
|
|
|
/* Diciembre 2004 / Enero 2005
|
|
ISOWk L M X J V S D
|
|
----- ----------------------------
|
|
51 13 14 15 16 17 18 19
|
|
52 20 21 22 23 24 25 26
|
|
53 27 28 29 30 31 1 2
|
|
1 3 4 5 6 7 8 9
|
|
2 10 11 12 13 14 15 16 */
|
|
|
|
// Muestra: 12/23/2004 - %V,%G,%Y = 52,2004,2004
|
|
echo "12/23/2004 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/23/2004")) . "\n";
|
|
|
|
// Muestra: 12/31/2004 - %V,%G,%Y = 53,2004,2004
|
|
echo "12/31/2004 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/31/2004")) . "\n";
|
|
|
|
// Muestra: 1/2/2005 - %V,%G,%Y = 53,2004,2005
|
|
echo "1/2/2005 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/2/2005")) . "\n";
|
|
|
|
// Muestra: 1/3/2005 - %V,%G,%Y = 1,2005,2005
|
|
echo "1/3/2005 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/3/2005")) . "\n";
|
|
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
</para>
|
|
<para>
|
|
<example>
|
|
<title><literal>%e</literal> funcionando en toda plataforma</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
|
|
// 1 de Enero: resultados en: '%e%1%' (%%, e, %%, %e, %%)
|
|
$format = '%%e%%%e%%';
|
|
|
|
// Verifica bajo Windows, para encontrar y reemplazar el modificador %e
|
|
// correctamente
|
|
if (strtoupper(substr(PHP_OS, 0, 3)) == 'WIN') {
|
|
$format = preg_replace('#(?<!%)((?:%%)*)%e#', '\1%#d', $format);
|
|
}
|
|
|
|
echo strftime($format);
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
</para>
|
|
<para>
|
|
<example>
|
|
<title>Muestra todos los formatos conocidos o no</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
|
|
// Describe los formatos
|
|
$strftimeFormats = array(
|
|
'A' => 'Una representación textual completa del día',
|
|
'B' => 'Nombre del mes completo, basado en la localización',
|
|
'C' => 'Representación con 2 dígitos del año (año, dividido por 100, truncado a entero)',
|
|
'D' => 'Idéntico a "%m/%d/%y"',
|
|
'E' => '',
|
|
'F' => 'Idéntico a "%Y-%m-%d"',
|
|
'G' => 'La versión completa, con 4 dígitos de %g',
|
|
'H' => 'Una representación con 2 dígitos de la hora en formato 24-horas',
|
|
'I' => 'Una representación con 2 dígitos de la hora en formato 12-horas',
|
|
'J' => '',
|
|
'K' => '',
|
|
'L' => '',
|
|
'M' => 'Una representación con 2 dígitos de los minutos',
|
|
'N' => '',
|
|
'O' => '',
|
|
'P' => '"am" o "pm" (en minúsculas) basado en la hora actual',
|
|
'Q' => '',
|
|
'R' => 'Idéntico a "%H:%M"',
|
|
'S' => 'Una representación con 2 dígitos de los segundos',
|
|
'T' => 'Idéntico a "%H:%M:%S"',
|
|
'U' => 'Número de la semana para el año actual, comenzando por el primer Domingo como primera semana',
|
|
'V' => 'Número ISO-8601:1988 de la semana del año actual, comenzando por la primera semana del año con al menos 4 días de semana, con el Lunes como inicio de semana',
|
|
'W' => 'Una representación numérica de la semana del año, comenzando por el primer Lunes como primera semana',
|
|
'X' => 'Representación preferida para la hora, basada en la localización, sin la fecha',
|
|
'Y' => 'Una representación con 4 dígitos del año',
|
|
'Z' => 'La abreviación del desplazamiento horario, no proporcionada por %z (depende del sistema operativo)',
|
|
'a' => 'La abreviación de la representación textual del día',
|
|
'b' => 'La abreviación del nombre del mes, basada en la localización',
|
|
'c' => 'Timestamp preferido basado en la localización',
|
|
'd' => 'Día del mes con 2 dígitos (con el cero inicial)',
|
|
'e' => 'Día del mes, con un espacio precediendo a un solo dígito',
|
|
'f' => '',
|
|
'g' => 'Una representación con 2 dígitos del año en formato ISO-8601:1988 (ver %V)',
|
|
'h' => 'Abreviación del nombre del mes, basada en la localización (alias de %b)',
|
|
'i' => '',
|
|
'j' => 'Día del año, con 3 dígitos con cero inicial',
|
|
'k' => 'Hora, en formato 24-horas, con un espacio precediendo a un solo dígito',
|
|
'l' => 'Hora, en formato 12-horas, con un espacio precediendo a un solo dígito',
|
|
'm' => 'Una representación del mes con 2 dígitos',
|
|
'n' => 'Un carácter de nueva línea ("\n")',
|
|
'o' => '',
|
|
'p' => '"AM" o "PM" (en mayúsculas) basado en la hora actual',
|
|
'q' => '',
|
|
'r' => 'Idéntico a "%I:%M:%S %p"',
|
|
's' => 'Timestamp respecto a la época Unix',
|
|
't' => 'Un carácter de tabulación ("\t")',
|
|
'u' => 'Representación numérica del día de la semana en formato ISO-8601',
|
|
'v' => '',
|
|
'w' => 'Representación numérica del día de la semana',
|
|
'x' => 'Representación preferida de la fecha, basada en la localización, sin la hora',
|
|
'y' => 'Representación del año con 2 dígitos',
|
|
'z' => 'O bien el desplazamiento horario desde UTC o su abreviación (según el sistema operativo)',
|
|
'%' => 'Un carácter porcentaje ("%")',
|
|
);
|
|
|
|
// Resultados
|
|
$strftimeValues = array();
|
|
|
|
// 2value los formatos mientras se eliminan los errores
|
|
foreach ($strftimeFormats as $format => $description) {
|
|
if (false !== ($value = @strftime("%{$format}"))) {
|
|
$strftimeValues[$format] = $value;
|
|
}
|
|
}
|
|
|
|
// Encuentra el valor más largo
|
|
$maxValueLength = 2 + max(array_map('strlen', $strftimeValues));
|
|
|
|
// Muestra todos los formatos conocidos
|
|
foreach ($strftimeValues as $format => $value) {
|
|
echo "Formato conocido: '{$format}' = ", str_pad("'{$value}'", $maxValueLength), " ( {$strftimeFormats[$format]} )\n";
|
|
}
|
|
|
|
// Muestra todos los formatos no conocidos
|
|
foreach (array_diff_key($strftimeFormats, $strftimeValues) as $format => $description) {
|
|
echo "Formato desconocido: '{$format}' ", str_pad(' ', $maxValueLength), ($description ? " ( {$description} )" : ''), "\n";
|
|
}
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
&example.outputs.similar;
|
|
<screen>
|
|
<![CDATA[
|
|
Formato conocido: 'A' = 'Friday' ( Una representación textual completa del día )
|
|
Formato conocido: 'B' = 'December' ( Nombre del mes completo, basado en la localización )
|
|
Formato conocido: 'H' = '11' ( Una representación con 2 dígitos de la hora en formato 24-horas )
|
|
Formato conocido: 'I' = '11' ( Una representación con 2 dígitos de la hora en formato 12-horas )
|
|
Formato conocido: 'M' = '24' ( Una representación con 2 dígitos de los minutos )
|
|
Formato conocido: 'S' = '44' ( Una representación con 2 dígitos de los segundos )
|
|
Formato conocido: 'U' = '48' ( Número de la semana para el año actual, comenzando por el primer Domingo como primera semana )
|
|
Formato conocido: 'W' = '48' ( Una representación numérica de la semana del año, comenzando por el primer Lunes como primera semana )
|
|
Formato conocido: 'X' = '11:24:44' ( Representación preferida para la hora, basada en la localización, sin la fecha )
|
|
Formato conocido: 'Y' = '2010' ( Una representación con 4 dígitos del año )
|
|
Formato conocido: 'Z' = 'GMT Standard Time' ( La abreviación del desplazamiento horario, no proporcionada por %z (depende del sistema operativo) )
|
|
Formato conocido: 'a' = 'Fri' ( La abreviación de la representación textual del día )
|
|
Formato conocido: 'b' = 'Dec' ( La abreviación del nombre del mes, basada en la localización )
|
|
Formato conocido: 'c' = '12/03/10 11:24:44' ( Timestamp preferido basado en la localización )
|
|
Formato conocido: 'd' = '03' ( Día del mes con 2 dígitos (con el cero inicial) )
|
|
Formato conocido: 'j' = '337' ( Día del año, con 3 dígitos con cero inicial )
|
|
Formato conocido: 'm' = '12' ( Una representación del mes con 2 dígitos )
|
|
Formato conocido: 'p' = 'AM' ( "AM" o "PM" (en mayúsculas) basado en la hora actual )
|
|
Formato conocido: 'w' = '5' ( Representación numérica del día de la semana )
|
|
Formato conocido: 'x' = '12/03/10' ( Representación preferida de la fecha, basada en la localización, sin la hora )
|
|
Formato conocido: 'y' = '10' ( Representación del año con 2 dígitos )
|
|
Formato conocido: 'z' = 'GMT Standard Time' ( O bien el desplazamiento horario desde UTC o su abreviación (según el sistema operativo) )
|
|
Formato conocido: '%' = '%' ( Un carácter porcentaje ("%") )
|
|
Formato desconocido: 'C' ( Representación con 2 dígitos del año (año, dividido por 100, truncado a entero) )
|
|
Formato desconocido: 'D' ( Idéntico a "%m/%d/%y" )
|
|
Formato desconocido: 'E'
|
|
Formato desconocido: 'F' ( Idéntico a "%Y-%m-%d" )
|
|
Formato desconocido: 'G' ( La versión completa, con 4 dígitos de %g )
|
|
Formato desconocido: 'J'
|
|
Formato desconocido: 'K'
|
|
Formato desconocido: 'L'
|
|
Formato desconocido: 'N'
|
|
Formato desconocido: 'O'
|
|
Formato desconocido: 'P' ( "am" o "pm" (en minúsculas) basado en la hora actual )
|
|
Formato desconocido: 'Q'
|
|
Formato desconocido: 'R' ( Idéntico a "%H:%M" )
|
|
Formato desconocido: 'T' ( Idéntico a "%H:%M:%S" )
|
|
Formato desconocido: 'V' ( Número ISO-8601:1988 de la semana del año actual, comenzando por la primera semana del año con al menos 4 días de semana, con el Lunes como inicio de semana )
|
|
Formato desconocido: 'e' ( Día del mes, con un espacio precediendo a un solo dígito )
|
|
Formato desconocido: 'f'
|
|
Formato desconocido: 'g' ( Una representación con 2 dígitos del año en formato ISO-8601:1988 (ver %V) )
|
|
Formato desconocido: 'h' ( Abreviación del nombre del mes, basada en la localización (alias de %b) )
|
|
Formato desconocido: 'i'
|
|
Formato desconocido: 'k' ( Hora, en formato 24-horas, con un espacio precediendo a un solo dígito )
|
|
Formato desconocido: 'l' ( Hora, en formato 12-horas, con un espacio precediendo a un solo dígito )
|
|
Formato desconocido: 'n' ( Un carácter de nueva línea ("\n") )
|
|
Formato desconocido: 'o'
|
|
Formato desconocido: 'q'
|
|
Formato desconocido: 'r' ( Idéntico a "%I:%M:%S %p" )
|
|
Formato desconocido: 's' ( Timestamp respecto a la época Unix )
|
|
Formato desconocido: 't' ( Un carácter de tabulación ("\t") )
|
|
Formato desconocido: 'u' ( Representación numérica del día de la semana en formato ISO-8601 )
|
|
Formato desconocido: 'v'
|
|
]]>
|
|
</screen>
|
|
</example>
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1 role="notes">
|
|
&reftitle.notes;
|
|
<note>
|
|
<simpara>
|
|
<literal>%G</literal> y <literal>%V</literal>, que están basadas
|
|
en la semana <literal>ISO 8601:1988</literal>, pueden conducir
|
|
a resultados inesperados (aunque correctos) si el
|
|
sistema de numeración no es conocido. Ver el ejemplo
|
|
<literal>%V</literal> de esta página.
|
|
</simpara>
|
|
</note>
|
|
</refsect1>
|
|
|
|
<refsect1 role="seealso">
|
|
&reftitle.seealso;
|
|
<para>
|
|
<simplelist>
|
|
<member><methodname>IntlDateFormatter::format</methodname></member>
|
|
<member><methodname>DateTimeInterface::format</methodname></member>
|
|
<member><link xlink:href="&url.strftime.format.designer;">Herramienta de formato strftime() en línea</link></member>
|
|
<member><function>setlocale</function></member>
|
|
<member><function>mktime</function></member>
|
|
<member><function>strptime</function></member>
|
|
<member><function>gmstrftime</function></member>
|
|
<member><link xlink:href="&spec.strftime;">grupo de especificaciones de <function>strftime</function></link></member>
|
|
</simplelist>
|
|
</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
|
|
-->
|