Add Date Time Range type

CHANGELOG.md

@@ -1,3 +1,5 @@
+* Add Date Time Range type
+
 v1.2.0
 
 * Return null for null dates rather than the unix epoch.

Type.sbvr

@@ -86,4 +86,19 @@ Fact type:  Color has Green Component
 Fact type:  Color has Blue Component
 	Necessity: Each Color has exactly one Blue Component
 Fact type:  Color has Alpha Component
-	Necessity: Each Color has exactly one Alpha Component
+	Necessity: Each Color has exactly one Alpha Component
+
+Term:		Begin
+	Concept Type: Date Time
+Term:		End
+	Concept Type: Date Time
+Term:		Bounds
+	Concept Type: Short Text
+Term:		Date Time Range
+	Concept Type: Short Text
+Fact type:	Date Time Range has Begin
+	Necessity: Each Date Time Range has exactly one Begin
+Fact Type:	Date Time Range has End
+	Necessity: Each Date Time Range has at most one End
+Fact Type:	Date Time Range has Bounds
+	Necessity: Each Date Time Range has exactly one Bounds

src/types/Date Time Range.coffee

@@ -0,0 +1,55 @@
+{
+	types:
+		postgres: 'TSTZRANGE'
+		mysql: 'VARCHAR(255)'
+		websql: 'VARCHAR(255)'
+		odata:
+			name: 'Self.DateTimeRange'
+			complexType: '''
+				<ComplexType Name="DateTimeRange">
+					 <Property Name="Begin" Nullable="false" Type="Edm.DateTime"/>\
+					 <Property Name="End" Nullable="true" Type="Edm.DateTime"/>\
+					 <Property Name="Bounds" Nullable="false" Type="Edm.String"/>\
+				</ComplexType>'''
+
+	nativeProperties:
+		has:
+			Begin: (from) -> ['RangeBegin', from]
+			End: (from) -> ['RangeEng', from]
+			Bounds: (from) -> ['RangeBounds', from]
+
+	fetchProcessing: (data, callback) ->
+		if data?
+			res =
+				Begin: data.split(',')[0].slice(1)
+				End: data.split(',')[1].trim().slice(0, -1)
+				Bounds: data[0] + data[data.length - 1]
+			callback(null, res)
+		else
+			callback(null, data)
+
+	validate: (value, required, callback) ->
+		if !_.isObject(value)
+			callback('is not a date time range object: ' + value)
+		else
+			# Check with hasOwnProperty since null values are allowed
+			if value.hasOwnProperty('Begin') and value.hasOwnProperty('End') and value.hasOwnProperty('Bounds')
+				processedValue = ''
+				begin = undefined
+				end = undefined
+				bounds = undefined
+				for own component, componentValue of value
+					switch component.toLowerCase()
+						when 'begin'
+							begin = componentValue
+						when 'end'
+							end = componentValue
+						when 'bounds'
+							bounds = componentValue
+						else
+							callback('has an unknown component: ' + component)
+				processedValue = bounds[0] + begin + ', ' + end + bounds[1]
+				callback(null, processedValue)
+			else
+				callback('has unknown components: ' + value)
+}

test/Date Time Range.coffee

@@ -0,0 +1,22 @@
+helpers = require './helpers'
+
+helpers.describe 'Date Time Range', (test) ->
+	begin = new Date()
+	end = null + ''
+	bounds = '[)'
+	describe 'fetchProcessing', ->
+		test.fetch(bounds[0] + begin + ', ' + end + bounds[1], {
+			Begin: begin.toString()
+			End: end
+			Bounds: bounds
+		})
+
+	describe 'validate', ->
+		begin = new Date()
+		end = null
+		bounds = '[)'
+		test.validate({
+			Begin: begin
+			End: end
+			Bounds: bounds
+		}, true,  bounds[0] + begin + ', ' + end + bounds[1])