ember-moment

Ember-moment

moment.js template helpers for ember

Requirements

• HTMLBars (see <= 2.0.0 for Handlebar support)
• Ember >= 1.10
  • If you need support for < Ember 1.10 please use ember-moment 1.x-2.x

Usage

• ember-cli < 0.2.3 ember install:addon ember-moment
• ember-cli >= 0.2.3 ember install ember-moment

{{moment-format date}}
{{moment-from-now date}}
{{moment-to-now date}}
{{moment-duration ms}}

Advance

{{moment-format date outputFormat inputFormat}}
{{moment-from-now date}}
{{moment-to-now date}}
{{moment-duration number units}}

Recomputes the time ago every 1-second. This is useful for "live" updating as time elapses.

NOTE: This feature is only supported in Ember >= 1.13.0

{{moment-from-now date interval=1000}}

Upgrading

If your npm dep for ember-moment is not fixed on a version (ie, using ~ or ^) then you may be required to ember g ember-moment between versions as the default blueprint may have changed.

Please try this, along with clearing node_modules and bower_components before reporting issues after upgrades.

ES6 Moment

This addon provides the ability to import moment as an ES6 module.

import moment from 'moment';

Computed Macro

import momentDuration from 'ember-moment/computeds/duration';
import momentFormat from 'ember-moment/computeds/format';
import momentFromNow from 'ember-moment/computeds/from-now';
import momentToNow from 'ember-moment/computeds/to-now';

export default Ember.Controller.extend({
  date: new Date('2013-02-08T09:30:26'),

  // Takes on the behavior of moment().format()
  // http://momentjs.com/docs/#/displaying/format/
  shortDate: momentFormat('date', 'MM/DD/YYYY'),

  // first param: date input
  // second param: date format http://momentjs.com/docs/#/parsing/string-format/ (optional)
  // third param: hide suffix (optional, false by default)
  // http://momentjs.com/docs/#/displaying/fromnow/
  timeSince: momentFromNow("12-25-1995", "MM-DD-YYYY", false), // -> output: "2 years ago"

  // first param: date input
  // second param: date format http://momentjs.com/docs/#/parsing/string-format/ (optional)
  // third param: hide prefix (optional, false by default)
  // http://momentjs.com/docs/#/displaying/tonow
  computedNumHours: momentToNow("12-25-1995", "MM-DD-YYYY", false), // -> output: "in 20 years"

  // duration units: seconds, minutes, hours, days, weeks, months, years
  // http://momentjs.com/docs/#/durations/
  computedNumHours: momentDuration(10, 'hours')
});

Include Moment Timezone

You can optionally include the Moment Timezone package in your config/environment.js like so:

// config.environment.js
module.exports = function(/* environment */) {
  return {
    moment: {
      // Options:
      // 'all' - all years, all timezones
      // '2010-2020' - 2010-2020, all timezones
      // 'none' - no data, just timezone API
      includeTimezone: 'all'
    }
  }
};

i18n support

Cherry pick locales (optimal)

// config.environment.js
module.exports = function(environment) {
  return {
    moment: {
      // To cherry-pick specific locale support into your application.
      // Full list of locales: https://github.com/moment/moment/tree/2.10.3/locale
      includeLocales: ['es', 'fr-ca']
    }
  };

Include all locales

// config.environment.js
module.exports = function(environment) {
  return {
    moment: {
      includeLocales: true
    }
  };

Configure default runtime locale

// app/routes/applicaton.js
import moment from 'moment';

export default Ember.Route.extend({
  beforeModel() {
    // sets the application locale to Spanish
    moment.locale('es');
  }
});

Feature set of i18n support within moment can be found here: http://momentjs.com/docs/#/i18n/

Development

• git clone this repository
• npm install
• bower install
• ember server
• Visit your app at http://localhost:4200.

Running Tests

• ember test
• ember test --server

Building

• ember build

For more information on using ember-cli, visit http://www.ember-cli.com/.

Changelog

3.3.0

• Adds toNow computed property macro
• Adds moment-to-now htmlbar helper
• Fixes documentation error around computed property macro argument order
• Adds the ability to hide the prefix/suffix from toNow/fromNow helpers and computed property macro output