Lightweight and simple JS date formatting and parsing

Taylor Hakes

Last update: Jan 5, 2023

Related tags

Overview

fecha

Lightweight date formatting and parsing (~2KB). Meant to replace parsing and formatting functionality of moment.js.

NPM

npm install fecha --save

Yarn

yarn add fecha

Fecha vs Moment

	Fecha	Moment
Size (Min. and Gzipped)	2.1KBs	13.1KBs
Date Parsing	✓	✓
Date Formatting	✓	✓
Date Manipulation		✓
I18n Support	✓	✓

Use it

Formatting

format accepts a Date object (or timestamp) and a string format and returns a formatted string. See below for available format tokens.

Note: format will throw an error when passed invalid parameters

import { format } from 'fecha';

type format = (date: Date, format?: string, i18n?: I18nSettings) => str;

// Custom formats
format(new Date(2015, 10, 20), 'dddd MMMM Do, YYYY'); // 'Friday November 20th, 2015'
format(new Date(1998, 5, 3, 15, 23, 10, 350), 'YYYY-MM-DD hh:mm:ss.SSS A'); // '1998-06-03 03:23:10.350 PM'

// Named masks
format(new Date(2015, 10, 20), 'isoDate'); // '2015-11-20'
format(new Date(2015, 10, 20), 'mediumDate'); // 'Nov 20, 2015'
format(new Date(2015, 10, 20, 3, 2, 1), 'isoDateTime'); // '2015-11-20T03:02:01-05:00'
format(new Date(2015, 2, 10, 5, 30, 20), 'shortTime'); // '05:30'

// Literals
format(new Date(2001, 2, 5, 6, 7, 2, 5), '[on] MM-DD-YYYY [at] HH:mm'); // 'on 03-05-2001 at 06:07'

Parsing

parse accepts a Date string and a string format and returns a Date object. See below for available format tokens.

NOTE: parse will throw an error when passed invalid string format or missing format. You MUST specify a format.

import { parse } from 'fecha';

type parse = (dateStr: string, format: string, i18n?: I18nSettingsOptional) => Date|null;

// Custom formats
parse('February 3rd, 2014', 'MMMM Do, YYYY'); // new Date(2014, 1, 3)
parse('10-12-10 14:11:12', 'YY-MM-DD HH:mm:ss'); // new Date(2010, 11, 10, 14, 11, 12)

// Named masks
parse('5/3/98', 'shortDate'); // new Date(1998, 4, 3)
parse('November 4, 2005', 'longDate'); // new Date(2005, 10, 4)
parse('2015-11-20T03:02:01-05:00', 'isoDateTime'); // new Date(2015, 10, 20, 3, 2, 1)

// Override i18n
parse('4 de octubre de 1983', 'M de MMMM de YYYY', {
  monthNames: [
    'enero',
    'febrero',
    'marzo',
    'abril',
    'mayo',
    'junio',
    'julio',
    'agosto',
    'septiembre',
    'octubre',
    'noviembre',
    'diciembre'
  ]
}); // new Date(1983, 9, 4)

i18n Support

import {setGlobalDateI18n} from 'fecha';

/*
Default I18n Settings
{
  dayNamesShort: ['Sun', 'Mon', 'Tue', 'Wed', 'Thur', 'Fri', 'Sat'],
  dayNames: ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'],
  monthNamesShort: ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'],
  monthNames: ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'],
  amPm: ['am', 'pm'],
  // D is the day of the month, function returns something like...  3rd or 11th
  DoFn(dayOfMonth) {
    return dayOfMonth + [ 'th', 'st', 'nd', 'rd' ][ dayOfMonth % 10 > 3 ? 0 : (dayOfMonth - dayOfMonth % 10 !== 10) * dayOfMonth % 10 ];
  }
}
*/

setGlobalDateI18n({
  dayNamesShort: ['Sun', 'Mon', 'Tue', 'Wed', 'Thur', 'Fri', 'Sat'],
  dayNames: ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'],
  monthNamesShort: ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'],
  monthNames: ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'],
  amPm: ['am', 'pm'],
  // D is the day of the month, function returns something like...  3rd or 11th
  DoFn: function (D) {
    return D + [ 'th', 'st', 'nd', 'rd' ][ D % 10 > 3 ? 0 : (D - D % 10 !== 10) * D % 10 ];
  }
});

