Issue 17227: Description of time point conversion is confused (date-time-ftf) Source: NIST (Mr. Edward J. Barkmeyer, edbark(at)nist.gov) Nature: Uncategorized Issue Severity: Summary: Clause 12.4 contains the following: "The concept “time point converts to time period on time scale” enables conversion of a time point on some time scale1, to a time period on the given time scale. The target time scale always is finer, meaning that it has a granularity that is less than or equal to the granularity of time scale1. This means that time point is equivalent to a time period on time scale2. "For example, the Gregorian month that is indicated by “January” (on the Gregorian year of months scale) is the time period from Gregorian day of year 1 through Gregorian day of year 31 on the Gregorian year of days scale." In all of this text, the term 'time period' should probably be replaced by 'time point sequence'. Clause 12.4 then contains this entry: "time point converts to time period on time scale "Definition: time point converts to a time point sequence on the time scale and the time period instantiates the time point sequence" The verb concept 'time point converts to time point sequence' appears in diagram 12-12, but is not defined anywhere, and 'time point converts to time period on time scale' does not appear on the diagram. So the obvious interpretation is that 'time period' should be replaced by 'time point sequence' in the verb concept entry. But then the definition is circular. Resolution: Revised Text: Actions taken: March 12, 2012: received issue Discussion: End of Annotations:===== m: Ed Barkmeyer To: issues@omg.org Subject: DTV Issue -- Description of time point conversion is confused Specification: Date Time Vocabulary Version: beta-1 Title: Description of time point conversion is confused Source: Ed Barkmeyer, NIST, edbark@nist.gov' Summary: Clause 12.4 contains the following: "The concept .time point converts to time period on time scale. enables conversion of a time point on some time scale1, to a time period on the given time scale. The target time scale always is finer, meaning that it has a granularity that is less than or equal to the granularity of time scale1. This means that time point is equivalent to a time period on time scale2. "For example, the Gregorian month that is indicated by .January. (on the Gregorian year of months scale) is the time period from Gregorian day of year 1 through Gregorian day of year 31 on the Gregorian year of days scale." In all of this text, the term 'time period' should probably be replaced by 'time point sequence'. Clause 12.4 then contains this entry: "time point converts to time period on time scale "Definition: time point converts to a time point sequence on the time scale and the time period instantiates the time point sequence" The verb concept 'time point converts to time point sequence' appears in diagram 12-12, but is not defined anywhere, and 'time point converts to time period on time scale' does not appear on the diagram. So the obvious interpretation is that 'time period' should be replaced by 'time point sequence' in the verb concept entry. But then the definition is circular. -- Edward J. Barkmeyer Email: edbark@nist.gov National Institute of Standards & Technology Systems Integration Division 100 Bureau Drive, Stop 8263 Tel: +1 301-975-3528 Gaithersburg, MD 20899-8263 Cel: +1 240-672-5800 To: date-time-ftf@omg.org Subject: Date-Time Issue 17227 - Description of time point conversion is confused X-KeepSent: 80D4A5C3:994DBD16-85257A02:0077BEBB; type=4; name=$KeepSent X-Mailer: Lotus Notes Release 8.5.1FP5 SHF29 November 12, 2010 From: Mark H Linehan Date: Fri, 18 May 2012 17:53:02 -0400 X-MIMETrack: Serialize by Router on D01MC604/01/M/IBM(Release 8.5.3 ZX853HP5|January 12, 2012) at 05/18/2012 17:53:06 X-Content-Scanned: Fidelis XPS MAILER x-cbid: 12051821-4242-0000-0000-000001B6DCFC Here is a proposed resolution for this issue. I will put it on the agenda for Monday conference call. -------------------------------- Mark H. Linehan STSM, Model Driven Business Transformation IBM Research Date-Time Issue 17227 - Description of time point conversion is confused.doc Disposition: ??? OMG Issue No: 17227 Title: Description of time point conversion is confused Source: Ed Barkmeyer, edbark@nist.gov, NIST Summary: Clause 12.4 contains the following: "The concept time point converts to time period on time scale enables conversion of a time point on some time scale1, to a time period on the given time scale. The target time scale always is finer, meaning that it has a granularity that is less than or equal to the granularity of time scale1. This means that time point is equivalent to a time period on time scale2. For example, the Gregorian month that is indicated by January (on the Gregorian year of months scale) is the time period from Gregorian day of year 1 through Gregorian day of year 31 on the Gregorian year of days scale." In all of this text, the term 'time period' should probably be replaced by 'time point sequence'. Clause 12.4 then contains this entry: "time point converts to time period on time scale Definition: time point converts to a time point sequence on the time scale and the time period instantiates the time point sequence" The verb concept 'time point converts to time point sequence' appears in diagram 12-12, but is not defined anywhere, and 'time point converts to time period on time scale' does not appear on the diagram. So the obvious interpretation is that 'time period' should be replaced by 'time point sequence' in the verb concept entry. But then the definition is circular. Resolution: The existing verb concept entry is correct, but it references another verb concept that is currently specified only in several specializations. Clarify the relationship among these by defining the general case of 'time point converts to time point sequence on time scale'. Also for clarity, add 'time point converts to time set on time scale'. Include these verb concepts in figure 12-2. Add "General Concept" captions to each specialization of these verb concepts to relate the specializations to the general concepts. Revised Text: REPLACE figure 12.12 in clause 12.4, with this version, which adds the verb concept 'time point converts to time period on time scale': In clause 12.4, DELETE this paragraph: The following concept is defined generally below, with each possible conversion explicitly defined in the following sub-clauses. In clause 12.4, ADD a new paragraph and two glossary entries after 'time point converts to time period on time scale': The following concepts are defined generally below, with each possible conversion explicitly defined in the following sub clauses. time point converts to time point sequence on time scale Definition: the time point corresponds to at least one time interval1 and the time point sequence corresponds to at least one time interval2 and each time interval1 is some time interval2 and each time interval2 is some time interval1 Necessity: Each time point of the time point sequence is on the time scale. Possibility: The time point is an absolute time point or is a relative time point. Description: The time point and the time point sequence are two different ways to identify the same time intervals. Note: The specific conversions supported by this document are defined below in verb concepts that specialize .time coordinate converts to time point sequence on time scale.. Example: The time point that is indicated by the time coordinate January 2012 converts to the time point sequence 2012 day 1 through 2012 day 31 on the Gregorian days scale. time point converts to time set on time scale Definition: the time point corresponds to at least one time interval and at least one time point sequence of the time set corresponds to the time interval Necessity: Each time point of each time point sequence of the time set is on the time scale. Possibility: The time point is an absolute time point or is a relative time point Description: The time scale is defined with discontinuities (e.g. leap days), such that the time set identifies several alternative time intervals that may correspond to the time point. Note: The specific conversions supported by this document are defined below in verb concepts that specialize .time coordinate converts to time set on time scale.. Example: The time point that is indicated by the time coordinate 'February' converts to the time set {Gregorian day of year 32 through Gregorian day of year 59, Gregorian day of year 32 through Gregorian day of year 60} on the Gregorian year of days scale. In clause 12.4, in the final sentence, REPLACE, the term 'time periods' with 'time point sequences' so that the entire paragraph reads: The following clauses identify the particular combinations of time point comparisons and conversions that are defined by this specification. Other combinations are invalid. Each clause first specifies which kinds of .time point. share the same time scale, and then provides definitions for conversion of time points to time point sequences on another time scale. In clause 12.4.1, ADD a new caption before the Definition caption of 'Gregorian year converts to time point sequence on the Gregorian days scale': General Concept: time point converts to time point sequence on time scale In clause 12.4.1, ADD a new caption before the Definition caption of 'Gregorian month converts to time point sequence on the Gregorian days scale': General Concept: time point converts to time point sequence on time scale In clause 12.4.2, ADD a new caption before the Definition caption of 'Gregorian month converts to time set on the Gregorian year of days scale': General Concept: time point converts to time set on time scale In clause 12.4.3, ADD a new caption before the Definition caption of 'week of year converts to time set on the Gregorian year of days scale': General Concept: time point converts to time set on time scale In clause 12.4.3, ADD a new caption before the Definition caption of 'weekday of year converts to time set on the Gregorian year of days scale': General Concept: time point converts to time set on time scale In clause 12.4.4, ADD a new caption before the Definition caption of 'hour of day converts to time point sequence on the day of seconds scale': General Concept: time point converts to time point sequence on time scale In clause 12.4.4, ADD a new caption before the Definition caption of 'minute of day converts to time point sequence on the day of seconds scale': General Concept: time point converts to time point sequence on time scale Disposition: Resolved To: date-time-ftf@omg.org Subject: Date-Time Issue 17227 - Description of time point conversion is confused X-KeepSent: 7CAC5DB0:41904900-85257A13:00063F82; type=4; name=$KeepSent X-Mailer: Lotus Notes Release 8.5.1FP5 SHF29 November 12, 2010 From: Mark H Linehan Date: Sun, 3 Jun 2012 21:10:37 -0400 X-MIMETrack: Serialize by Router on D01MC604/01/M/IBM(Release 8.5.3 ZX853HP5|January 12, 2012) at 06/03/2012 21:10:38 X-Content-Scanned: Fidelis XPS MAILER x-cbid: 12060401-6078-0000-0000-00000BB49403 I decided that Ed is right - we don't need the "time point converts to time period on time scale" verb concept. So I updated the resolution to remove that concept. Ed - I think all we need now is an update to figure 12.2 to add "time point converts to time set on time scale". -------------------------------- Mark H. Linehan STSM, Model Driven Business Transformation IBM Research Date-Time Issue 17227 - Description of time point conversion is confused1.doc Disposition: Resolved OMG Issue No: 17227 Title: Description of time point conversion is confused Source: Ed Barkmeyer, edbark@nist.gov, NIST Summary: Clause 12.4 contains the following: "The concept time point converts to time period on time scale enables conversion of a time point on some time scale1, to a time period on the given time scale. The target time scale always is finer, meaning that it has a granularity that is less than or equal to the granularity of time scale1. This means that time point is equivalent to a time period on time scale2. For example, the Gregorian month that is indicated by January (on the Gregorian year of months scale) is the time period from Gregorian day of year 1 through Gregorian day of year 31 on the Gregorian year of days scale." In all of this text, the term 'time period' should probably be replaced by 'time point sequence'. Clause 12.4 then contains this entry: "time point converts to time period on time scale Definition: time point converts to a time point sequence on the time scale and the time period instantiates the time point sequence" The verb concept 'time point converts to time point sequence' appears in diagram 12-12, but is not defined anywhere, and 'time point converts to time period on time scale' does not appear on the diagram. So the obvious interpretation is that 'time period' should be replaced by 'time point sequence' in the verb concept entry. But then the definition is circular. Resolution: Replace the glossary entry for 'time point converts to time period on time scale' with 'time point converts to time point sequence on time scale'. Also for clarity, add 'time point converts to time set on time scale'. Include these verb concepts in figure 12-2. Add "General Concept" captions to each specialization of these verb concepts to relate the specializations to the general concepts. Revised Text: REPLACE figure 12.12 in clause 12.4, with this version, which adds the verb concept 'time point converts to time set on time scale': In clause 12.4, REPLACE the paragraph that reads: The concept .time point converts to time period on time scale. enables conversion of a time point on some time scale1, to a time period on the given time scale. The target time scale always is finer, meaning that it has a granularity that is less than or equal to the granularity of time scale1. This means that time point is equivalent to a time period on time scale2. For example, the Gregorian month that is indicated by .January. (on the Gregorian year of months scale) is the time period from Gregorian day of year 1 through Gregorian day of year 31 on the Gregorian year of days scale. .. with this: The concept .time point converts to time point sequence on time scale. enables conversion of a time point on some time scale1, to a time point sequence on the given time scale. The target time scale always is finer, meaning that it has a granularity that is less than or equal to the granularity of time scale1. This means that time point is equivalent to a time point sequence on time scale2. For example, the Gregorian month that is indicated by .January. (on the Gregorian year of months scale) is the time period from Gregorian day of year 1 through Gregorian day of year 31 on the Gregorian year of days scale. In clause 12.4, REPLACE the glossary entry for 'time point converts to time period on time scale' with these: time point converts to time point sequence on time scale Definition: the time point is coextensive with the time point sequence Necessity: Each time point of the time point sequence is on the time scale. Possibility: The time point is an absolute time point or is a relative time point. Description: The time point and the time point sequence are two different ways to identify the same time intervals. Note: The specific conversions supported by this document are defined below in verb concepts that specialize .time coordinate converts to time point sequence on time scale.. Example: The time point that is indicated by the time coordinate January 2012 converts to the time point sequence 2012 day 1 through 2012 day 31 on the Gregorian days scale. time point converts to time set on time scale Definition: each instance of the time point is an instance of at least one time point sequence of the time set Necessity: Each time point of each time point sequence of the time set is on the time scale. Possibility: The time point is an absolute time point or is a relative time point Description: The time scale is defined with discontinuities (e.g. leap days), such that the time set identifies several alternative time intervals that may correspond to the time point. Note: The specific conversions supported by this document are defined below in verb concepts that specialize .time coordinate converts to time set on time scale.. Example: The time point that is indicated by the time coordinate 'February' converts to the time set {Gregorian day of year 32 through Gregorian day of year 59, Gregorian day of year 32 through Gregorian day of year 60} on the Gregorian year of days scale. In clause 12.4, in the final sentence, REPLACE, the term 'time periods' with 'time point sequences' so that the entire paragraph reads: The following clauses identify the particular combinations of time point comparisons and conversions that are defined by this specification. Other combinations are invalid. Each clause first specifies which kinds of .time point. share the same time scale, and then provides definitions for conversion of time points to time point sequences on another time scale. In clause 12.4.1, ADD a new caption before the Definition caption of 'Gregorian year converts to time point sequence on the Gregorian days scale': General Concept: time point converts to time point sequence on time scale In clause 12.4.1, ADD a new caption before the Definition caption of 'Gregorian month converts to time point sequence on the Gregorian days scale': General Concept: time point converts to time point sequence on time scale In clause 12.4.2, ADD a new caption before the Definition caption of 'Gregorian month converts to time set on the Gregorian year of days scale': General Concept: time point converts to time set on time scale In clause 12.4.3, ADD a new caption before the Definition caption of 'week of year converts to time set on the Gregorian year of days scale': General Concept: time point converts to time set on time scale In clause 12.4.3, ADD a new caption before the Definition caption of 'weekday of year converts to time set on the Gregorian year of days scale': General Concept: time point converts to time set on time scale In clause 12.4.4, ADD a new caption before the Definition caption of 'hour of day converts to time point sequence on the day of seconds scale': General Concept: time point converts to time point sequence on time scale In clause 12.4.4, ADD a new caption before the Definition caption of 'minute of day converts to time point sequence on the day of seconds scale': General Concept: time point converts to time point sequence on time scale Disposition: Resolved To: date-time-ftf@omg.org Subject: Date-Time Issue 17227 - Description of time point conversion is confused X-KeepSent: 4FE3654C:0B6F9651-85257A17:0069919A; type=4; name=$KeepSent X-Mailer: Lotus Notes Release 8.5.3 September 15, 2011 From: Mark H Linehan Date: Fri, 8 Jun 2012 15:15:32 -0400 X-MIMETrack: Serialize by Router on D01MC604/01/M/IBM(Release 8.5.3 ZX853HP5|January 12, 2012) at 06/08/2012 15:15:33 X-Content-Scanned: Fidelis XPS MAILER x-cbid: 12060819-3534-0000-0000-0000092DA96D This is the same as the last version sent out, but with the UML diagram supplied by Ed. We agreed to take this to ballot, so will not discuss this further unless I hear any additional comments. -------------------------------- Mark H. Linehan STSM, IBM Research Date-Time Issue 17227 - Description of time point conversion is confused2.doc Disposition: Resolved OMG Issue No: 17227 Title: Description of time point conversion is confused Source: Ed Barkmeyer, edbark@nist.gov, NIST Summary: Clause 12.4 contains the following: "The concept time point converts to time period on time scale enables conversion of a time point on some time scale1, to a time period on the given time scale. The target time scale always is finer, meaning that it has a granularity that is less than or equal to the granularity of time scale1. This means that time point is equivalent to a time period on time scale2. For example, the Gregorian month that is indicated by January (on the Gregorian year of months scale) is the time period from Gregorian day of year 1 through Gregorian day of year 31 on the Gregorian year of days scale." In all of this text, the term 'time period' should probably be replaced by 'time point sequence'. Clause 12.4 then contains this entry: "time point converts to time period on time scale Definition: time point converts to a time point sequence on the time scale and the time period instantiates the time point sequence" The verb concept 'time point converts to time point sequence' appears in diagram 12-12, but is not defined anywhere, and 'time point converts to time period on time scale' does not appear on the diagram. So the obvious interpretation is that 'time period' should be replaced by 'time point sequence' in the verb concept entry. But then the definition is circular. Resolution: Replace the glossary entry for 'time point converts to time period on time scale' with 'time point converts to time point sequence on time scale'. Also for clarity, add 'time point converts to time set on time scale'. Include these verb concepts in figure 12-2. Add "General Concept" captions to each specialization of these verb concepts to relate the specializations to the general concepts. Revised Text: REPLACE figure 12.12 in clause 12.4, with this version, which adds the verb concept 'time point converts to time set on time scale': In clause 12.4, REPLACE the paragraph that reads: The concept .time point converts to time period on time scale. enables conversion of a time point on some time scale1, to a time period on the given time scale. The target time scale always is finer, meaning that it has a granularity that is less than or equal to the granularity of time scale1. This means that time point is equivalent to a time period on time scale2. For example, the Gregorian month that is indicated by .January. (on the Gregorian year of months scale) is the time period from Gregorian day of year 1 through Gregorian day of year 31 on the Gregorian year of days scale. .. with this: The concept .time point converts to time point sequence on time scale. enables conversion of a time point on some time scale1, to a time point sequence on the given time scale. The target time scale always is finer, meaning that it has a granularity that is less than or equal to the granularity of time scale1. This means that time point is equivalent to a time point sequence on time scale2. For example, the Gregorian month that is indicated by .January. (on the Gregorian year of months scale) is the time period from Gregorian day of year 1 through Gregorian day of year 31 on the Gregorian year of days scale. In clause 12.4, REPLACE the glossary entry for 'time point converts to time period on time scale' with these: time point converts to time point sequence on time scale Definition: the time point is coextensive with the time point sequence Necessity: Each time point of the time point sequence is on the time scale. Possibility: The time point is an absolute time point or is a relative time point. Description: The time point and the time point sequence are two different ways to identify the same time intervals. Note: The specific conversions supported by this document are defined below in verb concepts that specialize .time coordinate converts to time point sequence on time scale.. Example: The time point that is indicated by the time coordinate January 2012 converts to the time point sequence 2012 day 1 through 2012 day 31 on the Gregorian days scale. time point converts to time set on time scale Definition: each instance of the time point is an instance of at least one time point sequence of the time set Necessity: Each time point of each time point sequence of the time set is on the time scale. Possibility: The time point is an absolute time point or is a relative time point Description: The time scale is defined with discontinuities (e.g. leap days), such that the time set identifies several alternative time intervals that may correspond to the time point. Note: The specific conversions supported by this document are defined below in verb concepts that specialize .time coordinate converts to time set on time scale.. Example: The time point that is indicated by the time coordinate 'February' converts to the time set {Gregorian day of year 32 through Gregorian day of year 59, Gregorian day of year 32 through Gregorian day of year 60} on the Gregorian year of days scale. In clause 12.4, in the final sentence, REPLACE, the term 'time periods' with 'time point sequences' so that the entire paragraph reads: The following clauses identify the particular combinations of time point comparisons and conversions that are defined by this specification. Other combinations are invalid. Each clause first specifies which kinds of .time point. share the same time scale, and then provides definitions for conversion of time points to time point sequences on another time scale. In clause 12.4.1, ADD a new caption before the Definition caption of 'Gregorian year converts to time point sequence on the Gregorian days scale': General Concept: time point converts to time point sequence on time scale In clause 12.4.1, ADD a new caption before the Definition caption of 'Gregorian month converts to time point sequence on the Gregorian days scale': General Concept: time point converts to time point sequence on time scale In clause 12.4.2, ADD a new caption before the Definition caption of 'Gregorian month converts to time set on the Gregorian year of days scale': General Concept: time point converts to time set on time scale In clause 12.4.3, ADD a new caption before the Definition caption of 'week of year converts to time set on the Gregorian year of days scale': General Concept: time point converts to time set on time scale In clause 12.4.3, ADD a new caption before the Definition caption of 'weekday of year converts to time set on the Gregorian year of days scale': General Concept: time point converts to time set on time scale In clause 12.4.4, ADD a new caption before the Definition caption of 'hour of day converts to time point sequence on the day of seconds scale': General Concept: time point converts to time point sequence on time scale In clause 12.4.4, ADD a new caption before the Definition caption of 'minute of day converts to time point sequence on the day of seconds scale': General Concept: time point converts to time point sequence on time scale Disposition: Resolved