feat($time): create time service

Add simple $time service to allow easier mocking dates in applications.

Closes angular#10402
Closes angular#10525

Author: marcin-wosinek

angularFiles.js

@@ -38,6 +38,7 @@ var angularFiles = {
     'src/ng/sniffer.js',
     'src/ng/templateRequest.js',
     'src/ng/testability.js',
+    'src/ng/date.js',
     'src/ng/timeout.js',
     'src/ng/urlUtils.js',
     'src/ng/window.js',

src/AngularPublic.js

@@ -86,6 +86,7 @@
   $TemplateCacheProvider,
   $TemplateRequestProvider,
   $$TestabilityProvider,
+  $TimeProvider,
   $TimeoutProvider,
   $$RAFProvider,
   $WindowProvider,
@@ -244,6 +245,7 @@ function publishExternalAPI(angular) {
         $templateCache: $TemplateCacheProvider,
         $templateRequest: $TemplateRequestProvider,
         $$testability: $$TestabilityProvider,
+        $date: $DateProvider,
         $timeout: $TimeoutProvider,
         $window: $WindowProvider,
         $$rAF: $$RAFProvider,

src/ng/date.js

@@ -0,0 +1,45 @@
+'use strict';
+
+/**
+ * @ngdoc service
+ * @name $date
+ * @requires $window
+ *
+ * @description
+ * Simple service for accessing date.
+ *
+ * The main purpose of this service is to simplify mocking date in tests.
+ *
+ * @example
+   <example module="dateExample">
+     <file name="script.js">
+       angular.module('dateExample', [])
+         .controller('TimeController', ['$scope', '$date', function($scope, $date) {
+           $scope.now = $date.now();
+         }]);
+     </file>
+     <file name="index.html">
+       <div ng-controller="TimeController">
+         <p>Time when the page was created: {{now | date}}</p>
+       </div>
+     </file>
+   </example>
+ */
+function $DateProvider() {
+  var self = this;
+
+  this.$get = ['$window', function($window) {
+    return {
+      /**
+       * @ngdoc method
+       * @name $date#now
+       *
+       * @description
+       * Return Date object representing current date
+       */
+      now: function () {
+        return $window.Date();
+      }
+    };
+  }];
+}

test/ng/dateSpec.js

@@ -0,0 +1,25 @@
+/* global $TimeProvider: false */
+'use strict';
+
+describe('$date', function() {
+  var $window;
+
+  beforeEach(module(function($provide) {
+    $window = {};
+
+    $provide.value('$window', $window);
+  }));
+
+  it('should return Date.new() when $date.now() is called', inject(
+    function() {
+      $window.Date = function() {
+        return Date(1418998923940);
+      };
+    },
+    function($date) {
+      var date = $date.now();
+      expect(date).toEqual(Date(1418998923940));
+    }
+  ));
+
+});