Custom Named Masks

import { format, setGlobalDateMasks } from 'fecha';
/*
Default global masks
{
  default: 'ddd MMM DD YYYY HH:mm:ss',
  shortDate: 'M/D/YY',
  mediumDate: 'MMM D, YYYY',
  longDate: 'MMMM D, YYYY',
  fullDate: 'dddd, MMMM D, YYYY',
  shortTime: 'HH:mm',
  mediumTime: 'HH:mm:ss',
  longTime: 'HH:mm:ss.SSS'
}
*/

// Create a new mask
setGlobalDateMasks({
  myMask: 'HH:mm:ss YY/MM/DD';
});

// Use it
format(new Date(2014, 5, 6, 14, 10, 45), 'myMask'); // '14:10:45 14/06/06'

Formatting Tokens

	Token	Output
Month	M	1 2 ... 11 12
	MM	01 02 ... 11 12
	MMM	Jan Feb ... Nov Dec
	MMMM	January February ... November December
Day of Month	D	1 2 ... 30 31
	Do	1st 2nd ... 30th 31st
	DD	01 02 ... 30 31
Day of Week	d	0 1 ... 5 6
	ddd	Sun Mon ... Fri Sat
	dddd	Sunday Monday ... Friday Saturday
Year	YY	70 71 ... 29 30
	YYYY	1970 1971 ... 2029 2030
AM/PM	A	AM PM
	a	am pm
Hour	H	0 1 ... 22 23
	HH	00 01 ... 22 23
	h	1 2 ... 11 12
	hh	01 02 ... 11 12
Minute	m	0 1 ... 58 59
	mm	00 01 ... 58 59
Second	s	0 1 ... 58 59
	ss	00 01 ... 58 59
Fractional Second	S	0 1 ... 8 9
	SS	0 1 ... 98 99
	SSS	0 1 ... 998 999
Timezone	Z	-07:00 -06:00 ... +06:00 +07:00
	ZZ	-0700 -0600 ... +0600 +0700

Comments

Allow extending formatting tokens

It would be great if formatting tokens can be extensible. For my use case, I want a token for showing year, only if it's not equal to the current year. Other tokens can be relative time (e.g. 3 minutes ago). I don't know if the implementation allows such extensibility but it would be nice to support such feature.

opened by alirezamirian 5

fecha.parse method is allowing an invalid and a malformed dates

I'd expected to get a false return or an exception when I called the fecha.parse method with an invalid and a malformed dates. But it parsed them successfully. Is this the desired result?

Invalid: Date parts are not in the valid ranges (12 >= Month >= 1, 31>= Day>= 1, 23>=Hour>= 0 ...)

fecha.parse('2016-44-99', 'YYYY-MM-DD'); // Sat Nov 12 2016 21:39:00 GMT+0300
fecha.parse('2016-11-11 44:44', 'YYYY-MM-DD HH:mm'); // Sat Nov 12 2016 20:44:00 GMT+0300

Malformed: Supplied date string does not match the format

fecha.parse('2016-1-1', 'YYYY-MM-DD'); // Fri Jan 01 2016 01:00:00 GMT+0400
fecha.parse('2016-11-11 3:4', 'YYYY-MM-DD HH:mm'); // Fri Nov 11 2016 03:04:00 GMT+0300

Invalid & Malformed:

fecha.parse('2016-9876-123', 'YYYY-MM-DD'); // Tue Apr 16 2024 00:00:00 GMT+0300
fecha.parse('2016-11-11 4433:3344', 'YYYY-MM-DD HH:mm'); // Sat Nov 12 2016 20:33:00 GMT+0300

Tested on: Google Chrome Version 54.0.2840.71 m (Windows 10)

Thanks,

opened by ktunador 5

type define is not valid

current is:

export function format(dateObj: Date | number, mask: string, i18nSettings?: i18nSettings): string;
export function parse(dateStr: string, format: string, i18nSettings?: i18nSettings): Date | null;

should be:

type Fecha = {
  format: (dateObj: Date | number, mask: string, i18nSettings?: i18nSettings): string;
  parse: (dateStr: string, format: string, i18nSettings?: i18nSettings): Date | null;
}

export default Fecha;

opened by hustcc 4

Convert fecha to use ES modules
First off, this is a 100% backwards compatible change.

