Converts the value of this instance to its equivalent string representation using the specified format and culture-specific formatting information.
Params:
const(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