Introduce FluentLib sources.

src/core/fluent-date.js

@@ -0,0 +1,80 @@
+/**
+The FluentCV date representation.
+@license Copyright (c) 2015 by James M. Devlin. All rights reserved.
+*/
+
+var moment = require('moment');
+
+/**
+Create a FluentDate from a string or Moment date object. There are a few date
+formats to be aware of here.
+1. The words "Present" and "Now", referring to the current date
+2. The default "YYYY-MM-DD" format used in JSON Resume ("2015-02-10")
+3. Year-and-month only ("2015-04")
+4. Year-only "YYYY" ("2015")
+5. The friendly FluentCV "mmm YYYY" format ("Mar 2015" or "Dec 2008")
+6. Empty dates ("", " ")
+7. Any other date format that Moment.js can parse from
+Note: Moment can transparently parse all or most of these, without requiring us
+to specify a date format...but for maximum parsing safety and to avoid Moment
+deprecation warnings, it's recommended to either a) explicitly specify the date
+format or b) use an ISO format. For clarity, we handle these cases explicitly.
+@class FluentDate
+*/
+function FluentDate( dt ) {
+  this.rep = this.fmt( dt );
+}
+
+FluentDate/*.prototype*/.fmt = function( dt ) {
+  if( (typeof dt === 'string' || dt instanceof String) ) {
+    dt = dt.toLowerCase().trim();
+    if( /^(present|now)$/.test(dt) ) { // "Present", "Now"
+      return moment();
+    }
+    else if( /^\D+\s+\d{4}$/.test(dt) ) { // "Mar 2015"
+      var parts = dt.split(' ');
+      var month = (months[parts[0]] || abbr[parts[0]]);
+      var dt = parts[1] + '-' + (month < 10 ? '0' + month : month.toString());
+      return moment( dt, 'YYYY-MM' );
+    }
+    else if( /^\d{4}-\d{1,2}$/.test(dt) ) { // "2015-03", "1998-4"
+      return moment( dt, 'YYYY-MM' );
+    }
+    else if( /^\s\d{4}$/.test(dt) ) { // "2015"
+      return moment( dt, 'YYYY' );
+    }
+    else if( /^\s*$/.test(dt) ) { // "", " "
+      var defTime = {
+        isNull: true,
+        isBefore: function( other ) {
+          return( other && !other.isNull ) ? true : false;
+        },
+        isAfter: function( other ) {
+          return( other && !other.isNull ) ? false : false;
+        },
+        unix: function() { return 0; },
+        format: function() { return ''; },
+        diff: function() { return 0; }
+      };
+      return defTime;
+    }
+    else {
+      var mt = moment( dt );
+      if(mt.isValid())
+        return mt;
+      throw 'Invalid date format encountered.';
+    }
+  }
+  else {
+    if( dt.isValid && dt.isValid() )
+      return dt;
+    throw 'Unknown date object encountered.';
+  }
+};
+
+var months = {}, abbr = {};
+moment.months().forEach(function(m,idx){months[m.toLowerCase()]=idx+1;});
+moment.monthsShort().forEach(function(m,idx){abbr[m.toLowerCase()]=idx+1;});
+abbr.sept = 9;
+
+module.exports = FluentDate;