3.3.9 Contract Commitment Duration Type
Contract Commitment Duration Type represents the categorical length of a contract commitment (e.g., "1 Year", "3 Years") based on the commercial agreement or pricing model.
This column serves as a stable classifier for the commitment's duration, distinct from the actual lifespan of the specific record. For example, a 3-year commitment that is exchanged or modified may have a calculated duration of only a few months, but its Contract Commitment Duration Type remains "3 Years". This allows for consistent grouping and reporting on commitment durations, regardless of lifecycle events.
3.3.9.1 Requirements
ContractCommitmentDurationType MUST adhere to the following requirements:
- ContractCommitmentDurationType MUST be of type String.
- ContractCommitmentDurationType MUST conform to StringHandling requirements.
- ContractCommitmentDurationType MUST NOT be null.
- ContractCommitmentDurationType SHOULD be expressed with a quantity and time unit, where quantity is a positive integer, and time-unit is a standardized unit of time, either singular or plural (e.g., "1 Day", "1 Year", "3 Months", "3 Years").
- ContractCommitmentDurationType SHOULD present the unit of time as one of the allowed values.
- ContractCommitmentDurationType SHOULD correspond to the standard duration of the purchased offering (e.g., "1 Year", "3 Years") rather than a precise calculation of days or hours.
- ContractCommitmentDurationType MAY differ from the actual duration calculated between ContractCommitmentPeriodStart and ContractCommitmentPeriodEnd (e.g., if a 3-year commitment is exchanged in its final month, the resulting record may have a short lifespan but retains a value of "3 Years").
3.3.9.2 Allowed Values
The following units should be used for the representation of time:
| Time Unit |
|---|
| Minute |
| Minutes |
| Hour |
| Hours |
| Day |
| Days |
| Week |
| Weeks |
| Month |
| Months |
| Quarter |
| Quarters |
| Year |
| Years |
3.3.9.3 Expected Format
A given Contract Commitment Duration Type value follows a structured format of "[Numeric Value] [Unit]".
- [Numeric Value]: A positive integer.
- [Unit]: A standardized unit of time, singular or plural (e.g., Hour, Year, Years).
3.3.9.6 Description
Represents the categorical length of the contract commitment offering.
Constraints
| Property | Value |
|---|---|
| Column Type | Dimension |
| Feature Level | Mandatory |
| Allows Nulls | No |
| Data Type | String |
| Value Format | Expected format |