px_timestamp2string(3) [debian man page]

PX_TIMESTAMP2STRING(3)					     Library Functions Manual					    PX_TIMESTAMP2STRING(3)

NAME

       PX_timestamp2string -- Convert paradox timestamp into formated string

SYNOPSIS

       #include <paradox.h>

       char * PX_timestamp2string(pxdoc_t *pxdoc, double timestamp, const char *format)

DESCRIPTION

       Creates	a  string representation of a paradox timestamp as specified in the parameter format.  The timestamp must be either retrieved with
       PX_get_data_double(3) after calling PX_get_record(3)  or  by  simply  using  the  double  value	in  the  pxval_t  struct  as  returned	by
       PX_retrieve_record(3). A timestamp contains both time and date information. The format string contains chars which stand for certain values
       of the date/time. The following table lists all available characters with a meaning. All other characters are being  copied  unmodified	to
       the output string. If a special character shall not be interpreted it must be preceded with a backslash.

       Characters and their meaning in date/time format string

       Character					   Meaning
       Y						   year, numeric, 4 digits
       y						   year, numeric, 2 digits
       m						   month, numeric
       n						   month, numeric, no leading zeroes
       d						   day of the month, numeric
       j						   T{
       day of the month, numeric, no leading zeros
       T}
       H						   hour, numeric, 24 hour format
       h						   hour, numeric, 12 hour format
       G						   T{
       hour, numeric, 24 hour format, no leading zeroes
       T}
       g						   T{
       hour, numeric, 12 hour format, no leading zeroes
       T}
       i						   minutes, numeric
       s						   seconds, numeric
       A						   AM/PM
       a						   am/pm
       L						   boolean for leap year

RETURN VALUE

       Returns pointer to string on success and NULL on failure.

SEE ALSO

       PX_time2string(3), PX_date2string(3)

AUTHOR

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

															    PX_TIMESTAMP2STRING(3)

CHEWMAIL(1)						User Contributed Perl Documentation					       CHEWMAIL(1)

NAME

       chewmail - mail archiver

SYNOPSIS

       chewmail [OPTIONS] <MAILBOX> ...

DESCRIPTION

       chewmail is a program for archiving mail. It is inspired by the by the Python-based archivemail, but with more useful semantics. All mail
       is archived to the mailbox specified with the --output-box switch, in mbox format. It can read mailboxes in mbox, Maildir and MH formats.

       Internally, chewmail uses Mail::Box, so it support file names and URLs supported by that module.

OPTIONS

       -o mailbox-format, --output-box=mailbox-format
	   The mailbox to archive messages to. The mailbox is run through the Date::Format module, so it supports all it's conversion specifiers.
	   The date and time is relative to the messages timestamp, or the current time if the timestamp is impossible to determine. A sample of
	   the conversion specifiers follows:

	       %%      PERCENT
	       %b      month abbr
	       %B      month
	       %d      numeric day of the month, with leading zeros (eg 01..31)
	       %e      numeric day of the month, without leading zeros (eg 1..31)
	       %D      MM/DD/YY
	       %G      GPS week number (weeks since January 6, 1980)
	       %h      month abbr
	       %H      hour, 24 hour clock, leading 0's)
	       %I      hour, 12 hour clock, leading 0's)
	       %j      day of the year
	       %k      hour
	       %l      hour, 12 hour clock
	       %L      month number, starting with 1
	       %m      month number, starting with 01
	       %n      NEWLINE
	       %o      ornate day of month -- "1st", "2nd", "25th", etc.
	       %t      TAB
	       %U      week number, Sunday as first day of week
	       %w      day of the week, numerically, Sunday == 0
	       %W      week number, Monday as first day of week
	       %x      date format: 11/19/94
	       %y      year (2 digits)
	       %Y      year (4 digits)

       -d days-old, --days=days-old
	   Only archive messages older than than this many days.

       -D date, --date=date
	   Only archive messages old than this date. The date can be any date understood by Perl's Date::Parse module.

       -R, --only-read
	   Only archive messages that are marked seen or read.

       --delete-immediately
	   Synchonize the mailboxes after every message is moved. This will be substantially slower but may provide better recovery for some mail-
	   box formats in the event of a crash.

       --preserve-timestamp
	   Preserve the atime and mtime of the input mailbox. This only affects file-based mailboxes, such as mbox.

       -n, --dry-run
	   Go through all the motions of archiving the mail, but don't actually change any mailboxes.

       -v, --verbose
	   Output more informational messages. Use multiple times for more verbosity.

       -q, --quiet
	   Don't output any messages other than error messages.

       -V, --version
	   Print the version number then exit.

       -h, --help
	   Print usage information then exit.

EXAMPLES

       Archive two day old messages in inbox to inbox-old:

	 chewmail --days 2 -o inbox-old inbox

       Archive read messages to a mailbox named the year-month of the message:

	 chewmail --only-read -o %Y-%m inbox

SEE ALSO

       archivemail(1), Date::Parse, Date::Format, Mail::Box

AUTHOR

       Eric Dorland <eric@kuroneko.ca>

perl v5.8.8							    2006-08-15							       CHEWMAIL(1)