Date-Time Vocabulary Annex C – Business Usage Guidelines (Informative) C.1 Introduction

advertisement
Date Time Vocabulary BusinessUsage Guidelines
dtc/2015-02-11
Date-Time Vocabulary
Annex C – Business Usage Guidelines
(Informative)
C.1 Introduction
Developers of business vocabularies need to understand how to employ the Date-Time
Vocabulary (DTV). The normative clauses of this specification contain both concepts intended
for business use, and concepts that describe the complex technical details of time concepts.
Which Date-Time noun concepts provide the right foundations for business vocabularies and
business rules? This Annex answers that question in two ways: by a discussion of and examples
of "calendar expressions", and by inventorying the Date-Time noun and verb concepts
recommended for business use.
C.2 Calendar Expressions
Business speech commonly includes references such as "every Monday at noon for 2 hours",
"the fourth Thursday of each November", "October 1 through September 30", and "the first
Tuesday after the first Monday in November". For the purposes of this annex, complex
combinations of calendar dates, such as these examples, are called "calendar expressions". This
section shows how calendar expressions are formalized using DTV concepts.
Calendar expressions may appear in SBVR Definition, Necessity, and Possibility statements.
The normative portions of DTV define many concepts that may be combined to formalize these
expressions. Principal among these are calendar-defined noun concepts (such as "Monday" and
"November") which identify time intervals, and verb concepts that relate time intervals to each
other by containment (as calendar months contain calendar days) and by temporal order.
The number and variety of possible calendar expressions is unlimited, so it is not possible to
describe how to formalize every such expression. Instead, the table below gives examples of
common forms, with the expectation that readers can easily adapt the examples to their needs.
Calendar Expression
Example DTV and SBVR Formalization
A team must be scheduled every Monday at
noon for 2 hours.
A team meeting must be scheduled for each
Monday at noon for 2 hours.
'Thanksgiving day' defined as "the fourth
Thursday of each November"
Thanksgiving day
Definition: the fourth of the Thursdays that are in
a given November
'default contract term' defined as "October 1
through September 30"
default contract term
Definition: time interval that is from October 1
through September 30
The Annual General Meeting (AGM) must be
schedule on the first Tuesday after the first
Monday in November
The AGM for a given Gregorian year must be
scheduled on the first of the Tuesdays that are after
the first of the Mondays that are in the November of
the Gregorian year.
1
Date Time Vocabulary BusinessUsage Guidelines
Calendar Expression
dtc/2015-02-11
Example DTV and SBVR Formalization
"the cancellation period is the three days after
the contract signing", as used in a definition
of a verb concept 'contract has cancellation
period'
contract has cancellation period
Definition: the cancellation period of the contract
is the 3 days following the contract
signing of the contract
'contract term' defined as "from the contract
signing to the contract termination"
contract term
Definition: time interval that is from the signing of
a contract to the termination of the
contract
'contract initial stub' defined as "contract
signing through the end of the year"
contract initial stub
Definition: time interval that is from the signing of
a contract through the time interval
that ends the calendar year of the
signing of the contract
C.3 Date-Time Business Terms
Business vocabularies can build upon any of the Date-Time concepts, but many DTV concepts
deal with intricacies of time and calendars that are not relevant to businesses. Those concepts
that are intended for business use are summarized here for the convenience of DTV users.
C.3.1 Durations and Time Units
Durations are amounts of time, such as the length of a meeting. Durations may be specified by
literal amounts, such as "3 weeks", or "10 minutes", using these well-known time units: day, hour,
minute, month, second, week, and year. Durations may also be specified as the lengths of time
periods (see section C.3.2, below).
Businesses should build upon the term 'duration' for all concepts whose meaning is an amount of
time. When a business requires measuring time in specific units, an SBVR Definition or
Necessity can specify the constraint. For example, EU-Rent defines a "rental hour" as "duration
that has the time unit 'hour'".
Any two durations may be compared using verb concepts is equal, is greater than / is less
than, and is greater than or equal / is less than or equal. Duration arithmetic is enabled by
plus and minus verb concepts, and by a number times duration verb concept.
C.3.2 Time Periods
Businesses often need to reference time periods, which are places in time. For example, EU-Rent uses
the term 'rental period' to mean a time period from when a rental starts to when it finishes.
2
Date Time Vocabulary BusinessUsage Guidelines
dtc/2015-02-11
DTV defines a number of standard time periods whose duration is one of the standard time units listed
above, in section C.3.1. DTV distinguishes between calendar-based time periods and arbitrary time
periods. Calendar-based time periods start and end according to a clock or calendar: calendar day,
calendar week, calendar month, calendar year, second of day, minute of day, hour of day.
Arbitrary time periods are periods whose duration is a standard time unit and that start at any time: day
period, week period, month period, year period.
Businesses should use 'time period' for most purposes. The other concepts narrow the meaning of 'time
period' to specify periods of particular time units or calendar alignments. Use those only when the
narrowing of meaning is intended.
Do not confuse time units with time periods; the former are about amounts of time (e.g. specifying the
length of a contract), while the latter are about locations in time (e.g. the period from the start of a
contract to its end). For example, a contract that has duration "3 months" might take place during three
calendar months starting at the beginning of May.
A date or calendar date is a calendar reference, such as "July 17, 2015", that means a calendar
day. A time of day (e.g. "12:45:16") means a second of day, minute of day, or hour of day
depending upon its granularity. A date time or date and time is the combination of a date and a
time of day. Dates can incorporate the usual English month names (January, etc.) and weekday
names (Monday, etc.) You can use a calendar reference wherever you mean a time period. For
example, EU-Rent defines the term 'transfer date' (the date when a car is moved among EU-Rent
branches) as a category of DTV 'date'.
There are many ways to compare or combine time periods, as shown in Table C.1. To save space in the
table, the roles of the verb concepts are abbreviated: t indicates a role that can be filled by a time
period 1 (e.g. "rental period") or a calendar reference (e.g. "July 17, 2015"). Multiple synonymous forms
are listed for some verb concepts.
Table C.1: Verb Concepts for Time Periods
Time Period Verb
Concepts
1
Informal Description
Example
(‘Necessity’ definitional rules)
t begins before t
The start of one time period is
before or the same as the start of
the other.
The contracted period of a rental
begins before the actual pick-up date
time of the rental.
t ends after t
The end of one time period is the
same or after the end of the other.
The closure date-time of a rental ends
after the actual return date time of the
rental.
Technically, these verb concepts relate time intervals, but time periods are more relevant to business users.
3
Date Time Vocabulary BusinessUsage Guidelines
Time Period Verb
Concepts
Informal Description
dtc/2015-02-11
Example
(‘Necessity’ definitional rules)
t finishes t
The first time period starts
after the second time period,
but ends with the second time
period.
The scheduled return date time
of a rental finishes the scheduled
rental period of the rental.
t finishes after t
The two time periods overlap,
but the end of one time period
is later than the end of the other.
The chargeable period of a late-return
rental finishes after the contracted
period of the rental.
t finishes with t
The two time periods end
together, but either may start first.
The scheduled return date time of a
late-return rental finishes with the
contracted period of the rental.
t is t
t equals t
The two time
same.
The chargeable period of an earlyreturn rental is the contracted period
of the rental.
t is after t
t is before t
t follows t
t precedes t
t is followed by t
One time
another.
t is between t and t
The first time period is after
the second and is before the
third.
The open period of an advance rental
is between the booking period of the
rental and the closure period of the
rental.
t includes t
t is part of t
t is within t
One time period is contained
within or is the same as another.
The chargeable period of a rental
is a part of the open period of the
rental.
t is proper part of t
One time period is entirely
contained within another.
The opening hours of a branch
are a proper part of the working
hours of the branch.
t meets t
One time period ends just as
another starts.
The open period of an advance rental
meets the closure period of the rental.
t overlaps t
Some part of one time
is within the other.
The time period of a breakdown of
a car may overlap the rental period
of the car.
periods are the
period is after
period
4
The open period of an advance rental
is after the booking period of the
rental.
Date Time Vocabulary BusinessUsage Guidelines
Time Period Verb
Concepts
dtc/2015-02-11
Example
(‘Necessity’ definitional rules)
Informal Description
t starts t
The first time period starts at
the same time as the second time
period, but ends before the
second time period ends.
The actual pick-up date time of a
rental starts the chargeable
period of the rental.
t starts before t
The two time periods overlap,
and the start of the first time
period is earlier than the start of
the second time period.
The working hours of a branch starts
before the opening hours of the
branch.
t starts with t
The two time periods start
together, but either may end first.
The chargeable period of a rental
starts with the actual pick-up datetime of the rental.
t to t
A time period from the start of
the first time period to the start
of the second one.
The rent period of an apartment lease
is the first day of a calendar month1 to
the first day of the calendar month2
that follows the calendar month1.
t through t
The smallest time period that
includes both of them.
The chargeable period of a short-term
apartment rental is the first calendar
month of the rental through the final
calendar month of the rental.
Table C.2 lists verb concepts that relate durations and time periods. In this table, d represents a
duration, and t represents a time period.
Table C.2: Verb Concepts that Relate Durations and Time Periods
Verb Concepts that
Relate Durations and
Time Periods
t finishes d after t
Informal Description
The first time period ends d after
the end of the second time period.
Example
The grace period of a rental
finishes 30 minutes after the
scheduled return date-time of
the rental.
t is d after t
t is d before t
The first time period starts or ends
d after or before the start of the
second time period.
5
The late period of a rental is 1 day
after the scheduled return datetime of the rental.
Date Time Vocabulary BusinessUsage Guidelines
Verb Concepts that
Relate Durations and
Time Periods
Informal Description
dtc/2015-02-11
Example
t is the d following t
The first time period has
duration d and immediately
follows the second time period.
The grace period of a rental is
the 30 minutes following the
scheduled return date-time of
the rental.
t is the d preceding t
The first time period has
duration d and immediately
precedes the second time period.
The tax look-back period is the 2
years preceding the date of death.
t starts d before t
The first time period starts d
before the start of the second time
period.
The pre-game coverage period
starts 1 hour before the start of the
game.
t finishes d after t
The first time period ends d after
the end of the second time period.
The TV coverage period finishes
30 minutes after the end of the game.
d of t
The amount of time in the time
period.
The base price of a rental is
calculated using the duration of the
chargeable period of the rental and
the rental rates of the car group of
the rental.
C.3.3 Occurrences and Time
Occurrences are real events, activities, situations, or circumstances that actually happen at
some time. Use 'occurrence' when referring to individual events (etc.), such as the actual drop-off
of a rental. Use 'situation kind' (below) for rules and vocabulary concepts about events (etc.) that
may or may not occur, such as potential rentals.
DTV presents, per Table C 4.3, several verb concepts that relate occurrences to time. In the
following tables, the symbols o represents the concept occurrence, t means time period or
interval, and d means duration. To save space, verb concepts that are paired (with "start" and
"end" versions) are described together.
Table C.3: Occurrences and Time
Relationships between
Occurrences and Time
Informal Description
o ends at t
o starts at t
The occurrence starts or ends simultaneously with the time
o ends after t
o starts before t
The occurrence starts before /ends after the time
period starts / ends.
o for t
The occurrence happens exactly during the time
period.
6
period.
Date Time Vocabulary BusinessUsage Guidelines
Relationships between
Occurrences and Time
dtc/2015-02-11
Informal Description
o is between o and o
The first occurrence happens between the other two.
t is the d preceding o
t is the d following o
The time
o starts d after o
o ends d after o
The first occurrence starts / ends duration d before / after the second
occurrence starts / ends.
t starts d before o
t ends d after o
The time
o occurs d before t
o occurs d after t
The occurrence starts / ends duration d after / before the time
interval ends / starts.
d of o
o lasts d
The duration of the occurrence.
o overlaps o
o while o
The first occurrence starts before the second occurrence starts, and
ends before the second occurrence ends.
o precedes o
The first occurrence happens before the second one.
o through o specifies t
The time period extends from the start of the first occurrence through
the end of the occurrence.
t through o specifies t
The second time period extends from the start of the first time
through the end of the occurrence.
o throughout t
The occurrence happens during the time
or end later than the time period.
o to o specifies t
The time period extends from the start of the first occurrence up to,
but not including the start of the second occurrence.
t to o specifies t
The second time period extends from the start of the time
but not including the start of the occurrence.
o to t specifies t
The second time period extends from the start of the occurrence up to,
but not including the start of the first time period.
o within t
The occurrence happens some (possibly shorter) time during the time
period.
period has duration d, and is immediately before or after the
occurrence.
interval starts / ends duration d before / after the
occurrence starts / ends.
7
interval
period, but may start earlier
period up to,
Date Time Vocabulary BusinessUsage Guidelines
dtc/2015-02-11
C.3.4 Situation Kinds and Time
Situation kinds are events, activities, situations, or circumstances that may or may not happen,
and may happen multiple times. For example, the business concept 'rental booking', defined as
"acceptance by EU-Rent of a request from a renter for an advance rental" implicitly is a situation
kind that happens multiple times. The situation kind 'rental booking' itself has no unique time,
but its occurrences each happen at specific times.
The verb concept 'situation kind has occurrence' defines the relationship between situation
kinds and occurrences. A situation kind can have zero, one, or many occurrences.
It can be difficult to distinguish between situation kinds and occurrences, because many situation
kinds have just one occurrence. These are called individual situation kinds. For example, a
business concept defined as "the incorporation of EU-Rent" may have just one occurrence. For
practical purposes, the distinction between individual situation kinds and their occurrences is
often ignored. Most of the verb concepts listed in Table C.3 are also defined for individual
situation kinds.
Table C.3 uses the symbols s for situation kinds and t for time period in verb concepts that relate
situation kinds to time.
Table C.3: Situation Kinds and Time
Relationships between
Situation Kinds and Time
Informal Description
s ends before s
All occurrences of the first situation
of the second situation kind.
s has o
The occurrence is one (of possibly many) instances of the situation
s has o after t
The occurrence is the first occurrence of the situation
time period.
kind after the
s has o before t
The occurrence is the last occurrence of the situation
time period.
kind before the
s is between s and s
All occurrences of the first situation kind start after the end of all
occurrences of the second situation kind, and end before or with the start of
all occurrences of the third situation kind.
s occurs for t
The situation
period.
t of s
t is the smallest time
kind.
s starts before s
All occurrences of the first situation kind starts before the start of every
occurrence of the second situation kind.
s throughout t
The situation kind has an occurrence that occurs throughout the time
period, and may start before or end after the time period.
kind end before every occurrence
kind.
kind has an occurrence that occurs for exactly the time
period that contains all the occurrences of the situation
8
Date Time Vocabulary BusinessUsage Guidelines
Relationships between
Situation Kinds and Time
dtc/2015-02-11
Informal Description
s while s
Every occurrence of the first situation
the second situation kind.
s within t
The situation
time period.
kind overlaps some occurrence of
kind has an occurrence that occurs during some part of the
C.3.5 Indexical Time Concepts
Indexical time concepts are concepts that are defined relative to some reference time, such as
"the next day after the rental drop off date". Table C.5 lists the DTV indexical time verb
concepts. All are defined with respect to some reference time period that should be made explicit
in the definition or rule that uses them. The table uses the symbol t to mean a time period or
interval.
Table C.5: Indexical Time Verb Concepts
Indexical Verb Concepts
Time Adjective
t is past
past
The time
period is before some reference time period.
t is current
current
The time
period includes the reference time period.
t is future
future
The time
period is after some reference time period.
Informal Description
The indexical time intervals are not listed here because there are so many of them. See the
detailed list in DTV clause 15.3.
To keep the indexical time intervals straight, they are named using the regular pattern "<time
adjective> <time frame>". The time adjectives are listed in Table C.5. The time frames are
"day", "hour", "month", "week", "year", and "time". Each of these time frames means a time
period of the corresponding length. The time frame called "time" is any time period. For
example, "current day" means a calendar day that includes some reference time period, "past
year" means a calendar year that is before some reference time period, "future time" means a
time interval that is after some reference time interval.
C.3.6 Tense and Aspect
Regulations, contracts, and business policies often reference the future or past with respect to
some time (e.g. the inception of a contract), and often need to distinguish between the
continuation of a situation (such as the ongoing rental of a car) versus the completion of one
(such as the completed rental of a car) as of some time. In English, verb tense indicates event
time frames, and verb aspect identifies the completion status of situations. Table C.6 summarizes
the DTV verb concepts for tense and aspect, using the symbol x to mean either 'situation kind' or
'occurrence' because many of these concepts apply to both.
Verb aspect can be confusing, because a situation or occurrence can be continuing or
accomplished, or both, or neither. Table 7.1 in clause 7.12 gives business examples of the
9
Date Time Vocabulary BusinessUsage Guidelines
dtc/2015-02-11
twelve possible combinations of the three tenses and 4 aspects. The table at the end of clause
16.9 shows how these twelve combinations are formed from the verb concepts in Table C.6. All
these verb concepts are defined with respect to some reference time period that should be made
explicit in the definition or rule that uses them.
Table C.6 uses the symbols x to mean either an occurrence or a situation kind, and t to mean a
time period or interval.
Table C.6: Language Tense and Aspect
Language Tense and
Aspect
Informal Description
Example
(‘Obligation’ behavioral rules)
x is accomplished
An occurrence (or all
occurrences of a situation kind)
has reached a point of perfection at
some reference time period.
A renter who has damaged a
rented car must pay the insurance
deductible of the rental of the
rented car.
x is accomplished in
t
An occurrence (or all
occurrences of a situation kind)
has reached a point of perfection at
some time within the time period.
A customer who has purchased a
product in a holiday sales period
must not apply for a refund for the
product.
x is continuing
An occurrence (or all
occurrences of a situation kind)
is ongoing at some reference time
period.
A guest who is occupying a hotel
room must not entertain visitors in
the hotel room.
x is both continuing
and is accomplished
An occurrence (or all
occurrences of a situation kind)
that is ongoing but has reached a point
of perfection at some reference time
period.
A guest who has been renting a
hotel room must pay for the hotel
room.
x is in the past
An occurrence (or all
occurrences of the situation
kind) occurs in the past with respect to
some reference time period..
Each product promotion that is in
the past must be reported in the
accounts of the quarter that
includes the end date of the
product promotion.
x is current
An occurrence (or all
occurrences of the situation
kind) occurs for some reference time
period.
Each product promotion that is
current must have weekly status
reports.
x is in the future
An occurrence (or all
occurrences of the situation
kind) occurs in the future with respect
to some reference time period.
Each product promotion that is in
the future must be authorized by a
senior manager.
10
Date Time Vocabulary BusinessUsage Guidelines
dtc/2015-02-11
C.3.7 Schedules
Schedules are combinations of times and situation kinds that are planned to occur at the times.
Regular schedules repeat regularly, whereas ad hoc schedules list irregular times and
matching situation kinds. Examples of schedules include airline schedules, meeting schedules,
and so forth.
A regular schedule is defined by a start time, a recurrence count, a recurrence duration,
and a situation kind. The situation kind is planned to occur at the start time, and to repeat once
per recurrence duration for the indicated count. A regular schedule can have an initial stub and a
final stub, which each identify a situation that should occur at a time before or after the
repeating part of the regular schedule.
An ad hoc schedule is defined by a set of schedule entries, each of which has a situation
kind and a time interval. Each situation kind is planned to occur at the corresponding time
interval.
Both kinds of schedule have an earliest time (the earliest time an occurrence is planned), a
latest time (the latest time an occurrence is planned), and a time span (the time interval that
covers the entire schedule).
DTV clause 16 gives the details.
11
Download