added filter date_from_string

README.md

@@ -5,6 +5,7 @@ Making twig do things it really shouldn't. Twig is not intended to be a gene
 - {% break %}, {% continue %}, and {% return %} tags
 - `is numeric` test
 - `json_decode` filter
+- `date_from_string` filter
 
 ## Installation
 
@@ -78,6 +79,9 @@ The test will return false for hexadecimal strings as this will be the default b
 - **json_decode**
   Decode json string, returning php associative arrays. Uses the PHP [json_decode](http://php.net/manual/en/function.json-decode.php) function
 
+- **date_from_string**
+  Convert a string to a Craft [DateTime](https://craftcms.com/docs/templating/datetime) object. Uses [strtotime](http://php.net/strtotime) internally, can parse a wide variety of datetime descriptions.
+
 ## MN Twig Perversion Changelog
 
 ### 1.0.0 -- 2016.04.17
@@ -100,4 +104,8 @@ The test will return false for hexadecimal strings as this will be the default b
 
 * Added json_decode
 
+### 1.2.0 -- 2016.08.07
+
+* Added date_from_string
+
 Brought to you by [Marion Newlevant](http://marion.newlevant.com)

mntwigperversion/twigextensions/MnTwigPerversionTwigExtension.php

@@ -46,13 +46,26 @@ public function getTests()
 		);
 	}
 
-	public function getFilters() {
+	public function getFilters()
+	{
 		return array(
-		'json_decode' => new \Twig_Filter_Method($this, 'jsonDecode'),
+			'json_decode' => new \Twig_Filter_Method($this, 'jsonDecode'),
+			'date_from_string' => new \Twig_Filter_Method($this, 'dateFromString'),
 		);
 	}
 
-	public function jsonDecode($str) {
+	public function jsonDecode($str)
+	{
 		return json_decode($str, true); // return assoc arrays (more twig-like)
 	}
+
+	public function dateFromString($str)
+	{
+		$timezone = new \DateTimeZone(craft()->timezone);
+		$date = new \Craft\DateTime();
+		$date->setTimezone($timezone);
+		$date->setTimestamp(strtotime($str));
+		return $date;
+	}
+
 }

releases.json

@@ -40,5 +40,13 @@
     "notes": [
       "[Added] new filter json_decode"
     ]
+  },
+  {
+    "version": "1.2.0",
+    "downloadUrl": "https://github.com/marionnewlevant/craft-twig_perversion/archive/v1.2.0.zip",
+    "date": "2016-08-07T20:37:12.921Z",
+    "notes": [
+      "[Added] new filter date_from_string"
+    ]
   }
 ]