Class CDateTimeField

class CDateTimeField : public CTextField;

Description

A date/time field.

This may contain any or all components of the date and time, and can be formatted in a variety of ways. It stores a format string, which is used by the Value() function to format the current date/time. For information on date/time formatting, see TTime::FormatL().

Derivation

• CBase - Base class for all classes to be instantiated on the heap

• CTextField - Abstract class: derive from this to instantiate a particular type of field (eg date etc) Abstract base class for all field types

• CDateTimeField - A date/time field

Members

Defined in CDateTimeField:
CDateTimeField(), ExternalizeL(), FormatString(), InternalizeL(), SetFormat(), Type(), Value(), iFormatString

Inherited from CBase:
Delete(), Extension_(), operator new()

Inherited from CTextField:
RestoreL(), StoreL()

IMPORT_C CDateTimeField();

Description

The default C++ constructor initialises the object's date/time format string to D%M%Y%/0%1%/1%2%/2%3%/3. This produces fields in the format "31/05/2000" (with no time component, and using the current locale's date separators).

IMPORT_C void SetFormat(const TDesC &aFormat);

Description

Sets the date/time format string. For information on the format string, see the documentation of TTime::FormatL().

Parameters

const TDesC &aFormat The new date/time format string.

virtual IMPORT_C TInt Value(TPtr &aValueText);

Description

Gets the current local date/time, then formats it according to the field's format string. aValueText is set to the formatted date/time string if the buffer is large enough to contain it. If not, the function returns the length which is required to contain the formatted date/time string.

Parameters

TPtr &aValueText Descriptor which on return contains the current date/time, formatted according to the format string.

Return value

TInt Zero if aValueText is long enough to hold the formatted local date/time string. Otherwise, the length of the buffer which is required to hold the string.

virtual IMPORT_C void InternalizeL(RReadStream &aStream);

Description

Internalises the format string from a read stream. The presence of this function means that the standard templated operator>>() (defined in s32strm.h) is available to internalise objects of this class.

Parameters

RReadStream &aStream Stream from which the format string should be internalised.

virtual IMPORT_C void ExternalizeL(RWriteStream &aStream) const;

Description

Externalises the format string to a write stream. The presence of this function means that the standard templated operator<<() (defined in s32strm.h) is available to externalise objects of this class.

Parameters

RWriteStream &aStream Stream to which the format string should be externalised.

IMPORT_C const TDesC &FormatString() const;

Description

Gets the field's date/time format string.

Return value

const TDesC & The date/time format string.

virtual IMPORT_C TUid Type() const;

Description

Gets the field's type UID.

Return value

TUid KDateTimeFieldUid.

protected: TBuf< 64 > iFormatString;

Description