# hoursInYear
> Determine the number of hours in a year according to the [Gregorian calendar][gregorian-calendar].
## Usage
```javascript
var hoursInYear = require( '@stdlib/time/hours-in-year' );
```
#### hoursInYear( \[value] )
Returns the number of hours in a year according to the [Gregorian calendar][gregorian-calendar].
```javascript
var num = hoursInYear();
// returns
```
By default, the function returns the number of hours in the current year (according to local time). To determine the number of hours for a particular year, provide either a year or a [`Date`][date-object] object.
```javascript
var num = hoursInYear( new Date() );
// returns
num = hoursInYear( 2000 );
// returns 8784
num = hoursInYear( 2017 );
// returns 8760
```
## 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 hoursInYear = require( '@stdlib/time/hours-in-year' );
var v;
var i;
for ( i = 0; i < 2021; i++ ) {
v = hoursInYear( i );
console.log( 'The year %d has %d hours.', i, v );
}
```
* * *
## CLI
### Usage
```text
Usage: hours-in-year [options] [year]
Options:
-h, --help Print this message.
-V, --version Print the package version.
```
### Examples
```bash
$ hours-in-year
```
For a specific year,
```bash
$ hours-in-year 2016
8784
```
[gregorian-calendar]: https://en.wikipedia.org/wiki/Gregorian_calendar
[date-object]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date