* Converts the value of this instance to its equivalent string representation using the specified format and culture-specific formatting information.
* Params:
* format = A format string.
* 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
* ---
char[]formatDateTime(char[] output, Time dateTime, const(char)[] format, IFormatService formatService)
* Converts the value of this instance to its equivalent string representation using the specified format and culture-specific formatting information. * Params: * format = A format string. * 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 * ---