px_date2string(3) [debian man page]

PX_DATE2STRING(3)					     Library Functions Manual						 PX_DATE2STRING(3)

NAME

       PX_date2string -- Convert paradox date into formated string

SYNOPSIS

       #include <paradox.h>

       char * PX_date2string(pxdoc_t *pxdoc, long date, const char *format)

DESCRIPTION

       Creates	a  string  representation  of  a  paradox  date  as  specified	in  the  parameter format.  The date must be either retrieved with
       PX_get_data_long(3)  after  calling  PX_get_record(3)  or  by  simply  using  the  long	value  in  the	pxval_t  struct  as  returned	by
       PX_retrieve_record(3).  The function uses internally the PX_timestamp2string(3) function.  The format string may contain all chars as docu-
       mented with PX_timestamp2string(3), though only those concerning the date will produce resonable results.

RETURN VALUE

       Returns pointer to string on success and NULL on failure.

SEE ALSO

       PX_timestamp2string(3), PX_time2string(3)

AUTHOR

       This manual page was written by Uwe Steinmann uwe@steinmann.cx.

																 PX_DATE2STRING(3)

PX_DATE2STRING(3)														 PX_DATE2STRING(3)

px_date2string - Converts a date into a string.

SYNOPSIS

       string px_date2string (resource	$pxdoc, int  $value, string  $format)

DESCRIPTION

	Turns  a date as it stored in the paradox file into human readable format. Paradox dates are the number of days since 1.1.0000. This func-
       tion is just for convenience. It can be easily replaced by some math and the calendar functions as demonstrated in the example below.

PARAMETERS

	      o $pxdoc
		- Resource identifier of the paradox database as returned by px_new(3).

	      o $value
		- Value as stored in paradox database field of type PX_FIELD_DATE.

	      o $format
		- String format similar to the format used by date(3). The placeholders support by this function is a subset of those supported by
		date(3) (Y, y, m, n, d, j, L).

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      Turn a paradox date into a human readable form

	      <?php
	      $px = px_new();

	      /* make up a date as it could be stored in */
	      /* a date field of a paradox db. */
	      /* 700000 days since 1.1.0000. */
	      $days = 700000;

	      /* Use the calendar functions to print a */
	      /* human readable format of the date */
	      echo jdtogregorian($days+1721425)."
";
	      /* px_date2string() outputs the same */
	      echo px_date2string($px, $days, "n/d/Y")."
";

	      px_delete($px);
	      ?>

	      The above example will output:

	      7/15/1917
	      7/15/1917

SEE ALSO

       px_timestamp2string(3), jdtogregorian(3).

PHP Documentation Group 													 PX_DATE2STRING(3)