--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/PDK/Source/GUID-A3ACAE90-F1D5-5876-AA02-416B09112F88.dita	Fri Jan 22 18:26:19 2010 +0000
@@ -0,0 +1,40 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
+<!-- This component and the accompanying materials are made available under the terms of the License 
+"Eclipse Public License v1.0" which accompanies this distribution, 
+and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
+<!-- Initial Contributors:
+    Nokia Corporation - initial contribution.
+Contributors: 
+-->
+<!DOCTYPE concept
+  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
+<concept id="GUID-A3ACAE90-F1D5-5876-AA02-416B09112F88" xml:lang="en"><title>How
+to format date as text</title><shortdesc>Formats the day number, date suffix and month name as text into
+a supplied descriptor.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
+<p> The function in the code fragment assumes that the descriptor is sufficiently
+big:</p>
+<codeblock id="GUID-207CAB83-6D49-5D28-A2B3-283D2F767A40" xml:space="preserve">void formatDateTime(TDes&amp; aBuffer,TDateTime aDateTime)
+    {
+    _LIT(KFormatTxt,"Date as text: %d%S %S\n");
+    aBuffer.Format(KFormatTxt,aDateTime.Day()+1,&amp;(TDateSuffix(aDateTime.Day())),&amp;(TMonthName(aDateTime.Month())));
+    }</codeblock>
+<p>Note the following:</p>
+<ul>
+<li id="GUID-CCF22563-3AAA-5A91-8BA4-B9EC20205E17"><p><xref href="GUID-E22ADC67-CEBC-3A6C-A507-EDB8C706476F.dita"><apiname>TDateSuffix</apiname></xref> and <xref href="GUID-98B3912D-84FC-3BD8-B1F0-1FF965C67D24.dita"><apiname>TMonthName</apiname></xref> are
+descriptors</p> </li>
+<li id="GUID-DEABA35F-1B1F-5895-A92C-B359B8478238"><p>A <codeph>TDateSuffix</codeph> object
+can contain a maximum of 4 characters</p> </li>
+<li id="GUID-FE7DEAD0-6BB7-5315-BF9C-818F7ACFE924"><p>A <codeph>TMonthName</codeph> object
+can contain a maximum of 32 characters</p> </li>
+<li id="GUID-980DC91A-A736-5D70-B8A3-7461DBFE0644"><p>In this example, both
+objects are constructed with a <codeph>TInt</codeph> value representing the
+day number within the month for the <codeph>TDateSuffix</codeph> object, and
+the month number for the <codeph>TMonthName</codeph> object. Both numbers
+are values offset from zero.</p> </li>
+<li id="GUID-1C2F253C-3B25-5A07-A04E-37205C066E4E"><p>The numbers are used
+to generate the appropriate text. For example, for a <codeph>TDateSuffix</codeph> object,
+a value of zero gives "st", (fir<i>st</i> day of the month), one gives "nd"
+etc.</p> </li>
+</ul>
+</conbody></concept>
\ No newline at end of file