date datetime helper

sql/helpers/functions/datetime/date/README.md

@@ -0,0 +1,43 @@
+# date Helper
+Specifies the `DATE` function.
+
+#### Supported by
+- [PostgreSQL](https://www.postgresql.org/docs/10/functions-formatting.html)
+- [Oracle](https://docs.oracle.com/cd/B19306_01/server.102/b14200/functions193.htm)
+
+# Allowed Types and Usage
+
+## as String:
+
+Usage of `date` as **String** with the following Syntax:
+
+**Syntax:**
+
+```javascript
+$date: < String >
+```
+
+**SQL-Definition:**
+```javascript
+DATE(<value-param>)
+```
+
+:bulb: **Example:**
+```javascript
+function() {
+    return sql.$select({
+        my_timestamp: { $date: '~~foo.column' },
+        $from: 'foo'
+    });
+}
+
+// SQL output
+SELECT
+    DATE(foo.column) AS my_timestamp
+FROM
+    foo
+
+// Values
+{}
+```
+

sql/helpers/functions/datetime/date/date.js

@@ -0,0 +1,38 @@
+'use strict';
+
+class date extends SQLBuilder.SQLHelper {
+	constructor(sql){
+		super(sql);
+
+		this.Types({
+			String: { syntax: this.Syntax('DATE(<value-param>)') },
+		});
+	}
+}
+
+module.exports = {
+	definition: date,
+	description: `Specifies the \`DATE\` function.`,
+	supportedBy: {
+		PostgreSQL: 'https://www.postgresql.org/docs/10/functions-formatting.html',
+		Oracle: 'https://docs.oracle.com/cd/B19306_01/server.102/b14200/functions193.htm',
+	},
+	examples: {
+		String: {
+			"Basic Usage": function(sql) {
+				return {
+					test: function(){
+						return sql.$select({
+							my_timestamp: { $date: '~~foo.column' },
+							$from: 'foo'
+						});
+					},
+					expectedResults: {
+						sql: 'SELECT DATE(foo.column) AS my_timestamp FROM foo',
+						values: {}
+					}
+				}
+			}
+		},
+	}
+}