tango.text.locale.Convert

License:
BSD style: see license.txt

Version:
Initial release: 2005

author:
John Chapman

char[] formatDateTime (char[] output, Time dateTime, char[] format, IFormatService formatService = cast(IFormatService)null);

Converts the value of this instance to its equivalent string representation using the specified format and culture-specific formatting information.

Params:

char[] format	A format string.
IFormatService formatService	An IFormatService that provides culture-specific formatting information.

Returns:
A string representation of the value of this instance as specified by format and formatService.

Remarks:
See Time Formatting for more information about date and time formatting.

Examples:

 import tango.io.Print, tango.text.locale.Core, tango.time.WallClock;

 void main() {
   Culture culture = Culture.current;
   Time now = WallClock.now;

   Println("Current date and time: %s", now.toString());
   Println();

   // Format the current date and time in a number of ways.
   Println("Culture: %s", culture.englishName);
   Println();

   Println("Short date:              %s", now.toString("d"));
   Println("Long date:               %s", now.toString("D"));
   Println("Short time:              %s", now.toString("t"));
   Println("Long time:               %s", now.toString("T"));
   Println("General date short time: %s", now.toString("g"));
   Println("General date long time:  %s", now.toString("G"));
   Println("Month:                   %s", now.toString("M"));
   Println("RFC1123:                 %s", now.toString("R"));
   Println("Sortable:                %s", now.toString("s"));
   Println("Year:                    %s", now.toString("Y"));
   Println();

   // Display the same values using a different culture.
   culture = Culture.getCulture("fr-FR");
   Println("Culture: %s", culture.englishName);
   Println();

   Println("Short date:              %s", now.toString("d", culture));
   Println("Long date:               %s", now.toString("D", culture));
   Println("Short time:              %s", now.toString("t", culture));
   Println("Long time:               %s", now.toString("T", culture));
   Println("General date short time: %s", now.toString("g", culture));
   Println("General date long time:  %s", now.toString("G", culture));
   Println("Month:                   %s", now.toString("M", culture));
   Println("RFC1123:                 %s", now.toString("R", culture));
   Println("Sortable:                %s", now.toString("s", culture));
   Println("Year:                    %s", now.toString("Y", culture));
   Println();
 }

 // Produces the following output:
 // Current date and time: 26/05/2006 10:04:57 AM
 //
 // Culture: English (United Kingdom)
 //
 // Short date:              26/05/2006
 // Long date:               26 May 2006
 // Short time:              10:04
 // Long time:               10:04:57 AM
 // General date short time: 26/05/2006 10:04
 // General date long time:  26/05/2006 10:04:57 AM
 // Month:                   26 May
 // RFC1123:                 Fri, 26 May 2006 10:04:57 GMT
 // Sortable:                2006-05-26T10:04:57
 // Year:                    May 2006
 //
 // Culture: French (France)
 //
 // Short date:              26/05/2006
 // Long date:               vendredi 26 mai 2006
 // Short time:              10:04
 // Long time:               10:04:57
 // General date short time: 26/05/2006 10:04
 // General date long time:  26/05/2006 10:04:57
 // Month:                   26 mai
 // RFC1123:                 ven., 26 mai 2006 10:04:57 GMT
 // Sortable:                2006-05-26T10:04:57
 // Year:                    mai 2006

package const char[] positiveNumberFormat ;

int charTerm (T)(T* s);

char[] longToString (char[] buffer, long value, int digits, char[] negativeSign);

char[] longToHexString (char[] buffer, ulong value, int digits, char format);

char[] longToBinString (char[] buffer, ulong value, int digits);

char parseFormatSpecifier (char[] format, out int length);

char[] formatInteger (char[] output, long value, char[] format, NumberFormat nf);

void formatGeneral (ref Number number, ref Result target, int length, char format, NumberFormat nf);

void formatNumber (ref Number number, ref Result target, int length, NumberFormat nf);

void formatCurrency (ref Number number, ref Result target, int length, NumberFormat nf);

void formatFixed (ref Number number, ref Result target, int length, int[] groupSizes, char[] decimalSeparator, char[] groupSeparator);

char[] toString (ref Number number, ref Result result, char format, int length, NumberFormat nf);

anchorFromTitle('tango.text.locale.Convert', 'source/', 'html');