Macromedia coldfusion 4.5-cfml language reference User Manual

Chapter 1: ColdFusion Tags

157

Usage

To create a ColdFusion date/time object from the date-time string that is extracted
from a mail message in the queryname.date column, use the following table to
determine what to do.

See also the description of the

SetLocale

function.

For complete usage information on CFPOP, see Developing Web Applications with
ColdFusion.

Example

<HTML>
<HEAD>
<TITLE>CFPOP Example</TITLE>
</HEAD>

<BODY>
<H3>CFPOP Example</H3>
<P>CFPOP allows you to retrieve and manipulate mail
in a POP3 mailbox. This view-only example shows how to
create one feature of a mail client, allowing you to display
the mail headers in a POP3 mailbox.

<P>Simply uncomment this code and run with a mail-enabled CF Server to
see this feature in action.

<CFIF form.server is not "“ and form.username is not "“>
<CFPOP SERVER= "#server# " USERNAME=#UserName# PASSWORD=#pwd#
ACTION= "GETHEADERONLY " NAME= "GetHeaders ">

<H3>Message Headers in Your Inbox</H3>

<P>Number of Records:
<CFOUTPUT>#GetHeaders.RecordCount#</CFOUTPUT></P>
<UL>

Date-Time Parsing According to Locale

Locale

What to do?

English (US) locale

Use the

ParseDateTime

function and

specify the POP attribute, which
converts the date-time value to
Greenwich Meantime.

Other locales

Extract the date portion of the string
and pass it to the

LSParseDateTime

function, then add or subtract the
conversion time, depending on the
locale.