Wondering what’s next for npm?Check out our public roadmap! »

    @fav/type.to-date

    1.0.2 • Public • Published

    @fav/type.to-date NPM version MIT License Build Status Build Status Coverage status

    Converts a string in various date format to a date object.

    "fav" is an abbreviation of "favorite" and also the acronym of "for all versions". This package is intended to support all Node.js versions and many browsers as possible. At least, this package supports Node.js >= v0.10 and major Web browsers: Chrome, Firefox, IE11, Edge, Vivaldi and Safari.

    Install

    To install from npm:

    $ npm install --save @fav/type.to-date

    NOTE: npm < 2.7.0 does not support scoped package, but old version Node.js supports it. So when you use such older npm, you should download this package from github.com, and move it in node_modules/@fav/type.to-date/ directory manually.

    Usage

    For Node.js:

    var toDate = require('@fav/type.to-date');
     
    toDate(99, 0, 1).toString(); // => 'Thu Jan 01 0099 00:00:00 GMT+0900 (JST)'
     
    toDate['Y-M-D']('2017-09-30'); // => new Date(2017, 8, 30)
    toDate.YYYYMMDDHHmmss('20170930133000'); // => new Date(2017, 8, 30, 13, 30, 0)
    toDate.RFC2822('Sat, 30 Sep 2017 13:30:00 +0900'); // => new Date(2017, 8, 30, 13, 30, 0) at Japan
    toDate.RFC3339('2017-09-30T13:30:00Z'); // => new Date(2017, 8, 30, 13, 30, 0) in GMT
    toDate.ISO8601('2017W406'); // => new Date(2017, 8, 30)

    For Web browsers:

    <script src="fav.type.to-date.min.js"></script>
    <script>
    var toDate = fav.type.toDate;
    toDate(99, 0, 1).toString(); // => 'Thu Jan 01 0099 00:00:00 GMT+0900 (JST)'
    toDate['Y-M-D']('2017-09-30'); // => new Date(2017, 8, 30)
    </script> 

    API

    toDate([ year ][, month ][, day ][, hour ][, min ][, sec ][, msec ]) : Date

    Creates a Date object which represents a moment in time.

    Parameters:

    Parameter Type Description
    year number An integer value represents a full year. This can be specified a year before 1900. (Optional)
    month number An integer value represents a month, beginning with 0 for January to 11 for December. (Optional)
    day number An integer value represents a day. (Optional)
    hour number An integer value represents a hour. (Optional)
    min number An integer value represents a minute. (Optional)
    sec number An integer value represents a second. (Optional.)
    msec number An integer value represents a millisecond. (Optional.)

    Each element of date and time is set to the first value (zero, or one) if any leading elements are specified but the element is not specified, or is set to the current value if every leading elements and the element are not specified.

    Returns:

    A date object which represents the specified date.

    Type: Date

    In addition, this function has a set of functions to convert a date format string to a date object as its properties. This function set provides functions supporting following date formats:

    toDate['Y-M-D'](value) : Date

    Converts a date format string separated by hyphens to a data object.

    Parameter:
    Parameter Type Description
    value string The date format string like: "2017-09-30".
    Return:

    A Date object, or null if failing to convert.

    Type: Date

    toDate['Y-M-D HⓂ️s'](value) : Date

    Converts a date-time format string separated by hyphens and colons to a data object.

    Parameter:
    Parameter Type Description
    value string The date format string like: "2017-9-30 1:22:3.4".
    Return:

    A Date object, or null if failing to convert.

    Type: Date

    toDate['Y/M/D'](value) : Date

    Converts a date format string separated by slashes to a data object.

    Parameter:
    Parameter Type Description
    value string The date format string like: "2017/09/30".
    Return:

    A Date object, or null if failing to convert.

    Type: Date

    toDate['Y/M/D HⓂ️s'](value) : Date

    Converts a date-time format string separated by slashes and colons to a data object.

    Parameter:
    Parameter Type Description
    value string The date format string like: "2017/9/30 1:22:3.45".
    Return:

    A Date object, or null if failing to convert.

    Type: Date

    toDate.YYMMDD(value) : Date

    Converts a date format string in fixed size to a data object.

    Parameter:
    Parameter Type Description
    value string The date format string like: "170930".
    Return:

    A Date object, or null if failing to convert.

    This format can represent a date within the range 100 years centered the current year. (If the current year is 2017, the range is 1967〜2066).

    Type: Date

    toDate.YYMMDDHHmmss(value) : Date

    Converts a date format string in fixed size to a data object.

    Parameter:
    Parameter Type Description
    value string The date format string like: "170930010203".
    Return:

    A Date object, or null if failing to convert.

    This format can represent a date within the range 100 years centered the current year. (If the current year is 2017, the range is 1967〜2066).

    Type: Date

    toDate.YYYYMMDD(value) : Date

    Converts a date format string in fixed size to a data object.

    Parameter:
    Parameter Type Description
    value string The date format string like: "20170930".
    Return:

    A Date object, or null if failing to convert.

    Type: Date

    toDate.YYYYMMDDHHmmss(value) : Date

    Converts a date format string in fixed size to a data object.

    Parameter:
    Parameter Type Description
    value string The date format string like: "20170930010203".
    Return:

    A Date object, or null if failing to convert.

    Type: Date

    toDate.RFC2822(value) : Date

    Converts a date format string according to RFC2822 to a data object.

    Parameter:
    Parameter Type Description
    value string The date format string like "Sat, 30 Sep 2017 13:30:00 +0900"
    Return:

    A Date object, or null if failing to convert.

    Type: Date

    toDate.RFC3339(value) : Date

    Converts a date format string according to RFC3339 to a data object.

    Parameter:
    Parameter Type Description
    value string The date format string like "2017-09-30T13:30:00+09:00"
    Return:

    A Date object, or null if failing to convert.

    Type: Date

    toDate.ISO8601(value) : Date

    Converts a date format string according to ISO8601 to a data object.

    There are many formats in ISO8601: basic/extended, calendar-date/ordinal-date/week-date and expanded/non-expanded, and this function supports all formats of them.

    Parameter:
    Parameter Type Description
    value string The date format string like "2017-09-30T13:30:00+09:00"
    Return:

    A Date object, or null if failing to convert.

    Type: Date

    Checked

    Node.js (4〜)

    Platform 4 5 6 7 8 9 10
    macOS
    Windows10
    Linux

    io.js (1〜3)

    Platform 1 2 3
    macOS
    Windows10
    Linux

    Node.js (〜0.12)

    Platform 0.8 0.9 0.10 0.11 0.12
    macOS
    Windows10
    Linux

    Web browsers

    Platform Chrome Firefox Vivaldi Safari Edge IE11
    macOS -- --
    Windows10 --
    Linux -- -- --

    License

    Copyright (C) 2017 Takayuki Sato

    This program is free software under MIT License. See the file LICENSE in this distribution for more details.

    Install

    npm i @fav/type.to-date

    DownloadsWeekly Downloads

    3

    Version

    1.0.2

    License

    MIT

    Unpacked Size

    82.8 kB

    Total Files

    19

    Last publish

    Collaborators

    • avatar