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