Next: The elapsedTimeFormat
Element, Previous: The stringFormat
Element, Up: The setFormat
Element [Contents][Index]
dateTimeFormat
ElementdateTimeFormat :baseFormat[dt_base_format]=(date | time | dateTime) :separatorChars? :mdyOrder=(dayMonthYear | monthDayYear | yearMonthDay)? :showYear=bool? :yearAbbreviation=bool? :showQuarter=bool? :quarterPrefix? :quarterSuffix? :showMonth=bool? :monthFormat=(long | short | number | paddedNumber)? :showWeek=bool? :weekPadding=bool? :weekSuffix? :showDayOfWeek=bool? :dayOfWeekAbbreviation=bool? :dayPadding=bool? :dayOfMonthPadding=bool? :hourPadding=bool? :minutePadding=bool? :secondPadding=bool? :showDay=bool? :showHour=bool? :showMinute=bool? :showSecond=bool? :showMillis=bool? :dayType=(month | year)? :hourFormat=(AMPM | AS_24 | AS_12)? => affix*
This element appears only in schema version 2.5 and earlier
(see The visualization
Element).
Data to be formatted in date formats is stored as strings in legacy
data, in the format yyyy-mm-ddTHH:MM:SS.SSS
and must be parsed
and reformatted by the reader.
The following attribute is required.
Specifies whether a date and time are both to be displayed, or just one of them.
Many of the attributes’ meanings are obvious. The following seem to be worth documenting.
Exactly four characters. In order, these are used for: decimal point, grouping, date separator, time separator. Always ‘.,-:’.
Within a date, the order of the days, months, and years.
dayMonthYear
is the only observed value, but one would expect
that monthDayYear
and yearMonthDay
to be reasonable as
well.
Whether to include the year and, if so, whether the year should be
shown abbreviated, that is, with only 2 digits. Each is true
or false
; only values of true
and false
,
respectively, have been observed.
Whether to include the month (true
or false
) and, if so,
how to format it. monthFormat
is one of the following:
long
The full name of the month, e.g. in an English locale,
September
.
short
The abbreviated name of the month, e.g. in an English locale,
Sep
.
number
The number representing the month, e.g. 9 for September.
paddedNumber
A two-digit number representing the month, e.g. 09 for September.
Only values of true
and short
, respectively, have been
observed.
This attribute is always month
in the corpus, specifying that
the day of the month is to be displayed; a value of year
is
supposed to indicate that the day of the year, where 1 is January 1,
is to be displayed instead.
hourFormat
, if present, is one of:
AMPM
The time is displayed with an am
or pm
suffix, e.g.
10:15pm
.
AS_24
The time is displayed in a 24-hour format, e.g. 22:15
.
This is the only value observed in the corpus.
AS_12
The time is displayed in a 12-hour format, without distinguishing
morning or evening, e.g. 10;15
.
hourFormat
is sometimes present for elapsedTime
formats,
which is confusing since a time duration does not have a concept of AM
or PM. This might indicate a bug in the code that generated the XML
in the corpus, or it might indicate that elapsedTime
is
sometimes used to format a time of day.
For a baseFormat
of date
, PSPP chooses a print format
type based on the following rules:
showQuarter
is true: QYR
.
showWeek
is true: WKYR
.
mdyOrder
is dayMonthYear
:
monthFormat
is number
or paddedNumber
: EDATE
.
DATE
.
mdyOrder
is yearMonthDay
: SDATE
.
ADATE
.
For a baseFormat
of dateTime
, PSPP uses YMDHMS
if
mdyOrder
is yearMonthDay
and DATETIME
otherwise.
For a baseFormat
of time
, PSPP uses DTIME
if
showDay
is true, otherwise TIME
if showHour
is
true, otherwise MTIME
.
For a baseFormat
of date
, the chosen width is the
minimum for the format type, adding 2 if yearAbbreviation
is
false or omitted. For other base formats, the chosen width is the
minimum for its type, plus 3 if showSecond
is true, plus 4 more
if showMillis
is also true. Decimals are 0 by default, or 3
if showMillis
is true.
Next: The elapsedTimeFormat
Element, Previous: The stringFormat
Element, Up: The setFormat
Element [Contents][Index]