This repository has been archived by the owner. It is now read-only.
strftime support for Moment.js
JavaScript
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
docs
.eslintrc.json
.gitignore
.jsdoc.json
.travis.yml
CHANGELOG.md
LICENSE.md
README.md
bower.json
main.js
package.json
tests.js

README.md

moment-strftime2

Package Version Dependency Status Build Status Coverage Status

strftime support for Moment.js

https://github.com/ShogunPanda/moment-strftime2

END OF DEVELOPMENT NOTICE

This module has been discontinued.

Introduction

Moment.js is a great, lightweight date-manipulation library, with a very approachable date format syntax that makes it a breeze to work with dates and times in the Javascript world.

Unfortunately, the library doesn't support (and won't do it) one of the most common approaches to format strings: the Unix-Style strftime syntax.

This plugin (any many others) aims to fill the gap.

Installation (NPM)

Simply do:

npm install moment-strftime2

Installation (Bower)

Simply do:

bower install moment-strftime2

Usage

const moment = require("moment")
require("moment-strftime2").installTo(moment)

moment().strftime("%m/%d/%y %I:%M %p %Z") // => "16/09/11 09:22 AM CET"

Supported modifiers

This plugin supports all modifiers listed here with the exception of the following:

  • %c
  • %C
  • %E
  • %G
  • %n
  • %O
  • %t
  • %U
  • %x
  • %X
  • %+

And with the addition of the following modifiers:

  • %L: The milliseconds as decimal-number (range 000 to 999).

Customization

You can completely customize moment-strftime2 behavior by requiring the module and overriding the separator and modifiers variables:

Example:

const moment = require("moment")
const strftime2 = require("moment-strftime2")
strftime2.installTo(moment)

moment("2016-10-10 12:34:56.135 +02:00").strftime("%d %o #d #o") // "10 %o #d #o"
strftime2.separator = "$"
strftime2.modifier.o = "DD"
moment("2016-10-10 12:34:56.135 +02:00").strftime("%d %o #d #o") // "%d %o 10 10"

Supported implementations.

moment-strftime2 supports and has been tested on NodeJS 6.0+.

API Documentation

The API documentation can be found here.

Contributing to moment-strftime2

  • Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
  • Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
  • Fork the project.
  • Start a feature/bugfix branch.
  • Commit and push until you are happy with your contribution.
  • Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.

Copyright

Copyright (C) 2016 and above Shogun mailto:shogun@cowtech.it.

Licensed under the MIT license, which can be found at https://choosealicense.com/licenses/mit.