Because I changed the padding on fecha.js and fecha.strict.js, it's best to look at the changed files with ignoring whitespace turned on.

Why

Browsers have added support for ES modules. By including the source based on ES modules, users will be able to import fecha using modules.

<script type="module"> import fecha from 'https://unpkg.com/fecha'; console.log(fecha) </script>

Bundlers have added support for ES modules. By consuming the ES modules version, there is no need to include the UMD snippet, making it a little smaller.

How

Changes to fecha.js and fecha.strict.js: Remove the wrapping function and the UMD snippet at the end. Rollup is used to create a UMD build from this and save it as fecha.min.js and fecha.strict.min.js.

I've verified that this works by pointing the test suite at the UMD build produced by Rollup and it all works. If you would want to run the tests against the original source code, we could include reify to make that possible.

Changes to development flow

When developing, run rollup -c --watch to generate fecha.min.js and keep it up to date as you make changes to the source. This file will not be minified unless called with NODE_ENV=production rollup -c (as the yarn build command does)
opened by balloob 4
Reduce size of NPM package
The NPM package contains a lot of files that are not needed to use fecha. This change reduces the package to just the source and minified files. The README and LICENSE files are always included, by the way.

The files that are currently in the package are:

bower.json

CHANGELOG.md

CONTRIBUTING.md

.editorconfig

.eslintrc.js

fecha.js

fecha.min.js

.idea

LICENSE

.npmignore

package.json

README.md

test.js

.travis.yml

My preference is to not include tests, but if you want to keep them in the NPM package I'll update the PR.
opened by jorrit 4
fecha.format force specific timezone

Hi,

It's possible to add tjhe possibility to force the format function with specific timezone ?

Actually, If I pass an UTC date in my brwoser, the formatted date is converted into the local timezone (Europe/Paris).

But, I want show the date in UTC format (or get a part of this date in the UTC timezone like juste the hour part).

Thanks

opened by throrin19 4
Adds fecha.info() and fecha.valid() methods and tests
Finding myself needing to inspect the properties of a parsed date string quite often.

fecha.info('1985-12-08', 'YYYY-MM-DD') // {year: 1985, month: 11, day: 8}

Also useful to know if a date is valid or not.

fecha.valid('2015-2-29', 'YYYY-MM-DD') // false
opened by bwendt-mylo 4
Add bower.json specification

To be able to register fecha as a Bower package there must be a valid spec so add it.

Also, would you be willing to register this package on bower.io?

opened by ur5us 4
refactor date parsing to validate months outside 1-12 range

Fixes https://github.com/taylorhakes/fecha/issues/70

Code pulled from https://github.com/bwendt-mylo/fecha/commit/f59b34a974cd9ecea9516fd4b65bffd0357795d5

all tests passing

opened by ForestJohnson 3
Feature request: Support microseconds in timestamp format

Winston@3, AWS Linux instance, Javascript

What's the feature? Add microseconds precision to the timestamp format. something like: timestamp({ format: 'YYYY-MM-DD HH:mm:ss.' })

What problem is the feature intended to solve? My use case is logging (I'm using Winston which in turn is using fecha under the hood for timestamp formatting). Log aggregation of logs created by many instances of different microservices requires a precision level higher than milliseconds in order to better sort the logs based on their timestamp.

Is the absence of this feature blocking you or your team? If so, how? Not a blocker, but a very desirable feature.

Is this feature similar to an existing feature in another tool? No that I know of.

Is this a feature you're prepared to implement, with support from us? I'd be willing to look into it.

opened by omeraha 3
Add literal support for formatting masks
It would be nice to be able to use literals in formatting masks, for example

fecha.format(new Date(2001, 2, 5, 6, 7, 2, 5), '[on] MM-DD-YYYY [at] HH:mm'); // 'on 03-05-2001 at 06:07'

moment.js includes support for literals as well http://stackoverflow.com/questions/28241002/moment-js-include-text-in-middle-of-date-format

This PR adds support for literals in formatting masks, updates README to include an example of literal usage and increases the minor version number.
opened by amoilanen 3
Bump json5 from 2.1.1 to 2.2.3
Bumps json5 from 2.1.1 to 2.2.3.

Release notes

Sourced from json5's releases.

v2.2.3

Fix: [email protected] is now the 'latest' release according to npm instead of v1.0.2. (#299)

v2.2.2

Fix: Properties with the name __proto__ are added to objects and arrays. (#199) This also fixes a prototype pollution vulnerability reported by Jonathan Gregson! (#295).

v2.2.1

Fix: Removed dependence on minimist to patch CVE-2021-44906. (#266)

v2.2.0

New: Accurate and documented TypeScript declarations are now included. There is no need to install @types/json5. (#236, #244)

v2.1.3 [code, diff]

Fix: An out of memory bug when parsing numbers has been fixed. (#228, #229)

v2.1.2

Fix: Bump minimist to v1.2.5. (#222)

Changelog

Sourced from json5's changelog.

v2.2.3 [code, diff]

Fix: [email protected] is now the 'latest' release according to npm instead of v1.0.2. (#299)

v2.2.2 [code, diff]

Fix: Properties with the name __proto__ are added to objects and arrays. (#199) This also fixes a prototype pollution vulnerability reported by Jonathan Gregson! (#295).

v2.2.1 [code, diff]

Fix: Removed dependence on minimist to patch CVE-2021-44906. (#266)

v2.2.0 [code, diff]

New: Accurate and documented TypeScript declarations are now included. There is no need to install @types/json5. (#236, #244)

v2.1.3 [code, diff]

Fix: An out of memory bug when parsing numbers has been fixed. (#228, #229)

v2.1.2 [code, diff]

Fix: Bump minimist to v1.2.5. (#222)

Commits

c3a7524 2.2.3

94fd06d docs: update CHANGELOG for v2.2.3

3b8cebf docs(security): use GitHub security advisories

f0fd9e1 docs: publish a security policy

6a91a05 docs(template): bug -> bug report

14f8cb1 2.2.2

10cc7ca docs: update CHANGELOG for v2.2.2

7774c10 fix: add proto to objects and arrays

edde30a Readme: slight tweak to intro

97286f8 Improve example in readme

Additional commits viewable in compare view

Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.

Dependabot commands and options

You can trigger Dependabot actions by commenting on this PR:

@dependabot rebase will rebase this PR

@dependabot recreate will recreate this PR, overwriting any edits that have been made to it

@dependabot merge will merge this PR after your CI passes on it

@dependabot squash and merge will squash and merge this PR after your CI passes on it

@dependabot cancel merge will cancel a previously requested merge and block automerging

@dependabot reopen will reopen this PR if it is closed

@dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually

@dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)

@dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)

@dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)

@dependabot use these labels will set the current labels as the default for future PRs for this repo and language

@dependabot use these reviewers will set the current reviewers as the default for future PRs for this repo and language

@dependabot use these assignees will set the current assignees as the default for future PRs for this repo and language

@dependabot use this milestone will set the current milestone as the default for future PRs for this repo and language

You can disable automated security fix PRs for this repo from the Security Alerts page.

dependencies
opened by dependabot[bot] 0
Bump decode-uri-component from 0.2.0 to 0.2.2
Bumps decode-uri-component from 0.2.0 to 0.2.2.

Release notes

Sourced from decode-uri-component's releases.

v0.2.2

Prevent overwriting previously decoded tokens 980e0bf

https://github.com/SamVerschueren/decode-uri-component/compare/v0.2.1...v0.2.2

v0.2.1

Switch to GitHub workflows 76abc93

Fix issue where decode throws - fixes #6 746ca5d

Update license (#1) 486d7e2

Tidelift tasks a650457

Meta tweaks 66e1c28

https://github.com/SamVerschueren/decode-uri-component/compare/v0.2.0...v0.2.1

Commits

a0eea46 0.2.2

980e0bf Prevent overwriting previously decoded tokens

3c8a373 0.2.1

76abc93 Switch to GitHub workflows

746ca5d Fix issue where decode throws - fixes #6

486d7e2 Update license (#1)

a650457 Tidelift tasks

66e1c28 Meta tweaks

See full diff in compare view

Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.

Dependabot commands and options

You can trigger Dependabot actions by commenting on this PR:

@dependabot rebase will rebase this PR

@dependabot recreate will recreate this PR, overwriting any edits that have been made to it

@dependabot merge will merge this PR after your CI passes on it

@dependabot squash and merge will squash and merge this PR after your CI passes on it

@dependabot cancel merge will cancel a previously requested merge and block automerging

@dependabot reopen will reopen this PR if it is closed

@dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually

@dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)

@dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)

@dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)

@dependabot use these labels will set the current labels as the default for future PRs for this repo and language

@dependabot use these reviewers will set the current reviewers as the default for future PRs for this repo and language

@dependabot use these assignees will set the current assignees as the default for future PRs for this repo and language

@dependabot use this milestone will set the current milestone as the default for future PRs for this repo and language

You can disable automated security fix PRs for this repo from the Security Alerts page.

dependencies
opened by dependabot[bot] 0
Bump minimatch from 3.0.4 to 3.1.2
Bumps minimatch from 3.0.4 to 3.1.2.

Commits

699c459 3.1.2

2f2b5ff fix: trim pattern

25d7c0d 3.1.1

55dda29 fix: treat nocase:true as always having magic

5e1fb8d 3.1.0

f8145c5 Add 'allowWindowsEscape' option

570e8b1 add publishConfig for v3 publishes

5b7cd33 3.0.6

20b4b56 [fix] revert all breaking syntax changes

2ff0388 document, expose, and test 'partial:true' option

Additional commits viewable in compare view

Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.

Dependabot commands and options

You can trigger Dependabot actions by commenting on this PR:

@dependabot rebase will rebase this PR

@dependabot recreate will recreate this PR, overwriting any edits that have been made to it

@dependabot merge will merge this PR after your CI passes on it

@dependabot squash and merge will squash and merge this PR after your CI passes on it

@dependabot cancel merge will cancel a previously requested merge and block automerging

@dependabot reopen will reopen this PR if it is closed

@dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually

@dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)

@dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)

@dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)

@dependabot use these labels will set the current labels as the default for future PRs for this repo and language

@dependabot use these reviewers will set the current reviewers as the default for future PRs for this repo and language

@dependabot use these assignees will set the current assignees as the default for future PRs for this repo and language

@dependabot use this milestone will set the current milestone as the default for future PRs for this repo and language

You can disable automated security fix PRs for this repo from the Security Alerts page.

dependencies
opened by dependabot[bot] 0
Bump browserslist from 4.16.3 to 4.20.2
Bumps browserslist from 4.16.3 to 4.20.2.

Changelog

Sourced from browserslist's changelog.

4.20.2

Fixed package.funding URL format.

4.20.1

Fixed package.funding.

Fixed docs (by Michael Lohmann).

4.20

Added last 2 node versions and last 2 node major versions (by @g-plane).

4.19.3

Updated Firefox ESR (by Christophe Coevoet).

4.19.2

Fixed --help output.

4.19.1

Fixed throwOnMissing types (by Øyvind Saltvik).

4.19

Added queries grammar definition (by Pig Fang).

Added throwOnMissing option (by Øyvind Saltvik).

Fixed null data ignoring in < 50% in CN (byPig Fang).

Fixed data parsing in in my stats (by Sun Xiaoran).

Fixed yarn.lock support with integrity (by Alexey Berezin).

Fixed Yarn Berry error message in --update-db.

4.18.1

Fixed case inventiveness for cover queries (by Pig Fang).

Fixed since 1970 query for null in release date (by Pig Fang).

4.18

Added --ignore-unknown-versions CLI option (by Pig Fang).

4.17.6

Fixed sharable config resolution (by Adaline Valentina Simonian).

4.17.5

Fixed --update-db for some pnpm cases.

4.17.4

Reduced package size.

4.17.3

Use picocolors for color output in --update-db.

4.17.2

Reduced package size.

4.17.1

... (truncated)

Commits

69e60bf Release 4.20.2 version

733722b Fix funding URL format

14508ce Release 4.20.1 version

43914a8 Update CI config

48d1142 Update dependencies

90ead7a Update package.funding

1f6f218 README: clarify relative complement (#674)

be2f1a5 Release 4.20 version

c293a99 Update dependencies

51a1ad2 Add last N node versions (with major) support (#671)

Additional commits viewable in compare view

Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.

Dependabot commands and options

You can trigger Dependabot actions by commenting on this PR:

@dependabot rebase will rebase this PR

@dependabot recreate will recreate this PR, overwriting any edits that have been made to it

@dependabot merge will merge this PR after your CI passes on it

@dependabot squash and merge will squash and merge this PR after your CI passes on it

@dependabot cancel merge will cancel a previously requested merge and block automerging

@dependabot reopen will reopen this PR if it is closed

@dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually

@dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)

@dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)

@dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)

@dependabot use these labels will set the current labels as the default for future PRs for this repo and language

@dependabot use these reviewers will set the current reviewers as the default for future PRs for this repo and language

@dependabot use these assignees will set the current assignees as the default for future PRs for this repo and language

@dependabot use this milestone will set the current milestone as the default for future PRs for this repo and language

You can disable automated security fix PRs for this repo from the Security Alerts page.

dependencies
opened by dependabot[bot] 0
Replace deprecated String.prototype.substr()

String.prototype.substr() is deprecated so we replace it with String.prototype.slice() which works similarily but isn't deprecated. .substr() probably isn't going away anytime soon but the change is trivial so it doesn't hurt to do it.

opened by CommanderRoot 1

Releases(4.2.1)

4.2.1(Apr 5, 2021)

Source code(tar.gz)
Source code(zip)
4.2.0(Mar 3, 2020)

Source code(tar.gz)
Source code(zip)
4.1.0(Feb 10, 2020)
Added Z format token. See readme for more info. Big thanks to @fer22f for writing the code.

Fixed a strange issue when Peru changed timezones in 1990. See #78

Source code(tar.gz)
Source code(zip)
4.0.0(Jan 17, 2020)

Breaking Changes in this release No changes from alpha and beta. See 4.0.0-alpha for full change log.
Source code(tar.gz)
Source code(zip)
4.0.0-alpha.1(Jan 6, 2020)
Major Features and Breaking changes in this version

Improvements

Valid date parsing - By default fecha will check validity of dates. Previously 2019-55-01 or 2019-01-42 would parse correctly, since Javascript can handle it. Now invalid dates will return null instead

ES Module and Tree Shaking Support - You can now import fecha parse or format independently

import {format, parse} from 'fecha'; format(...); parse(...)

Breaking changes

parseDate may return null when previously returned a Date. See improvements above, but invalid dates will return null now

Change to how to set masks and i18n Previously

import fecha from 'fecha'; fecha.i18n = { ... } fecha.masks.myMask = 'DD , MM, YYYY'

New

import {parse, format, setGlobalDateI18n, setGlobalDateMasks} from 'fecha'; setGlobalDateI18n({ // ... }) setGlobalDateMasks({ myMask: 'DD , MM, YYYY' });
Source code(tar.gz)
Source code(zip)
3.0.3(Apr 16, 2019)

Source code(tar.gz)
Source code(zip)
3.0.2(Dec 2, 2018)

Source code(tar.gz)
Source code(zip)
2.3.3(Feb 21, 2018)

Source code(tar.gz)
Source code(zip)
2.3.1(May 9, 2017)

Source code(tar.gz)
Source code(zip)
2.3.0(Sep 18, 2016)

Added literal support to fecha. https://github.com/taylorhakes/fecha/issues/18

Thanks @antivanov
Source code(tar.gz)
Source code(zip)
2.2.0(Jul 21, 2016)

Fixed a bug when parsing dates with 10th, 12th, 1st, etc.
Source code(tar.gz)
Source code(zip)
2.0.0(Feb 13, 2016)
Fecha will now throw errors if you try to format a Date object that is not valid. This helps in debugging and not allowing invalid dates being shown to users.

Removed gulp and now use NPM script to build minified file

Added nyc to see test coverage when testing

Source code(tar.gz)
Source code(zip)
1.2.2(Jan 7, 2016)

Source code(tar.gz)
Source code(zip)
1.2.1(Jan 7, 2016)

Moved to new testing framework painless. Tests run much faster.
Source code(tar.gz)
Source code(zip)
1.2.0(Dec 27, 2015)

Possible denial of service was possible if unvalidated input is passed to fecha.parse. Input strings longer than 1000 characters now return false
Source code(tar.gz)
Source code(zip)
1.1.0(Nov 19, 2015)

Source code(tar.gz)
Source code(zip)
v1.0.0(Sep 6, 2015)
Breaking Changes:

Removed ability to use Fecha.parse without format parameter

Removed ability to use Fecha.format with string or null for date object

Source code(tar.gz)
Source code(zip)
v0.2.2(Aug 8, 2015)

Source code(tar.gz)
Source code(zip)
v0.2.1(Apr 19, 2015)

Source code(tar.gz)
Source code(zip)