# hoursInMonth
> Determine the number of hours in a month.
## Usage
```javascript
var hoursInMonth = require( '@stdlib/time/hours-in-month' );
```
#### hoursInMonth( \[month\[, year]] )
Returns the number of hours in a month.
```javascript
var num = hoursInMonth();
// returns
```
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.
```javascript
var num = hoursInMonth( 2 );
// returns
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).
```javascript
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`][date-object] object.
```javascript
var num = hoursInMonth( new Date() );
// returns
```
## 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
```javascript
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
```text
Usage: hours-in-month [options] [month] [year]
Options:
-h, --help Print this message.
-V, --version Print the package version.
```
### Examples
```bash
$ hours-in-month
```
For a specific month,
```bash
$ hours-in-month 2
```
For a specific month and year,
```bash
$ hours-in-month 2 2016
696
```
[date-object]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date