[OASIS Issue Tracker] Updated: (OFFICE-3375) 19.882text:time-adjust - duration poorly stated and truncation not referenced -see description

[OASIS Issues Tracker <workgroup_mailer@lists.oasis-open.org>]

     [ http://tools.oasis-open.org/issues/browse/OFFICE-3375?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Dennis Hamilton updated OFFICE-3375:
------------------------------------

        Summary: 19.882 text:time-adjust - duration poorly stated and truncation not referenced - see description  (was: 19.822 text:time-adjust - duration poorly stated and truncation not referenced - see description)
    Description: 
19.882 reads in part: "The duration is truncated to full minutes."

Suggest:

Duration values are truncated to full minutes.

Note: Truncation of time values is defined by number:truncate-on-overflow. 19.367

  was:
19.822 reads in part: "The duration is truncated to full minutes."

Suggest:

Duration values are truncated to full minutes.

Note: Truncation of time values is defined by number:truncate-on-overflow. 19.367


[Corrected reference to 19.882, not 19.822.]

The proposed note seems to be incorrect.  number:truncate-on-overflow is about styles of presentation for time and is an attribute on <number:time-style>.  Overflow is about the value being too large and truncation is used in a peculiar way in that description.  "Reduction" might be more appropriate, but I think the number:truncate-on-overflow case is more complicated than that.  This is completely different than truncation of any text:time-adjust value, since that value is not presented but used to adjust the time that is then displayed.  

My reading is that the truncation in 19.882 is more like a kind of rounding (by truncation) that removes seconds and any fractions of seconds.  That is, the time adjustment will be no finer than whole minutes.  This is the conventional use of truncation.  On the other hand, does that mean PT192M73S truncated to PT193M (since it is PT193M13S) or PT192M?  Note that [xml-schema2] uses truncation to indicate when components that have value 0 can be omitted (and is why there need not be H, D, Month, and Y components in the example since zero is understood for those).

If the 19.367 rule for *not* *extending* values applies here, it would be simpler to say that the value of text:time-adjust shall be less than 60 minutes in magnitude, and I know of no basis for such a limitation.

Even adjusting text:time-adjust to whole minutes is a peculiar restraint, since there is no such restriction on the granularity of the associated text:time-value attribute in the same <text:time> element.  Also, when text:time-value is missing and the current time is understood, I don't know that there is any assumption that the current time is adjusted to whole minutes.

My wild guess is that the limitation to minutes is to avoid dealing with leap seconds, a requirement of the XML Schema datatype for ISO 8601 date-time representation.  On the other hand, it probably needs to be clear that, for <text:time>, the addition of the duration specified by a text:time-adjust is subject to the rules for addition of durations to date times in Appendix E of [xml-schema2].  It is also useful to know whether "the current time" is a nominal dateTime, not a nominal Time of day, for timestamp values such as <text:time>.  

It would appear that there are a number of underspecified characteristics here.  

> 19.882 text:time-adjust - duration poorly stated and truncation not referenced - see description
> ------------------------------------------------------------------------------------------------
>
>                 Key: OFFICE-3375
>                 URL: http://tools.oasis-open.org/issues/browse/OFFICE-3375
>             Project: OASIS Open Document Format for Office Applications (OpenDocument) TC
>          Issue Type: Bug
>          Components: Text
>    Affects Versions: ODF 1.2 CD 05
>            Reporter: Patrick Durusau
>            Assignee: Patrick Durusau
>            Priority: Minor
>             Fix For: ODF 1.2 CD 06
>
>
> 19.882 reads in part: "The duration is truncated to full minutes."
> Suggest:
> Duration values are truncated to full minutes.
> Note: Truncation of time values is defined by number:truncate-on-overflow. 19.367

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://tools.oasis-open.org/issues/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira