dateformat
Advanced tools
Comparing version 1.0.12 to 2.0.0
@@ -10,14 +10,8 @@ { | ||
"Felix Geisendörfer <felix@debuggable.com>", | ||
"Christoph Tavan <dev@tavan.de>" | ||
"Christoph Tavan <dev@tavan.de>", | ||
"Jon Schlinkert (https://github.com/jonschlinkert)" | ||
], | ||
"version": "1.0.12", | ||
"version": "2.0.0", | ||
"license": "MIT", | ||
"main": "lib/dateformat", | ||
"bin": { | ||
"dateformat": "bin/cli.js" | ||
}, | ||
"dependencies": { | ||
"get-stdin": "^4.0.1", | ||
"meow": "^3.3.0" | ||
}, | ||
"devDependencies": { | ||
@@ -24,0 +18,0 @@ "underscore": "1.7.0", |
135
Readme.md
@@ -24,55 +24,108 @@ # dateformat | ||
```js | ||
var dateFormat = require('dateformat'); | ||
var now = new Date(); | ||
var dateFormat = require('dateformat'); | ||
var now = new Date(); | ||
// Basic usage | ||
dateFormat(now, "dddd, mmmm dS, yyyy, h:MM:ss TT"); | ||
// Saturday, June 9th, 2007, 5:46:21 PM | ||
// Basic usage | ||
dateFormat(now, "dddd, mmmm dS, yyyy, h:MM:ss TT"); | ||
// Saturday, June 9th, 2007, 5:46:21 PM | ||
// You can use one of several named masks | ||
dateFormat(now, "isoDateTime"); | ||
// 2007-06-09T17:46:21 | ||
// You can use one of several named masks | ||
dateFormat(now, "isoDateTime"); | ||
// 2007-06-09T17:46:21 | ||
// ...Or add your own | ||
dateFormat.masks.hammerTime = 'HH:MM! "Can\'t touch this!"'; | ||
dateFormat(now, "hammerTime"); | ||
// 17:46! Can't touch this! | ||
// ...Or add your own | ||
dateFormat.masks.hammerTime = 'HH:MM! "Can\'t touch this!"'; | ||
dateFormat(now, "hammerTime"); | ||
// 17:46! Can't touch this! | ||
// When using the standalone dateFormat function, | ||
// you can also provide the date as a string | ||
dateFormat("Jun 9 2007", "fullDate"); | ||
// Saturday, June 9, 2007 | ||
// When using the standalone dateFormat function, | ||
// you can also provide the date as a string | ||
dateFormat("Jun 9 2007", "fullDate"); | ||
// Saturday, June 9, 2007 | ||
// Note that if you don't include the mask argument, | ||
// dateFormat.masks.default is used | ||
dateFormat(now); | ||
// Sat Jun 09 2007 17:46:21 | ||
// Note that if you don't include the mask argument, | ||
// dateFormat.masks.default is used | ||
dateFormat(now); | ||
// Sat Jun 09 2007 17:46:21 | ||
// And if you don't include the date argument, | ||
// the current date and time is used | ||
dateFormat(); | ||
// Sat Jun 09 2007 17:46:22 | ||
// And if you don't include the date argument, | ||
// the current date and time is used | ||
dateFormat(); | ||
// Sat Jun 09 2007 17:46:22 | ||
// You can also skip the date argument (as long as your mask doesn't | ||
// contain any numbers), in which case the current date/time is used | ||
dateFormat("longTime"); | ||
// 5:46:22 PM EST | ||
// You can also skip the date argument (as long as your mask doesn't | ||
// contain any numbers), in which case the current date/time is used | ||
dateFormat("longTime"); | ||
// 5:46:22 PM EST | ||
// And finally, you can convert local time to UTC time. Simply pass in | ||
// true as an additional argument (no argument skipping allowed in this case): | ||
dateFormat(now, "longTime", true); | ||
// 10:46:21 PM UTC | ||
// And finally, you can convert local time to UTC time. Simply pass in | ||
// true as an additional argument (no argument skipping allowed in this case): | ||
dateFormat(now, "longTime", true); | ||
// 10:46:21 PM UTC | ||
// ...Or add the prefix "UTC:" or "GMT:" to your mask. | ||
dateFormat(now, "UTC:h:MM:ss TT Z"); | ||
// 10:46:21 PM UTC | ||
// ...Or add the prefix "UTC:" or "GMT:" to your mask. | ||
dateFormat(now, "UTC:h:MM:ss TT Z"); | ||
// 10:46:21 PM UTC | ||
// You can also get the ISO 8601 week of the year: | ||
dateFormat(now, "W"); | ||
// 42 | ||
// You can also get the ISO 8601 week of the year: | ||
dateFormat(now, "W"); | ||
// 42 | ||
// and also get the ISO 8601 numeric representation of the day of the week: | ||
dateFormat(now,"N"); | ||
// 6 | ||
// and also get the ISO 8601 numeric representation of the day of the week: | ||
dateFormat(now,"N"); | ||
// 6 | ||
``` | ||
### Mask options | ||
Mask | Description | ||
---- | ----------- | ||
`d` | Day of the month as digits; no leading zero for single-digit days. | ||
`dd` | Day of the month as digits; leading zero for single-digit days. | ||
`ddd` | Day of the week as a three-letter abbreviation. | ||
`dddd` | Day of the week as its full name. | ||
`m` | Month as digits; no leading zero for single-digit months. | ||
`mm` | Month as digits; leading zero for single-digit months. | ||
`mmm` | Month as a three-letter abbreviation. | ||
`mmmm` | Month as its full name. | ||
`yy` | Year as last two digits; leading zero for years less than 10. | ||
`yyyy` | Year represented by four digits. | ||
`h` | Hours; no leading zero for single-digit hours (12-hour clock). | ||
`hh` | Hours; leading zero for single-digit hours (12-hour clock). | ||
`H` | Hours; no leading zero for single-digit hours (24-hour clock). | ||
`HH` | Hours; leading zero for single-digit hours (24-hour clock). | ||
`M` | Minutes; no leading zero for single-digit minutes. | ||
`MM` | Minutes; leading zero for single-digit minutes. | ||
`N` | ISO 8601 numeric representation of the day of the week. | ||
`o` | GMT/UTC timezone offset, e.g. -0500 or +0230. | ||
`s` | Seconds; no leading zero for single-digit seconds. | ||
`ss` | Seconds; leading zero for single-digit seconds. | ||
`S` | The date's ordinal suffix (st, nd, rd, or th). Works well with `d`. | ||
`l` | Milliseconds; gives 3 digits. | ||
`L` | Milliseconds; gives 2 digits. | ||
`t` | Lowercase, single-character time marker string: a or p. | ||
`tt` | Lowercase, two-character time marker string: am or pm. | ||
`T` | Uppercase, single-character time marker string: A or P. | ||
`TT` | Uppercase, two-character time marker string: AM or PM. | ||
`W` | ISO 8601 week number of the year, e.g. 42 | ||
`Z` | US timezone abbreviation, e.g. EST or MDT. With non-US timezones or in the | ||
`'...'`, `"..."` | Literal character sequence. Surrounding quotes are removed. | ||
`UTC:` | Must be the first four characters of the mask. Converts the date from local time to UTC/GMT/Zulu time before applying the mask. The "UTC:" prefix is removed. | ||
### Named Formats | ||
Name | Mask | Example | ||
---- | ---- | ------- | ||
`default` | `ddd mmm dd yyyy HH:MM:ss` | Sat Jun 09 2007 17:46:21 | ||
`shortDate` | `m/d/yy` | 6/9/07 | ||
`mediumDate` | `mmm d, yyyy` | Jun 9, 2007 | ||
`longDate` | `mmmm d, yyyy` | June 9, 2007 | ||
`fullDate` | `dddd, mmmm d, yyyy` | Saturday, June 9, 2007 | ||
`shortTime` | `h:MM TT` | 5:46 PM | ||
`mediumTime` | `h:MM:ss TT` | 5:46:21 PM | ||
`longTime` | `h:MM:ss TT Z` | 5:46:21 PM EST | ||
`isoDate` | `yyyy-mm-dd` | 2007-06-09 | ||
`isoTime` | `HH:MM:ss` | 17:46:21 | ||
`isoDateTime` | `yyyy-mm-dd'T'HH:MM:ss` | 2007-06-09T17:46:21 | ||
`isoUtcDateTime` | `UTC:yyyy-mm-dd'T'HH:MM:ss'Z'` | 2007-06-09T22:46:21Z | ||
## License | ||
@@ -79,0 +132,0 @@ |
Sorry, the diff of this file is not supported yet
License Policy Violation
LicenseThis package is not allowed per your license policy. Review the package's license to ensure compliance.
Found 1 instance in 1 package
New author
Supply chain riskA new npm collaborator published a version of the package for the first time. New collaborators are usually benign additions to a project, but do indicate a change to the security surface area of a package.
Found 1 instance in 1 package
License Policy Violation
LicenseThis package is not allowed per your license policy. Review the package's license to ensure compliance.
Found 1 instance in 1 package
0
136
13746
5
197
1
- Removedget-stdin@^4.0.1
- Removedmeow@^3.3.0
- Removedarray-find-index@1.0.2(transitive)
- Removedcamelcase@2.1.1(transitive)
- Removedcamelcase-keys@2.1.0(transitive)
- Removedcurrently-unhandled@0.4.1(transitive)
- Removeddecamelize@1.2.0(transitive)
- Removederror-ex@1.3.2(transitive)
- Removedfind-up@1.1.2(transitive)
- Removedfunction-bind@1.1.2(transitive)
- Removedget-stdin@4.0.1(transitive)
- Removedgraceful-fs@4.2.11(transitive)
- Removedhasown@2.0.2(transitive)
- Removedhosted-git-info@2.8.9(transitive)
- Removedindent-string@2.1.0(transitive)
- Removedis-arrayish@0.2.1(transitive)
- Removedis-core-module@2.15.1(transitive)
- Removedis-finite@1.1.0(transitive)
- Removedis-utf8@0.2.1(transitive)
- Removedload-json-file@1.1.0(transitive)
- Removedloud-rejection@1.6.0(transitive)
- Removedmap-obj@1.0.1(transitive)
- Removedmeow@3.7.0(transitive)
- Removedminimist@1.2.8(transitive)
- Removednormalize-package-data@2.5.0(transitive)
- Removedobject-assign@4.1.1(transitive)
- Removedparse-json@2.2.0(transitive)
- Removedpath-exists@2.1.0(transitive)
- Removedpath-parse@1.0.7(transitive)
- Removedpath-type@1.1.0(transitive)
- Removedpify@2.3.0(transitive)
- Removedpinkie@2.0.4(transitive)
- Removedpinkie-promise@2.0.1(transitive)
- Removedread-pkg@1.1.0(transitive)
- Removedread-pkg-up@1.0.1(transitive)
- Removedredent@1.0.0(transitive)
- Removedrepeating@2.0.1(transitive)
- Removedresolve@1.22.8(transitive)
- Removedsemver@5.7.2(transitive)
- Removedsignal-exit@3.0.7(transitive)
- Removedspdx-correct@3.2.0(transitive)
- Removedspdx-exceptions@2.5.0(transitive)
- Removedspdx-expression-parse@3.0.1(transitive)
- Removedspdx-license-ids@3.0.20(transitive)
- Removedstrip-bom@2.0.0(transitive)
- Removedstrip-indent@1.0.1(transitive)
- Removedsupports-preserve-symlinks-flag@1.0.0(transitive)
- Removedtrim-newlines@1.0.0(transitive)
- Removedvalidate-npm-package-license@3.0.4(transitive)