KMime::DateFormatter Class Reference

#include <kmime_util.h>

Public Types
enum	FormatType {   CTime , Localized , Fancy , Iso ,   Custom }

Public Member Functions
	DateFormatter (FormatType fType=DateFormatter::Fancy)
FormatType	getFormat () const
void	setFormat (FormatType t)
TQString	dateString (time_t otime, const TQString &lang=TQString(), bool shortFormat=true, bool includeSecs=false) const
TQString	dateString (const TQDateTime &dtime, const TQString &lang=TQString(), bool shortFormat=true, bool includeSecs=false) const
void	setCustomFormat (const TQString &format)
TQString	getCustomFormat () const
TQCString	rfc2822 (time_t otime) const
void	reset ()

Static Public Member Functions
static TQString	formatDate (DateFormatter::FormatType t, time_t time, const TQString &data=TQString(), bool shortFormat=true, bool includeSecs=false)
static TQString	formatCurrentDate (DateFormatter::FormatType t, const TQString &data=TQString(), bool shortFormat=true, bool includeSecs=false)
static TQCString	rfc2822FormatDate (time_t time)
static bool	isDaylight ()

Protected Member Functions
TQString	fancy (time_t otime) const
TQString	localized (time_t otime, bool shortFormat=true, bool includeSecs=false, const TQString &localeLanguage=TQString()) const
TQString	cTime (time_t otime) const
TQString	isoDate (time_t otime) const
TQString	custom (time_t t) const
TQCString	zone (time_t otime) const
time_t	qdateToTimeT (const TQDateTime &dt) const

Detailed Description

class abstracting date formatting

DateFormatter deals with different kinds of date display formats. The formats supported by the class include:

• fancy "Today 02:08:35"
• ctime "Sun Mar 31 02:08:35 2002"
• localized "2002-03-31 02:08"
• iso "2002-03-31 02:08:35"
• rfc2822 "Sun, 31 Mar 2002 02:08:35 -0500"
• custom "whatever you like"

Definition at line 194 of file kmime_util.h.

Member Enumeration Documentation

FormatType

enum KMime::DateFormatter::FormatType

Definition at line 196 of file kmime_util.h.

Constructor & Destructor Documentation

DateFormatter()

KMime::DateFormatter::DateFormatter

(

FormatType

fType = DateFormatter::Fancy

)

constructor

Parameters

fType

default format used by the class

Definition at line 460 of file kmime_util.cpp.

~DateFormatter()

KMime::DateFormatter::~DateFormatter

(

)

Definition at line 466 of file kmime_util.cpp.

Member Function Documentation

cTime()

TQString KMime::DateFormatter::cTime ( time_t  otime ) const

protected

returns string as formatted with ctime function

Definition at line 706 of file kmime_util.cpp.

custom()

TQString KMime::DateFormatter::custom ( time_t  t ) const

protected

returns date formatted with the earlier given custom format

Parameters

t	time used for formatting

Definition at line 527 of file kmime_util.cpp.

dateString() [1/2]

TQString KMime::DateFormatter::dateString	(	const TQDateTime &	dtime,
		const TQString &	lang = TQString(),
		bool	shortFormat = true,
		bool	includeSecs = false
	)		const

