--- a/AbstractTime.st Sun Jun 14 10:51:10 2009 +0200
+++ b/AbstractTime.st Sun Jun 14 11:27:39 2009 +0200
@@ -848,7 +848,78 @@
addPrintBindingsTo:aDictionary language:languageOrNil
"private print support: add bindings for printing to aDictionary.
- languageOrNil can only be #en or nil for the current language."
+ languageOrNil can only be #en or nil for the current language.
+ bindings:
+ %h hours, 00..23 (i.e. european) 0-padded to length 2
+ %u hours, 00..12 (i.e. us) 0-padded to length 2
+ %m minutes, 00..59 0-padded to length 2
+ %s seconds, 00..59 0-padded to length 2
+ %i milliseconds, 000..999 0-padded to length 3
+ %a am/pm
+
+ Timestamp only:
+ %(day) day, 00..31 0-padded to length 2
+ %(month) month, 00..12 0-padded to length 2
+ %(year) year, 4 digits 0-padded to length 4
+
+ special:
+ %H 24-hours - unpadded
+ %U 12-hours - unpadded
+ %M minutes - unpadded
+ %S seconds - unpadded
+ %I milliseconds, unpadded
+ %A AM/PM - uppercase
+
+ %t seconds within hour (unpadded)
+ %T seconds from midNight (unpadded)
+
+ %(TZD) timeZone delta from UTC in the format +/-hh:mm
+
+ %milli1 milliseconds, truncated to 1/10th of a second 0..9
+ %milli2 milliseconds, truncated to 1/100th of a second 00..99 0-padded to length 2
+
+ %nth - counting day-in-month (1->'st'; 2->'nd'; 3->'rd'; 4...->'th')
+ %weekDayNth - counting day-in-week (1->'st'; 2->'nd'; 3->'rd'; 4...->'th')
+ %weekNth - counting week-in-year (1->'st'; 2->'nd'; 3->'rd'; 4...->'th')
+
+ Timestamp only:
+ %Day day - unpadded
+ %Month month - unpadded
+ %(yearOrTime) year or time 5 digits as in unix-ls:
+ year if it is not the current year;
+ time otherwise
+
+
+ The ISO8601 printString are generated with:
+
+ Year:
+ YYYY (eg 1997)
+ Date today printStringFormat:'%(year)'
+ Timestamp now printStringFormat:'%(year)'
+
+ Year and month:
+ YYYY-MM (eg 1997-07)
+ Date today printStringFormat:'%(year)-%(month)'
+ Timestamp now printStringFormat:'%(year)-%(month)'
+
+ Complete date:
+ YYYY-MM-DD (eg 1997-07-16)
+ Date today printStringFormat:'%(year)-%(month)-%(day)'
+ Timestamp now printStringFormat:'%(year)-%(month)-%(day)'
+
+ Complete date plus hours and minutes:
+ YYYY-MM-DDThh:mmTZD (eg 1997-07-16T19:20+01:00)
+ Timestamp now printStringFormat:'%(year)-%(month)-%(day)T%h:%m%(TZD)'
+
+ Complete date plus hours, minutes and seconds:
+ YYYY-MM-DDThh:mm:ssTZD (eg 1997-07-16T19:20:30+01:00)
+ Timestamp now printStringFormat:'%(year)-%(month)-%(day)T%h:%m:%s%(TZD)'
+
+ Complete date plus hours, minutes, seconds and a decimal fraction of a second
+ YYYY-MM-DDThh:mm:ss.sTZD (eg 1997-07-16T19:20:30.45+01:00)
+ Timestamp now printStringFormat:'%(year)-%(month)-%(day)T%h:%m:%s.%(milli2)%(TZD)'
+
+ "
|hours minutes seconds millis usHours ampm s zone tzDelta|
@@ -1068,5 +1139,5 @@
!AbstractTime class methodsFor:'documentation'!
version
- ^ '$Header: /cvs/stx/stx/libbasic/AbstractTime.st,v 1.63 2009-06-14 08:51:10 cg Exp $'
+ ^ '$Header: /cvs/stx/stx/libbasic/AbstractTime.st,v 1.64 2009-06-14 09:27:39 cg Exp $'
! !