archived-doc-es/reference/paradox/functions/px-date2string.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: jesusruiz Status: ready -->
<!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc. -->
<refentry xml:id="function.px-date2string" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>px_date2string</refname>
  <refpurpose>
   Convierte una fecha en una cadena.
  </refpurpose>
 </refnamediv>
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>string</type><methodname>px_date2string</methodname>
   <methodparam><type>resource</type><parameter>pxdoc</parameter></methodparam>
   <methodparam><type>int</type><parameter>value</parameter></methodparam>
   <methodparam><type>string</type><parameter>format</parameter></methodparam>
  </methodsynopsis>

  <para>
   Convierte una fecha, ya almacenada en el archivo paradox en formato legible 
   por humanos. Las fechas Paradox son el número de días desde el 1.1.0000.
   Esta función es sólo por conveniencia. Puede ser fácilmente reemplazada por algunas
   funciones matemáticas y de calendario como se demuestra en el siguiente ejemplo.
  </para>

 </refsect1>
 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>pxdoc</parameter></term>
     <listitem>
      <para>
       Identificador de recursos de la base de datos paradox
       devuelto por la función <function>px_new</function>.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>value</parameter></term>
     <listitem>
      <para>
       Valor almacenado en la base de datos paradox del tipo de campo
       PX_FIELD_DATE.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>format</parameter></term>
     <listitem>
      <para>
        Cadena de formato similar al formato utilizado por la función <function>date</function>.
        Los marcadores de posición admitidos por esta función es un subconjunto de los
        admitidos por la función <function>date</function> (Y, y, m, n, d, j, L).
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   &return.success;
  </para>
 </refsect1>

 <!-- Use when ERRORS exist
 <refsect1 role="errors">
  &reftitle.errors;
  <para>
   When does this function throw E_* level errors, or exceptions?
  </para>
 </refsect1>
 -->


 <!-- Use when a CHANGELOG exists
 <refsect1 role="changelog">
  &reftitle.changelog;
  <para>
   <informaltable>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>&Version;</entry>
       <entry>&Description</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>Enter the PHP version of change here
       <entry>Description of change
      </row>
     </tbody>
    </tgroup>
   </informaltable>
  </para>
 </refsect1>
 -->


 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Convierte una fecha en el archivo paradox en un formato legible por humanos</title>
    <programlisting role="php">
<![CDATA[
<?php
$px = px_new();

/* Construir una fecha y almacenarla en */
/* un campo fecha de una base de datos paradox. */
/* 700000 días desde el 1.1.0000. */
$days = 700000;

/* Usar las funciones de calendario para imprimir un */
/* formato de fecha legible por humanos */
echo jdtogregorian($days+1721425)."\n";
/* px_date2string() la misma salida */
echo px_date2string($px, $days, "n/d/Y")."\n";

px_delete($px);
?>
]]>
    </programlisting>
    &example.outputs;
    <screen>
<![CDATA[
7/15/1917
7/15/1917
]]>
    </screen>
   </example>
  </para>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>px_timestamp2string</function></member>
    <member><function>jdtogregorian</function></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
-->