overloaded, does exactly what dateString does (it's slower)

Definition at line 506 of file kmime_util.cpp.

dateString() [2/2]

TQString KMime::DateFormatter::dateString	(	time_t	otime,
		const TQString &	lang = TQString(),
		bool	shortFormat = true,
		bool	includeSecs = false
	)		const

returns formatted date string in a currently set format.

Parameters

otime	time to format
lang	used only by the Localized format, sets the used language
shortFormat	used only by the Localized format, is passed to TDELocale::formatDateTime
includeSecs	used only by the Localized format, is passed to TDELocale::formatDateTime

Definition at line 482 of file kmime_util.cpp.

fancy()

TQString KMime::DateFormatter::fancy ( time_t  otime ) const

protected

returns fancy formatted date string

Parameters

otime

time to format

Definition at line 634 of file kmime_util.cpp.

formatCurrentDate()

TQString KMime::DateFormatter::formatCurrentDate ( DateFormatter::FormatType  t, const TQString &  data = TQString(), bool  shortFormat = true, bool  includeSecs = false  )

static

convenience function, same as formatDate but returns the current time formatted

Parameters

t	specifies the FormatType to use
data	is either the format when FormatType is Custom, or language when FormatType is Localized
shortFormat	used only by the Localized format, is passed to TDELocale::formatDateTime
includeSecs	used only by the Localized format, is passed to TDELocale::formatDateTime

Definition at line 738 of file kmime_util.cpp.

formatDate()

TQString KMime::DateFormatter::formatDate ( DateFormatter::FormatType  t, time_t  time, const TQString &  data = TQString(), bool  shortFormat = true, bool  includeSecs = false  )

static

convenience function dateString

Parameters

t	specifies the FormatType to use
time	time to format
data	is either the format when FormatType is Custom, or language when FormatType is Localized
shortFormat	used only by the Localized format, is passed to TDELocale::formatDateTime
includeSecs	used only by the Localized format, is passed to TDELocale::formatDateTime

Definition at line 727 of file kmime_util.cpp.

getCustomFormat()

TQString KMime::DateFormatter::getCustomFormat

(

)

const

Definition at line 554 of file kmime_util.cpp.

getFormat()

DateFormatter::FormatType KMime::DateFormatter::getFormat

(

)

const

returns the currently set format

Definition at line 470 of file kmime_util.cpp.

isDaylight()

bool KMime::DateFormatter::isDaylight ( )

static

Definition at line 756 of file kmime_util.cpp.

isoDate()

TQString KMime::DateFormatter::isoDate ( time_t  otime ) const

protected

returns a string in the "%Y-%m-%d %H:%M:%S" format

Definition at line 712 of file kmime_util.cpp.

localized()

TQString KMime::DateFormatter::localized ( time_t  otime, bool  shortFormat = true, bool  includeSecs = false, const TQString &  localeLanguage = TQString()  ) const

protected

returns localized formatted date string

Parameters

otime	time to format
shortFormat
includeSecs
localeLanguage	language used for formatting

Definition at line 682 of file kmime_util.cpp.

qdateToTimeT()

time_t KMime::DateFormatter::qdateToTimeT ( const TQDateTime &  dt ) const

protected

Definition at line 620 of file kmime_util.cpp.

reset()

void KMime::DateFormatter::reset

(

)

resets the internal clock

Definition at line 721 of file kmime_util.cpp.

rfc2822()

TQCString KMime::DateFormatter::rfc2822

(

time_t

otime

)

const

returns rfc2822 formatted string

Parameters

otime

time to use for formatting

Definition at line 513 of file kmime_util.cpp.

rfc2822FormatDate()

TQCString KMime::DateFormatter::rfc2822FormatDate ( time_t  time )

static

convenience function, same as rfc2822

Definition at line 749 of file kmime_util.cpp.

setCustomFormat()

void KMime::DateFormatter::setCustomFormat

(

const TQString &

format

)

makes the class use the custom format for date to string conversions.

Method accepts the same arguments as TQDateTime::toString method and adds "Z" expression which is substituted with the RFC-822 style numeric timezone (-0500)

Parameters

format

the custom format

Definition at line 547 of file kmime_util.cpp.

setFormat()

void KMime::DateFormatter::setFormat

(

FormatType

t

)

sets the currently used format

Definition at line 476 of file kmime_util.cpp.

zone()

TQCString KMime::DateFormatter::zone ( time_t  otime ) const

protected

returns a string identifying the timezone (eg.

"-0500")

Definition at line 561 of file kmime_util.cpp.

---

The documentation for this class was generated from the following files:

• kmime_util.h
• kmime_util.cpp