time-to-botec/js/node_modules/@stdlib/time/hours-in-month/README.md
NunoSempere b6addc7f05 feat: add the node modules
Necessary in order to clearly see the squiggle hotwiring.
2022-12-03 12:44:49 +00:00

3.0 KiB

hoursInMonth

Determine the number of hours in a month.

Usage

var hoursInMonth = require( '@stdlib/time/hours-in-month' );

hoursInMonth( [month[, year]] )

Returns the number of hours in a month.

var num = hoursInMonth();
// returns <number>

By default, the function returns the number of hours in the current month of the current year (according to local time). To determine the number of hours for a particular month and year, provide month and year arguments.

var num = hoursInMonth( 2 );
// returns <number>

num = hoursInMonth( 2, 2016 );
// returns 696

num = hoursInMonth( 2, 2017 );
// returns 672

A month may be either a month's integer value, three letter abbreviation, or full name (case insensitive).

var num = hoursInMonth( 2, 2016 );
// returns 696

num = hoursInMonth( 'feb', 2016 );
// returns 696

num = hoursInMonth( 'february', 2016 );
// returns 696

The function also supports providing a Date object.

var num = hoursInMonth( new Date() );
// returns <number>

Notes

  • The function's return value is a generalization and does not take into account inaccuracies due to daylight savings conventions, crossing timezones, or other complications with time and dates.

Examples

var hoursInMonth = require( '@stdlib/time/hours-in-month' );

var v;
var i;

for ( i = 0; i < 2021; i++ ) {
    v = hoursInMonth( 'feb', i );
    console.log( 'In the year %d, February has %d hours.', i, v );
}

CLI

Usage

Usage: hours-in-month [options] [month] [year]

Options:

  -h,    --help                Print this message.
  -V,    --version             Print the package version.

Examples

$ hours-in-month
<number>

For a specific month,

$ hours-in-month 2
<number>

For a specific month and year,

$ hours-in-month 2 2016
696