A set of functions to handle date values in various shapes

(version 1.0.0)

• Functions are grouped into:

  • set*(), to create various value shapes expressing a date:

    • setDateObj( value ), a simple object with integer values ({ year:, month:, day: })

    • setDateArray( value ), an array of integers ([ yaer, month, day ])

    • setDateStr( value ), a string in form of 'YYYYMMDD' (where YYYY is for year, MM for month, DD for day)

    • setDateRepr( value, pattern ) a representation string in form of 'DD/MM/YYYY' (by default but also customizable to other patterns)

    • setDateDate( value ) an instance of JS Date class

  • get*(), to evaluate and retrieve the date values from the above shapes:

    • getDateObj( value ), date values from an object ({ year:, month:, day: })

    • getDateArray( value ), date values from an array of integers ([ yaer, month, day ])

    • getDateStr( value ), date values from a string in form of 'YYYYMMDD'

    • getDateRepr( value, pattern ), date values from a representation string like 'DD/MM/YYYY'

    • getDateDate( value ), date values from an instance of JS Date class

  • op*(), to compare two date values:

    • opEqualTo( date1, date2 ), the one date should be equal to the other

    • opNotEqualTo( date1, date2 ), the one date should not be equal to the other

    • opGreaterThan( date1, date2 ), the first date should be greater than the second

    • opGreaterThanEqualTo( date1, date2 ), the first date should be greater than or equal to the second

    • opLessThan( date1, date2 ), the first date should be less than the second

    • opLessThanEqualTo( date1, date2 ), the first date should be less than or equal to the second

  • calc*(), to calculate new date or related values:

    • calcDayOfWeek( date ), the position of a date in the days sequence of the week (from 1 to 7, monday to sunday)

    • calcDayOfYear( date ), the position of a date in the days sequence of the year (from 1 to 365/366)

    • calcDateByDayOfYear( day, year ), the date according to a day in the sequence of a year (from 1 to 365/366)

    • calcDateByDaysAddition( from, days ), the date according to a starting date and a positive or negative number of days to be added

    • calcWeeksOfRange( from, till ), the weeks according to a range of days that are placed within

  • count*(), to count date related values

    • countDaysOfMonth( month, year ), the number of days of a month

    • countDaysOfYear( year ), the number of days of a year

    • countDaysOfRange( from, till ), the number of days of a date range including the starting and ending limits

  • is*(), to validate date related values:

    • isYear( value ), if a value is an integer expressing a year (by default from 1900 to 2099 but also customizable to other values)

    • isLeapYear( value ), if a value is an integer expressing a leap year

    • isMonth( month, year ), if a value is an integer expressing a month (from 1 to 12)

    • isDate( year, month, day ), if a series of values expressing a date

  • config.set*(), to customize general parameters:

    • config.setYearRange( from, till ), the range of valid years (by default from 1900 to 2099)

    • config.setReprPattern( pattern ), the pattern for the date representation (by default DD/MM/YYYY)

  • config.get*(), to retrieve general parameters:

    • config.getYearRange(), the range of valid years

    • config.getReprPattern(), the pattern for the date representation

Repository here

Documentation here