![](\"https://raw.githubusercontent.com/doniseferi/suntimes/master/logo.svg?sanitize=true\"){kind=logo}
\r\n\r\n\r\n
numberThe angular distance of the sun north or south of the earth's equator.
\r\nnumberGets the equation of time for the date instance. The correction between standard clock time and the time based on the exact position of the sun in the sky represented as decimal time in minutes (e.g. 5.5 equal 5 minutes and 30 seconds).
\r\nnumberGets the day of the year for the date instance.
\r\nnumberGets the hour angle difference between noon and the angle value.
\r\nnumberGets the noon hour angle for the date instance and longitude value.
\r\nstringGets the noon date and time in UTC for the date instance and longitude value.
\r\nstringGets the date and time at an angle before noon for the angle value, date instance, latitude and longitude value.
\r\nstringGets the date and time at an angle after noon for the angle value, date instance, latitude and longitude value.
\r\nstringGets the sunrise date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the sunset date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the end of civil dawn date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the start of civil dawn date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the end of nautical dawn date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the start of nautical dawn date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the end of astronomical dawn date and time in UTC for the date instance, latitude and longitude\r\nvalue.
\r\nstringGets the start of astronomical dawn date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the start of astronomical dusk date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the end of astronomical dusk date and time in UTC for the date instance, latitude and longitude\r\nvalue.
\r\nstringGets the end of nautical dusk date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the start of nautical dusk date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the end of civil dusk date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the start of civil dusk date and time in UTC for the date instance, latitude and longitude value.
\r\nnumber\r\n\r\nThe angular distance of the sun north or south of the earth's equator.\r\n\r\n**Kind**: global variable\r\n**Returns**: number - The declination in degrees where north is a positive value and south is a negative value within a range of range of -23.45 and 23.45.\r\n\r\n| Param | Type | Description |\r\n| ----- | ----------------- | --------------- |\r\n| date | Date | A date instance |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getDeclinationOfTheSun(new Date(2019, 0, 1));\r\n```\r\n\r\n\r\n\r\n## equationOfTime ⇒ number\r\n\r\nGets the equation of time for the date instance. The correction between standard clock time and the time based on the exact position of the sun in the sky represented as decimal time in minutes (e.g. 5.5 equal 5 minutes and 30 seconds).\r\n\r\n**Kind**: global variable\r\n**Returns**: number - A number whose value is the equation of time in minutes decimal time for\r\nthe Date represented by date.\r\n\r\n| Param | Type | Description |\r\n| ----- | ----------------- | ---------------- |\r\n| date | Date | A date instance. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.equationOfTime(new Date(2019, 0, 1));\r\n```\r\n\r\n\r\n\r\n## getDayOfTheYear ⇒ number\r\n\r\nGets the day of the year for the date instance.\r\n\r\n**Kind**: global variable\r\n**Returns**: number - The day of the year, expressed as a value between 1 and 366 for the Date\r\ninstance represented by date.\r\n\r\n| Param | Type | Description |\r\n| ----- | ----------------- | ---------------- |\r\n| date | Date | A date instance. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getDayOfTheYear(new Date(2019, 0, 1));\r\n```\r\n\r\n\r\n\r\n## getHourAngleSinceNoon ⇒ number\r\n\r\nGets the hour angle difference between noon and the angle value.\r\n\r\n**Kind**: global variable\r\n**Returns**: number - A number whose value represents the hour angle since noon for the date instance, latitude and angle value.\r\n\r\n| Param | Type | Description |\r\n| -------- | ------------------- | ------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| angle | number | An angle value. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getHourAngleSinceNoon(new Date(2019, 0, 1), 51.476852, -0.833);\r\n```\r\n\r\n\r\n\r\n## getNoonHourAngle ⇒ number\r\n\r\nGets the noon hour angle for the date instance and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: number - The noon hour angle expressed as a number between 0.00 and 23.9.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getNoonHourAngle(new Date(2019, 0, 1), -0.0005);\r\n```\r\n\r\n\r\n\r\n## getNoonDateTimeUtc ⇒ string\r\n\r\nGets the noon date and time in UTC for the date instance and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing noon date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getNoonDateTimeUtc(new Date(2019, 0, 1), -0.0005);\r\n```\r\n\r\n\r\n\r\n## getDateTimeUtcOfAngleBeforeNoon ⇒ string\r\n\r\nGets the date and time at an angle before noon for the angle value, date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the time and date for an angle before noon in UTC,\r\nexpressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| angle | number | An angle value. |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getDateTimeUtcOfAngleBeforeNoon(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getDateTimeUtcOfAngleAfterNoon ⇒ string\r\n\r\nGets the date and time at an angle after noon for the angle value, date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the time and date for an angle after noon in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| angle | number | An angle value. |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getDateTimeUtcOfAngleAfterNoon(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getSunriseDateTimeUtc ⇒ string\r\n\r\nGets the sunrise date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing sunrise date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getSunriseDateTimeUtc(new Date(2019, 0, 1), 51.476852, -0.0005);\r\n```\r\n\r\n\r\n\r\n## getSunsetDateTimeUtc ⇒ string\r\n\r\nGets the sunset date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing sunset date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getSunsetDateTimeUtc(new Date(2019, 0, 1), 51.476852, -0.0005);\r\n```\r\n\r\n\r\n\r\n## getCivilDawnEndDateTimeUtc ⇒ string\r\n\r\nGets the end of civil dawn date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the end of civil dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getCivilDawnEndDateTimeUtc(new Date(2019, 0, 1), 51.476852, -0.0005);\r\n```\r\n\r\n\r\n\r\n## getCivilDawnStartDateTimeUtc ⇒ string\r\n\r\nGets the start of civil dawn date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the start of civil dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getCivilDawnStartDateTimeUtc(new Date(2019, 0, 1), 51.476852, -0.0005);\r\n```\r\n\r\n\r\n\r\n## getNauticalDawnEndDateTimeUtc ⇒ string\r\n\r\nGets the end of nautical dawn date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the end of nautical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getNauticalDawnEndDateTimeUtc(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getNauticalDawnStartDateTimeUtc ⇒ string\r\n\r\nGets the start of nautical dawn date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the start of nautical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getNauticalDawnStartDateTimeUtc(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getAstronomicalDawnEndDateTimeUtc ⇒ string\r\n\r\nGets the end of astronomical dawn date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the end of astronomical dawn date and time in UTC,\r\nexpressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getAstronomicalDawnEndDateTimeUtc(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getAstronomicalDawnStartDateTimeUtc ⇒ string\r\n\r\nGets the start of astronomical dawn date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the start of astronomical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getAstronomicalDawnStartDateTimeUtc(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getAstronomicalDuskStartDateTimeUtc ⇒ string\r\n\r\nGets the start of astronomical dusk date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the start of astronomical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getAstronomicalDuskStartDateTimeUtc(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getAstronomicalDuskEndDateTimeUtc ⇒ string\r\n\r\nGets the end of astronomical dusk date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the end of astronomical dusk date and time in UTC,\r\nexpressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getAstronomicalDuskEndDateTimeUtc(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getNauticalDuskEndDateTimeUtc ⇒ string\r\n\r\nGets the end of nautical dusk date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the end of nautical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getNauticalDuskEndDateTimeUtc(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getNauticalDuskStartDateTimeUtc ⇒ string\r\n\r\nGets the start of nautical dusk date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the start of nautical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getNauticalDuskStartDateTimeUtc(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getCivilDuskEndDateTimeUtc ⇒ string\r\n\r\nGets the end of civil dusk date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the end of civil dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getCivilDuskEndDateTimeUtc(new Date(2019, 0, 1), 51.476852, -0.0005);\r\n```\r\n\r\n\r\n\r\n## getCivilDuskStartDateTimeUtc ⇒ string\r\n\r\nGets the start of civil dusk date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the start of civil dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getCivilDuskStartDateTimeUtc(new Date(2019, 0, 1), 51.476852, -0.0005);\r\n```\r\n","readmeFilename":"README.md","_id":"suntimes@4.0.0-0","_nodeVersion":"10.16.3","_npmVersion":"6.11.3","dist":{"integrity":"sha512-Fp2AS2tga3icm8HsQXYTYWXxR7C+zq6jhctyBMgyBeraOYoTPwZv2ETbo41jL3kMNgoBSvyC8QUxNoD67CCZ3Q==","shasum":"e8fc26899fa50d961bfb9e7dc67854d77d7e7e23","tarball":"https://registry.npmjs.org/suntimes/-/suntimes-4.0.0-0.tgz","fileCount":52,"unpackedSize":604210,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJeD54iCRA9TVsSAnZWagAAOkEP/2nC0kLGqcb0XXQYpVch\n80bvS3NnXJbPXrdMB/5O/4PaKA9P2+QNM+GtwFebxInjUeUpvq84/Y9XHzmL\nKhJLaI74Vy3x6SkBtSWoR6Wdmy0UyRquYaV8aFyVb4ldJFWNmb06Gg7PHxvk\nQXFlydfklvazAy3UPInU8lvDm+8c8o0TFSxURqipg2Yx8NLMHJYUDvpIKjSj\nVve8ceU2+woQ+/gvgQ632ko7b0y9pUFXycWZuUo+sGnycjo4PtbQ4Mtt2kBE\ne7WBkMpN69MMTUiINGkLbxGruSCe86OQo3stk5jMcZoei/ieWne6QkRvJ4Iv\nY1aCIiX4KHoXsi2Bti1eM7JXibb0JcHjAVXRKaGEMYxqWwpl/0T/un40Pkus\nasbyJWdjvBg6/tJYNa5gAWzeJhgh8p08HsN3J9bYnCb7OOKDsTvBQw84z9ki\nGo2qP1JpXGDi73AMftU5kwT0qsry075kNBFO4fIbnBstYO8EA54S7C614W1R\nq4qM2H/k2qS1u93jJd4jZs2XqhN7Kjv446RlF4hsu+GWGfxiPhvHiWFtdvfk\n4EjxO16Q5BpA8CHepCIhEK73rBi6SCd8vzALQU7OfcZQpIAhnhLBOdaQYU4r\nu1+3GDHuqFsO/BiFfiCSrWcRHmyKLkx8h1eOPoeipqsvXVFK7wbQ86nyD0Zj\nObvy\r\n=uZ1U\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCICw5HNH0f8D2kJncoQrNo9pM2KDA/P36DBQo51YVIVzPAiEAgOqzGk89jMjmwcnDMiana2l+JgWG9YgqgZKd3HYvyDU="}]},"maintainers":[{"name":"doniseferi","email":"doni.seferi@gmail.com"}],"_npmUser":{"name":"doniseferi","email":"doni.seferi@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/suntimes_4.0.0-0_1578081825615_0.04784342549681142"},"_hasShrinkwrap":false,"deprecated":"not supported and may be prone to bugs, use v4.1.7 or higher"},"4.0.0-1":{"name":"suntimes","version":"4.0.0-1","description":"A simple library to get the exact date and time in utc for certain points of the day for any desired location and date.","main":"lib/suntimes.js","module":"src/index","scripts":{"bundle":"rimraf lib && rollup -c","test":"semistandard && nyc mocha --opts support/mocha.opts **/*.test.js","coverage":"nyc report --reporter=text-lcov | coveralls","fix":"semistandard --fix","build":"npm run bundle && copyfiles package.json lib/","release":"npm run build && np"},"repository":{"type":"git","url":"git+https://github.com/doniseferi/suntimes.git"},"keywords":["sun","suntimes","equationOfTime","solar","declination","sunrise","sunset","twilight","dusk","dawn","maths","astronomy","celestial"],"author":{"name":"Edonis Seferi"},"license":"ISC","bugs":{"url":"https://github.com/doniseferi/suntimes/issues"},"homepage":"https://github.com/doniseferi/suntimes#readme","devDependencies":{"@babel/cli":"^7.7.0","@babel/core":"^7.7.0","@babel/preset-env":"^7.7.1","@babel/register":"^7.7.0","chai":"^4.2.0","copyfiles":"^2.1.1","coveralls":"^3.0.7","depcheck":"^0.9.0","eslint":"^6.6.0","eslint-config-semistandard":"^15.0.0","eslint-config-standard":"^14.1.0","eslint-plugin-import":"^2.18.2","eslint-plugin-node":"^10.0.0","eslint-plugin-promise":"^4.2.1","eslint-plugin-standard":"^4.0.1","jsdoc-to-markdown":"^5.0.2","mocha":"^6.2.2","nyc":"^14.1.1","rimraf":"^3.0.0","rollup":"^1.27.14","rollup-plugin-babel":"^4.3.3","rollup-plugin-terser":"^5.1.3","semistandard":"^14.2.0"},"gitHead":"6067f505ddd00759dc2f80e9d0cd22ee34e65e1b","readme":"\r\n\r\n
numberThe angular distance of the sun north or south of the earth's equator.
\r\nnumberGets the equation of time for the date instance. The correction between standard clock time and the time based on the exact position of the sun in the sky represented as decimal time in minutes (e.g. 5.5 equal 5 minutes and 30 seconds).
\r\nnumberGets the day of the year for the date instance.
\r\nnumberGets the hour angle difference between noon and the angle value.
\r\nnumberGets the noon hour angle for the date instance and longitude value.
\r\nstringGets the noon date and time in UTC for the date instance and longitude value.
\r\nstringGets the date and time at an angle before noon for the angle value, date instance, latitude and longitude value.
\r\nstringGets the date and time at an angle after noon for the angle value, date instance, latitude and longitude value.
\r\nstringGets the sunrise date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the sunset date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the end of civil dawn date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the start of civil dawn date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the end of nautical dawn date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the start of nautical dawn date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the end of astronomical dawn date and time in UTC for the date instance, latitude and longitude\r\nvalue.
\r\nstringGets the start of astronomical dawn date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the start of astronomical dusk date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the end of astronomical dusk date and time in UTC for the date instance, latitude and longitude\r\nvalue.
\r\nstringGets the end of nautical dusk date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the start of nautical dusk date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the end of civil dusk date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the start of civil dusk date and time in UTC for the date instance, latitude and longitude value.
\r\nnumber\r\n\r\nThe angular distance of the sun north or south of the earth's equator.\r\n\r\n**Kind**: global variable\r\n**Returns**: number - The declination in degrees where north is a positive value and south is a negative value within a range of range of -23.45 and 23.45.\r\n\r\n| Param | Type | Description |\r\n| ----- | ----------------- | --------------- |\r\n| date | Date | A date instance |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getDeclinationOfTheSun(new Date(2019, 0, 1));\r\n```\r\n\r\n\r\n\r\n## equationOfTime ⇒ number\r\n\r\nGets the equation of time for the date instance. The correction between standard clock time and the time based on the exact position of the sun in the sky represented as decimal time in minutes (e.g. 5.5 equal 5 minutes and 30 seconds).\r\n\r\n**Kind**: global variable\r\n**Returns**: number - A number whose value is the equation of time in minutes decimal time for\r\nthe Date represented by date.\r\n\r\n| Param | Type | Description |\r\n| ----- | ----------------- | ---------------- |\r\n| date | Date | A date instance. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.equationOfTime(new Date(2019, 0, 1));\r\n```\r\n\r\n\r\n\r\n## getDayOfTheYear ⇒ number\r\n\r\nGets the day of the year for the date instance.\r\n\r\n**Kind**: global variable\r\n**Returns**: number - The day of the year, expressed as a value between 1 and 366 for the Date\r\ninstance represented by date.\r\n\r\n| Param | Type | Description |\r\n| ----- | ----------------- | ---------------- |\r\n| date | Date | A date instance. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getDayOfTheYear(new Date(2019, 0, 1));\r\n```\r\n\r\n\r\n\r\n## getHourAngleSinceNoon ⇒ number\r\n\r\nGets the hour angle difference between noon and the angle value.\r\n\r\n**Kind**: global variable\r\n**Returns**: number - A number whose value represents the hour angle since noon for the date instance, latitude and angle value.\r\n\r\n| Param | Type | Description |\r\n| -------- | ------------------- | ------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| angle | number | An angle value. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getHourAngleSinceNoon(new Date(2019, 0, 1), 51.476852, -0.833);\r\n```\r\n\r\n\r\n\r\n## getNoonHourAngle ⇒ number\r\n\r\nGets the noon hour angle for the date instance and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: number - The noon hour angle expressed as a number between 0.00 and 23.9.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getNoonHourAngle(new Date(2019, 0, 1), -0.0005);\r\n```\r\n\r\n\r\n\r\n## getNoonDateTimeUtc ⇒ string\r\n\r\nGets the noon date and time in UTC for the date instance and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing noon date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getNoonDateTimeUtc(new Date(2019, 0, 1), -0.0005);\r\n```\r\n\r\n\r\n\r\n## getDateTimeUtcOfAngleBeforeNoon ⇒ string\r\n\r\nGets the date and time at an angle before noon for the angle value, date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the time and date for an angle before noon in UTC,\r\nexpressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| angle | number | An angle value. |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getDateTimeUtcOfAngleBeforeNoon(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getDateTimeUtcOfAngleAfterNoon ⇒ string\r\n\r\nGets the date and time at an angle after noon for the angle value, date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the time and date for an angle after noon in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| angle | number | An angle value. |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getDateTimeUtcOfAngleAfterNoon(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getSunriseDateTimeUtc ⇒ string\r\n\r\nGets the sunrise date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing sunrise date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getSunriseDateTimeUtc(new Date(2019, 0, 1), 51.476852, -0.0005);\r\n```\r\n\r\n\r\n\r\n## getSunsetDateTimeUtc ⇒ string\r\n\r\nGets the sunset date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing sunset date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getSunsetDateTimeUtc(new Date(2019, 0, 1), 51.476852, -0.0005);\r\n```\r\n\r\n\r\n\r\n## getCivilDawnEndDateTimeUtc ⇒ string\r\n\r\nGets the end of civil dawn date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the end of civil dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getCivilDawnEndDateTimeUtc(new Date(2019, 0, 1), 51.476852, -0.0005);\r\n```\r\n\r\n\r\n\r\n## getCivilDawnStartDateTimeUtc ⇒ string\r\n\r\nGets the start of civil dawn date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the start of civil dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getCivilDawnStartDateTimeUtc(new Date(2019, 0, 1), 51.476852, -0.0005);\r\n```\r\n\r\n\r\n\r\n## getNauticalDawnEndDateTimeUtc ⇒ string\r\n\r\nGets the end of nautical dawn date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the end of nautical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getNauticalDawnEndDateTimeUtc(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getNauticalDawnStartDateTimeUtc ⇒ string\r\n\r\nGets the start of nautical dawn date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the start of nautical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getNauticalDawnStartDateTimeUtc(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getAstronomicalDawnEndDateTimeUtc ⇒ string\r\n\r\nGets the end of astronomical dawn date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the end of astronomical dawn date and time in UTC,\r\nexpressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getAstronomicalDawnEndDateTimeUtc(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getAstronomicalDawnStartDateTimeUtc ⇒ string\r\n\r\nGets the start of astronomical dawn date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the start of astronomical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getAstronomicalDawnStartDateTimeUtc(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getAstronomicalDuskStartDateTimeUtc ⇒ string\r\n\r\nGets the start of astronomical dusk date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the start of astronomical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getAstronomicalDuskStartDateTimeUtc(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getAstronomicalDuskEndDateTimeUtc ⇒ string\r\n\r\nGets the end of astronomical dusk date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the end of astronomical dusk date and time in UTC,\r\nexpressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getAstronomicalDuskEndDateTimeUtc(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getNauticalDuskEndDateTimeUtc ⇒ string\r\n\r\nGets the end of nautical dusk date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the end of nautical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getNauticalDuskEndDateTimeUtc(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getNauticalDuskStartDateTimeUtc ⇒ string\r\n\r\nGets the start of nautical dusk date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the start of nautical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getNauticalDuskStartDateTimeUtc(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getCivilDuskEndDateTimeUtc ⇒ string\r\n\r\nGets the end of civil dusk date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the end of civil dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getCivilDuskEndDateTimeUtc(new Date(2019, 0, 1), 51.476852, -0.0005);\r\n```\r\n\r\n\r\n\r\n## getCivilDuskStartDateTimeUtc ⇒ string\r\n\r\nGets the start of civil dusk date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the start of civil dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getCivilDuskStartDateTimeUtc(new Date(2019, 0, 1), 51.476852, -0.0005);\r\n```\r\n","readmeFilename":"README.md","_id":"suntimes@4.0.0-1","_nodeVersion":"10.16.3","_npmVersion":"6.11.3","dist":{"integrity":"sha512-2Hbiy1N9vuBDSl6j37atGItN1gyE4GIqRQWff6Qxxkmir+aJwnF2V4BopojpeiDjCsVqbKX9hHvcmCo4rePg5Q==","shasum":"e9aee3cd41c5ce8888b5d7ed3fa7ed9452fed06b","tarball":"https://registry.npmjs.org/suntimes/-/suntimes-4.0.0-1.tgz","fileCount":52,"unpackedSize":604212,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJeD6KeCRA9TVsSAnZWagAAgpQP/AmRqbkN5sELr2JKWmsL\n0BwbwwX4QGV5Fn/Zw+YYipZsEif1DlkYMO0PN917H1yyhErq1gJJ8MGsAdm8\nqoh41+3i2fzPJohgE1IoDDIT2e8tFYrHKkQxrRNxPc4C6t9j55AnfenOnUsW\nlHcVuffKfni/Oz7PkmD85Ksn293IN84pC+3+pCeXbc6NmaAuSB8ixOWzMGzv\n8vpspO16/8+aiZHSX+UAAciV690yBQ0aB0SWEfP/eroT2pekMrdsnxqPr4HE\nZf9wPlHEHW5Py1E9lIJNea2uExB2nOxCtU2Lbx6CTHc/EhjVcsx7sX+U1VFj\npOfopZfHRa4frLiGeSHCFYlsRMCKDvBnKQugjh9prwAG429CA6P+2JTgHk/0\nvYOGDT3T4tlF4Mb53yh6O7KuYLdQ5TUF4EaampvXDVygc4XPnNRSO4zllVTM\niczT/FD+XwLAhr0fjvwbomHuvp1/5Oxh6X7KGRWcXVwVXWP94f8KcR3b8BCZ\nlLxAzPmnNX1t6RcnMBbTEG8QJpJvhfS7qF+svbwzU1wyNwMaBZuuCg+TquMB\nVYqRec23FA/Hil5CFsHTnUAEBy9qOnvYInS3Uwba3D7v6/DPG0e2ME/iAJHJ\nLQjcAyJNHxL0NsGKmUacp0hztiSNXDzQ8wvFh7K/OW/W6wnQloK0AGKUrLSj\ncFsy\r\n=X1qS\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCg02gG9vs3GQN6rSTNAmk1DmQ4t+cnwjC9BFQo1B064AIgT3ztRZLqoMqru3s5n18aFZ5vUaDd10Tgtv+OEru0omI="}]},"maintainers":[{"name":"doniseferi","email":"doni.seferi@gmail.com"}],"_npmUser":{"name":"doniseferi","email":"doni.seferi@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/suntimes_4.0.0-1_1578082974234_0.18821277841728468"},"_hasShrinkwrap":false,"deprecated":"not supported and may be prone to bugs, use v4.1.7 or higher"},"4.0.0-2":{"name":"suntimes","version":"4.0.0-2","description":"A simple library to get the exact date and time in utc for certain points of the day for any desired location and date.","main":"lib/suntimes.js","module":"src/index","scripts":{"bundle":"rimraf lib && rollup -c","test":"semistandard && nyc mocha --opts support/mocha.opts **/*.test.js","coverage":"nyc report --reporter=text-lcov | coveralls","fix":"semistandard --fix","build":"npm run bundle","release":"np --contents=lib"},"repository":{"type":"git","url":"git+https://github.com/doniseferi/suntimes.git"},"keywords":["sun","suntimes","equationOfTime","solar","declination","sunrise","sunset","twilight","dusk","dawn","maths","astronomy","celestial"],"author":{"name":"Edonis Seferi"},"license":"ISC","bugs":{"url":"https://github.com/doniseferi/suntimes/issues"},"homepage":"https://github.com/doniseferi/suntimes#readme","devDependencies":{"@babel/cli":"^7.7.0","@babel/core":"^7.7.0","@babel/preset-env":"^7.7.1","@babel/register":"^7.7.0","chai":"^4.2.0","copyfiles":"^2.1.1","coveralls":"^3.0.7","depcheck":"^0.9.0","eslint":"^6.6.0","eslint-config-semistandard":"^15.0.0","eslint-config-standard":"^14.1.0","eslint-plugin-import":"^2.18.2","eslint-plugin-node":"^10.0.0","eslint-plugin-promise":"^4.2.1","eslint-plugin-standard":"^4.0.1","jsdoc-to-markdown":"^5.0.2","mocha":"^6.2.2","nyc":"^14.1.1","rimraf":"^3.0.0","rollup":"^1.27.14","rollup-plugin-babel":"^4.3.3","rollup-plugin-terser":"^5.1.3","semistandard":"^14.2.0"},"readme":"ERROR: No README data found!","_id":"suntimes@4.0.0-2","_nodeVersion":"10.16.3","_npmVersion":"6.11.3","dist":{"integrity":"sha512-0C+riRmob2Hk2NDebBfEtG+X/+luMjJ4NevmOJ/fqoA6Lvvf2Nrtl9lwg1+3a5y8tzPXXuTbX1Bx/ifRUT1HvA==","shasum":"aa134bd3f13dfacaf8a4c0c43b4503bbd03de140","tarball":"https://registry.npmjs.org/suntimes/-/suntimes-4.0.0-2.tgz","fileCount":2,"unpackedSize":11083,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJeEQO1CRA9TVsSAnZWagAAXcgP/R/kapIPQ/S0KqgBklkW\n00tWMNRi0Jeum91ZEeO6MWiwdFXdA9D/ZSG2L7uNdzrKmcuVk7f6wKUopIJ+\nlC+cd9KHaTupbd9sBs3hAfs4n390ajoTwSMGYTyxz5vd+4lpeHm6qAuGLVGf\nfbOwBP5u2vVRB+ZlwUJaoVqVqXJCDurimsuRCsn0HNvO63OwXTsTwUbStuVA\nOB5TPk8Ygiyvje1NPoEKFHStEKpKmFUJSfE+qvkKENqCz/pxW/pbJNZGaaVp\ns+Bh9D70prd4P3XNBlzdD7IBPsi0pRqGJimzd0iq5DT7cP6syQQ76HGxa6BB\nGcx51LNqpMqOTaxJ4lPfbJE3IZa88Twb0DEIFLxtnk+naJhkKuajSYn1pAmY\nqKD92qEpp7ApRrQ3lBJtAvxFc1hWw/zZS7UGbr21gJzsIieXv7SRIUFXWRRw\n/Cil5l6/WZLxpmk8+0dMMNfaHHY88OsEmDq5MjKZ9XzosxUeEqIj2U6zGpdI\nAyFjiHpBM930q+Y0YtJF/gEhrtbWfYGW3DNi+HxkecuKJlYzqi3NWdJIXdOe\nMEtb7r8G75XXUEhKIL3T/8XPS8ePU1aVMH23hglBabCPvXtRDwsQdBK82iW+\nYwP+/X7A7JWb0H+fIkOwabfP3NQrTGz6l5PjPhWrHfgu4RkFzyZ+F9c6bD0Q\nVhRu\r\n=Wzts\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCICheorXzGG8eSqcm4+yDfZwehpCUNBZUSXyT7UQJFWRnAiEA9cOoEthBXOP1T7qwhzkh0CkvXVAdcQWCOxfzspvgirQ="}]},"maintainers":[{"name":"doniseferi","email":"doni.seferi@gmail.com"}],"_npmUser":{"name":"doniseferi","email":"doni.seferi@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/suntimes_4.0.0-2_1578173364643_0.5295363205992543"},"_hasShrinkwrap":false,"deprecated":"not supported and may be prone to bugs, use v4.1.7 or higher"},"4.0.0-3":{"name":"suntimes","version":"4.0.0-3","description":"A simple library to get the exact date and time in utc for certain points of the day for any desired location and date.","main":"lib/suntimes.js","module":"src/index","scripts":{"bundle":"rimraf lib && rollup -c","test":"semistandard && nyc mocha --opts support/mocha.opts **/*.test.js","coverage":"nyc report --reporter=text-lcov | coveralls","fix":"semistandard --fix","pack":"npm run bundle && copyfiles README.md package.json License.md lib","release":"npm run pack && np --contents=lib"},"repository":{"type":"git","url":"git+https://github.com/doniseferi/suntimes.git"},"keywords":["sun","suntimes","equationOfTime","solar","declination","sunrise","sunset","twilight","dusk","dawn","maths","astronomy","celestial"],"author":{"name":"Edonis Seferi"},"license":"ISC","bugs":{"url":"https://github.com/doniseferi/suntimes/issues"},"homepage":"https://github.com/doniseferi/suntimes#readme","devDependencies":{"@babel/cli":"^7.7.0","@babel/core":"^7.7.0","@babel/preset-env":"^7.7.1","@babel/register":"^7.7.0","chai":"^4.2.0","copyfiles":"^2.1.1","coveralls":"^3.0.7","depcheck":"^0.9.0","eslint":"^6.6.0","eslint-config-semistandard":"^15.0.0","eslint-config-standard":"^14.1.0","eslint-plugin-import":"^2.18.2","eslint-plugin-node":"^10.0.0","eslint-plugin-promise":"^4.2.1","eslint-plugin-standard":"^4.0.1","jsdoc-to-markdown":"^5.0.2","mocha":"^6.2.2","nyc":"^14.1.1","rimraf":"^3.0.0","rollup":"^1.27.14","rollup-plugin-babel":"^4.3.3","rollup-plugin-terser":"^5.1.3","semistandard":"^14.2.0"},"readme":"\r\n\r\n
numberThe angular distance of the sun north or south of the earth's equator.
\r\nnumberGets the equation of time for the date instance. The correction between standard clock time and the time based on the exact position of the sun in the sky represented as decimal time in minutes (e.g. 5.5 equal 5 minutes and 30 seconds).
\r\nnumberGets the day of the year for the date instance.
\r\nnumberGets the hour angle difference between noon and the angle value.
\r\nnumberGets the noon hour angle for the date instance and longitude value.
\r\nstringGets the noon date and time in UTC for the date instance and longitude value.
\r\nstringGets the date and time at an angle before noon for the angle value, date instance, latitude and longitude value.
\r\nstringGets the date and time at an angle after noon for the angle value, date instance, latitude and longitude value.
\r\nstringGets the sunrise date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the sunset date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the end of civil dawn date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the start of civil dawn date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the end of nautical dawn date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the start of nautical dawn date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the end of astronomical dawn date and time in UTC for the date instance, latitude and longitude\r\nvalue.
\r\nstringGets the start of astronomical dawn date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the start of astronomical dusk date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the end of astronomical dusk date and time in UTC for the date instance, latitude and longitude\r\nvalue.
\r\nstringGets the end of nautical dusk date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the start of nautical dusk date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the end of civil dusk date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the start of civil dusk date and time in UTC for the date instance, latitude and longitude value.
\r\nnumber\r\n\r\nThe angular distance of the sun north or south of the earth's equator.\r\n\r\n**Kind**: global variable\r\n**Returns**: number - The declination in degrees where north is a positive value and south is a negative value within a range of range of -23.45 and 23.45.\r\n\r\n| Param | Type | Description |\r\n| ----- | ----------------- | --------------- |\r\n| date | Date | A date instance |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getDeclinationOfTheSun(new Date(2019, 0, 1));\r\n```\r\n\r\n\r\n\r\n## equationOfTime ⇒ number\r\n\r\nGets the equation of time for the date instance. The correction between standard clock time and the time based on the exact position of the sun in the sky represented as decimal time in minutes (e.g. 5.5 equal 5 minutes and 30 seconds).\r\n\r\n**Kind**: global variable\r\n**Returns**: number - A number whose value is the equation of time in minutes decimal time for\r\nthe Date represented by date.\r\n\r\n| Param | Type | Description |\r\n| ----- | ----------------- | ---------------- |\r\n| date | Date | A date instance. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.equationOfTime(new Date(2019, 0, 1));\r\n```\r\n\r\n\r\n\r\n## getDayOfTheYear ⇒ number\r\n\r\nGets the day of the year for the date instance.\r\n\r\n**Kind**: global variable\r\n**Returns**: number - The day of the year, expressed as a value between 1 and 366 for the Date\r\ninstance represented by date.\r\n\r\n| Param | Type | Description |\r\n| ----- | ----------------- | ---------------- |\r\n| date | Date | A date instance. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getDayOfTheYear(new Date(2019, 0, 1));\r\n```\r\n\r\n\r\n\r\n## getHourAngleSinceNoon ⇒ number\r\n\r\nGets the hour angle difference between noon and the angle value.\r\n\r\n**Kind**: global variable\r\n**Returns**: number - A number whose value represents the hour angle since noon for the date instance, latitude and angle value.\r\n\r\n| Param | Type | Description |\r\n| -------- | ------------------- | ------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| angle | number | An angle value. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getHourAngleSinceNoon(new Date(2019, 0, 1), 51.476852, -0.833);\r\n```\r\n\r\n\r\n\r\n## getNoonHourAngle ⇒ number\r\n\r\nGets the noon hour angle for the date instance and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: number - The noon hour angle expressed as a number between 0.00 and 23.9.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getNoonHourAngle(new Date(2019, 0, 1), -0.0005);\r\n```\r\n\r\n\r\n\r\n## getNoonDateTimeUtc ⇒ string\r\n\r\nGets the noon date and time in UTC for the date instance and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing noon date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getNoonDateTimeUtc(new Date(2019, 0, 1), -0.0005);\r\n```\r\n\r\n\r\n\r\n## getDateTimeUtcOfAngleBeforeNoon ⇒ string\r\n\r\nGets the date and time at an angle before noon for the angle value, date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the time and date for an angle before noon in UTC,\r\nexpressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| angle | number | An angle value. |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getDateTimeUtcOfAngleBeforeNoon(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getDateTimeUtcOfAngleAfterNoon ⇒ string\r\n\r\nGets the date and time at an angle after noon for the angle value, date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the time and date for an angle after noon in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| angle | number | An angle value. |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getDateTimeUtcOfAngleAfterNoon(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getSunriseDateTimeUtc ⇒ string\r\n\r\nGets the sunrise date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing sunrise date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getSunriseDateTimeUtc(new Date(2019, 0, 1), 51.476852, -0.0005);\r\n```\r\n\r\n\r\n\r\n## getSunsetDateTimeUtc ⇒ string\r\n\r\nGets the sunset date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing sunset date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getSunsetDateTimeUtc(new Date(2019, 0, 1), 51.476852, -0.0005);\r\n```\r\n\r\n\r\n\r\n## getCivilDawnEndDateTimeUtc ⇒ string\r\n\r\nGets the end of civil dawn date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the end of civil dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getCivilDawnEndDateTimeUtc(new Date(2019, 0, 1), 51.476852, -0.0005);\r\n```\r\n\r\n\r\n\r\n## getCivilDawnStartDateTimeUtc ⇒ string\r\n\r\nGets the start of civil dawn date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the start of civil dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getCivilDawnStartDateTimeUtc(new Date(2019, 0, 1), 51.476852, -0.0005);\r\n```\r\n\r\n\r\n\r\n## getNauticalDawnEndDateTimeUtc ⇒ string\r\n\r\nGets the end of nautical dawn date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the end of nautical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getNauticalDawnEndDateTimeUtc(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getNauticalDawnStartDateTimeUtc ⇒ string\r\n\r\nGets the start of nautical dawn date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the start of nautical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getNauticalDawnStartDateTimeUtc(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getAstronomicalDawnEndDateTimeUtc ⇒ string\r\n\r\nGets the end of astronomical dawn date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the end of astronomical dawn date and time in UTC,\r\nexpressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getAstronomicalDawnEndDateTimeUtc(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getAstronomicalDawnStartDateTimeUtc ⇒ string\r\n\r\nGets the start of astronomical dawn date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the start of astronomical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getAstronomicalDawnStartDateTimeUtc(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getAstronomicalDuskStartDateTimeUtc ⇒ string\r\n\r\nGets the start of astronomical dusk date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the start of astronomical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getAstronomicalDuskStartDateTimeUtc(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getAstronomicalDuskEndDateTimeUtc ⇒ string\r\n\r\nGets the end of astronomical dusk date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the end of astronomical dusk date and time in UTC,\r\nexpressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getAstronomicalDuskEndDateTimeUtc(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getNauticalDuskEndDateTimeUtc ⇒ string\r\n\r\nGets the end of nautical dusk date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the end of nautical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getNauticalDuskEndDateTimeUtc(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getNauticalDuskStartDateTimeUtc ⇒ string\r\n\r\nGets the start of nautical dusk date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the start of nautical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getNauticalDuskStartDateTimeUtc(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getCivilDuskEndDateTimeUtc ⇒ string\r\n\r\nGets the end of civil dusk date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the end of civil dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getCivilDuskEndDateTimeUtc(new Date(2019, 0, 1), 51.476852, -0.0005);\r\n```\r\n\r\n\r\n\r\n## getCivilDuskStartDateTimeUtc ⇒ string\r\n\r\nGets the start of civil dusk date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the start of civil dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getCivilDuskStartDateTimeUtc(new Date(2019, 0, 1), 51.476852, -0.0005);\r\n```\r\n","readmeFilename":"README.md","_id":"suntimes@4.0.0-3","_nodeVersion":"10.16.3","_npmVersion":"6.11.3","dist":{"integrity":"sha512-udpOK2G5L/fG47qJGlWH3PFzsAtyWubYRDeTxr5hsxopXHvfq/RK0y2ZnPDvize85Q3l05b/A/1YwD8dFIk5MA==","shasum":"22b9df444190439cef2abe4bdfca482385c7ae33","tarball":"https://registry.npmjs.org/suntimes/-/suntimes-4.0.0-3.tgz","fileCount":4,"unpackedSize":37529,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJeEgIQCRA9TVsSAnZWagAAVVsP/iVwuBPifdbkQI6Wg41C\nHf4f2NIXTaxVn/hSJCFOsBef4RG9ALsIyTDF72C7Ld3WMwIJ/UoPV8Cm11dO\nx6TecmkmsxKL6k6tUcQvw0ItzTtsAIZ2LzlLmy+DY7UKSWALJ8qZtjzeuNaN\n355ca0//aQvyp0v/XFoTk3rWQfdQf7QU8/ppeMS0xKGlqA0l0WE97Cnu4yET\nn7JoKNYMdk4ux39FbgcBTipb02TMEJqucat35EHN1F72xo5gjFy9hKmIqdDo\n1c3xqVhTeP8PWTYHUMyeHrYZQ4LrOZzsdBK5pwUok/0Q36rv7i1qPmXqpxNX\n1SR63l55lAKIvboM0iNq/5vinQwma6i7aB7r1IKXhkTakBeLESEekQvtRtSg\ng6aW99L2cNIJwIE9RvxPq1AQnPvk6Qnx+5i0vnj5AcDaLBHGoVGJ/zRnh6mZ\nUttb7cGqm2cPx2fb+vUgRhIGz0ExzTAKl2aOavwNgI1DP4AO1OPElsT2M6vt\nLy6WbWqjopsilWXe2tBHGPltvNHCRTnK91D6cTzBPaOIkU618aMsApXVvgNM\nVEZ3fF/KZK83HQMnf3Xy4pc/1LG8HFGG8jRsb+K1S155P2FGWG0p7op7baY4\nqlSX3sSiUwDzyqUjdTD/+LJ4xyK5Ppj66HOc4heFaNEmToK2623EgCur29Ck\niM5U\r\n=/f+U\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDJ3twLu/mCDrsxKDF9iMDC8uv4NFp8zgZJil00xGPdwgIhAJ1ZnXb8iVz/ZpbOF2aAqLmuXbo0djjnxIuQ0JffssAO"}]},"maintainers":[{"name":"doniseferi","email":"doni.seferi@gmail.com"}],"_npmUser":{"name":"doniseferi","email":"doni.seferi@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/suntimes_4.0.0-3_1578238480434_0.014718030148548333"},"_hasShrinkwrap":false,"deprecated":"not supported and may be prone to bugs, use v4.1.7 or higher"},"4.0.0-4":{"name":"suntimes","version":"4.0.0-4","description":"A simple library to get the exact date and time in utc for certain points of the day for any desired location and date.","main":"suntimes.js","scripts":{"bundle":"rimraf lib && rollup -c","test":"semistandard && nyc mocha --opts support/mocha.opts **/*.test.js","coverage":"nyc report --reporter=text-lcov | coveralls","fix":"semistandard --fix","pack":"npm run bundle && copyfiles README.md package.json License.md lib","release":"npm run pack && np --contents=lib"},"repository":{"type":"git","url":"git+https://github.com/doniseferi/suntimes.git"},"keywords":["sun","suntimes","equationOfTime","solar","declination","sunrise","sunset","twilight","dusk","dawn","maths","astronomy","celestial"],"author":{"name":"Edonis Seferi"},"license":"ISC","bugs":{"url":"https://github.com/doniseferi/suntimes/issues"},"homepage":"https://github.com/doniseferi/suntimes#readme","devDependencies":{"@babel/cli":"^7.7.0","@babel/core":"^7.7.0","@babel/preset-env":"^7.7.1","@babel/register":"^7.7.0","chai":"^4.2.0","copyfiles":"^2.1.1","coveralls":"^3.0.7","depcheck":"^0.9.0","eslint":"^6.6.0","eslint-config-semistandard":"^15.0.0","eslint-config-standard":"^14.1.0","eslint-plugin-import":"^2.18.2","eslint-plugin-node":"^10.0.0","eslint-plugin-promise":"^4.2.1","eslint-plugin-standard":"^4.0.1","jsdoc-to-markdown":"^5.0.2","mocha":"^6.2.2","nyc":"^14.1.1","rimraf":"^3.0.0","rollup":"^1.27.14","rollup-plugin-babel":"^4.3.3","rollup-plugin-terser":"^5.1.3","semistandard":"^14.2.0"},"readme":"\r\n\r\n
numberThe angular distance of the sun north or south of the earth's equator.
\r\nnumberGets the equation of time for the date instance. The correction between standard clock time and the time based on the exact position of the sun in the sky represented as decimal time in minutes (e.g. 5.5 equal 5 minutes and 30 seconds).
\r\nnumberGets the day of the year for the date instance.
\r\nnumberGets the hour angle difference between noon and the angle value.
\r\nnumberGets the noon hour angle for the date instance and longitude value.
\r\nstringGets the noon date and time in UTC for the date instance and longitude value.
\r\nstringGets the date and time at an angle before noon for the angle value, date instance, latitude and longitude value.
\r\nstringGets the date and time at an angle after noon for the angle value, date instance, latitude and longitude value.
\r\nstringGets the sunrise date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the sunset date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the end of civil dawn date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the start of civil dawn date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the end of nautical dawn date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the start of nautical dawn date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the end of astronomical dawn date and time in UTC for the date instance, latitude and longitude\r\nvalue.
\r\nstringGets the start of astronomical dawn date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the start of astronomical dusk date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the end of astronomical dusk date and time in UTC for the date instance, latitude and longitude\r\nvalue.
\r\nstringGets the end of nautical dusk date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the start of nautical dusk date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the end of civil dusk date and time in UTC for the date instance, latitude and longitude value.
\r\nstringGets the start of civil dusk date and time in UTC for the date instance, latitude and longitude value.
\r\nnumber\r\n\r\nThe angular distance of the sun north or south of the earth's equator.\r\n\r\n**Kind**: global variable\r\n**Returns**: number - The declination in degrees where north is a positive value and south is a negative value within a range of range of -23.45 and 23.45.\r\n\r\n| Param | Type | Description |\r\n| ----- | ----------------- | --------------- |\r\n| date | Date | A date instance |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getDeclinationOfTheSun(new Date(2019, 0, 1));\r\n```\r\n\r\n\r\n\r\n## equationOfTime ⇒ number\r\n\r\nGets the equation of time for the date instance. The correction between standard clock time and the time based on the exact position of the sun in the sky represented as decimal time in minutes (e.g. 5.5 equal 5 minutes and 30 seconds).\r\n\r\n**Kind**: global variable\r\n**Returns**: number - A number whose value is the equation of time in minutes decimal time for\r\nthe Date represented by date.\r\n\r\n| Param | Type | Description |\r\n| ----- | ----------------- | ---------------- |\r\n| date | Date | A date instance. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.equationOfTime(new Date(2019, 0, 1));\r\n```\r\n\r\n\r\n\r\n## getDayOfTheYear ⇒ number\r\n\r\nGets the day of the year for the date instance.\r\n\r\n**Kind**: global variable\r\n**Returns**: number - The day of the year, expressed as a value between 1 and 366 for the Date\r\ninstance represented by date.\r\n\r\n| Param | Type | Description |\r\n| ----- | ----------------- | ---------------- |\r\n| date | Date | A date instance. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getDayOfTheYear(new Date(2019, 0, 1));\r\n```\r\n\r\n\r\n\r\n## getHourAngleSinceNoon ⇒ number\r\n\r\nGets the hour angle difference between noon and the angle value.\r\n\r\n**Kind**: global variable\r\n**Returns**: number - A number whose value represents the hour angle since noon for the date instance, latitude and angle value.\r\n\r\n| Param | Type | Description |\r\n| -------- | ------------------- | ------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| angle | number | An angle value. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getHourAngleSinceNoon(new Date(2019, 0, 1), 51.476852, -0.833);\r\n```\r\n\r\n\r\n\r\n## getNoonHourAngle ⇒ number\r\n\r\nGets the noon hour angle for the date instance and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: number - The noon hour angle expressed as a number between 0.00 and 23.9.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getNoonHourAngle(new Date(2019, 0, 1), -0.0005);\r\n```\r\n\r\n\r\n\r\n## getNoonDateTimeUtc ⇒ string\r\n\r\nGets the noon date and time in UTC for the date instance and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing noon date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getNoonDateTimeUtc(new Date(2019, 0, 1), -0.0005);\r\n```\r\n\r\n\r\n\r\n## getDateTimeUtcOfAngleBeforeNoon ⇒ string\r\n\r\nGets the date and time at an angle before noon for the angle value, date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the time and date for an angle before noon in UTC,\r\nexpressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| angle | number | An angle value. |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getDateTimeUtcOfAngleBeforeNoon(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getDateTimeUtcOfAngleAfterNoon ⇒ string\r\n\r\nGets the date and time at an angle after noon for the angle value, date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the time and date for an angle after noon in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| angle | number | An angle value. |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getDateTimeUtcOfAngleAfterNoon(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getSunriseDateTimeUtc ⇒ string\r\n\r\nGets the sunrise date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing sunrise date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getSunriseDateTimeUtc(new Date(2019, 0, 1), 51.476852, -0.0005);\r\n```\r\n\r\n\r\n\r\n## getSunsetDateTimeUtc ⇒ string\r\n\r\nGets the sunset date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing sunset date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getSunsetDateTimeUtc(new Date(2019, 0, 1), 51.476852, -0.0005);\r\n```\r\n\r\n\r\n\r\n## getCivilDawnEndDateTimeUtc ⇒ string\r\n\r\nGets the end of civil dawn date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the end of civil dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getCivilDawnEndDateTimeUtc(new Date(2019, 0, 1), 51.476852, -0.0005);\r\n```\r\n\r\n\r\n\r\n## getCivilDawnStartDateTimeUtc ⇒ string\r\n\r\nGets the start of civil dawn date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the start of civil dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getCivilDawnStartDateTimeUtc(new Date(2019, 0, 1), 51.476852, -0.0005);\r\n```\r\n\r\n\r\n\r\n## getNauticalDawnEndDateTimeUtc ⇒ string\r\n\r\nGets the end of nautical dawn date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the end of nautical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getNauticalDawnEndDateTimeUtc(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getNauticalDawnStartDateTimeUtc ⇒ string\r\n\r\nGets the start of nautical dawn date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the start of nautical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getNauticalDawnStartDateTimeUtc(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getAstronomicalDawnEndDateTimeUtc ⇒ string\r\n\r\nGets the end of astronomical dawn date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the end of astronomical dawn date and time in UTC,\r\nexpressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getAstronomicalDawnEndDateTimeUtc(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getAstronomicalDawnStartDateTimeUtc ⇒ string\r\n\r\nGets the start of astronomical dawn date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the start of astronomical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getAstronomicalDawnStartDateTimeUtc(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getAstronomicalDuskStartDateTimeUtc ⇒ string\r\n\r\nGets the start of astronomical dusk date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the start of astronomical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getAstronomicalDuskStartDateTimeUtc(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getAstronomicalDuskEndDateTimeUtc ⇒ string\r\n\r\nGets the end of astronomical dusk date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the end of astronomical dusk date and time in UTC,\r\nexpressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getAstronomicalDuskEndDateTimeUtc(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getNauticalDuskEndDateTimeUtc ⇒ string\r\n\r\nGets the end of nautical dusk date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the end of nautical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getNauticalDuskEndDateTimeUtc(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getNauticalDuskStartDateTimeUtc ⇒ string\r\n\r\nGets the start of nautical dusk date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the start of nautical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getNauticalDuskStartDateTimeUtc(\r\n new Date(2019, 0, 1),\r\n 51.476852,\r\n -0.0005\r\n);\r\n```\r\n\r\n\r\n\r\n## getCivilDuskEndDateTimeUtc ⇒ string\r\n\r\nGets the end of civil dusk date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the end of civil dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getCivilDuskEndDateTimeUtc(new Date(2019, 0, 1), 51.476852, -0.0005);\r\n```\r\n\r\n\r\n\r\n## getCivilDuskStartDateTimeUtc ⇒ string\r\n\r\nGets the start of civil dusk date and time in UTC for the date instance, latitude and longitude value.\r\n\r\n**Kind**: global variable\r\n**Returns**: string - A string representing the start of civil dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --------- | ------------------- | ---------------------------------------------- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n\r\n```js\r\nsuntimes.getCivilDuskStartDateTimeUtc(new Date(2019, 0, 1), 51.476852, -0.0005);\r\n```\r\n","readmeFilename":"README.md","_id":"suntimes@4.0.0-4","_nodeVersion":"10.16.3","_npmVersion":"6.11.3","dist":{"integrity":"sha512-++olHXrhxKmaNzkeo73TEgEPtx0T8pJHrgHNA1jJttFhnklc3UwZL17MKEpD2ZVoe0iioHgXOQhehdwiP0IO5A==","shasum":"630f5b05c984244e22dcf647d2ac13d3305a6780","tarball":"https://registry.npmjs.org/suntimes/-/suntimes-4.0.0-4.tgz","fileCount":4,"unpackedSize":37499,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJeE5dqCRA9TVsSAnZWagAAKHQP/1IW+1EQTcJy9w2ZFewR\nINRunLV2iZDZYP2ufWASoeDW7UrJb9AtR3EZYphafc3A7XePsFmxu3UQJH3+\noODiagiBA2BguTBsjJ+QQUZK94AdNkR9hscA+J6fxzj0kbpHWG/jOn5Dnz7r\nfcv7l3joj5zqcuvoMsXGrifr2l+qb0QceZUnQ3n+5bf4iCrUazh68lz/lbhQ\nLkqAJSF4GaWhqPzzi5gt1N140b/twlG++JVgMq78sjQL71hOVHrwdugZafqZ\nRV2MAJlwn8SVX3B83ybcVc6W5hko44DG2N0Q6hmhdN/lWJNs3PMplFOMlOft\nAenCUXd4bsgZ6MrNMjEvkxyfg6NzwRrQOO6EKvYYEsNS0H3Qoc83vBSudCE5\njbMqpIVPm02tOalovrj0vM1DVCOBB0+f9jYloIyry1YsMX0QLfcclSJ++T1S\nE3T67bvaiUyUCmTFVXFd0V2SYaOSUAAdBZTEtPZA/8+IF0R30Y79Na5gZP9/\nJkleBQNwSjHz2BNw0rp5IpgiNXwi2GCX09E0HPZ4oufmGW5OUhIkKw5VR8h/\nyljRF8Hy2iaPbNLphdTmURZWuHMIc4hc5JcJugYlP3mPxYX9ahAHg+yaEEZj\nb3WJ+mapHQ1RCUEuVkYjXg2t7VO74c5k1VeluQjJpdUsUEEjeKPUvozjn57r\nLZb5\r\n=XiJU\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCICYsLo7eohteXh3Kg9CNcpmJhYBoLGPd9pU16ikDZPVDAiAbEPPbUHpOzbBg7nHEdNI1bCBfyvlxyshNJEjEzAtaOg=="}]},"maintainers":[{"name":"doniseferi","email":"doni.seferi@gmail.com"}],"_npmUser":{"name":"doniseferi","email":"doni.seferi@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/suntimes_4.0.0-4_1578342250194_0.5179483341926621"},"_hasShrinkwrap":false,"deprecated":"not supported and may be prone to bugs, use v4.1.7 or higher"},"4.0.0-5":{"name":"suntimes","version":"4.0.0-5","description":"A simple library to get the exact date and time in utc for certain points of the day for any desired location and date.","main":"suntimes.js","scripts":{"bundle":"rimraf lib && rollup -c","test":"semistandard && nyc mocha --opts support/mocha.opts **/*.test.js","coverage":"nyc report --reporter=text-lcov | coveralls","fix":"semistandard --fix","pack":"npm run bundle && copyfiles README.md package.json License.md lib","release":"npm run pack && np --contents=lib"},"repository":{"type":"git","url":"git+https://github.com/doniseferi/suntimes.git"},"keywords":["sun","suntimes","equationOfTime","solar","declination","sunrise","sunset","twilight","dusk","dawn","maths","astronomy","celestial"],"author":{"name":"Edonis Seferi"},"license":"ISC","bugs":{"url":"https://github.com/doniseferi/suntimes/issues"},"homepage":"https://github.com/doniseferi/suntimes#readme","devDependencies":{"@babel/cli":"^7.7.0","@babel/core":"^7.7.0","@babel/preset-env":"^7.7.1","@babel/register":"^7.7.0","chai":"^4.2.0","copyfiles":"^2.1.1","coveralls":"^3.0.7","depcheck":"^0.9.0","eslint":"^6.6.0","eslint-config-semistandard":"^15.0.0","eslint-config-standard":"^14.1.0","eslint-plugin-import":"^2.18.2","eslint-plugin-node":"^10.0.0","eslint-plugin-promise":"^4.2.1","eslint-plugin-standard":"^4.0.1","jsdoc-to-markdown":"^5.0.2","mocha":"^6.2.2","nyc":"^14.1.1","rimraf":"^3.0.0","rollup":"^1.27.14","rollup-plugin-babel":"^4.3.3","rollup-plugin-terser":"^5.1.3","semistandard":"^14.2.0"},"_id":"suntimes@4.0.0-5","_nodeVersion":"10.16.3","_npmVersion":"6.11.3","dist":{"integrity":"sha512-R8Ss5a3v0BMCwb9zbKT5wKdLN7megajR8BjijTtKcoPJYNMfjaRgM6ryTBAHz2Prm3+ygKvIDl5TS0JcmuN3EQ==","shasum":"3a7c0324aa1ee6abc40e86b0bebbddc7ad5aad27","tarball":"https://registry.npmjs.org/suntimes/-/suntimes-4.0.0-5.tgz","fileCount":4,"unpackedSize":37499,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJeE5l1CRA9TVsSAnZWagAAhS4QAI4BmxoTIqQGtij00qRA\nHUYUIXRWyCbpu8MpAHLkyFPhxExVPTXxNpKHbT+xzLJ4mnGq2K67B/mYoE8F\nbfzSDGDonLHiS+a5wd3GTuMyE/ipbSjulr12QQ9aBKZR3gD/h4Sx6F1O40XB\n+6Wlf2JV01369SHRBkf3KC7z4QHenKZRNVz1HY3B3y+SjngbJcuuGFq6wFdl\nZayhNVfGxiD7v4MndS0PVEENfW1Qd8RS71qAkYAdFxxrs9law0Oz44GqcBMn\nWGeVvIvgmULTC9oRR6LsAjMvEmhZbftpWnIYQ4RIDuzvFGaUUKzRI0Q4HoP1\nTUys46NbGVxVYYypDGJ+kZG/6Oxf+Od8G27uvQhN5Zk/pNy3G7GnnGNwQ0XF\nVh5oRNrspPRVGjwdZ9zF2RpgCD79hh0TugtAXSBC34Q5mJfWI0fWNqwNbhL8\nbujsg/cx1DkDVOZX5/G2KsaPjGCSt/ua4NoEqDdgKUsloBmDVJy0c5iMfedl\nsRkMWXIKzHfmlt0pVT/zv16DZX4O5pCW3p1INSp+pAeMcw6Sjn+myF85UvWW\nXDK6SrGK3lyxxgrrIQefCWOUCnCAJy00x97HXEAdYz14cdv2UEqLZCWHMXGg\nV9GL/QtV2qbuhNgXF0zzqMLcYmapexXbVJKaNCchJjldVwrjcUAKnZXne2kM\nwNVe\r\n=Wlgc\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIBVokYEglOJMA6O5P9c2ANYbjdu2dW3wBIqN2Hnd9WVRAiEA/E0yiYpv1Pghwih011qUt1kbA/DiWWQoDwBgh2rFN+c="}]},"maintainers":[{"name":"doniseferi","email":"doni.seferi@gmail.com"}],"_npmUser":{"name":"doniseferi","email":"doni.seferi@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/suntimes_4.0.0-5_1578342773012_0.03154908941178336"},"_hasShrinkwrap":false,"deprecated":"not supported and may be prone to bugs, use v4.1.7 or higher"},"4.0.0":{"name":"suntimes","version":"4.0.0","description":"A tiny library to get the exact date and time in utc for certain points of the day for any desired location and date.","main":"suntimes.js","scripts":{"bundle":"rimraf lib && rollup -c","test":"semistandard && nyc mocha --opts support/mocha.opts **/*.test.js","coverage":"nyc report --reporter=text-lcov | coveralls","fix":"semistandard --fix","pack":"npm run bundle && copyfiles README.md package.json License.md lib","release":"npm run pack && np --contents=lib"},"repository":{"type":"git","url":"git+https://github.com/doniseferi/suntimes.git"},"keywords":["sun","suntimes","equationOfTime","solar","declination","sunrise","sunset","twilight","dusk","dawn","maths","astronomy","celestial"],"author":{"name":"Edonis Seferi"},"license":"ISC","bugs":{"url":"https://github.com/doniseferi/suntimes/issues"},"homepage":"https://github.com/doniseferi/suntimes#readme","devDependencies":{"@babel/cli":"^7.7.0","@babel/core":"^7.7.0","@babel/preset-env":"^7.7.1","@babel/register":"^7.7.0","chai":"^4.2.0","copyfiles":"^2.1.1","coveralls":"^3.0.7","depcheck":"^0.9.0","eslint":"^6.6.0","eslint-config-semistandard":"^15.0.0","eslint-config-standard":"^14.1.0","eslint-plugin-import":"^2.18.2","eslint-plugin-node":"^10.0.0","eslint-plugin-promise":"^4.2.1","eslint-plugin-standard":"^4.0.1","jsdoc-to-markdown":"^5.0.2","mocha":"^6.2.2","nyc":"^14.1.1","rimraf":"^3.0.0","rollup":"^1.27.14","rollup-plugin-babel":"^4.3.3","rollup-plugin-terser":"^5.1.3","semistandard":"^14.2.0"},"_id":"suntimes@4.0.0","_nodeVersion":"10.16.3","_npmVersion":"6.11.3","dist":{"integrity":"sha512-XW4p+B6oztSqNhM8DSz2HXuL8wKY0Oz4cU92HaF0L70vXMwTFwV9lN/XYBeeEvhPNSBEJPeaylCvwaqrMpI2qQ==","shasum":"6b9c8c5bc2231872b83278f886fa25f606abe3b7","tarball":"https://registry.npmjs.org/suntimes/-/suntimes-4.0.0.tgz","fileCount":4,"unpackedSize":37495,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJeE6H/CRA9TVsSAnZWagAA03QP/A9kowmobCw6eEAxamgB\n16rWGLeMHgIGI79apnumaiuradXUefv1EMv/m0mERO0zs5F5Up/m92v1OStr\nLoGbfccSsRVSn9yeADJsCqR6iKadG++T2bDD+QPqiZ1IuE1351b5zR4ck7Pl\nt4MxMdvhuVOk/kZqWp0EenvfDiuP1edWVFL6xLMsnO2GYqYS1MoRJ1Houopw\nlKA6IFdQ2DzI9h60wuIl4LDH2NW5MQkEBHBtGv+XJJUBVJMY2lXwFvYNt0t8\nWcctHLkIf6qC1AS1kMSbdnHyMHYY7KlbaeaxBOAVMYPNCqQlSJaD/5JXmR3N\nY9ez9Y9lNv83Nl327sYvhoufDBPfKm3zPC2xwD0sVxxpVTqeDLpo8/zvCqaR\n2O2L4/z0oA0kY7c+FuQjKF0xB3kf5EhDXS1hSTyLQApLf9Ur68KnVXJZF9gu\nSjpweAt0QbfpFzN3vi371RcDbW+sfwoSRZYKzujPW/gQSzW6Rnaiv7x0j/Yx\nC9qskSVDvKwnhgT+bweABwFxzmt/CTg/c7VnsmI24S1TwoFNlzGTuLf5WG4F\n6CK2dwUwNeI9hsc5IOxzT5AKFcQdSSIwni1ble6GdXuhWw7Vo3qWFkJUlQ6j\nJ9Qm88fFDiX1Enld3LYzxn7/+n5ZQYoUJMk0Buu+tPLcAn+sbPcRRTKEQYiH\nMbUp\r\n=s5zQ\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDLUmj4U+h4c6CeSaaAZ1Bp9T+oYX6Ri0ZPyCO6zRUDCQIgP2z4xvEEKSFyYGfmhSVoglKULhJfhmPzwlw5K+EqLEQ="}]},"maintainers":[{"name":"doniseferi","email":"doni.seferi@gmail.com"}],"_npmUser":{"name":"doniseferi","email":"doni.seferi@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/suntimes_4.0.0_1578344959178_0.3106944019789688"},"_hasShrinkwrap":false,"deprecated":"Not supported. Please use v4.1.7 or above"},"4.0.1":{"name":"suntimes","version":"4.0.1","description":"A tiny library to get the exact date and time in utc for certain points of the day for any desired location and date.","main":"suntimes.js","scripts":{"bundle":"rimraf lib && rollup -c","test":"semistandard && nyc mocha --opts support/mocha.opts **/*.test.js","coverage":"nyc report --reporter=text-lcov | coveralls","fix":"semistandard --fix","pack":"npm run bundle && copyfiles README.md package.json License.md lib","release":"npm run pack && np --contents=lib"},"repository":{"type":"git","url":"git+https://github.com/doniseferi/suntimes.git"},"keywords":["sun","suntimes","equationOfTime","solar","declination","sunrise","sunset","twilight","dusk","dawn","maths","astronomy","celestial"],"author":{"name":"Edonis Seferi"},"license":"ISC","bugs":{"url":"https://github.com/doniseferi/suntimes/issues"},"homepage":"https://github.com/doniseferi/suntimes#readme","devDependencies":{"@babel/cli":"^7.7.0","@babel/core":"^7.7.0","@babel/preset-env":"^7.7.1","@babel/register":"^7.7.0","chai":"^4.2.0","copyfiles":"^2.1.1","coveralls":"^3.0.7","depcheck":"^0.9.0","eslint":"^6.6.0","eslint-config-semistandard":"^15.0.0","eslint-config-standard":"^14.1.0","eslint-plugin-import":"^2.18.2","eslint-plugin-node":"^10.0.0","eslint-plugin-promise":"^4.2.1","eslint-plugin-standard":"^4.0.1","jsdoc-to-markdown":"^5.0.2","mocha":"^6.2.2","nyc":"^14.1.1","rimraf":"^3.0.0","rollup":"^1.27.14","rollup-plugin-babel":"^4.3.3","rollup-plugin-terser":"^5.1.3","semistandard":"^14.2.0"},"_id":"suntimes@4.0.1","_nodeVersion":"10.16.3","_npmVersion":"6.11.3","dist":{"integrity":"sha512-4xc3ZURxzyj5AgXMxCZEP/VIF6xgf7vS7nDujuKZ0onTcXlE8ZmuTLC4oMX4zSjcNYQFw34xcWnJlnFv60oROg==","shasum":"c67cac3925e39cacd1b8b92f04fa4e51d251dfbe","tarball":"https://registry.npmjs.org/suntimes/-/suntimes-4.0.1.tgz","fileCount":4,"unpackedSize":37495,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJeFGyWCRA9TVsSAnZWagAA4oYP/33GAJSpYMzP4wsUAB83\nYCQZba8CoBZUruUmvVPFH2kZlQcSL+Y0IgdB+VX06XXre+H9fB8CcSiK4/sr\nSL7659AsdMEfsoQPcpdw9s9ldMcNWHkA17xyfpkv0FIt3g7yqqAckfct/C3g\nxEhU/5GXGtvgAkg23byr0Xu8H+cpzjGCProjpiRJWPqeOwjx9pdhn44xUyVD\nPv0zGD9X09cFn+v1jDexfSBlXyiOGTFL4Ttl/xr5ItJsxab1IILV3Je7TZVC\nPDW68Hma658d/WftBwiCNmfI0nJnvkq3euLgBDvwjh+E5K3X6sXMo31P+fUj\nSmOCyFXrgR//KhELIgnfejKUIU56jlfflGaQKGK5WA+WHT4K7yw+uytlJ+6h\nAqdHeB6yz0FgLsyS5EXrE5YzFatG5NP7BNSVYv4py2/3MPLEFMJHqwFGyTwN\nVTUO8BajJXKzgffYALcR3RBBU6c9O172RiDXGQ1ezxYqE2hpZRF0OfcUj5IZ\nskekqci5mYbE75jaQClPIy6rHC6ypE5LeJTMTFhvtNCOyZ0grcEcM5920Tzf\n16hkElAHJOInHT99eOnz/xAr1bMLWcILglByovlbpw7TGE6h/avEU/kXfJz+\njGapR8Hj2gIe6ZLD7t3zIYBAqCThYJlViFV1F4/mvip5xxtZLLuxpKGlh8nr\n6d/3\r\n=LY4I\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCaTVVUbCjO++LYtRT2pw27w3325+PQV8xyARzPbUkbawIgallKTTBV5/M8JRiUEid1XrO7NjwfmlLChxZj2mEtT74="}]},"maintainers":[{"name":"doniseferi","email":"doni.seferi@gmail.com"}],"_npmUser":{"name":"doniseferi","email":"doni.seferi@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/suntimes_4.0.1_1578396821473_0.5879054993864117"},"_hasShrinkwrap":false,"deprecated":"Not supported. Please use v4.1.7 or above"},"4.1.2":{"name":"suntimes","version":"4.1.2","description":"A tiny library to get the exact date and time in utc for certain points of the day for any desired location and date.","main":"suntimes.js","typings":"suntimes.d.ts","scripts":{"build":"rollup -c","release":"standard-version","coverage":"nyc report --reporter=text-lcov | coveralls","test":"semistandard && nyc mocha --opts support/mocha.opts **/*.test.js","fix":"semistandard --fix"},"repository":{"type":"git","url":"git+https://github.com/doniseferi/suntimes.git"},"keywords":["sun","suntimes","equationOfTime","solar","declination","sunrise","sunset","twilight","dusk","dawn","maths","astronomy","celestial"],"author":{"name":"Edonis Seferi"},"license":"ISC","bugs":{"url":"https://github.com/doniseferi/suntimes/issues"},"homepage":"https://github.com/doniseferi/suntimes#readme","devDependencies":{"@babel/core":"^7.7.0","@babel/preset-env":"^7.7.1","@babel/register":"^7.7.0","chai":"^4.2.0","coveralls":"^3.0.7","depcheck":"^0.9.1","eslint":"^6.6.0","eslint-config-semistandard":"^15.0.0","eslint-config-standard":"^14.1.0","eslint-plugin-import":"^2.18.2","eslint-plugin-node":"^10.0.0","eslint-plugin-promise":"^4.2.1","eslint-plugin-standard":"^4.0.1","mocha":"^6.2.2","nyc":"^14.1.1","rollup":"^1.27.14","rollup-plugin-babel":"^4.3.3","rollup-plugin-terser":"^5.1.3","semistandard":"^14.2.0","standard-version":"^7.0.1"},"dependencies":{},"gitHead":"c8f4409c89a6aac65fa8c8e8e6d7a392c4dc1438","_id":"suntimes@4.1.2","_nodeVersion":"10.16.3","_npmVersion":"6.11.3","dist":{"integrity":"sha512-poPtg6rPwQJqAoxq8YiA1NP2TWHBzfm2C5Qs38BnzOLXL+kWP2naWewUUTeFgrRPChxphvHUIeo4HAoYTGHUBw==","shasum":"512bcc52546a44d4fd43cad9f46cc888e345f0fe","tarball":"https://registry.npmjs.org/suntimes/-/suntimes-4.1.2.tgz","fileCount":5,"unpackedSize":47353,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJeIkHCCRA9TVsSAnZWagAAIvYQAKFEEo2PhsIWRIDzwnGW\nC5yWwD0Df6eR7xPib1EduLN4LVxAgAVqcpyRRvXeNeH9KdH/f1sfua6CAJqj\nLZ9dC4mgwY6Yx54DFiu7BnZlR/TPFCO9VqxJO/c2mGW/VGS0CF7ILbY9JHmc\nPZBMPSIbkcjZxdQce9tYhfsISNURhLlUj4MHRNWH2pZ98YowE/vzsd2pgaCE\n5RnYquhYWK5Ko1u3TeQC0Z+k5BrcSISdIRzWzfMUcKXyufSzVYQg3XQFZTvA\nJa01ds0ewSS/7LIYwGeeOKnw5/WOm0xwMbUQuezpb5mg67BdqPoR7rH/i0Xm\ncwBT78JJaKo3qwFBCMoZVROa57acJyID7vRx3j5EppYXdNSwYn/p96CyoYgt\nzG0Biwj8JneX66dgOT0b3tPtrFPC2+0S/ZVFQQ0XjmXY0j/jPKlxnvr9WFPM\nAkixdzOH5PnxLotSvJUxsG1hTstdbFi8y9GJ8nEgkVsOhNPdqRejK5YgSCC3\nHvSbsOxklSMZV03DVg4mRtPs1Im4ld8b18/UTUZ9PrKw6CGm3NoTF/KmeEZV\nBosJcEpcLUhkss3GKD5fCeC43UVhxbBhd/us2r24ttj6rvStqLYDJtrzkj9j\nX2cm78fkSJ9aWhMaIm8jTVEDjNMmpaG6nXZg78Uq+MH1GBifY7PhPz3QQfqt\nelIf\r\n=Ts6J\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDSXOpTmbh0SSt/O7GDHD8l11AyEqXiX0KYMAQ5xOvppwIgar7nLUk0sM2Ro2ptKAjRcFOhKoZUypTNTR8WPP/o30s="}]},"maintainers":[{"name":"doniseferi","email":"doni.seferi@gmail.com"}],"_npmUser":{"name":"doniseferi","email":"doni.seferi@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/suntimes_4.1.2_1579303361820_0.5140134382499262"},"_hasShrinkwrap":false,"deprecated":"Not supported. Please use v4.1.7 or above"},"4.1.4":{"name":"suntimes","version":"4.1.4","description":"A tiny library to get the exact date and time in utc for certain points of the day for any desired location and date.","main":"suntimes.js","typings":"suntimes.d.ts","scripts":{"build":"rollup -c","release":"standard-version","coverage":"nyc report --reporter=text-lcov | coveralls","test":"semistandard && nyc mocha --opts support/mocha.opts **/*.test.js","fix":"semistandard --fix"},"repository":{"type":"git","url":"git+https://github.com/doniseferi/suntimes.git"},"keywords":["sun","suntimes","equationOfTime","solar","declination","sunrise","sunset","twilight","dusk","dawn","maths","astronomy","celestial"],"author":{"name":"Edonis Seferi"},"license":"ISC","bugs":{"url":"https://github.com/doniseferi/suntimes/issues"},"homepage":"https://github.com/doniseferi/suntimes#readme","devDependencies":{"@babel/core":"^7.7.0","@babel/preset-env":"^7.7.1","@babel/register":"^7.7.0","chai":"^4.2.0","coveralls":"^3.0.7","depcheck":"^0.9.1","eslint":"^6.6.0","eslint-config-semistandard":"^15.0.0","eslint-config-standard":"^14.1.0","eslint-plugin-import":"^2.18.2","eslint-plugin-node":"^10.0.0","eslint-plugin-promise":"^4.2.1","eslint-plugin-standard":"^4.0.1","mocha":"^6.2.2","nyc":"^14.1.1","rollup":"^1.27.14","rollup-plugin-babel":"^4.3.3","rollup-plugin-terser":"^5.1.3","semistandard":"^14.2.0","standard-version":"^7.0.1"},"dependencies":{},"gitHead":"d0925e1832186e530b4f1be496e74eda28525953","_id":"suntimes@4.1.4","_nodeVersion":"10.16.3","_npmVersion":"6.11.3","dist":{"integrity":"sha512-Ran9oUblsQ+6XKh+fGQY4dm3RcNVn8erAaMwWwwGzXK8QzkxxBm1IJu+BYPV2t9eJb4Mep9GNJL3KaCJTLdqPw==","shasum":"c8b609514add51dc39f7561c7ccb2235b3ea994d","tarball":"https://registry.npmjs.org/suntimes/-/suntimes-4.1.4.tgz","fileCount":6,"unpackedSize":48879,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJeaoy9CRA9TVsSAnZWagAAqmIP+wfSVO1Nbvos7PRYlnBl\nvqdkogj5/4o5AfbYCj7WGw95P4z+oFekda61njjmw1P+OpDo9KEQ4gYQXXIT\n+VQjkgUvMcwALL05JV6dMeFhKFWMzuhlRfoMZd+NkjSxGfcVNuAjDEb7iG/y\nEEpRb4amK4OuSjfeXm4HczLJyAdvbQoWxvv5vHpGebV1lTh7gw0SSkEh+svg\nnfjnqG4i0WtOJolNMAqTUY0rFtHDIXs8k7K/65kT+1xVuz87QzxmvOPd+JtR\njgB8Ogunk7usjfqlH6kIz12s+8c86MAQEj6J3ciIFUCorBWhUUZ0KKmysgyo\ngtfdZY6gFBBx0xEgXQj29iBR76d4KE1OJ94SFHhfqNlKSxSv5wkCxWpSnYYs\n+vNyRiYtWxmWMyrYlDsVQFVb82XvpunTCMxl20HipINkR2PHXBvDuwj5eD5r\nxm0EftOqkb6szxD0jzRouZgzn4HURsvi+T6TUegUSTfCa92fZNGMd0cVFHba\ncQOr0w8KNNDde1VJc0kHz3yp9+1zRNkzcIrBVM6XDA7VI5CSSUy/ZCQtVxST\nu/5PqseOYXAx/Ai/VtYnjlrz41apzgI2uKtWYTsiXrahIYln/r70TYcIfT2e\npGYoNq/cFCXjxRCnkEr0JEDXG+TqtC5m8r2UH/MmnEXqjQmwBEZBMnrh0bNE\nYMkk\r\n=ams6\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCNO/riqXcnweuMmmEUVS+7KzfB+c55dgn2dsba85sn0wIgOsSunCPBWbzIctOuUt8znqKBaM9G6H710S9NPWMC8/s="}]},"maintainers":[{"name":"doniseferi","email":"doni.seferi@gmail.com"}],"_npmUser":{"name":"doniseferi","email":"doni.seferi@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/suntimes_4.1.4_1584041148678_0.04957227515172935"},"_hasShrinkwrap":false,"deprecated":"BUG: high latitude locations where certain events persist throughout the night/day/week/month was incorrectly returning a datetime value. This is due to the introduction of the inverse cosine function that is able to handle complex numbers. Previous versions and versions at or above 4.1.7 correctly return an Invalid Date when those events do not happen. Please use v4.1.7 and above"},"4.1.5":{"name":"suntimes","version":"4.1.5","description":"A tiny library to get the exact date and time in utc for certain points of the day for any desired location and date.","main":"suntimes.js","typings":"suntimes.d.ts","scripts":{"build":"rollup -c","release":"standard-version","coverage":"nyc report --reporter=text-lcov | coveralls","test":"semistandard && nyc mocha --opts support/mocha.opts **/*.test.js","fix":"semistandard --fix"},"repository":{"type":"git","url":"git+https://github.com/doniseferi/suntimes.git"},"keywords":["sun","suntimes","equationOfTime","solar","declination","sunrise","sunset","twilight","dusk","dawn","maths","astronomy","celestial"],"author":{"name":"Edonis Seferi"},"license":"ISC","bugs":{"url":"https://github.com/doniseferi/suntimes/issues"},"homepage":"https://github.com/doniseferi/suntimes#readme","devDependencies":{"@babel/core":"^7.7.0","@babel/preset-env":"^7.7.1","@babel/register":"^7.7.0","chai":"^4.2.0","coveralls":"^3.0.7","depcheck":"^0.9.1","eslint":"^6.6.0","eslint-config-semistandard":"^15.0.0","eslint-config-standard":"^14.1.0","eslint-plugin-import":"^2.18.2","eslint-plugin-node":"^10.0.0","eslint-plugin-promise":"^4.2.1","eslint-plugin-standard":"^4.0.1","mocha":"^6.2.2","nyc":"^14.1.1","rollup":"^1.27.14","rollup-plugin-babel":"^4.3.3","rollup-plugin-terser":"^5.1.3","semistandard":"^14.2.0","standard-version":"^7.0.1"},"dependencies":{},"gitHead":"b9a42c1b3c965e4c7571c0334c24c77ccc6a9c60","_id":"suntimes@4.1.5","_nodeVersion":"10.16.3","_npmVersion":"6.11.3","dist":{"integrity":"sha512-ruzJ6ITTmNnUFN9gLsDA7VHKhQjUEZc4Eu/Pfl+N9npAMmVdmZdAZ0Wn/a/vIr6A0B5w227vUDiOJcAlxQAgYA==","shasum":"3ab5930b3dd79de0b2aca17ed59a844313938ab3","tarball":"https://registry.npmjs.org/suntimes/-/suntimes-4.1.5.tgz","fileCount":6,"unpackedSize":48965,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJeao6DCRA9TVsSAnZWagAAiX4P/A9s6J4P1DwEh/YBFfjq\nIGFYvitT06NDaKveoAW980sWvEkc1u7kLRRnpD38badtLUeQTafB4IKlPVjX\nM65Gz3mRpU7apQbfjPIoAtWX69WcDiSuEdwGLlB4WHB2kJBHWxYyCjBMckD3\ndxaA+v3ZFpG4bRQTNt3MG+xKJ2RnGWiijoNxJ8lzuzWz0lLjm4cO20xHxPfP\n1vYBMnpbXU9K8c0K4PG2YH9Wq31wavXkUBKOqQ72RkzWI8klNgiFesp+2xl5\niFUo11nvswk0FR2ajavuZpM8MITmtQ4zqGHx8mXvH4kqmD76BoOw8V5JXXzE\n9a+QBzTvsrGtOASO3asUF0tqn/AoP+S2ph4RqNsGop8ojj2PwM4e71ekS4/7\nVqtDiF/vqUfTHZ7ai7ZvlqqDNCFtz1bVuRTFzW0j9btxC1Fgpf2OSyX7XvbI\nNOSkyJG/Hbz8cdzNgQciCBNcvAp83sVFupDBEWyyefy+b3+1xbjK9Szp5zrI\nhMcKgOtKcxsrrHNmDIVmA1aWOdkHd3pVDXzo+iZ6ZWAjg2t7TH3B0rA3qbxU\n8qEmw6kFWbH4pkV97fNL3/ZCYZeIGJQ9j3nhNUoZMHBI1VfOGuMv2WeQaJw6\nPhRPGtOH/rL16uwB0O0GGQzLzmOIYuXduMHzLq4TJswBY3vCxc9ibSJlGwLs\nsSO4\r\n=0tmn\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCN4l9aT3R+4uf8KddmXWL0QBvnp0ABLIN+HEY5gIsz+QIhAKivv11TAEsvk3gKt7wJJx1BLIDmMhltXPSCf9HDGBjJ"}]},"maintainers":[{"name":"doniseferi","email":"doni.seferi@gmail.com"}],"_npmUser":{"name":"doniseferi","email":"doni.seferi@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/suntimes_4.1.5_1584041602873_0.6358133995557449"},"_hasShrinkwrap":false,"deprecated":"BUG: high latitude locations where certain events persist throughout the night/day/week/month was incorrectly returning a datetime value. This is due to the introduction of the inverse cosine function that is able to handle complex numbers. Previous versions and versions at or above 4.1.7 correctly return an Invalid Date when those events do not happen. Please use v4.1.7 and above"},"4.1.6":{"name":"suntimes","version":"4.1.6","description":"A tiny library to get the exact date and time in utc for certain points of the day for any desired location and date.","main":"suntimes.js","typings":"suntimes.d.ts","scripts":{"build":"rollup -c","release":"standard-version","coverage":"nyc report --reporter=text-lcov | coveralls","test":"semistandard && nyc mocha --opts support/mocha.opts **/*.test.js","fix":"semistandard --fix"},"repository":{"type":"git","url":"git+https://github.com/doniseferi/suntimes.git"},"keywords":["sun","suntimes","equationOfTime","solar","declination","sunrise","sunset","twilight","dusk","dawn","maths","astronomy","celestial"],"author":{"name":"Edonis Seferi"},"license":"ISC","bugs":{"url":"https://github.com/doniseferi/suntimes/issues"},"homepage":"https://github.com/doniseferi/suntimes#readme","devDependencies":{"@babel/core":"^7.7.0","@babel/preset-env":"^7.7.1","@babel/register":"^7.7.0","chai":"^4.2.0","coveralls":"^3.0.7","depcheck":"^0.9.1","eslint":"^6.6.0","eslint-config-semistandard":"^15.0.0","eslint-config-standard":"^14.1.0","eslint-plugin-import":"^2.18.2","eslint-plugin-node":"^10.0.0","eslint-plugin-promise":"^4.2.1","eslint-plugin-standard":"^4.0.1","mocha":"^6.2.2","nyc":"^14.1.1","rollup":"^1.27.14","rollup-plugin-babel":"^4.3.3","rollup-plugin-terser":"^5.1.3","semistandard":"^14.2.0","standard-version":"^7.0.1"},"dependencies":{},"gitHead":"7727ee7b25671d81984c25b2b6eed08d68ecdc4e","_id":"suntimes@4.1.6","_nodeVersion":"10.16.3","_npmVersion":"6.11.3","dist":{"integrity":"sha512-Ufivh9mofXKzCioQyosHbrhx0vZG0QyRnXJmM68rapY1NnZoct4xiFJ/uFjcR0Xq3ODl9YtsDVvtQ5UrUf1HCg==","shasum":"71469c3712f6a55bdc838619ec19226b42e5765d","tarball":"https://registry.npmjs.org/suntimes/-/suntimes-4.1.6.tgz","fileCount":6,"unpackedSize":49055,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJebi1rCRA9TVsSAnZWagAAd2UP/3cWuDggVH4Korj7np4Y\nzmNS1Yob6yagiJ0JkXOzYGESzqI8fJuNJ/MT+vOQ/E/a95XVLfRnmGj/NRmI\navKxGbO3CSgHKA6SLf4Tq9StyXRcjSqPax0wWnuuQxBTYYD6PMAcSwDCbdT/\nfGINn4L54ZibHbxF99j0l6Yr1+LZBcF7elq+rLKST4/qJdj9mSs0Sq/Djshs\nn+9CtiwynxbBOcBjfIv4JyQUJGlLNi2bY5TrKLu980MDBJQQ8ip26E+9YHnv\nl1GNZxRXPbthFAsAwrWQF3qIRc4cL82odMO0JVO6qUu0nS/hIrLxjnhAKLY+\nIGxa8BX3nqtBg1fzC9REqEkHOqFmgLYXWANDilU90MsVl/flnWTYH1LCM7Tv\nWrDmoJDi5BMSd77teLFkq3Mgkb6o3hDBB0Z346vpnuohy6sPWunWZpVZ4XyL\nQv89EqYCJrdkiXDTSwwkVVYQq0qGMN/9/xcmM9/XrST2UxXf588XWzCz3XVI\njCpnLbhxgpoqkskWcGyOdQU0jFDG32A3OS8mUPzeSp7LeCL5yZ0PEeVGkV4q\n+q1dzI4SbRIM/L5DPbB0+OqY5SgamVa6ACZB/gD41FLj+60ytPiYdnS6WpQe\nZHjD45We3FDpky8Hg2A077jV/CdfOHPo+bSxXlR8V1Mqbjd2MA4oTRfpOM43\n0pwB\r\n=tYVj\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDYHta63Z4YJ9cS37d0OSfsJ02LzCCCDUuwM1OsPrOzdwIhAK+RKjxTd8Swc6pDSZcwo37P22w5bWUsLKOB87sQjgVI"}]},"maintainers":[{"name":"doniseferi","email":"doni.seferi@gmail.com"}],"_npmUser":{"name":"doniseferi","email":"doni.seferi@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/suntimes_4.1.6_1584278891262_0.5598529743586751"},"_hasShrinkwrap":false,"deprecated":"BUG: high latitude locations where certain events persist throughout the night/day/week/month was incorrectly returning a datetime value. This is due to the introduction of the inverse cosine function that is able to handle complex numbers. Previous versions and versions at or above 4.1.7 correctly return an Invalid Date when those events do not happen. Please use v4.1.7 and above"},"4.1.7":{"name":"suntimes","version":"4.1.7","description":"A tiny library to get the exact date and time in utc for certain points of the day for any desired location and date.","main":"suntimes.js","typings":"suntimes.d.ts","scripts":{"build":"rollup -c","release":"standard-version","coverage":"nyc report --reporter=text-lcov | coveralls","test":"semistandard && nyc mocha --opts support/mocha.opts **/*.test.js","fix":"semistandard --fix"},"repository":{"type":"git","url":"git+https://github.com/doniseferi/suntimes.git"},"keywords":["sun","suntimes","equationOfTime","solar","declination","sunrise","sunset","twilight","dusk","dawn","maths","astronomy","celestial"],"author":{"name":"Edonis Seferi"},"license":"ISC","bugs":{"url":"https://github.com/doniseferi/suntimes/issues"},"homepage":"https://github.com/doniseferi/suntimes#readme","devDependencies":{"@babel/core":"^7.7.0","@babel/preset-env":"^7.7.1","@babel/register":"^7.7.0","chai":"^4.2.0","coveralls":"^3.0.7","depcheck":"^0.9.1","eslint":"^6.6.0","eslint-config-semistandard":"^15.0.0","eslint-config-standard":"^14.1.0","eslint-plugin-import":"^2.18.2","eslint-plugin-node":"^10.0.0","eslint-plugin-promise":"^4.2.1","eslint-plugin-standard":"^4.0.1","mocha":"^6.2.2","nyc":"^14.1.1","rollup":"^1.27.14","rollup-plugin-babel":"^4.3.3","rollup-plugin-terser":"^5.1.3","semistandard":"^14.2.0","standard-version":"^7.0.1"},"dependencies":{},"gitHead":"77c7b8198e3da2bbbd3ac51cd880c945c8acf95e","_id":"suntimes@4.1.7","_nodeVersion":"12.16.1","_npmVersion":"6.8.0","dist":{"integrity":"sha512-QHM+0NSbO7IJpCsrQswcBysPEdFCgA3stTGmKyrV1xFeu6Rti3Sty+C3eskN3SDsXOlJ1FA7fdHTPNuYCC1yWQ==","shasum":"d1cf57a86a1ab0a77f66b4d979b679440d6af017","tarball":"https://registry.npmjs.org/suntimes/-/suntimes-4.1.7.tgz","fileCount":6,"unpackedSize":48013,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJef8oZCRA9TVsSAnZWagAAyE8P/3LZpowsjclgHz8JJIDP\nqWyqefxEYaNUss8K+juVUA9lTvvN3kDJ5FuIxy7712LQMucwGtc1OZUEddo8\n4P6aw+BDEMChW+gqDbRVhh1fwWdlGeiTZYS5iMJmXTt14cs5wnsEGN3MY6IA\n9uvDwhvRuBvji8KMoZCoJDL8mTwN+EtxG3v6tkLn6xCPbo1SUQjKrW+CDCoE\nmacZ0mWqWgX4x2c9WkQ3u+Q0MhsIKFxW3UXgbu+H5DMExII2Jpk6CvWgGZiR\n5s0ocKmoOS/FtmL16xxyWm0afwqoWoTYCcAXSQoXmMcK3MPB7dgKtkebjjkN\nkDSZIMn8bSTjv1lCym3Z5lE9PWJdHGYW02DUER0mT2GqF4tqlLnQhcDMyDrA\nfg/OazE+JQw0COJLSH3lc7jixkrnZAaL+rFXDmBXc21e1GcP/Hrr9j3szSGu\n+rJHQfqtMjCEkh2xUP3cR57VPOwRT8aF6Qbh2Dhg62NHR0l7jHvoOBH+iVEI\nu23l6Fdd0YcKEfG0uC7J0QtbKWQuLb2NNdlBlPxyWTwmqZ5jWVCwfXtoMzPP\n5pL4A3ftAzxhltQ86U5A8T5EZrxriz5jZKa8VMjWsAfWogNI9W+9xrwCumsQ\ndFyNB1LlegFn8bkrL79lNxi+1VD2xTzM2eVK1Jbri6CzM+uhb7ud3PXfjTqa\n3tVY\r\n=CKO3\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIHRRN8GKTY1TLYkYSjcJCFetc11/q73zHQNNIP+76jk9AiEAmO2qCUnCCKUuYOCIJ5PIwVxiq30/+wZF8fi4Mpx8mN4="}]},"maintainers":[{"name":"doniseferi","email":"doni.seferi@gmail.com"}],"_npmUser":{"name":"doniseferi","email":"doni.seferi@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/suntimes_4.1.7_1585433113105_0.3312730927719758"},"_hasShrinkwrap":false},"4.1.8-1":{"name":"suntimes","version":"4.1.8-1","description":"A tiny library to get the exact date and time in utc for certain points of the day for any desired location and date.","main":"suntimes.js","typings":"suntimes.d.ts","scripts":{"typedef":"jsdoc -t node_modules/tsd-jsdoc/dist -r ./src/index.js","readme":"jsdoc2md ./src/index.js","build":"rollup -c","release":"standard-version","coverage":"nyc report --reporter=text-lcov | coveralls","test":"semistandard && npm run build && nyc mocha --opts support/mocha.opts **/*.test.js","fix":"semistandard --fix"},"repository":{"type":"git","url":"git+https://github.com/doniseferi/suntimes.git"},"keywords":["sun","suntimes","equationOfTime","solar","declination","sunrise","sunset","twilight","dusk","dawn","maths","astronomy","celestial"],"author":{"name":"Edonis Seferi"},"license":"ISC","bugs":{"url":"https://github.com/doniseferi/suntimes/issues"},"homepage":"https://github.com/doniseferi/suntimes#readme","devDependencies":{"@babel/core":"^7.9.0","@babel/preset-env":"^7.9.0","@babel/register":"^7.9.0","chai":"^4.2.0","coveralls":"^3.0.11","depcheck":"^0.9.2","eslint":"^6.8.0","eslint-config-semistandard":"^15.0.0","eslint-config-standard":"^14.1.1","eslint-plugin-import":"^2.20.2","eslint-plugin-node":"^10.0.0","eslint-plugin-promise":"^4.2.1","eslint-plugin-standard":"^4.0.1","jsdoc":"^3.6.4","jsdoc-to-markdown":"^5.0.3","mocha":"^6.2.3","nyc":"^14.1.1","rollup":"^1.32.1","rollup-plugin-babel":"^4.4.0","rollup-plugin-terser":"^5.3.0","semistandard":"^14.2.0","standard-version":"^7.1.0","tsd-jsdoc":"^2.4.0"},"dependencies":{},"readme":"\r\n\r\n
number\r\n * [~equationOfTime(date)](#module_suntimes..equationOfTime) ⇒ number\r\n * [~getHourAngleSinceNoon(date, latitude, angle)](#module_suntimes..getHourAngleSinceNoon) ⇒ number\r\n * [~getNoonHourAngle(date, longitude)](#module_suntimes..getNoonHourAngle) ⇒ number\r\n * [~getNoonDateTimeUtc(date, longitude)](#module_suntimes..getNoonDateTimeUtc) ⇒ string\r\n * [~getDateTimeUtcOfAngleBeforeNoon(angle, date, latitude, longitude)](#module_suntimes..getDateTimeUtcOfAngleBeforeNoon) ⇒ string\r\n * [~getDateTimeUtcOfAngleAfterNoon(angle, date, latitude, longitude)](#module_suntimes..getDateTimeUtcOfAngleAfterNoon) ⇒ string\r\n * [~getSunriseDateTimeUtc(date, latitude, longitude)](#module_suntimes..getSunriseDateTimeUtc) ⇒ string\r\n * [~getSunsetDateTimeUtc(date, latitude, longitude)](#module_suntimes..getSunsetDateTimeUtc) ⇒ string\r\n * [~getCivilDawnEndDateTimeUtc(date, latitude, longitude)](#module_suntimes..getCivilDawnEndDateTimeUtc) ⇒ string\r\n * [~getCivilDawnStartDateTimeUtc(date, latitude, longitude)](#module_suntimes..getCivilDawnStartDateTimeUtc) ⇒ string\r\n * [~getNauticalDawnEndDateTimeUtc(date, latitude, longitude)](#module_suntimes..getNauticalDawnEndDateTimeUtc) ⇒ string\r\n * [~getNauticalDawnStartDateTimeUtc(date, latitude, longitude)](#module_suntimes..getNauticalDawnStartDateTimeUtc) ⇒ string\r\n * [~getAstronomicalDawnEndDateTimeUtc(date, latitude, longitude)](#module_suntimes..getAstronomicalDawnEndDateTimeUtc) ⇒ string\r\n * [~getAstronomicalDawnStartDateTimeUtc(date, latitude, longitude)](#module_suntimes..getAstronomicalDawnStartDateTimeUtc) ⇒ string\r\n * [~getAstronomicalDuskStartDateTimeUtc(date, latitude, longitude)](#module_suntimes..getAstronomicalDuskStartDateTimeUtc) ⇒ string\r\n * [~getAstronomicalDuskEndDateTimeUtc(date, latitude, longitude)](#module_suntimes..getAstronomicalDuskEndDateTimeUtc) ⇒ string\r\n * [~getNauticalDuskEndDateTimeUtc(date, latitude, longitude)](#module_suntimes..getNauticalDuskEndDateTimeUtc) ⇒ string\r\n * [~getNauticalDuskStartDateTimeUtc(date, latitude, longitude)](#module_suntimes..getNauticalDuskStartDateTimeUtc) ⇒ string\r\n * [~getCivilDuskEndDateTimeUtc(date, latitude, longitude)](#module_suntimes..getCivilDuskEndDateTimeUtc) ⇒ string\r\n * [~getCivilDuskStartDateTimeUtc(date, latitude, longitude)](#module_suntimes..getCivilDuskStartDateTimeUtc) ⇒ string\r\n\r\n\r\n\r\n### suntimes~getDeclinationOfTheSun(date) ⇒ number\r\nThe angular distance of the sun north or south of the earth's equator.\r\n\r\n**Kind**: inner method of [suntimes](#module_suntimes)\r\n**Returns**: number - The declination in degrees where north is a positive value and south is a negative value within a range of range of -23.45 and 23.45.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance |\r\n\r\n**Example**\r\n```js\r\nsuntimes.getDeclinationOfTheSun(new Date(2019, 0, 1));\r\n```\r\n\r\n\r\n### suntimes~equationOfTime(date) ⇒ number\r\nThe correction between standard clock time and the time based on the exact position of the sun in the sky represented as decimal time in minutes.\r\n\r\n**Kind**: inner method of [suntimes](#module_suntimes)\r\n**Returns**: number - A number whose value is the equation of time in minutes decimal time for the Date represented by date.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n\r\n**Example**\r\n```js\r\nsuntimes.equationOfTime(new Date(2025, 0, 18));\r\n```\r\n\r\n\r\n### suntimes~getHourAngleSinceNoon(date, latitude, angle) ⇒ number\r\nGets the hour angle difference between noon and the angle value.\r\n\r\n**Kind**: inner method of [suntimes](#module_suntimes)\r\n**Returns**: number - A number whose value represents the hour angle since noon for the date, latitude and angle value.\r\n**Throws**:\r\n\r\n- RangeError The sun altitude never elevates above the angle specified\r\n- RangeError The sun altitude never drops below the angle specified\r\n\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| angle | number | An angle value. |\r\n\r\n**Example** *(Example usage of getHourAngleSinceNoon)*\r\n```js\r\n// returns 5.54554469317797\r\nsuntimes.suntimes.getHourAngleSinceNoon(new Date(2025, 0, 18), 51.477730, -12);\r\n```\r\n\r\n\r\n### suntimes~getNoonHourAngle(date, longitude) ⇒ number\r\nGets the noon hour angle for the date and longitude value.\r\n\r\n**Kind**: inner method of [suntimes](#module_suntimes)\r\n**Returns**: number - The noon hour angle expressed as a number between 0.00 and 23.9.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNoonHourAngle)*\r\n```js\r\n// returns 12.17245941025575\r\nsuntimes.getNoonHourAngle(new Date(2025, 0, 18), -0.010150);\r\n```\r\n\r\n\r\n### suntimes~getNoonDateTimeUtc(date, longitude) ⇒ string\r\nGets the noon date and time in UTC expressed in an ISO 8601 format for date and longitude value.\r\n\r\n**Kind**: inner method of [suntimes](#module_suntimes)\r\n**Returns**: string - A string representing noon date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNoonDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T08:44:23.762Z\"\r\nsuntimes.getNoonDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n\r\n\r\n### suntimes~getDateTimeUtcOfAngleBeforeNoon(angle, date, latitude, longitude) ⇒ string\r\nGets the date and time in UTC expressed in an ISO 8601 format for an angle before noon for the angle, date, latitude and longitude value.\r\n\r\n**Kind**: inner method of [suntimes](#module_suntimes)\r\n**Returns**: string - A string representing the time and date for an angle before noon in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| angle | number | An angle value. |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n\r\n\r\n### suntimes~getDateTimeUtcOfAngleAfterNoon(angle, date, latitude, longitude) ⇒ string\r\nGets the date and time in UTC expressed in an ISO 8601 format for an angle after noon for the angle, date, latitude and longitude value.\r\n\r\n**Kind**: inner method of [suntimes](#module_suntimes)\r\n**Returns**: string - A string representing the time and date for an angle after noon in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| angle | number | An angle value. |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n\r\n\r\n### suntimes~getSunriseDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the sunrise date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: inner method of [suntimes](#module_suntimes)\r\n**Returns**: string - A string representing sunrise date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getSunriseDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T07:57:29.802Z\"\r\nsuntimes.getSunriseDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getSunriseDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);d longitude 102.47427\"\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getSunriseDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);5 and longitude -30.45\"\r\n```\r\n\r\n\r\n### suntimes~getSunsetDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the sunset date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: inner method of [suntimes](#module_suntimes)\r\n**Returns**: string - A string representing sunset date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getSunsetDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T16:23:11.903Z\"\r\nsuntimes.getSunsetDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getSunsetDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);nd longitude 102.47427\"\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getSunsetDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);25 and longitude -30.45\"\r\n```\r\n\r\n\r\n### suntimes~getCivilDawnEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of civil dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: inner method of [suntimes](#module_suntimes)\r\n**Returns**: string - A string representing the end of civil dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getCivilDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T07:59:31.616Z\"\r\nsuntimes.getCivilDawnEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getCivilDawnEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);gitude 102.47427\"\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getCivilDawnEndDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500); longitude -30.45\r\n```\r\n\r\n\r\n### suntimes~getCivilDawnStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of civil dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: inner method of [suntimes](#module_suntimes)\r\n**Returns**: string - A string representing the start of civil dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getCivilDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T07:19:15.781Z\"\r\nsuntimes.getCivilDawnStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getCivilDawnStartDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);ude 89.525 and longitude -30.45\"\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getCivilDawnStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);71.98007 and longitude 102.47427\"\r\n```\r\n\r\n\r\n### suntimes~getNauticalDawnEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of nautical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: inner method of [suntimes](#module_suntimes)\r\n**Returns**: string - A string representing the end of nautical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNauticalDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T07:19:15.781Z\"\r\nsuntimes.getNauticalDawnEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getNauticalDawnEndDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);de 89.525 and longitude -30.45\"\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getNauticalDawnEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);1.98007 and longitude 102.47427\"\r\n```\r\n\r\n\r\n### suntimes~getNauticalDawnStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of nautical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: inner method of [suntimes](#module_suntimes)\r\n**Returns**: string - A string representing the start of nautical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNauticalDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T06:37:36.892Z\"\r\nsuntimes.getNauticalDawnStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getNauticalDawnStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);.98007 and longitude 102.47427\"\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getNauticalDawnStartDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);e 89.525 and longitude -30.45\"\r\n```\r\n\r\n\r\n### suntimes~getAstronomicalDawnEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of astronomical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: inner method of [suntimes](#module_suntimes)\r\n**Returns**: string - A string representing the end of astronomical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getAstronomicalDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T06:37:36.892Z\"\r\nsuntimes.getAstronomicalDawnEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getAstronomicalDawnEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);8007 and longitude 102.47427\"\r\n```\r\n\r\n\r\n### suntimes~getAstronomicalDawnStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of astronomical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: inner method of [suntimes](#module_suntimes)\r\n**Returns**: string - A string representing the start of astronomical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getAstronomicalDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T05:57:45.720Z\"\r\nsuntimes.getAstronomicalDawnStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getAstronomicalDawnStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);07 and longitude 102.47427\"\r\n```\r\n\r\n\r\n### suntimes~getAstronomicalDuskStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of astronomical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: inner method of [suntimes](#module_suntimes)\r\n**Returns**: string - A string representing the start of astronomical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getAstronomicalDuskStartDateTimeUtc)*\r\n```js\r\n// returns 1\r\nsuntimes.getAstronomicalDuskStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getAstronomicalDuskStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);07 and longitude 102.47427\"\r\n```\r\n\r\n\r\n### suntimes~getAstronomicalDuskEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of astronomical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: inner method of [suntimes](#module_suntimes)\r\n**Returns**: string - A string representing the end of astronomical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getAstronomicalDuskEndDateTimeUtc)*\r\n```js\r\n// returns 1\r\nsuntimes.getAstronomicalDuskEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getAstronomicalDuskEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);8007 and longitude 102.47427\"\r\n```\r\n\r\n\r\n### suntimes~getNauticalDuskEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of nautical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: inner method of [suntimes](#module_suntimes)\r\n**Returns**: string - A string representing the end of nautical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNauticalDuskEndDateTimeUtc)*\r\n```js\r\n// returns 1\r\nsuntimes.getNauticalDuskEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getNauticalDuskEndDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);de 89.525 and longitude -30.45\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getNauticalDuskEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);71.98007 and longitude 102.47427\"\r\n```\r\n\r\n\r\n### suntimes~getNauticalDuskStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of nautical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: inner method of [suntimes](#module_suntimes)\r\n**Returns**: string - A string representing the start of nautical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNauticalDuskStartDateTimeUtc)*\r\n```js\r\n// returns 1\r\nsuntimes.getNauticalDuskStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getNauticalDuskStartDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);89.525 and longitude -30.45\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getNauticalDuskStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);98007 and longitude 102.47427\"\r\n```\r\n\r\n\r\n### suntimes~getCivilDuskEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of civil dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: inner method of [suntimes](#module_suntimes)\r\n**Returns**: string - A string representing the end of civil dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getCivilDuskEndDateTimeUtc)*\r\n```js\r\n// returns 1\r\nsuntimes.getCivilDuskEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n\r\n\r\n### suntimes~getCivilDuskStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of civil dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: inner method of [suntimes](#module_suntimes)\r\n**Returns**: string - A string representing the start of civil dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getCivilDuskStartDateTimeUtc)*\r\n```js\r\n// returns 1\r\nsuntimes.getCivilDuskStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```","readmeFilename":"README.md","gitHead":"cfd2a2fd28aeb5815fe8529fcf9e3a2a22090f87","_id":"suntimes@4.1.8-1","_nodeVersion":"12.16.1","_npmVersion":"6.8.0","dist":{"integrity":"sha512-IocZSYA/6un7XvuwPMQ3wO4apKvgKnyQbg0hcgKEYmZG6NCJ6hWG1DdgKl0C1szT1NQ+V/FOYSplq97L9JeVEg==","shasum":"a59c0eca1e223024ae4d0fb57a884dd5f99cae91","tarball":"https://registry.npmjs.org/suntimes/-/suntimes-4.1.8-1.tgz","fileCount":6,"unpackedSize":60062,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJejIMuCRA9TVsSAnZWagAAGzYQAIxohkZlrmWuXrZ3zWRA\nEiUK6myJYo2C/pEihlW6uXemG2drLhJJPI8dv64I/U/k+LRhr297A1S9Ep9r\nTFF6X0oyWBTxbIGWSPdwh6sCJeAa/fqZSLletPRjB+1YFsea0uXKTSvVUgSC\nqvh4SpLlA/W4Vb9gR5UEEinsh8YvY0aPXUo3lZmfEPzGfXkj7Hj35i+G3EVB\ncVaWTyfRicUV4sMAViRoFKcuyx1xwx+MVGFte3y3d+UKim+s5JIifcXOFYdQ\nJOiS2J/aZNylKEq/Re08TqCzR0imCJ8cWr+do8jZCgypMLM7DWPrHfJOeJXB\nvR/0jIKzlHh+YEVoWRzy3WOPe1UdD64tGDoSKzbuscDxSfxK6wVVEXvfHjV/\nNdpoSpH4eBBFzkAGHsCi9pQGP8MhmXRPo9STUb+xiFwVG4C8GS7SxoSnaNEs\nX9P+J5DK+CvURzOO+jUt42enZNmfPP1ohuzTvl3kStnwFBeVQG9uVK6l5VrW\n2g8xjIItB6JCvAGJQHA5OElWNqs1SboPz0NqT9FF78sA4/xExi/i/XqKc9ku\nr0ya+qQt4795e++//IsreXMqZei9anb37NFQVNkogo5vxPPl8iEDN1AUaORm\nVEGkzp2DwBtsnLtE855STcK54xFlFvar8j4oJ0OQReKnyJQANz1IFn4Ii236\nFGRt\r\n=fH1t\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCICKGlgrxUSyRU86ZODRrT4GzXHkuiKhibF8gYrtgOxszAiAVxN5QPbjDIX14k5TYfnQzgWjlJA/RTBu0/iPQDPTVZg=="}]},"maintainers":[{"name":"doniseferi","email":"doni.seferi@gmail.com"}],"_npmUser":{"name":"doniseferi","email":"doni.seferi@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/suntimes_4.1.8-1_1586266925521_0.7958055953618246"},"_hasShrinkwrap":false},"5.0.0-0":{"name":"suntimes","version":"5.0.0-0","description":"A tiny library to get the exact date and time in utc for certain points of the day for any desired location and date.","main":"suntimes.js","typings":"suntimes.d.ts","scripts":{"readme":"jsdoc2md ./src/index.js","typedef":"jsdoc -t node_modules/tsd-jsdoc/dist -r ./src/index.js","build":"rollup -c","release":"standard-version","test":"semistandard && npm run build && nyc mocha **/*.test.js --colors --full-trace --require @babel/register","coverage":"nyc report --reporter=text-lcov | coveralls","fix":"semistandard --fix"},"repository":{"type":"git","url":"git+https://github.com/doniseferi/suntimes.git"},"keywords":["sun","suntimes","equationOfTime","solar","declination","sunrise","sunset","twilight","dusk","dawn","maths","astronomy","celestial"],"author":{"name":"Edonis Seferi"},"license":"ISC","bugs":{"url":"https://github.com/doniseferi/suntimes/issues"},"homepage":"https://github.com/doniseferi/suntimes#readme","devDependencies":{"@babel/core":"^7.7.0","@babel/preset-env":"^7.7.1","@babel/register":"^7.7.0","chai":"^4.2.0","coveralls":"^3.0.7","depcheck":"^0.9.1","eslint":"^6.6.0","eslint-config-semistandard":"^15.0.0","eslint-config-standard":"^14.1.0","eslint-plugin-import":"^2.18.2","eslint-plugin-node":"^10.0.0","eslint-plugin-promise":"^4.2.1","eslint-plugin-standard":"^4.0.1","jsdoc":"^3.6.3","jsdoc-to-markdown":"^5.0.3","mocha":"^7.1.1","nyc":"^14.1.1","rollup":"^1.27.14","rollup-plugin-babel":"^4.3.3","rollup-plugin-terser":"^5.1.3","semistandard":"^14.2.0","standard-version":"^7.1.0","tsd-jsdoc":"^2.4.0"},"dependencies":{},"readme":"\r\n\r\n
objectAn object that provides basic astronomy functionality for any given date and location.
\r\nnumberThe angular distance of the sun north or south of the earth's equator.
\r\nnumberThe correction between standard clock time and the time based on the exact position of the sun in the sky represented as decimal time in minutes.
\r\nnumberGets the hour angle difference between noon and the angle value.
\r\nnumberGets the noon hour angle for the date and longitude value.
\r\nstringGets the noon date and time in UTC expressed in an ISO 8601 format for date and longitude value.
\r\nstringGets the date and time in UTC expressed in an ISO 8601 format for an angle before noon for the angle, date, latitude and longitude value.
\r\nstringGets the date and time in UTC expressed in an ISO 8601 format for an angle after noon for the angle, date, latitude and longitude value.
\r\nstringGets the sunrise date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the sunset date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the end of civil dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the start of civil dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the end of nautical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the start of nautical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the end of astronomical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the start of astronomical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the start of astronomical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the end of astronomical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the end of nautical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the start of nautical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the end of civil dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the start of civil dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nobject\r\nAn object that provides basic astronomy functionality for any given date and location.\r\n\r\n**Kind**: global namespace\r\n**Author**: Edonis Seferi number\r\nThe angular distance of the sun north or south of the earth's equator.\r\n\r\n**Kind**: global function\r\n**Returns**: number - The declination in degrees where north is a positive value and south is a negative value within a range of range of -23.45 and 23.45.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance |\r\n\r\n**Example**\r\n```js\r\nsuntimes.getDeclinationOfTheSun(new Date(2019, 0, 1));\r\n```\r\n\r\n\r\n## equationOfTime(date) ⇒ number\r\nThe correction between standard clock time and the time based on the exact position of the sun in the sky represented as decimal time in minutes.\r\n\r\n**Kind**: global function\r\n**Returns**: number - A number whose value is the equation of time in minutes decimal time for the Date represented by date.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n\r\n**Example**\r\n```js\r\nsuntimes.equationOfTime(new Date(2025, 0, 18));\r\n```\r\n\r\n\r\n## getHourAngleSinceNoon(date, latitude, angle) ⇒ number\r\nGets the hour angle difference between noon and the angle value.\r\n\r\n**Kind**: global function\r\n**Returns**: number - A number whose value represents the hour angle since noon for the date, latitude and angle value.\r\n**Throws**:\r\n\r\n- RangeError The sun altitude never elevates above the angle specified\r\n- RangeError The sun altitude never drops below the angle specified\r\n\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| angle | number | An angle value. |\r\n\r\n**Example** *(Example usage of getHourAngleSinceNoon)*\r\n```js\r\n// returns 5.54554469317797\r\nsuntimes.getHourAngleSinceNoon(new Date(2025, 0, 18), 51.477730, -12);\r\n```\r\n\r\n\r\n## getNoonHourAngle(date, longitude) ⇒ number\r\nGets the noon hour angle for the date and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: number - The noon hour angle expressed as a number between 0.00 and 23.9.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNoonHourAngle)*\r\n```js\r\n// returns 12.17245941025575\r\nsuntimes.getNoonHourAngle(new Date(2025, 0, 18), -0.010150);\r\n```\r\n\r\n\r\n## getNoonDateTimeUtc(date, longitude) ⇒ string\r\nGets the noon date and time in UTC expressed in an ISO 8601 format for date and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing noon date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNoonDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T12:10:20.853Z\"\r\nsuntimes.getNoonDateTimeUtc(new Date(2025, 0, 18), -0.010150);\r\n```\r\n\r\n\r\n## getDateTimeUtcOfAngleBeforeNoon(angle, date, latitude, longitude) ⇒ string\r\nGets the date and time in UTC expressed in an ISO 8601 format for an angle before noon for the angle, date, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the time and date for an angle before noon in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| angle | number | An angle value. |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getDateTimeUtcOfAngleBeforeNoon)*\r\n```js\r\n// returns \"2025-01-18T05:57:45.720Z\"\r\nsuntimes.getDateTimeUtcOfAngleBeforeNoon(-18, new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getDateTimeUtcOfAngleBeforeNoon(-18, new Date(2025, 5, 18), 51.477730, -0.010150)73 and longitude -0.01015\"\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getDateTimeUtcOfAngleBeforeNoon(18, new Date(2025, 5, 18), -51.477730, -0.010150);3 and longitude -0.01015\"\r\n```\r\n\r\n\r\n## getDateTimeUtcOfAngleAfterNoon(angle, date, latitude, longitude) ⇒ string\r\nGets the date and time in UTC expressed in an ISO 8601 format for an angle after noon for the angle, date, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the time and date for an angle after noon in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| angle | number | An angle value. |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example**\r\n```js\r\nsuntimes.getDateTimeUtcOfAngleAfterNoon(-18, new Date(2025, 0, 18), -51.477730, -0.010150)773 and longitude -0.01015\"\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getDateTimeUtcOfAngleAfterNoon(18, new Date(2025, 5, 18), -51.477730, -0.010150);73 and longitude -0.01015\"\r\n```\r\n\r\n\r\n## getSunriseDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the sunrise date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing sunrise date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getSunriseDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T07:57:29.802Z\"\r\nsuntimes.getSunriseDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getSunriseDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);d longitude 102.47427\"\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getSunriseDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);5 and longitude -30.45\"\r\n```\r\n\r\n\r\n## getSunsetDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the sunset date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing sunset date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getSunsetDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T16:23:11.903Z\"\r\nsuntimes.getSunsetDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getSunsetDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);nd longitude 102.47427\"\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getSunsetDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);25 and longitude -30.45\"\r\n```\r\n\r\n\r\n## getCivilDawnEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of civil dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the end of civil dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getCivilDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T07:57:29.802Z\"\r\nsuntimes.getCivilDawnEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getCivilDawnEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);gitude 102.47427\"\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getCivilDawnEndDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500); longitude -30.45\r\n```\r\n\r\n\r\n## getCivilDawnStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of civil dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the start of civil dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getCivilDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T07:19:15.781Z\"\r\nsuntimes.getCivilDawnStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getCivilDawnStartDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);ude 89.525 and longitude -30.45\"\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getCivilDawnStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);71.98007 and longitude 102.47427\"\r\n```\r\n\r\n\r\n## getNauticalDawnEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of nautical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the end of nautical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNauticalDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T07:19:15.781Z\"\r\nsuntimes.getNauticalDawnEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getNauticalDawnEndDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);de 89.525 and longitude -30.45\"\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getNauticalDawnEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);1.98007 and longitude 102.47427\"\r\n```\r\n\r\n\r\n## getNauticalDawnStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of nautical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the start of nautical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNauticalDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T06:37:36.892Z\"\r\nsuntimes.getNauticalDawnStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getNauticalDawnStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);.98007 and longitude 102.47427\"\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getNauticalDawnStartDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);e 89.525 and longitude -30.45\"\r\n```\r\n\r\n\r\n## getAstronomicalDawnEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of astronomical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the end of astronomical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getAstronomicalDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T06:37:36.892Z\"\r\nsuntimes.getAstronomicalDawnEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getAstronomicalDawnEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);8007 and longitude 102.47427\"\r\n```\r\n\r\n\r\n## getAstronomicalDawnStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of astronomical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the start of astronomical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getAstronomicalDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T05:57:45.720Z\"\r\nsuntimes.getAstronomicalDawnStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getAstronomicalDawnStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);07 and longitude 102.47427\"\r\n```\r\n\r\n\r\n## getAstronomicalDuskStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of astronomical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the start of astronomical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getAstronomicalDuskStartDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T17:43:04.813Z\"\r\nsuntimes.getAstronomicalDuskStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getAstronomicalDuskStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);07 and longitude 102.47427\"\r\n```\r\n\r\n\r\n## getAstronomicalDuskEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of astronomical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the end of astronomical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getAstronomicalDuskEndDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T18:22:55.985Z\"\r\nsuntimes.getAstronomicalDuskEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getAstronomicalDuskEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);8007 and longitude 102.47427\"\r\n```\r\n\r\n\r\n## getNauticalDuskEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of nautical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the end of nautical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNauticalDuskEndDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T17:43:04.813Z\"\r\nsuntimes.getNauticalDuskEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getNauticalDuskEndDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);de 89.525 and longitude -30.45\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getNauticalDuskEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);71.98007 and longitude 102.47427\"\r\n```\r\n\r\n\r\n## getNauticalDuskStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of nautical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the start of nautical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNauticalDuskStartDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T17:01:25.924Z\"\r\nsuntimes.getNauticalDuskStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getNauticalDuskStartDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);89.525 and longitude -30.45\r\n```\r\n**Example**\r\n```js\r\nsuntimes.getNauticalDuskStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);98007 and longitude 102.47427\"\r\n```\r\n\r\n\r\n## getCivilDuskEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of civil dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the end of civil dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getCivilDuskEndDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T17:01:25.924Z\"\r\nsuntimes.getCivilDuskEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n\r\n\r\n## getCivilDuskStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of civil dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the start of civil dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getCivilDuskStartDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T16:23:11.903Z\"\r\nsuntimes.getCivilDuskStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```","readmeFilename":"README.md","gitHead":"eee911fe0ef3f28c183284aaa99379540371247f","_id":"suntimes@5.0.0-0","_nodeVersion":"12.16.1","_npmVersion":"6.8.0","dist":{"integrity":"sha512-HbkQFtkASqMwlHkeSvdxIqBNMK2a0h52DvOwWxnMEZNiPZqLcrcSNCyibOoiMEnoS59Ui5xuDOZR0L5K611tVQ==","shasum":"702e0db111a069f708e49d929b534dd5c4639168","tarball":"https://registry.npmjs.org/suntimes/-/suntimes-5.0.0-0.tgz","fileCount":6,"unpackedSize":64338,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJejP+vCRA9TVsSAnZWagAAKbEP+QHedXlhZYvB8AXxMxgj\nXXtArUgHyhiavpz08AofRWjllePph2rCpjfGhrutsz/7kIyjEVYhNRAXLg8q\n61zFj+aSt0Z4zHTqC8s3Prezye6WKUTbzcYHw+cwor4wT2PE54Ezz84ae/0q\nhbchJ65oz1Ip+PZTk1XtIXko6cioXTeP4TwZabweWt1wdd31tXpPcsSOes2q\nOKFjQRQrfrd+gOBt3wWkgB6V3lxrcEslN1ZkxV6rUjZFclPI7pxgl/OTKg0J\nZ9mbJPqt6Akj2H6qYPX2QfdTOyw3OhFHZ6/rej/b/mUQrIHGfF2gyeWKbXr6\nC8k5jUxtgToYULAfq+j0wexhvxLaziz9ufkWowlUNE9cqnOhIaRZ33o9g9rP\nJoiB/Ck5/UQXld91sQPtyD7wUnxo2VbfQfcTd4Ba2lj84FRpatd9V/K+Bmia\nY1S8NvdJ/BhL9slSYvtoo90/WRKOKCU2gAlIFHXsS0UcbB4CCThu/2zmO34q\nO7ZJu8vv4uUmJyLiLctRngpVJ+IGeos7admmCBqwp7caHD+cA2iYwzYZVWuX\nE6uPEZ7gTYpPTjpWW+bdSf3HaLcHtc+vgnInpN2Q+3t3eZcrVJpNsyvDwExT\n3Z5PpQb+l0KYH45pEzxEQANJpGrZe5MKNVdgV8a6Qij1jX8gZb2EOt7LeduC\nvU6f\r\n=/Dgp\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIEH8D2SX1WYb8P9pyB+a+CpzRFUTBV8bn/khizbMKcW0AiEA76lZShHroJOVO7AWIzQ6sBvkTUCBfh8EI4Ty3o4PlRw="}]},"maintainers":[{"name":"doniseferi","email":"doni.seferi@gmail.com"}],"_npmUser":{"name":"doniseferi","email":"doni.seferi@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/suntimes_5.0.0-0_1586298798649_0.9738732421984049"},"_hasShrinkwrap":false},"5.0.0":{"name":"suntimes","version":"5.0.0","description":"A tiny library to get the exact date and time in utc for certain points of the day for any desired location and date.","main":"suntimes.js","typings":"suntimes.d.ts","scripts":{"readme":"jsdoc2md ./src/index.js","typedef":"jsdoc -t node_modules/tsd-jsdoc/dist -r ./src/index.js","build":"rollup -c","release":"standard-version","test":"semistandard && npm run build && nyc mocha **/*.test.js --colors --full-trace --require @babel/register","coverage":"nyc report --reporter=text-lcov | coveralls","fix":"semistandard --fix"},"repository":{"type":"git","url":"git+https://github.com/doniseferi/suntimes.git"},"keywords":["sun","suntimes","equationOfTime","solar","declination","sunrise","sunset","twilight","dusk","dawn","maths","astronomy","celestial"],"author":{"name":"Edonis Seferi"},"license":"ISC","bugs":{"url":"https://github.com/doniseferi/suntimes/issues"},"homepage":"https://github.com/doniseferi/suntimes#readme","devDependencies":{"@babel/core":"^7.7.0","@babel/preset-env":"^7.7.1","@babel/register":"^7.7.0","chai":"^4.2.0","coveralls":"^3.0.7","depcheck":"^0.9.1","eslint":"^6.6.0","eslint-config-semistandard":"^15.0.0","eslint-config-standard":"^14.1.0","eslint-plugin-import":"^2.18.2","eslint-plugin-node":"^10.0.0","eslint-plugin-promise":"^4.2.1","eslint-plugin-standard":"^4.0.1","jsdoc":"^3.6.3","jsdoc-to-markdown":"^5.0.3","mocha":"^7.1.1","nyc":"^14.1.1","rollup":"^1.27.14","rollup-plugin-babel":"^4.3.3","rollup-plugin-terser":"^5.1.3","semistandard":"^14.2.0","standard-version":"^7.1.0","tsd-jsdoc":"^2.4.0"},"dependencies":{},"gitHead":"46b92a022dc4485dc5fe1d64df63f338f8217868","_id":"suntimes@5.0.0","_nodeVersion":"12.16.1","_npmVersion":"6.8.0","dist":{"integrity":"sha512-fAWZIHhrYfR3kuiCVJsjW0T5p87Bc7yr2aMsIv7CJo6aIGSG2BywRW3UH/6ThGwKq4iibDfXGWs02IVkeqDJ3A==","shasum":"c5f0fa08b43627467230a55be39c4ceda399183a","tarball":"https://registry.npmjs.org/suntimes/-/suntimes-5.0.0.tgz","fileCount":6,"unpackedSize":64427,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJejQCoCRA9TVsSAnZWagAAozkP/1j5waCLuzwePfwB5ztD\nw1Mv7hQiPB/P7cnUbaEz+UcMAxGNUB7zxO4RqyeH1nHCmrJtdClq69tF4Rct\ndbLml864eS7u6BvVWleBVcTz2BLvm/Xw88w6qhvKcoTZ5RVjZo9PcDStEzum\nk4pxpCQUiJhKDcgZyko5NB38nJBv0xfJL5Q+nvoYO1EknB4F3uF7NXyTJD9n\nZc+H6s9g4ORl7ntJb1ZscMyguZsMzAs/rxJUQxx7IQJYMQXUbchFvTjfYGpH\nuTiFWAILqqP68tVX5sdYBmqE8JizlXel6eIv2d3jiN4RhuUnnjY8nca7uXcA\nQx/Lo/ebx5J7OqB5TmrW0QhzTpHOZsfoXM4BkPQANkF0IP+mTMSs58HoG+MC\nxlN5SPtqJXtuyLP3ng8U9iucK7Ty/f4q95cKxDM/+uhfsI3H+WxdQW2fd6p/\n+w0Ub0BtfuiES97a2wdY+XjRrdHZBxyhtlvSNrwvMBBKDKGAGcovM+0Acnox\nqeV1maxH9i/LIEaDPyIn63xtKP8SdzJTy4JsBsi5+Yz1kJNN0CzSG2M+2mtS\nxnjbeRe9stpuyStjPe0X97lzjcNC8Hd5z/QfZFbTTewzqpN0TML9yZo3fgH1\nxMI9TTgS8hdmB8WE03uiMaLxPB3v/yiyTxYQRSGPnWpgtFNSNTJRgt6g6eoS\nGs6L\r\n=YPcz\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIGCIMigU1Tx7gudlgs1NEtQyhoAbLs9smTUoIJbXBickAiBtHaJZ7Lx6nqk8iEQKyjfDx7QECy4PyD47nzATEu60Wg=="}]},"maintainers":[{"name":"doniseferi","email":"doni.seferi@gmail.com"}],"_npmUser":{"name":"doniseferi","email":"doni.seferi@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/suntimes_5.0.0_1586299048210_0.2067259272511388"},"_hasShrinkwrap":false},"5.0.1-0":{"name":"suntimes","version":"5.0.1-0","description":"A tiny library to get the exact date and time in utc for certain points of the day for any desired location and date.","main":"suntimes.js","typings":"suntimes.d.ts","scripts":{"readme":"jsdoc2md src/declination/getDeclinationOfTheSun.js src/equationOfTime/equationOfTime.js src/hourAngle/getHourAngle.js src/hourAngle/getNoonHourAngle.js src/time/index.js","typedef":"jsdoc -t node_modules/tsd-jsdoc/dist -r ./src/","build":"rollup -c","release":"standard-version","test":"semistandard && npm run build && nyc mocha **/*.test.js --colors --full-trace --require @babel/register","coverage":"nyc report --reporter=text-lcov | coveralls","fix":"semistandard --fix"},"repository":{"type":"git","url":"git+https://github.com/doniseferi/suntimes.git"},"keywords":["sun","suntimes","equationOfTime","solar","declination","sunrise","sunset","twilight","dusk","dawn","maths","astronomy","celestial"],"author":{"name":"Edonis Seferi"},"license":"ISC","bugs":{"url":"https://github.com/doniseferi/suntimes/issues"},"homepage":"https://github.com/doniseferi/suntimes#readme","devDependencies":{"@babel/core":"^7.7.0","@babel/preset-env":"^7.7.1","@babel/register":"^7.7.0","chai":"^4.2.0","coveralls":"^3.0.7","depcheck":"^0.9.1","eslint":"^6.6.0","eslint-config-semistandard":"^15.0.0","eslint-config-standard":"^14.1.0","eslint-plugin-import":"^2.18.2","eslint-plugin-node":"^10.0.0","eslint-plugin-promise":"^4.2.1","eslint-plugin-standard":"^4.0.1","jsdoc":"^3.6.3","jsdoc-to-markdown":"^5.0.3","mocha":"^7.1.1","nyc":"^14.1.1","rollup":"^1.27.14","rollup-plugin-babel":"^4.3.3","rollup-plugin-terser":"^5.1.3","semistandard":"^14.2.0","standard-version":"^7.1.0","tsd-jsdoc":"^2.4.0"},"dependencies":{},"readme":"\r\n\r\n
numberThe angular distance of the sun north or south of the earth's equator.
\r\nnumberThe correction between standard clock time and the time based on the exact position of the sun in the sky represented as decimal time in minutes.
\r\nnumberGets the hour angle difference between noon and the angle value.
\r\nnumberGets the noon hour angle for the date and longitude value.
\r\nstringGets the noon date and time in UTC expressed in an ISO 8601 format for date and longitude value.
\r\nstringGets the date and time in UTC expressed in an ISO 8601 format for an angle before noon for the angle, date, latitude and longitude value.
\r\nstringGets the date and time in UTC expressed in an ISO 8601 format for an angle after noon for the angle, date, latitude and longitude value.
\r\nstringGets the sunrise date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the sunset date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the end of civil dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the start of civil dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the end of nautical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the start of nautical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the end of astronomical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
stringGets the start of astronomical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the start of astronomical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the end of astronomical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
stringGets the end of nautical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the start of nautical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the end of civil dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the start of civil dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nnumber\r\nThe angular distance of the sun north or south of the earth's equator.\r\n\r\n**Kind**: global function\r\n**Returns**: number - The declination in degrees where north is a positive value and south is a negative value within a range of range of -23.45 and 23.45.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance |\r\n\r\n**Example** *(Example usage of getDeclinationOfTheSun.)*\r\n```js\r\n// returns -23.078780854838076\r\nsuntimes.getDeclinationOfTheSun(new Date(2019, 0, 1));\r\n```\r\n* * *\r\n\r\n\r\n## equationOfTime(date) ⇒ number\r\nThe correction between standard clock time and the time based on the exact position of the sun in the sky represented as decimal time in minutes.\r\n\r\n**Kind**: global function\r\n**Returns**: number - A number whose value is the equation of time in minutes decimal time for the Date represented by date.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n\r\n**Example** *(Example usage of equationOfTime.)*\r\n```js\r\n// returns -10.306964615344999\r\nsuntimes.equationOfTime(new Date(2025, 0, 18));\r\n```\r\n* * *\r\n\r\n\r\n## getHourAngleSinceNoon(date, latitude, angle) ⇒ number\r\nGets the hour angle difference between noon and the angle value.\r\n\r\n**Kind**: global function\r\n**Returns**: number - A number whose value represents the hour angle since noon for the date, latitude and angle value.\r\n**Throws**:\r\n\r\n- RangeError The sun altitude never elevates above the angle specified.\r\n- RangeError The sun altitude never drops below the angle specified.\r\n\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| angle | number | An angle value. |\r\n\r\n**Example** *(Example usage of getHourAngleSinceNoon)*\r\n```js\r\n// returns 5.54554469317797\r\nsuntimes.getHourAngleSinceNoon(new Date(2025, 0, 18), 51.477730, -12);\r\n```\r\n* * *\r\n\r\n\r\n## getNoonHourAngle(date, longitude) ⇒ number\r\nGets the noon hour angle for the date and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: number - The noon hour angle expressed as a number between 0.00 and 23.9.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNoonHourAngle)*\r\n```js\r\n// returns 12.17245941025575\r\nsuntimes.getNoonHourAngle(new Date(2025, 0, 18), -0.010150);\r\n```\r\n* * *\r\n\r\n\r\n## getNoonDateTimeUtc(date, longitude) ⇒ string\r\nGets the noon date and time in UTC expressed in an ISO 8601 format for date and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing noon date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNoonDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T12:10:20.853Z\"\r\nsuntimes.getNoonDateTimeUtc(new Date(2025, 0, 18), -0.010150);\r\n```\r\n* * *\r\n\r\n\r\n## getDateTimeUtcOfAngleBeforeNoon(angle, date, latitude, longitude) ⇒ string\r\nGets the date and time in UTC expressed in an ISO 8601 format for an angle before noon for the angle, date, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the time and date for an angle before noon in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| angle | number | An angle value. |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getDateTimeUtcOfAngleBeforeNoon)*\r\n```js\r\n// returns \"2025-01-18T05:57:45.720Z\"\r\nsuntimes.getDateTimeUtcOfAngleBeforeNoon(-18, new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getDateTimeUtcOfAngleBeforeNoon)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -18° on Wed Jun 18 2025 at latitude 51.47773 and longitude -0.01015\"\r\nsuntimes.getDateTimeUtcOfAngleBeforeNoon(-18, new Date(2025, 5, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getDateTimeUtcOfAngleBeforeNoon)*\r\n```js\r\n// returns \"The sun's altitude does not rise to 18° on Wed Jun 18 2025 at latitude -51.47773 and longitude -0.01015\"\r\nsuntimes.getDateTimeUtcOfAngleBeforeNoon(18, new Date(2025, 5, 18), -51.477730, -0.010150);\r\n```\r\n* * *\r\n\r\n\r\n## getDateTimeUtcOfAngleAfterNoon(angle, date, latitude, longitude) ⇒ string\r\nGets the date and time in UTC expressed in an ISO 8601 format for an angle after noon for the angle, date, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the time and date for an angle after noon in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| angle | number | An angle value. |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getDateTimeUtcOfAngleAfterNoon)*\r\n```js\r\n//returns \"2025-06-18T14:33:42.689Z\"\r\nsuntimes.getDateTimeUtcOfAngleAfterNoon(8, new Date(2025, 5, 18), -51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getDateTimeUtcOfAngleAfterNoon)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -18° on Sat Jan 18 2025 at latitude -51.47773 and longitude -0.01015\"\r\nsuntimes.getDateTimeUtcOfAngleAfterNoon(-18, new Date(2025, 0, 18), -51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getDateTimeUtcOfAngleAfterNoon)*\r\n```js\r\n// returns \"The sun's altitude does not rise to 18° on Wed Jun 18 2025 at latitude -51.47773 and longitude -0.01015\"\r\nsuntimes.getDateTimeUtcOfAngleAfterNoon(18, new Date(2025, 5, 18), -51.477730, -0.010150);\r\n```\r\n* * *\r\n\r\n\r\n## getSunriseDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the sunrise date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing sunrise date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getSunriseDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T07:57:29.802Z\"\r\nsuntimes.getSunriseDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getSunriseDateTimeUtc)*\r\n```js\r\n// returns \"The sun is up all day on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getSunriseDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n**Example** *(Example usage of getSunriseDateTimeUtc)*\r\n```js\r\n// returns \"The sun is down all day on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\"\r\nsuntimes.getSunriseDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n* * *\r\n\r\n\r\n## getSunsetDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the sunset date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing sunset date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getSunsetDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T16:23:11.903Z\"\r\nsuntimes.getSunsetDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getSunsetDateTimeUtc)*\r\n```js\r\n// returns \"The sun is up all day on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getSunsetDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n**Example** *(Example usage of getSunsetDateTimeUtc)*\r\n```js\r\n// returns \"The sun is down all day on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\"\r\nsuntimes.getSunsetDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n* * *\r\n\r\n\r\n## getCivilDawnEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of civil dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the end of civil dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getCivilDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T07:57:29.802Z\"\r\nsuntimes.getCivilDawnEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getCivilDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"The sun is up all day on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getCivilDawnEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n**Example** *(Example usage of getCivilDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"The sun is down all day on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\r\nsuntimes.getCivilDawnEndDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n* * *\r\n\r\n\r\n## getCivilDawnStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of civil dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the start of civil dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getCivilDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T07:19:15.781Z\"\r\nsuntimes.getCivilDawnStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getCivilDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not rise to -6° on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\"\r\nsuntimes.getCivilDawnStartDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n**Example** *(Example usage of getCivilDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -6° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getCivilDawnStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n* * *\r\n\r\n\r\n## getNauticalDawnEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of nautical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the end of nautical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNauticalDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T07:19:15.781Z\"\r\nsuntimes.getNauticalDawnEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getNauticalDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not rise to -6° on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\"\r\nsuntimes.getNauticalDawnEndDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n**Example** *(Example usage of getNauticalDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -6° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getNauticalDawnEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n* * *\r\n\r\n\r\n## getNauticalDawnStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of nautical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the start of nautical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNauticalDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T06:37:36.892Z\"\r\nsuntimes.getNauticalDawnStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getNauticalDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -12° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getNauticalDawnStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n**Example** *(Example usage of getNauticalDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not rise to -12° on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\"\r\nsuntimes.getNauticalDawnStartDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n* * *\r\n\r\n\r\n## getAstronomicalDawnEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of astronomical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the end of astronomical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getAstronomicalDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T06:37:36.892Z\"\r\nsuntimes.getAstronomicalDawnEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getAstronomicalDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -12° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getAstronomicalDawnEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n* * *\r\n\r\n\r\n## getAstronomicalDawnStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of astronomical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the start of astronomical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getAstronomicalDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T05:57:45.720Z\"\r\nsuntimes.getAstronomicalDawnStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getAstronomicalDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -18° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getAstronomicalDawnStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n* * *\r\n\r\n\r\n## getAstronomicalDuskStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of astronomical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the start of astronomical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getAstronomicalDuskStartDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T17:43:04.813Z\"\r\nsuntimes.getAstronomicalDuskStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getAstronomicalDuskStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -12° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getAstronomicalDuskStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n* * *\r\n\r\n\r\n## getAstronomicalDuskEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of astronomical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the end of astronomical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getAstronomicalDuskEndDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T18:22:55.985Z\"\r\nsuntimes.getAstronomicalDuskEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getAstronomicalDuskEndDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -18° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getAstronomicalDuskEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n* * *\r\n\r\n\r\n## getNauticalDuskEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of nautical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the end of nautical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNauticalDuskEndDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T17:43:04.813Z\"\r\nsuntimes.getNauticalDuskEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getNauticalDuskEndDateTimeUtc)*\r\n```js\r\n// returns The sun's altitude does not rise to -12° on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\r\nsuntimes.getNauticalDuskEndDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n**Example** *(Example usage of getNauticalDuskEndDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -12° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getNauticalDuskEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n* * *\r\n\r\n\r\n## getNauticalDuskStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of nautical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the start of nautical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNauticalDuskStartDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T17:01:25.924Z\"\r\nsuntimes.getNauticalDuskStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getNauticalDuskStartDateTimeUtc)*\r\n```js\r\n// returns The sun's altitude does not rise to -6° on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\r\nsuntimes.getNauticalDuskStartDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n**Example** *(Example usage of getNauticalDuskStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -6° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getNauticalDuskStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n* * *\r\n\r\n\r\n## getCivilDuskEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of civil dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the end of civil dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getCivilDuskEndDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T17:01:25.924Z\"\r\nsuntimes.getCivilDuskEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getCivilDuskEndDateTimeUtc)*\r\n```js\r\nreturns \"The sun's altitude does not drop to -6° on Wed Jun 18 2025 at latitude -75.100620 and longitude 123.354750\"\r\nsuntimes.getCivilDuskEndDateTimeUtc(new Date(2002, 0, 27), -75.100620, 123.354750);\r\n```\r\n**Example** *(Example usage of getNauticalDuskEndDateTimeUtc)*\r\n```js\r\n// returns The sun's altitude does not rise to -6° on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\r\nsuntimes.getCivilDuskEndDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n* * *\r\n\r\n\r\n## getCivilDuskStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of civil dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the start of civil dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getCivilDuskStartDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T16:23:11.903Z\"\r\nsuntimes.getCivilDuskStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getCivilDuskStartDateTimeUtc)*\r\n```js\r\nreturns \"The sun's altitude does not rise to -6° on Wed Jun 18 2025 at latitude -75.100620 and longitude 123.354750\"\r\nsuntimes.getCivilDuskStartDateTimeUtc(new Date(2002, 0, 27), -75.100620, 123.354750);\r\n```\r\n**Example** *(Example usage of getCivilDuskStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun is up all day on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getCivilDuskStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n**Example** *(Example usage of getCivilDuskStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun is down all day on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\"\r\nsuntimes.getCivilDuskStartDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```","readmeFilename":"README.md","gitHead":"456a665d6ac69be7147a4cc07b43775dc26a8ec5","_id":"suntimes@5.0.1-0","_nodeVersion":"12.16.1","_npmVersion":"6.8.0","dist":{"integrity":"sha512-pTOc4vPqfiCAroMvojsLgf6BiQq5N4Z+wkbId0zQ3lhQpX3RQiHfA+6X7Z+a/Z31A7PetS/YVTimPcJNsSNdmw==","shasum":"15e88ec96339e9b967438dbfaea85110d9b3fcf3","tarball":"https://registry.npmjs.org/suntimes/-/suntimes-5.0.1-0.tgz","fileCount":6,"unpackedSize":70198,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJejjmNCRA9TVsSAnZWagAATGsQAJJX/qQ0XEjcGwLzshye\n4htTAMBt0cunX8+mWWuKchHKq79amKwOIJEsA9Xgs3NqAg5IlGJzrBbDmzZD\n2heTj1dJ3Ox43jKxlFAFpwa8L+DBqlhJN+W2ajkIwjljW1Z5cVEddBxSseXc\nNbnmSE0hOkTUBpV8zb5QLuwGXRraRIaokKBkFYUljeq5vEuhnFpEDZUCWHh1\ncE8Y7FdN8fMVeQ/q9ZX8+P5Jp8sLj03OPAK689/dtY7htFyXa4tts8z1uXun\nN04lwP99AyS5nFafaOXOOvNX1HQgN0QA0M854ddbmk8t7vf+BydILG3gd5yh\ndiVA0rxVrj2pnKQsfFvIhIRg8hEitvX7ASvag9ftCQ+rq4eyHlmnKFSn5Itb\ngq2F5C01efnX1fCUsRQGCWI02Ptg8KrsWUMqgkyJBKUW4ODRAWckpKKTQdX0\nu4JBBqujfeAby2CK69ScKqE51Yzs+QchBy2sVmV5UpojaFUucZP61noHTM4C\nrUPeL054mnIum+cP28q6/UzkK/EeEyDoG/ydQV0Z29HlDt69ayfgXMy9n6hC\ne2RtDPij8XWwV5EXjgGPJoWtIAK26DdL6F31DqEdEXdHoJ5zlCVoFMoRJqvD\n7KFiT5RwAPF0umd2Zk9/1Z+ql3jDnUlz+P9VA7lr8pNjeI+21zoa7cx8edor\nppfg\r\n=Qblf\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIEK9yda4HsUcsjkyQmlxZ5K9GLTep1R6PNR3giaInbe+AiEA7+JgutCZHgqGUMYZJvyPsgCJXDRXZW3m/adwf1wl3iM="}]},"maintainers":[{"name":"doniseferi","email":"doni.seferi@gmail.com"}],"_npmUser":{"name":"doniseferi","email":"doni.seferi@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/suntimes_5.0.1-0_1586379149300_0.05363805657848886"},"_hasShrinkwrap":false},"5.0.1-1":{"name":"suntimes","version":"5.0.1-1","description":"A tiny library to get the exact date and time in utc for certain points of the day for any desired location and date.","main":"suntimes.js","typings":"suntimes.d.ts","scripts":{"readme":"jsdoc2md src/declination/getDeclinationOfTheSun.js src/equationOfTime/equationOfTime.js src/hourAngle/getHourAngle.js src/hourAngle/getNoonHourAngle.js src/time/index.js","typedef":"jsdoc -t node_modules/tsd-jsdoc/dist -r ./src/","build":"rollup -c","release":"standard-version","test":"semistandard && npm run build && nyc mocha **/*.test.js --colors --full-trace --require @babel/register","coverage":"nyc report --reporter=text-lcov | coveralls","fix":"semistandard --fix"},"repository":{"type":"git","url":"git+https://github.com/doniseferi/suntimes.git"},"keywords":["sun","suntimes","equationOfTime","solar","declination","sunrise","sunset","twilight","dusk","dawn","maths","astronomy","celestial"],"author":{"name":"Edonis Seferi"},"license":"ISC","bugs":{"url":"https://github.com/doniseferi/suntimes/issues"},"homepage":"https://github.com/doniseferi/suntimes#readme","devDependencies":{"@babel/core":"^7.7.0","@babel/preset-env":"^7.7.1","@babel/register":"^7.7.0","chai":"^4.2.0","coveralls":"^3.0.7","depcheck":"^0.9.1","eslint":"^6.6.0","eslint-config-semistandard":"^15.0.0","eslint-config-standard":"^14.1.0","eslint-plugin-import":"^2.18.2","eslint-plugin-node":"^10.0.0","eslint-plugin-promise":"^4.2.1","eslint-plugin-standard":"^4.0.1","jsdoc":"^3.6.3","jsdoc-to-markdown":"^5.0.3","mocha":"^7.1.1","nyc":"^14.1.1","rollup":"^1.27.14","rollup-plugin-babel":"^4.3.3","rollup-plugin-terser":"^5.1.3","semistandard":"^14.2.0","standard-version":"^7.1.0","tsd-jsdoc":"^2.4.0"},"dependencies":{},"readme":"\r\n\r\n
numberThe angular distance of the sun north or south of the earth's equator.
\r\nnumberThe correction between standard clock time and the time based on the exact position of the sun in the sky represented as decimal time in minutes.
\r\nnumberGets the hour angle difference between noon and the angle value.
\r\nnumberGets the noon hour angle for the date and longitude value.
\r\nstringGets the noon date and time in UTC expressed in an ISO 8601 format for date and longitude value.
\r\nstringGets the date and time in UTC expressed in an ISO 8601 format for an angle before noon for the angle, date, latitude and longitude value.
\r\nstringGets the date and time in UTC expressed in an ISO 8601 format for an angle after noon for the angle, date, latitude and longitude value.
\r\nstringGets the sunrise date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the sunset date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the end of civil dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the start of civil dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the end of nautical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the start of nautical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the end of astronomical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
stringGets the start of astronomical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the start of astronomical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the end of astronomical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
stringGets the end of nautical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the start of nautical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the end of civil dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the start of civil dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nnumber\r\nThe angular distance of the sun north or south of the earth's equator.\r\n\r\n**Kind**: global function\r\n**Returns**: number - The declination in degrees where north is a positive value and south is a negative value within a range of range of -23.45 and 23.45.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance |\r\n\r\n**Example** *(Example usage of getDeclinationOfTheSun.)*\r\n```js\r\n// returns -23.078780854838076\r\nsuntimes.getDeclinationOfTheSun(new Date(2019, 0, 1));\r\n```\r\n* * *\r\n\r\n\r\n## equationOfTime(date) ⇒ number\r\nThe correction between standard clock time and the time based on the exact position of the sun in the sky represented as decimal time in minutes.\r\n\r\n**Kind**: global function\r\n**Returns**: number - A number whose value is the equation of time in minutes decimal time for the Date represented by date.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n\r\n**Example** *(Example usage of equationOfTime.)*\r\n```js\r\n// returns -10.306964615344999\r\nsuntimes.equationOfTime(new Date(2025, 0, 18));\r\n```\r\n* * *\r\n\r\n\r\n## getHourAngleSinceNoon(date, latitude, angle) ⇒ number\r\nGets the hour angle difference between noon and the angle value.\r\n\r\n**Kind**: global function\r\n**Returns**: number - A number whose value represents the hour angle since noon for the date, latitude and angle value.\r\n**Throws**:\r\n\r\n- RangeError The sun altitude never elevates above the angle specified.\r\n- RangeError The sun altitude never drops below the angle specified.\r\n\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| angle | number | An angle value. |\r\n\r\n**Example** *(Example usage of getHourAngleSinceNoon)*\r\n```js\r\n// returns 5.54554469317797\r\nsuntimes.getHourAngleSinceNoon(new Date(2025, 0, 18), 51.477730, -12);\r\n```\r\n* * *\r\n\r\n\r\n## getNoonHourAngle(date, longitude) ⇒ number\r\nGets the noon hour angle for the date and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: number - The noon hour angle expressed as a number between 0.00 and 23.9.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNoonHourAngle)*\r\n```js\r\n// returns 12.17245941025575\r\nsuntimes.getNoonHourAngle(new Date(2025, 0, 18), -0.010150);\r\n```\r\n* * *\r\n\r\n\r\n## getNoonDateTimeUtc(date, longitude) ⇒ string\r\nGets the noon date and time in UTC expressed in an ISO 8601 format for date and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing noon date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNoonDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T12:10:20.853Z\"\r\nsuntimes.getNoonDateTimeUtc(new Date(2025, 0, 18), -0.010150);\r\n```\r\n* * *\r\n\r\n\r\n## getDateTimeUtcOfAngleBeforeNoon(angle, date, latitude, longitude) ⇒ string\r\nGets the date and time in UTC expressed in an ISO 8601 format for an angle before noon for the angle, date, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the time and date for an angle before noon in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| angle | number | An angle value. |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getDateTimeUtcOfAngleBeforeNoon)*\r\n```js\r\n// returns \"2025-01-18T05:57:45.720Z\"\r\nsuntimes.getDateTimeUtcOfAngleBeforeNoon(-18, new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getDateTimeUtcOfAngleBeforeNoon)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -18° on Wed Jun 18 2025 at latitude 51.47773 and longitude -0.01015\"\r\nsuntimes.getDateTimeUtcOfAngleBeforeNoon(-18, new Date(2025, 5, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getDateTimeUtcOfAngleBeforeNoon)*\r\n```js\r\n// returns \"The sun's altitude does not rise to 18° on Wed Jun 18 2025 at latitude -51.47773 and longitude -0.01015\"\r\nsuntimes.getDateTimeUtcOfAngleBeforeNoon(18, new Date(2025, 5, 18), -51.477730, -0.010150);\r\n```\r\n* * *\r\n\r\n\r\n## getDateTimeUtcOfAngleAfterNoon(angle, date, latitude, longitude) ⇒ string\r\nGets the date and time in UTC expressed in an ISO 8601 format for an angle after noon for the angle, date, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the time and date for an angle after noon in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| angle | number | An angle value. |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getDateTimeUtcOfAngleAfterNoon)*\r\n```js\r\n//returns \"2025-06-18T14:33:42.689Z\"\r\nsuntimes.getDateTimeUtcOfAngleAfterNoon(8, new Date(2025, 5, 18), -51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getDateTimeUtcOfAngleAfterNoon)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -18° on Sat Jan 18 2025 at latitude -51.47773 and longitude -0.01015\"\r\nsuntimes.getDateTimeUtcOfAngleAfterNoon(-18, new Date(2025, 0, 18), -51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getDateTimeUtcOfAngleAfterNoon)*\r\n```js\r\n// returns \"The sun's altitude does not rise to 18° on Wed Jun 18 2025 at latitude -51.47773 and longitude -0.01015\"\r\nsuntimes.getDateTimeUtcOfAngleAfterNoon(18, new Date(2025, 5, 18), -51.477730, -0.010150);\r\n```\r\n* * *\r\n\r\n\r\n## getSunriseDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the sunrise date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing sunrise date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getSunriseDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T07:57:29.802Z\"\r\nsuntimes.getSunriseDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getSunriseDateTimeUtc)*\r\n```js\r\n// returns \"The sun is up all day on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getSunriseDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n**Example** *(Example usage of getSunriseDateTimeUtc)*\r\n```js\r\n// returns \"The sun is down all day on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\"\r\nsuntimes.getSunriseDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n* * *\r\n\r\n\r\n## getSunsetDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the sunset date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing sunset date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getSunsetDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T16:23:11.903Z\"\r\nsuntimes.getSunsetDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getSunsetDateTimeUtc)*\r\n```js\r\n// returns \"The sun is up all day on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getSunsetDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n**Example** *(Example usage of getSunsetDateTimeUtc)*\r\n```js\r\n// returns \"The sun is down all day on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\"\r\nsuntimes.getSunsetDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n* * *\r\n\r\n\r\n## getCivilDawnEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of civil dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the end of civil dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getCivilDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T07:57:29.802Z\"\r\nsuntimes.getCivilDawnEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getCivilDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"The sun is up all day on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getCivilDawnEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n**Example** *(Example usage of getCivilDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"The sun is down all day on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\r\nsuntimes.getCivilDawnEndDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n* * *\r\n\r\n\r\n## getCivilDawnStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of civil dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the start of civil dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getCivilDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T07:19:15.781Z\"\r\nsuntimes.getCivilDawnStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getCivilDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not rise to -6° on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\"\r\nsuntimes.getCivilDawnStartDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n**Example** *(Example usage of getCivilDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -6° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getCivilDawnStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n* * *\r\n\r\n\r\n## getNauticalDawnEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of nautical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the end of nautical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNauticalDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T07:19:15.781Z\"\r\nsuntimes.getNauticalDawnEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getNauticalDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not rise to -6° on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\"\r\nsuntimes.getNauticalDawnEndDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n**Example** *(Example usage of getNauticalDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -6° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getNauticalDawnEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n* * *\r\n\r\n\r\n## getNauticalDawnStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of nautical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the start of nautical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNauticalDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T06:37:36.892Z\"\r\nsuntimes.getNauticalDawnStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getNauticalDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -12° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getNauticalDawnStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n**Example** *(Example usage of getNauticalDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not rise to -12° on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\"\r\nsuntimes.getNauticalDawnStartDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n* * *\r\n\r\n\r\n## getAstronomicalDawnEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of astronomical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the end of astronomical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getAstronomicalDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T06:37:36.892Z\"\r\nsuntimes.getAstronomicalDawnEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getAstronomicalDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -12° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getAstronomicalDawnEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n* * *\r\n\r\n\r\n## getAstronomicalDawnStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of astronomical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the start of astronomical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getAstronomicalDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T05:57:45.720Z\"\r\nsuntimes.getAstronomicalDawnStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getAstronomicalDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -18° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getAstronomicalDawnStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n* * *\r\n\r\n\r\n## getAstronomicalDuskStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of astronomical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the start of astronomical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getAstronomicalDuskStartDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T17:43:04.813Z\"\r\nsuntimes.getAstronomicalDuskStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getAstronomicalDuskStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -12° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getAstronomicalDuskStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n* * *\r\n\r\n\r\n## getAstronomicalDuskEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of astronomical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the end of astronomical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getAstronomicalDuskEndDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T18:22:55.985Z\"\r\nsuntimes.getAstronomicalDuskEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getAstronomicalDuskEndDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -18° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getAstronomicalDuskEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n* * *\r\n\r\n\r\n## getNauticalDuskEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of nautical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the end of nautical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNauticalDuskEndDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T17:43:04.813Z\"\r\nsuntimes.getNauticalDuskEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getNauticalDuskEndDateTimeUtc)*\r\n```js\r\n// returns The sun's altitude does not rise to -12° on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\r\nsuntimes.getNauticalDuskEndDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n**Example** *(Example usage of getNauticalDuskEndDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -12° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getNauticalDuskEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n* * *\r\n\r\n\r\n## getNauticalDuskStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of nautical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the start of nautical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNauticalDuskStartDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T17:01:25.924Z\"\r\nsuntimes.getNauticalDuskStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getNauticalDuskStartDateTimeUtc)*\r\n```js\r\n// returns The sun's altitude does not rise to -6° on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\r\nsuntimes.getNauticalDuskStartDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n**Example** *(Example usage of getNauticalDuskStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -6° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getNauticalDuskStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n* * *\r\n\r\n\r\n## getCivilDuskEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of civil dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the end of civil dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getCivilDuskEndDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T17:01:25.924Z\"\r\nsuntimes.getCivilDuskEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getCivilDuskEndDateTimeUtc)*\r\n```js\r\nreturns \"The sun's altitude does not drop to -6° on Wed Jun 18 2025 at latitude -75.100620 and longitude 123.354750\"\r\nsuntimes.getCivilDuskEndDateTimeUtc(new Date(2002, 0, 27), -75.100620, 123.354750);\r\n```\r\n**Example** *(Example usage of getNauticalDuskEndDateTimeUtc)*\r\n```js\r\n// returns The sun's altitude does not rise to -6° on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\r\nsuntimes.getCivilDuskEndDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n* * *\r\n\r\n\r\n## getCivilDuskStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of civil dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the start of civil dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getCivilDuskStartDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T16:23:11.903Z\"\r\nsuntimes.getCivilDuskStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getCivilDuskStartDateTimeUtc)*\r\n```js\r\nreturns \"The sun's altitude does not rise to -6° on Wed Jun 18 2025 at latitude -75.100620 and longitude 123.354750\"\r\nsuntimes.getCivilDuskStartDateTimeUtc(new Date(2002, 0, 27), -75.100620, 123.354750);\r\n```\r\n**Example** *(Example usage of getCivilDuskStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun is up all day on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getCivilDuskStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n**Example** *(Example usage of getCivilDuskStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun is down all day on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\"\r\nsuntimes.getCivilDuskStartDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```","readmeFilename":"README.md","gitHead":"742fbc6561259e92f9a8beff8a536e76d6dbfb75","_id":"suntimes@5.0.1-1","_nodeVersion":"12.16.1","_npmVersion":"6.8.0","dist":{"integrity":"sha512-B3iwnUXvsB5R8aKvIbR5uNLayIDzHL9NEdREr3Mw8o3hLTHWDn2WFLE1XkNnM3AF9Sazb0MJyi3dB++gMduSSQ==","shasum":"9f3e3df250a684358d3a5841d4f6ac335e908369","tarball":"https://registry.npmjs.org/suntimes/-/suntimes-5.0.1-1.tgz","fileCount":6,"unpackedSize":70428,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJej5bPCRA9TVsSAnZWagAAYrYP/30LPWdJPCcLDnLiXy8K\nhSW5Uu3vrCGRwG/2aiSH/dsxGMYhiBJ4/hAx2r/v0puTsiX4NcH9jzJSZehx\nfVOGwlDyUWR+lHmkVYqxMn4siYHVzrH3oEyasRAdr+d8M3Zqy5e/n6KRSF1J\nQbay+FBpRPd/8QVnIxMqqoWvL+FpyDK2fhq0rj0bASUGxz/uKY2YHrwdeq/Z\n26X/dOCYk7+Yno00lJg+EPZSOJz3C0To0CqWljDC7W/i4qiK4IFSLy7JW2Ey\nLQqGQJmn2EcHVqZTzO6Rq/Q90k4dwQOSIr3ErzqD4ykdqWXEnz3SV7WdC13l\nyL9GAaCZXElDVUmMM+uKdZ/BOyp+tTKGgWKSVi8gvA/7o9I5ibOYWk0cZ5+J\npwHNXby0qbG/lXkip6roRi1tk36z7TE0AOgQRxyZvuKdtU4CTxH7NdEVWOcQ\n0BqypPXbBQUPfhqVeS0uXtjQHIj7WDFHxnOxSmPdwgI70pkQxgfRBcWwy26U\nGpZrh7NGA57UvBQNBFTns8wR+XRET6o1QDZqb+h0boI7+U+IRVEGuoSd+3PX\nGzQ4acKzfAENdtCF+zHrYe8I0sv5FMCPrw8OUd5GOD2mh7gJphyeL9MJ8fWo\nmQhjbl0+B4cyL6qNNSglI22Dir4WDmUMcn8hHd9eDeVP8BR7HAUAKmzki+zy\nih3O\r\n=kpco\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCcPFYU/1Mvl0gRXdoUwEle+hKHnSOVtxW+Ia8J14ncvwIgeR2ETJaZBTRlEZX+sNnr9M0U2t7Rsk8sQBs6MRqwhnM="}]},"maintainers":[{"name":"doniseferi","email":"doni.seferi@gmail.com"}],"_npmUser":{"name":"doniseferi","email":"doni.seferi@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/suntimes_5.0.1-1_1586468559408_0.8248820728751629"},"_hasShrinkwrap":false},"5.0.1-2":{"name":"suntimes","version":"5.0.1-2","description":"A tiny library to get the exact date and time in utc for certain points of the day for any desired location and date.","main":"suntimes.js","typings":"suntimes.d.ts","scripts":{"readme":"jsdoc2md src/declination/getDeclinationOfTheSun.js src/equationOfTime/equationOfTime.js src/hourAngle/getHourAngle.js src/hourAngle/getNoonHourAngle.js src/time/index.js src/index.js","typedef":"jsdoc -t node_modules/tsd-jsdoc/dist -r ./src/","build":"rollup -c","release":"standard-version","test":"semistandard && npm run build && nyc mocha **/*.test.js --colors --full-trace --require @babel/register","coverage":"nyc report --reporter=text-lcov | coveralls","fix":"semistandard --fix"},"repository":{"type":"git","url":"git+https://github.com/doniseferi/suntimes.git"},"keywords":["sun","suntimes","equationOfTime","solar","declination","sunrise","sunset","twilight","dusk","dawn","maths","astronomy","celestial"],"author":{"name":"Edonis Seferi"},"license":"ISC","bugs":{"url":"https://github.com/doniseferi/suntimes/issues"},"homepage":"https://github.com/doniseferi/suntimes#readme","devDependencies":{"@babel/core":"^7.7.0","@babel/preset-env":"^7.7.1","@babel/register":"^7.7.0","chai":"^4.2.0","coveralls":"^3.0.7","depcheck":"^0.9.1","eslint":"^6.6.0","eslint-config-semistandard":"^15.0.0","eslint-config-standard":"^14.1.0","eslint-plugin-import":"^2.18.2","eslint-plugin-node":"^10.0.0","eslint-plugin-promise":"^4.2.1","eslint-plugin-standard":"^4.0.1","jsdoc":"^3.6.3","jsdoc-to-markdown":"^5.0.3","mocha":"^7.1.1","nyc":"^14.1.1","rollup":"^1.27.14","rollup-plugin-babel":"^4.3.3","rollup-plugin-terser":"^5.1.3","semistandard":"^14.2.0","standard-version":"^7.1.0","tsd-jsdoc":"^2.4.0"},"dependencies":{},"gitHead":"b597f54059a5686057dff4d8afdccb88abc02e3b","readme":"\r\n\r\n
numberThe angular distance of the sun north or south of the earth's equator.
\r\nnumberThe correction between standard clock time and the time based on the exact position of the sun in the sky represented as decimal time in minutes.
\r\nnumberGets the hour angle difference between noon and the angle value.
\r\nnumberGets the noon hour angle for the date and longitude value.
\r\nstringGets the noon date and time in UTC expressed in an ISO 8601 format for date and longitude value.
\r\nstringGets the date and time in UTC expressed in an ISO 8601 format for an angle before noon for the angle, date, latitude and longitude value.
\r\nstringGets the date and time in UTC expressed in an ISO 8601 format for an angle after noon for the angle, date, latitude and longitude value.
\r\nstringGets the sunrise date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the sunset date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the end of civil dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the start of civil dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the end of nautical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the start of nautical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the end of astronomical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the start of astronomical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the start of astronomical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the end of astronomical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the end of nautical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the start of nautical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the end of civil dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the start of civil dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nObjectnumber\r\nThe angular distance of the sun north or south of the earth's equator.\r\n\r\n**Kind**: global function\r\n**Returns**: number - The declination in degrees where north is a positive value and south is a negative value within a range of range of -23.45 and 23.45.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance |\r\n\r\n**Example** *(Example usage of getDeclinationOfTheSun.)*\r\n```js\r\n// returns -23.078780854838076\r\nsuntimes.getDeclinationOfTheSun(new Date(2019, 0, 1));\r\n```\r\n\r\n\r\n## equationOfTime(date) ⇒ number\r\nThe correction between standard clock time and the time based on the exact position of the sun in the sky represented as decimal time in minutes.\r\n\r\n**Kind**: global function\r\n**Returns**: number - A number whose value is the equation of time in minutes decimal time for the Date represented by date.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n\r\n**Example** *(Example usage of equationOfTime.)*\r\n```js\r\n// returns -10.306964615344999\r\nsuntimes.equationOfTime(new Date(2025, 0, 18));\r\n```\r\n\r\n\r\n## getHourAngleSinceNoon(date, latitude, angle) ⇒ number\r\nGets the hour angle difference between noon and the angle value.\r\n\r\n**Kind**: global function\r\n**Returns**: number - A number whose value represents the hour angle since noon for the date, latitude and angle value.\r\n**Throws**:\r\n\r\n- RangeError The sun altitude never elevates above the angle specified.\r\n- RangeError The sun altitude never drops below the angle specified.\r\n\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| angle | number | An angle value. |\r\n\r\n**Example** *(Example usage of getHourAngleSinceNoon)*\r\n```js\r\n// returns 5.54554469317797\r\nsuntimes.getHourAngleSinceNoon(new Date(2025, 0, 18), 51.477730, -12);\r\n```\r\n\r\n\r\n## getNoonHourAngle(date, longitude) ⇒ number\r\nGets the noon hour angle for the date and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: number - The noon hour angle expressed as a number between 0.00 and 23.9.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNoonHourAngle)*\r\n```js\r\n// returns 12.17245941025575\r\nsuntimes.getNoonHourAngle(new Date(2025, 0, 18), -0.010150);\r\n```\r\n\r\n\r\n## getNoonDateTimeUtc(date, longitude) ⇒ string\r\nGets the noon date and time in UTC expressed in an ISO 8601 format for date and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing noon date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNoonDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T12:10:20.853Z\"\r\nsuntimes.getNoonDateTimeUtc(new Date(2025, 0, 18), -0.010150);\r\n```\r\n\r\n\r\n## getDateTimeUtcOfAngleBeforeNoon(angle, date, latitude, longitude) ⇒ string\r\nGets the date and time in UTC expressed in an ISO 8601 format for an angle before noon for the angle, date, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the time and date for an angle before noon in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| angle | number | An angle value. |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getDateTimeUtcOfAngleBeforeNoon)*\r\n```js\r\n// returns \"2025-01-18T05:57:45.720Z\"\r\nsuntimes.getDateTimeUtcOfAngleBeforeNoon(-18, new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getDateTimeUtcOfAngleBeforeNoon)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -18° on Wed Jun 18 2025 at latitude 51.47773 and longitude -0.01015\"\r\nsuntimes.getDateTimeUtcOfAngleBeforeNoon(-18, new Date(2025, 5, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getDateTimeUtcOfAngleBeforeNoon)*\r\n```js\r\n// returns \"The sun's altitude does not rise to 18° on Wed Jun 18 2025 at latitude -51.47773 and longitude -0.01015\"\r\nsuntimes.getDateTimeUtcOfAngleBeforeNoon(18, new Date(2025, 5, 18), -51.477730, -0.010150);\r\n```\r\n\r\n\r\n## getDateTimeUtcOfAngleAfterNoon(angle, date, latitude, longitude) ⇒ string\r\nGets the date and time in UTC expressed in an ISO 8601 format for an angle after noon for the angle, date, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the time and date for an angle after noon in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| angle | number | An angle value. |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getDateTimeUtcOfAngleAfterNoon)*\r\n```js\r\n//returns \"2025-06-18T14:33:42.689Z\"\r\nsuntimes.getDateTimeUtcOfAngleAfterNoon(8, new Date(2025, 5, 18), -51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getDateTimeUtcOfAngleAfterNoon)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -18° on Sat Jan 18 2025 at latitude -51.47773 and longitude -0.01015\"\r\nsuntimes.getDateTimeUtcOfAngleAfterNoon(-18, new Date(2025, 0, 18), -51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getDateTimeUtcOfAngleAfterNoon)*\r\n```js\r\n// returns \"The sun's altitude does not rise to 18° on Wed Jun 18 2025 at latitude -51.47773 and longitude -0.01015\"\r\nsuntimes.getDateTimeUtcOfAngleAfterNoon(18, new Date(2025, 5, 18), -51.477730, -0.010150);\r\n```\r\n\r\n\r\n## getSunriseDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the sunrise date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing sunrise date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getSunriseDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T07:57:29.802Z\"\r\nsuntimes.getSunriseDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getSunriseDateTimeUtc)*\r\n```js\r\n// returns \"The sun is up all day on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getSunriseDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n**Example** *(Example usage of getSunriseDateTimeUtc)*\r\n```js\r\n// returns \"The sun is down all day on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\"\r\nsuntimes.getSunriseDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n\r\n\r\n## getSunsetDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the sunset date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing sunset date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getSunsetDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T16:23:11.903Z\"\r\nsuntimes.getSunsetDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getSunsetDateTimeUtc)*\r\n```js\r\n// returns \"The sun is up all day on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getSunsetDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n**Example** *(Example usage of getSunsetDateTimeUtc)*\r\n```js\r\n// returns \"The sun is down all day on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\"\r\nsuntimes.getSunsetDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n\r\n\r\n## getCivilDawnEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of civil dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the end of civil dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getCivilDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T07:57:29.802Z\"\r\nsuntimes.getCivilDawnEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getCivilDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"The sun is up all day on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getCivilDawnEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n**Example** *(Example usage of getCivilDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"The sun is down all day on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\r\nsuntimes.getCivilDawnEndDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n\r\n\r\n## getCivilDawnStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of civil dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the start of civil dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getCivilDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T07:19:15.781Z\"\r\nsuntimes.getCivilDawnStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getCivilDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not rise to -6° on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\"\r\nsuntimes.getCivilDawnStartDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n**Example** *(Example usage of getCivilDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -6° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getCivilDawnStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n\r\n\r\n## getNauticalDawnEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of nautical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the end of nautical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNauticalDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T07:19:15.781Z\"\r\nsuntimes.getNauticalDawnEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getNauticalDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not rise to -6° on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\"\r\nsuntimes.getNauticalDawnEndDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n**Example** *(Example usage of getNauticalDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -6° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getNauticalDawnEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n\r\n\r\n## getNauticalDawnStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of nautical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the start of nautical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNauticalDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T06:37:36.892Z\"\r\nsuntimes.getNauticalDawnStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getNauticalDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -12° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getNauticalDawnStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n**Example** *(Example usage of getNauticalDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not rise to -12° on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\"\r\nsuntimes.getNauticalDawnStartDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n\r\n\r\n## getAstronomicalDawnEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of astronomical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the end of astronomical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getAstronomicalDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T06:37:36.892Z\"\r\nsuntimes.getAstronomicalDawnEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getAstronomicalDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -12° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getAstronomicalDawnEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n\r\n\r\n## getAstronomicalDawnStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of astronomical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the start of astronomical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getAstronomicalDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T05:57:45.720Z\"\r\nsuntimes.getAstronomicalDawnStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getAstronomicalDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -18° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getAstronomicalDawnStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n\r\n\r\n## getAstronomicalDuskStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of astronomical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the start of astronomical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getAstronomicalDuskStartDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T17:43:04.813Z\"\r\nsuntimes.getAstronomicalDuskStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getAstronomicalDuskStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -12° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getAstronomicalDuskStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n\r\n\r\n## getAstronomicalDuskEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of astronomical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the end of astronomical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getAstronomicalDuskEndDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T18:22:55.985Z\"\r\nsuntimes.getAstronomicalDuskEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getAstronomicalDuskEndDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -18° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getAstronomicalDuskEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n\r\n\r\n## getNauticalDuskEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of nautical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the end of nautical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNauticalDuskEndDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T17:43:04.813Z\"\r\nsuntimes.getNauticalDuskEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getNauticalDuskEndDateTimeUtc)*\r\n```js\r\n// returns The sun's altitude does not rise to -12° on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\r\nsuntimes.getNauticalDuskEndDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n**Example** *(Example usage of getNauticalDuskEndDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -12° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getNauticalDuskEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n\r\n\r\n## getNauticalDuskStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of nautical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the start of nautical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNauticalDuskStartDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T17:01:25.924Z\"\r\nsuntimes.getNauticalDuskStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getNauticalDuskStartDateTimeUtc)*\r\n```js\r\n// returns The sun's altitude does not rise to -6° on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\r\nsuntimes.getNauticalDuskStartDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n**Example** *(Example usage of getNauticalDuskStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -6° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getNauticalDuskStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n\r\n\r\n## getCivilDuskEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of civil dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the end of civil dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getCivilDuskEndDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T17:01:25.924Z\"\r\nsuntimes.getCivilDuskEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getCivilDuskEndDateTimeUtc)*\r\n```js\r\nreturns \"The sun's altitude does not drop to -6° on Wed Jun 18 2025 at latitude -75.100620 and longitude 123.354750\"\r\nsuntimes.getCivilDuskEndDateTimeUtc(new Date(2002, 0, 27), -75.100620, 123.354750);\r\n```\r\n**Example** *(Example usage of getNauticalDuskEndDateTimeUtc)*\r\n```js\r\n// returns The sun's altitude does not rise to -6° on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\r\nsuntimes.getCivilDuskEndDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n\r\n\r\n## getCivilDuskStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of civil dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the start of civil dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getCivilDuskStartDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T16:23:11.903Z\"\r\nsuntimes.getCivilDuskStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getCivilDuskStartDateTimeUtc)*\r\n```js\r\nreturns \"The sun's altitude does not rise to -6° on Wed Jun 18 2025 at latitude -75.100620 and longitude 123.354750\"\r\nsuntimes.getCivilDuskStartDateTimeUtc(new Date(2002, 0, 27), -75.100620, 123.354750);\r\n```\r\n**Example** *(Example usage of getCivilDuskStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun is up all day on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getCivilDuskStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n**Example** *(Example usage of getCivilDuskStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun is down all day on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\"\r\nsuntimes.getCivilDuskStartDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n\r\n\r\n## suntimes : Object\r\n**Kind**: global typedef\r\n**Properties**\r\n\r\n| Name | Type |\r\n| --- | --- |\r\n| getNoonDateTimeUtc | [getNoonDateTimeUtc](#getNoonDateTimeUtc) |\r\n| getDateTimeUtcOfAngleBeforeNoon | [getDateTimeUtcOfAngleBeforeNoon](#getDateTimeUtcOfAngleBeforeNoon) |\r\n| getDateTimeUtcOfAngleAfterNoon | [getDateTimeUtcOfAngleAfterNoon](#getDateTimeUtcOfAngleAfterNoon) |\r\n| getSunriseDateTimeUtc | [getSunriseDateTimeUtc](#getSunriseDateTimeUtc) |\r\n| getSunsetDateTimeUtc | [getSunsetDateTimeUtc](#getSunsetDateTimeUtc) |\r\n| getCivilDawnEndDateTimeUtc | [getCivilDawnEndDateTimeUtc](#getCivilDawnEndDateTimeUtc) |\r\n| getCivilDawnStartDateTimeUtc | [getCivilDawnStartDateTimeUtc](#getCivilDawnStartDateTimeUtc) |\r\n| getNauticalDawnEndDateTimeUtc | [getNauticalDawnEndDateTimeUtc](#getNauticalDawnEndDateTimeUtc) |\r\n| getNauticalDawnStartDateTimeUtc | [getNauticalDawnStartDateTimeUtc](#getNauticalDawnStartDateTimeUtc) |\r\n| getAstronomicalDawnEndDateTimeUtc | [getAstronomicalDawnEndDateTimeUtc](#getAstronomicalDawnEndDateTimeUtc) |\r\n| getAstronomicalDawnStartDateTimeUtc | [getAstronomicalDawnStartDateTimeUtc](#getAstronomicalDawnStartDateTimeUtc) |\r\n| getAstronomicalDuskStartDateTimeUtc | [getAstronomicalDuskStartDateTimeUtc](#getAstronomicalDuskStartDateTimeUtc) |\r\n| getAstronomicalDuskEndDateTimeUtc | [getAstronomicalDuskEndDateTimeUtc](#getAstronomicalDuskEndDateTimeUtc) |\r\n| getNauticalDuskEndDateTimeUtc | [getNauticalDuskEndDateTimeUtc](#getNauticalDuskEndDateTimeUtc) |\r\n| getNauticalDuskStartDateTimeUtc | [getNauticalDuskStartDateTimeUtc](#getNauticalDuskStartDateTimeUtc) |\r\n| getCivilDuskEndDateTimeUtc | [getCivilDuskEndDateTimeUtc](#getCivilDuskEndDateTimeUtc) |\r\n| getCivilDuskStartDateTimeUtc | [getCivilDuskStartDateTimeUtc](#getCivilDuskStartDateTimeUtc) |\r\n","readmeFilename":"README.md","_id":"suntimes@5.0.1-2","_nodeVersion":"12.16.1","_npmVersion":"6.8.0","dist":{"integrity":"sha512-HbIxgbRQz1win5dXWmjQcwzM3KBlZ8tOdgxjio7l4y1qS7dH4x0q7U3UgWyFVi0nB47ZAFKt8GFFcCDzpWEPtg==","shasum":"b5a15381cc5fdb20c697556136598d914d925dde","tarball":"https://registry.npmjs.org/suntimes/-/suntimes-5.0.1-2.tgz","fileCount":6,"unpackedSize":75652,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJekMFPCRA9TVsSAnZWagAAdMoP/Rrl6JmqXUGzptHMzu9N\n/xAcRFCws86JVaKGVPBcMIkhualzXPZ4g5/d86mtPWsHMyWk9NOU1TWJoiTP\nUpd/GdQmBMD4DrMbIPoWebDVi5sJbNcg+B8xb4HeVhKx3WlWKgCmqZssAr3k\nnkGCP5NKHvafsbsnxBoM/Ay/NlYIqXtYm4s/0wXnvBjmfPHgpNcnrrvT/Dpm\n9zqStL44MGZXT6Cgl6YRaxLf78Ji/r6WHYEp1GvG+vC4HvJwnVNWdf1l9TyV\n08JMOvCoKlx5BC3NmYHzi6DJxq0BuBCzFpjdnrBzK8BjtJaVwoYD2PWZHEw9\nXnAKCJf/rcsoatyfaJ8h9q+xKJYkCHkuzijE2lCV9hR345LdHV2aR1vOP3V+\nXBkDNX1ka8juqSE8E1zdbKuN96aXIqPdY3KB7XnKmMn4ATpYK3pH7kOz2431\nJnbGa6vrHxnlFo9Cs9TEKvffFaiGk2Jj2qfcpfT+j5h8uOxoAOPye0Nj7cfa\nd4sAAjTNYigOcAhV7WixswbHOvCBirOgh8hS//KN+zLgcmW0pYQghVQCBkqF\nrXQK/6X0Q+gL+zKjwIkUXUkIVCIXxrFsz7kjCpQ8fbIg8yTrR/gX3/bOF8AD\nDfSwWSQtpyCmjsrl88yDHatQ7zBROy58qzE7hAnagPS6ZdqiKD5qtMOr3qYk\n0xX3\r\n=FSKc\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIB1jjx2AmhT/nOyAqfmPTcI/FwDdc3mkEBvkelb6IaSpAiBeY3cNXES+2f3e5SC1wHJvS2JzroJMnD2ShxID8qEKPQ=="}]},"maintainers":[{"name":"doniseferi","email":"doni.seferi@gmail.com"}],"_npmUser":{"name":"doniseferi","email":"doni.seferi@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/suntimes_5.0.1-2_1586544974828_0.053202620848296744"},"_hasShrinkwrap":false},"5.0.1-3":{"name":"suntimes","version":"5.0.1-3","description":"A tiny library to get the exact date and time in utc for certain points of the day for any desired location and date.","main":"suntimes.js","typings":"suntimes.d.ts","scripts":{"readme":"jsdoc2md src/declination/getDeclinationOfTheSun.js src/equationOfTime/equationOfTime.js src/hourAngle/getHourAngle.js src/hourAngle/getNoonHourAngle.js src/time/index.js src/index.js","typedef":"jsdoc -t node_modules/tsd-jsdoc/dist -r ./src/","build":"rollup -c","release":"standard-version","test":"semistandard && npm run build && nyc mocha **/*.test.js --colors --full-trace --require @babel/register","coverage":"nyc report --reporter=text-lcov | coveralls","fix":"semistandard --fix"},"repository":{"type":"git","url":"git+https://github.com/doniseferi/suntimes.git"},"keywords":["sun","suntimes","equationOfTime","solar","declination","sunrise","sunset","twilight","dusk","dawn","maths","astronomy","celestial"],"author":{"name":"Edonis Seferi"},"license":"ISC","bugs":{"url":"https://github.com/doniseferi/suntimes/issues"},"homepage":"https://github.com/doniseferi/suntimes#readme","devDependencies":{"@babel/core":"^7.7.0","@babel/preset-env":"^7.7.1","@babel/register":"^7.7.0","chai":"^4.2.0","coveralls":"^3.0.7","depcheck":"^0.9.1","eslint":"^6.6.0","eslint-config-semistandard":"^15.0.0","eslint-config-standard":"^14.1.0","eslint-plugin-import":"^2.18.2","eslint-plugin-node":"^10.0.0","eslint-plugin-promise":"^4.2.1","eslint-plugin-standard":"^4.0.1","jsdoc":"^3.6.3","jsdoc-to-markdown":"^5.0.3","mocha":"^7.1.1","nyc":"^14.1.1","rollup":"^1.27.14","rollup-plugin-babel":"^4.3.3","rollup-plugin-terser":"^5.1.3","semistandard":"^14.2.0","standard-version":"^7.1.0","tsd-jsdoc":"^2.4.0"},"dependencies":{},"readme":"\r\n\r\n
numberThe angular distance of the sun north or south of the earth's equator.
\r\nnumberThe correction between standard clock time and the time based on the exact position of the sun in the sky represented as decimal time in minutes.
\r\nnumberGets the hour angle difference between noon and the angle value.
\r\nnumberGets the noon hour angle for the date and longitude value.
\r\nstringGets the noon date and time in UTC expressed in an ISO 8601 format for date and longitude value.
\r\nstringGets the date and time in UTC expressed in an ISO 8601 format for an angle before noon for the angle, date, latitude and longitude value.
\r\nstringGets the date and time in UTC expressed in an ISO 8601 format for an angle after noon for the angle, date, latitude and longitude value.
\r\nstringGets the sunrise date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the sunset date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the end of civil dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the start of civil dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the end of nautical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the start of nautical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the end of astronomical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the start of astronomical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the start of astronomical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the end of astronomical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the end of nautical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the start of nautical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the end of civil dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nstringGets the start of civil dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\r\nObjectnumber\r\nThe angular distance of the sun north or south of the earth's equator.\r\n\r\n**Kind**: global function\r\n**Returns**: number - The declination in degrees where north is a positive value and south is a negative value within a range of range of -23.45 and 23.45.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance |\r\n\r\n**Example** *(Example usage of getDeclinationOfTheSun.)*\r\n```js\r\n// returns -23.078780854838076\r\nsuntimes.getDeclinationOfTheSun(new Date(2019, 0, 1));\r\n```\r\n\r\n\r\n## equationOfTime(date) ⇒ number\r\nThe correction between standard clock time and the time based on the exact position of the sun in the sky represented as decimal time in minutes.\r\n\r\n**Kind**: global function\r\n**Returns**: number - A number whose value is the equation of time in minutes decimal time for the Date represented by date.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n\r\n**Example** *(Example usage of equationOfTime.)*\r\n```js\r\n// returns -10.306964615344999\r\nsuntimes.equationOfTime(new Date(2025, 0, 18));\r\n```\r\n\r\n\r\n## getHourAngleSinceNoon(date, latitude, angle) ⇒ number\r\nGets the hour angle difference between noon and the angle value.\r\n\r\n**Kind**: global function\r\n**Returns**: number - A number whose value represents the hour angle since noon for the date, latitude and angle value.\r\n**Throws**:\r\n\r\n- RangeError The sun altitude never elevates above the angle specified.\r\n- RangeError The sun altitude never drops below the angle specified.\r\n\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| angle | number | An angle value. |\r\n\r\n**Example** *(Example usage of getHourAngleSinceNoon)*\r\n```js\r\n// returns 5.54554469317797\r\nsuntimes.getHourAngleSinceNoon(new Date(2025, 0, 18), 51.477730, -12);\r\n```\r\n\r\n\r\n## getNoonHourAngle(date, longitude) ⇒ number\r\nGets the noon hour angle for the date and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: number - The noon hour angle expressed as a number between 0.00 and 23.9.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNoonHourAngle)*\r\n```js\r\n// returns 12.17245941025575\r\nsuntimes.getNoonHourAngle(new Date(2025, 0, 18), -0.010150);\r\n```\r\n\r\n\r\n## getNoonDateTimeUtc(date, longitude) ⇒ string\r\nGets the noon date and time in UTC expressed in an ISO 8601 format for date and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing noon date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNoonDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T12:10:20.853Z\"\r\nsuntimes.getNoonDateTimeUtc(new Date(2025, 0, 18), -0.010150);\r\n```\r\n\r\n\r\n## getDateTimeUtcOfAngleBeforeNoon(angle, date, latitude, longitude) ⇒ string\r\nGets the date and time in UTC expressed in an ISO 8601 format for an angle before noon for the angle, date, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the time and date for an angle before noon in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| angle | number | An angle value. |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getDateTimeUtcOfAngleBeforeNoon)*\r\n```js\r\n// returns \"2025-01-18T05:57:45.720Z\"\r\nsuntimes.getDateTimeUtcOfAngleBeforeNoon(-18, new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getDateTimeUtcOfAngleBeforeNoon)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -18° on Wed Jun 18 2025 at latitude 51.47773 and longitude -0.01015\"\r\nsuntimes.getDateTimeUtcOfAngleBeforeNoon(-18, new Date(2025, 5, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getDateTimeUtcOfAngleBeforeNoon)*\r\n```js\r\n// returns \"The sun's altitude does not rise to 18° on Wed Jun 18 2025 at latitude -51.47773 and longitude -0.01015\"\r\nsuntimes.getDateTimeUtcOfAngleBeforeNoon(18, new Date(2025, 5, 18), -51.477730, -0.010150);\r\n```\r\n\r\n\r\n## getDateTimeUtcOfAngleAfterNoon(angle, date, latitude, longitude) ⇒ string\r\nGets the date and time in UTC expressed in an ISO 8601 format for an angle after noon for the angle, date, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the time and date for an angle after noon in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| angle | number | An angle value. |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getDateTimeUtcOfAngleAfterNoon)*\r\n```js\r\n//returns \"2025-06-18T14:33:42.689Z\"\r\nsuntimes.getDateTimeUtcOfAngleAfterNoon(8, new Date(2025, 5, 18), -51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getDateTimeUtcOfAngleAfterNoon)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -18° on Sat Jan 18 2025 at latitude -51.47773 and longitude -0.01015\"\r\nsuntimes.getDateTimeUtcOfAngleAfterNoon(-18, new Date(2025, 0, 18), -51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getDateTimeUtcOfAngleAfterNoon)*\r\n```js\r\n// returns \"The sun's altitude does not rise to 18° on Wed Jun 18 2025 at latitude -51.47773 and longitude -0.01015\"\r\nsuntimes.getDateTimeUtcOfAngleAfterNoon(18, new Date(2025, 5, 18), -51.477730, -0.010150);\r\n```\r\n\r\n\r\n## getSunriseDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the sunrise date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing sunrise date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getSunriseDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T07:57:29.802Z\"\r\nsuntimes.getSunriseDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getSunriseDateTimeUtc)*\r\n```js\r\n// returns \"The sun is up all day on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getSunriseDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n**Example** *(Example usage of getSunriseDateTimeUtc)*\r\n```js\r\n// returns \"The sun is down all day on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\"\r\nsuntimes.getSunriseDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n\r\n\r\n## getSunsetDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the sunset date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing sunset date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getSunsetDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T16:23:11.903Z\"\r\nsuntimes.getSunsetDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getSunsetDateTimeUtc)*\r\n```js\r\n// returns \"The sun is up all day on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getSunsetDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n**Example** *(Example usage of getSunsetDateTimeUtc)*\r\n```js\r\n// returns \"The sun is down all day on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\"\r\nsuntimes.getSunsetDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n\r\n\r\n## getCivilDawnEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of civil dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the end of civil dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getCivilDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T07:57:29.802Z\"\r\nsuntimes.getCivilDawnEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getCivilDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"The sun is up all day on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getCivilDawnEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n**Example** *(Example usage of getCivilDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"The sun is down all day on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\r\nsuntimes.getCivilDawnEndDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n\r\n\r\n## getCivilDawnStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of civil dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the start of civil dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getCivilDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T07:19:15.781Z\"\r\nsuntimes.getCivilDawnStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getCivilDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not rise to -6° on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\"\r\nsuntimes.getCivilDawnStartDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n**Example** *(Example usage of getCivilDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -6° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getCivilDawnStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n\r\n\r\n## getNauticalDawnEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of nautical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the end of nautical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNauticalDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T07:19:15.781Z\"\r\nsuntimes.getNauticalDawnEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getNauticalDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not rise to -6° on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\"\r\nsuntimes.getNauticalDawnEndDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n**Example** *(Example usage of getNauticalDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -6° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getNauticalDawnEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n\r\n\r\n## getNauticalDawnStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of nautical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the start of nautical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNauticalDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T06:37:36.892Z\"\r\nsuntimes.getNauticalDawnStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getNauticalDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -12° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getNauticalDawnStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n**Example** *(Example usage of getNauticalDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not rise to -12° on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\"\r\nsuntimes.getNauticalDawnStartDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n\r\n\r\n## getAstronomicalDawnEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of astronomical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the end of astronomical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getAstronomicalDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T06:37:36.892Z\"\r\nsuntimes.getAstronomicalDawnEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getAstronomicalDawnEndDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -12° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getAstronomicalDawnEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n\r\n\r\n## getAstronomicalDawnStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of astronomical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the start of astronomical dawn date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getAstronomicalDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T05:57:45.720Z\"\r\nsuntimes.getAstronomicalDawnStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getAstronomicalDawnStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -18° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getAstronomicalDawnStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n\r\n\r\n## getAstronomicalDuskStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of astronomical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the start of astronomical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getAstronomicalDuskStartDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T17:43:04.813Z\"\r\nsuntimes.getAstronomicalDuskStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getAstronomicalDuskStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -12° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getAstronomicalDuskStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n\r\n\r\n## getAstronomicalDuskEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of astronomical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the end of astronomical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getAstronomicalDuskEndDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T18:22:55.985Z\"\r\nsuntimes.getAstronomicalDuskEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getAstronomicalDuskEndDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -18° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getAstronomicalDuskEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n\r\n\r\n## getNauticalDuskEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of nautical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the end of nautical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNauticalDuskEndDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T17:43:04.813Z\"\r\nsuntimes.getNauticalDuskEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getNauticalDuskEndDateTimeUtc)*\r\n```js\r\n// returns The sun's altitude does not rise to -12° on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\r\nsuntimes.getNauticalDuskEndDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n**Example** *(Example usage of getNauticalDuskEndDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -12° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getNauticalDuskEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n\r\n\r\n## getNauticalDuskStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of nautical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the start of nautical dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getNauticalDuskStartDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T17:01:25.924Z\"\r\nsuntimes.getNauticalDuskStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getNauticalDuskStartDateTimeUtc)*\r\n```js\r\n// returns The sun's altitude does not rise to -6° on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\r\nsuntimes.getNauticalDuskStartDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n**Example** *(Example usage of getNauticalDuskStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun's altitude does not drop to -6° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getNauticalDuskStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n\r\n\r\n## getCivilDuskEndDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the end of civil dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the end of civil dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getCivilDuskEndDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T17:01:25.924Z\"\r\nsuntimes.getCivilDuskEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getCivilDuskEndDateTimeUtc)*\r\n```js\r\nreturns \"The sun's altitude does not drop to -6° on Wed Jun 18 2025 at latitude -75.100620 and longitude 123.354750\"\r\nsuntimes.getCivilDuskEndDateTimeUtc(new Date(2002, 0, 27), -75.100620, 123.354750);\r\n```\r\n**Example** *(Example usage of getNauticalDuskEndDateTimeUtc)*\r\n```js\r\n// returns The sun's altitude does not rise to -6° on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\r\nsuntimes.getCivilDuskEndDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n\r\n\r\n## getCivilDuskStartDateTimeUtc(date, latitude, longitude) ⇒ string\r\nGets the start of civil dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\r\n\r\n**Kind**: global function\r\n**Returns**: string - A string representing the start of civil dusk date and time in UTC, expressed in an ISO 8601 format.\r\n\r\n| Param | Type | Description |\r\n| --- | --- | --- |\r\n| date | Date | A date instance. |\r\n| latitude | number | A latitude value in the range of -90 to 90. |\r\n| longitude | number | A longitude value in the range of -180 to 180. |\r\n\r\n**Example** *(Example usage of getCivilDuskStartDateTimeUtc)*\r\n```js\r\n// returns \"2025-01-18T16:23:11.903Z\"\r\nsuntimes.getCivilDuskStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\r\n```\r\n**Example** *(Example usage of getCivilDuskStartDateTimeUtc)*\r\n```js\r\nreturns \"The sun's altitude does not rise to -6° on Wed Jun 18 2025 at latitude -75.100620 and longitude 123.354750\"\r\nsuntimes.getCivilDuskStartDateTimeUtc(new Date(2002, 0, 27), -75.100620, 123.354750);\r\n```\r\n**Example** *(Example usage of getCivilDuskStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun is up all day on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\r\nsuntimes.getCivilDuskStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\r\n```\r\n**Example** *(Example usage of getCivilDuskStartDateTimeUtc)*\r\n```js\r\n// returns \"The sun is down all day on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\"\r\nsuntimes.getCivilDuskStartDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\r\n```\r\n\r\n\r\n## suntimes : Object\r\n**Kind**: global typedef\r\n**Properties**\r\n\r\n| Name | Type |\r\n| --- | --- |\r\n| getNoonDateTimeUtc | [getNoonDateTimeUtc](#getNoonDateTimeUtc) |\r\n| getDateTimeUtcOfAngleBeforeNoon | [getDateTimeUtcOfAngleBeforeNoon](#getDateTimeUtcOfAngleBeforeNoon) |\r\n| getDateTimeUtcOfAngleAfterNoon | [getDateTimeUtcOfAngleAfterNoon](#getDateTimeUtcOfAngleAfterNoon) |\r\n| getSunriseDateTimeUtc | [getSunriseDateTimeUtc](#getSunriseDateTimeUtc) |\r\n| getSunsetDateTimeUtc | [getSunsetDateTimeUtc](#getSunsetDateTimeUtc) |\r\n| getCivilDawnEndDateTimeUtc | [getCivilDawnEndDateTimeUtc](#getCivilDawnEndDateTimeUtc) |\r\n| getCivilDawnStartDateTimeUtc | [getCivilDawnStartDateTimeUtc](#getCivilDawnStartDateTimeUtc) |\r\n| getNauticalDawnEndDateTimeUtc | [getNauticalDawnEndDateTimeUtc](#getNauticalDawnEndDateTimeUtc) |\r\n| getNauticalDawnStartDateTimeUtc | [getNauticalDawnStartDateTimeUtc](#getNauticalDawnStartDateTimeUtc) |\r\n| getAstronomicalDawnEndDateTimeUtc | [getAstronomicalDawnEndDateTimeUtc](#getAstronomicalDawnEndDateTimeUtc) |\r\n| getAstronomicalDawnStartDateTimeUtc | [getAstronomicalDawnStartDateTimeUtc](#getAstronomicalDawnStartDateTimeUtc) |\r\n| getAstronomicalDuskStartDateTimeUtc | [getAstronomicalDuskStartDateTimeUtc](#getAstronomicalDuskStartDateTimeUtc) |\r\n| getAstronomicalDuskEndDateTimeUtc | [getAstronomicalDuskEndDateTimeUtc](#getAstronomicalDuskEndDateTimeUtc) |\r\n| getNauticalDuskEndDateTimeUtc | [getNauticalDuskEndDateTimeUtc](#getNauticalDuskEndDateTimeUtc) |\r\n| getNauticalDuskStartDateTimeUtc | [getNauticalDuskStartDateTimeUtc](#getNauticalDuskStartDateTimeUtc) |\r\n| getCivilDuskEndDateTimeUtc | [getCivilDuskEndDateTimeUtc](#getCivilDuskEndDateTimeUtc) |\r\n| getCivilDuskStartDateTimeUtc | [getCivilDuskStartDateTimeUtc](#getCivilDuskStartDateTimeUtc) |\r\n","readmeFilename":"README.md","gitHead":"82e4415a5b64f0044a151b71246167e4266c8871","_id":"suntimes@5.0.1-3","_nodeVersion":"12.16.1","_npmVersion":"6.8.0","dist":{"integrity":"sha512-PfEzwOG1WOJy9Iq52dXpEbqSv5h15e5+xXGMVe1QISwUs25a6IirBYhXbgt3tOCpc/IWXISEmJXtyy9erbfoQQ==","shasum":"21dc8c772aa432d335d6fb6d874be793a3e82cdc","tarball":"https://registry.npmjs.org/suntimes/-/suntimes-5.0.1-3.tgz","fileCount":6,"unpackedSize":73287,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJekMedCRA9TVsSAnZWagAALc0P/R1U9OyWDlTYNjIlVxwx\nUkrKMEIpy96RiSEAcngG1+H1q04od/5QWIDGP0E4O8Ym2X+bbKMO2NHjDnSf\nxPGl1OhETdOHsrjpgfO96awMi5eAl6jDjzufR796gqymUHuB286GMLq4abeC\n8aYevxCtmvKRJj5mXpFDmLmIxmU9F5oRWzXdFAIllNWw72ueV3fzD1l0dQJU\nCf6YkzA5pFvqW7Auc31nusrOru0KkiMLxZLSHeyAnkcsa897Fm1cl0/IBrs5\n5u4ws64bkrjupE0YWXMjPzgaxyQ4iW2RZlDix+YQ7j5J79WAEYVr5JdAv3/9\njYGiUPFgBk0gO8sqbJQWaCMeloR3jy6gXe+0x37uGVPcGyoemOPYjhUzHtL7\nXA4HXsDJxynVGzg+IZb/kk/pgPsjFudAWycN/VWtclJeDibEJ1BzkzJhZMwW\nokrVp8/ZzegE63rskmdu58YpP+atHqBcZP9EUl34XHPkIVnUWDbHb7FyyLTG\nKRA86bU1A3Qt9svTrYAJizCflG3spVOyl0dn1cupzv3XJnfp91uA3Avy16zl\nb+eQ9qlurAG+xqnLde6MQZ1v7p23N/rOPzorB793ycyMR4FYXKeE7l5fti9M\nYxLVEk46FHPP5mDyHvmP6QD2FGoqLNKd+z4lN/w4CusKDtqMQfwliw7F6yFw\nCpEm\r\n=yvSy\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCSR7jHOtHYBwejpTQ/yAxwYwJafqovH/+iRCMphBGOcgIhAO6fPBfAqu8tg4hLYumEl79K/AdyXywzxqR7bx7WKi78"}]},"maintainers":[{"name":"doniseferi","email":"doni.seferi@gmail.com"}],"_npmUser":{"name":"doniseferi","email":"doni.seferi@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/suntimes_5.0.1-3_1586546588926_0.36002091719173523"},"_hasShrinkwrap":false},"5.0.1":{"name":"suntimes","version":"5.0.1","description":"A tiny library to get the exact date and time in utc for certain points of the day for any desired location and date.","main":"suntimes.js","typings":"suntimes.d.ts","scripts":{"readme":"jsdoc2md src/declination/getDeclinationOfTheSun.js src/equationOfTime/equationOfTime.js src/hourAngle/getHourAngle.js src/hourAngle/getNoonHourAngle.js src/time/index.js src/index.js","typedef":"jsdoc -t node_modules/tsd-jsdoc/dist -r ./src/","build":"rollup -c","release":"standard-version","test":"semistandard && npm run build && nyc mocha **/*.test.js --colors --full-trace --require @babel/register","coverage":"nyc report --reporter=text-lcov | coveralls","fix":"semistandard --fix"},"repository":{"type":"git","url":"git+https://github.com/doniseferi/suntimes.git"},"keywords":["sun","suntimes","equationOfTime","solar","declination","sunrise","sunset","twilight","dusk","dawn","maths","astronomy","celestial"],"author":{"name":"Edonis Seferi"},"license":"ISC","bugs":{"url":"https://github.com/doniseferi/suntimes/issues"},"homepage":"https://github.com/doniseferi/suntimes#readme","devDependencies":{"@babel/core":"^7.7.0","@babel/preset-env":"^7.7.1","@babel/register":"^7.7.0","chai":"^4.2.0","coveralls":"^3.0.7","depcheck":"^0.9.1","eslint":"^6.6.0","eslint-config-semistandard":"^15.0.0","eslint-config-standard":"^14.1.0","eslint-plugin-import":"^2.18.2","eslint-plugin-node":"^10.0.0","eslint-plugin-promise":"^4.2.1","eslint-plugin-standard":"^4.0.1","jsdoc":"^3.6.3","jsdoc-to-markdown":"^5.0.3","mocha":"^7.1.1","nyc":"^14.1.1","rollup":"^1.27.14","rollup-plugin-babel":"^4.3.3","rollup-plugin-terser":"^5.1.3","semistandard":"^14.2.0","standard-version":"^7.1.0","tsd-jsdoc":"^2.4.0"},"dependencies":{},"gitHead":"0fd1068cec0b4caf1524964cbd14ae1ac624b7d9","_id":"suntimes@5.0.1","_nodeVersion":"12.16.1","_npmVersion":"6.8.0","dist":{"integrity":"sha512-Zqw3PfBg9ETA5dfcnKN/vIQBOgfMpPk3XdnPOVBb8SsivrS4tgQavTNgpaJEnFYllsgYmTBn6YJElvYYwEueJw==","shasum":"1daa08012828307e75e1c05260a0aecd095a72f3","tarball":"https://registry.npmjs.org/suntimes/-/suntimes-5.0.1.tgz","fileCount":6,"unpackedSize":71387,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJekNR/CRA9TVsSAnZWagAAmD8QAJqULKN4Zzbo5TdUFHlg\nnlzGpmoLsfSggw75QPY/BBGK9g7PtaMXcnhO/QhFcgUTdo3K8NalYnENzZ++\naknqEFTeRqyI4AqRM4DHLiFM22O630VigqaErTtXMWAA/IA6LhNCtRCXr79Z\nTXDsh31ob8kBWzqzYFsr7ExR+cvpEs6Xmi3/RZFA+UNnAgOLwgXOdc7wMnnX\ntGH1VgfwSq8V3BNFyVPsxOm0FKKwnFelf8tQ5DbKboKG9jacN4UuB5nxky7C\nvnkEbUZBgJVHwPDLlNzmnI8oiopTQo4qG6LUGvaFEMK9dr+sDu9Fu2hQrE67\nyIgfzmLPU3zFfx/AkwDv7928+8FuGe1ODbHwqneZfZAXzYOzZFeSt09Izuzg\nTFMeC+vJwBV2cvU2IhR1uJownw64FeK0/9J3AZ/AHrIZqumbSfSna2LF4gtJ\nvOxcJGn5ufMFqYlB8WWP8YKUHw82fIZD01Zedk4hTw3f9nDLISA1e9JTk7tR\n71HfL4I1qtFnK8DBLOW2ipC8VV6kUtSy+081bguJItqqcr7LBTy5W9tBTACk\n07Ltpmy5qGrw2xy93jjXcHEX4fub6ubjmQtXQiaDoVHg8/h006OWNvuUVflQ\nsxtwfFQj6ZxbLgzUJW13ccXSusJxE+A1kKTWve/7p/008/W8jcw6wo07xcff\nQS6y\r\n=8nWI\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIENgYDiahmb0gwwn8mIQ5r/dogUVDIc296EQGNcdSi/pAiEA/p8q6Pte1RPHE1KhqO+J5iYZT4XeNotnfO4lYDubDj8="}]},"maintainers":[{"name":"doniseferi","email":"doni.seferi@gmail.com"}],"_npmUser":{"name":"doniseferi","email":"doni.seferi@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/suntimes_5.0.1_1586549887337_0.8348381838433643"},"_hasShrinkwrap":false},"6.0.0":{"name":"suntimes","version":"6.0.0","description":"A tiny library to get the exact date and time in utc for certain points of the day for any desired location and date.","main":"suntimes.js","typings":"suntimes.d.ts","scripts":{"readme":"jsdoc2md src/declination/getDeclinationOfTheSun.js src/equationOfTime/equationOfTime.js src/hourAngle/getHourAngle.js src/hourAngle/getNoonHourAngle.js src/time/index.js src/index.js","typedef":"jsdoc -t node_modules/tsd-jsdoc/dist -r ./src/","build":"rollup -c","release":"standard-version","test":"semistandard && npm run build && nyc mocha **/*.test.js --colors --full-trace --require @babel/register","coverage":"nyc report --reporter=text-lcov | coveralls","fix":"semistandard --fix"},"repository":{"type":"git","url":"git+https://github.com/doniseferi/suntimes.git"},"keywords":["sun","suntimes","equationOfTime","solar","declination","sunrise","sunset","twilight","dusk","dawn","maths","astronomy","celestial"],"author":{"name":"Edonis Seferi"},"license":"ISC","bugs":{"url":"https://github.com/doniseferi/suntimes/issues"},"homepage":"https://github.com/doniseferi/suntimes#readme","devDependencies":{"@babel/core":"^7.7.0","@babel/preset-env":"^7.7.1","@babel/register":"^7.7.0","chai":"^4.2.0","coveralls":"^3.0.7","depcheck":"^0.9.1","eslint":"^6.6.0","eslint-config-semistandard":"^15.0.0","eslint-config-standard":"^14.1.0","eslint-plugin-import":"^2.18.2","eslint-plugin-node":"^10.0.0","eslint-plugin-promise":"^4.2.1","eslint-plugin-standard":"^4.0.1","jsdoc":"^3.6.3","jsdoc-to-markdown":"^5.0.3","mocha":"^7.1.1","nyc":"^14.1.1","rollup":"^1.27.14","rollup-plugin-babel":"^4.3.3","rollup-plugin-terser":"^5.1.3","semistandard":"^14.2.0","standard-version":"^7.1.0","tsd-jsdoc":"^2.4.0"},"dependencies":{},"gitHead":"1d346e31b6d6b24de23e732ea06ba787522af3f3","_id":"suntimes@6.0.0","_nodeVersion":"12.16.1","_npmVersion":"6.8.0","dist":{"integrity":"sha512-EXOfa67fN0MQSslwxoKkclJG+yY7eVVTOJ/fMIBjud82gAOTU5s3gExBOu53FXrv9/nLp+Tu8pQguK1yDDrAyQ==","shasum":"0822b3eebc0ad3c445f5c2d086e0fd4cb7ccc8c7","tarball":"https://registry.npmjs.org/suntimes/-/suntimes-6.0.0.tgz","fileCount":6,"unpackedSize":73687,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJekzXCCRA9TVsSAnZWagAAPlMP/i5kf8SsX8OwvzUpJfbt\nmesGowZ9uOu04t35ta4KYmHPVJQ+DkA6igBW9WeJBdEH+j4LIeDBRfqswoZF\njZLiQhisgzQonKjWIqVfWHie+aTEQTsBRbSq8rtD+l65q8W8bSN8yTuCwbDs\nkEWrbgYcVWJmWPzGmhiBB9SrFZhP1UjwQQwvhJSVGx4P5jTKJDQzrcTGXbiY\nE0ojaqzFfA5KEb8/7GeWYWsJihGuSRYof11zAC/L//RvIwonWAkWbBs2y/Aq\n5SS1tWxg0vAtN9TfC0HhBXJJSz1wRfTj5pqGE5tnVIwqSBT0Ui8K+/S1lgMu\nwrUMi5lPSAnWKL1bMz2/p+T/U7hxyX+KJNO5QRPBBdt7Wkki8+T/SCvP7lvm\naoDwjLWKpQ0e4a/gq79jyKEmA2JLdi6T7sjwGk0sxk2k5J7tVf1yIvU/sJti\ngvXZmTYyOVPx41PA3lTduBmc5H2NdJNCyXhfNR9eKn/JBFpum2V0NE/PPajU\neRBsTmkr16mAvBbE7+y/2Y0+UKuRbUfDkBmPDS4SB1zmohbZUiUVONtDS50h\nt4916Xy8fxNaTef4DZZWKczG4A9T2o02ttdxhLl8fJJQIMRuNYp9e7pWzZ5Z\nrqes/UyWm53o9QQ2cSxVZ4L/UA3OXq75lSZuGPPNP12K7OeqscSYL+/+7FNZ\n1Sxe\r\n=VVzf\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIEAnMR2Ya0DNZPy84uKY+SMAUfEnE52YDN00LNVIxsMEAiAZNUqcYAvqorTQJxZJWGXTZP/tIu93QLpIQ3/LASzaNQ=="}]},"maintainers":[{"name":"doniseferi","email":"doni.seferi@gmail.com"}],"_npmUser":{"name":"doniseferi","email":"doni.seferi@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/suntimes_6.0.0_1586705858107_0.7851147740547963"},"_hasShrinkwrap":false},"6.0.1":{"name":"suntimes","version":"6.0.1","description":"A tiny library to get the exact date and time in utc for certain points of the day for any desired location and date.","main":"suntimes.js","typings":"suntimes.d.ts","scripts":{"readme":"jsdoc2md src/declination/getDeclinationOfTheSun.js src/equationOfTime/equationOfTime.js src/hourAngle/getHourAngle.js src/hourAngle/getNoonHourAngle.js src/time/index.js src/index.js","typedef":"jsdoc -t node_modules/tsd-jsdoc/dist -r ./src/","build":"rollup -c","release":"standard-version","pretest":"semistandard && npm run build","test":"nyc mocha **/*.test.js --colors --full-trace --require @babel/register","coverage":"nyc report --reporter=text-lcov | coveralls","fix":"semistandard --fix"},"semistandard":{"ignore":["**/dist/","suntimes.js"]},"repository":{"type":"git","url":"git+https://github.com/doniseferi/suntimes.git"},"keywords":["sun","suntimes","astronomy","celestial","solar","sunrise","sunset","equationOfTime","declination","dusk","dawn","twilight"],"author":{"name":"Edonis Seferi"},"license":"ISC","bugs":{"url":"https://github.com/doniseferi/suntimes/issues"},"homepage":"https://github.com/doniseferi/suntimes#readme","devDependencies":{"@babel/core":"^7.7.0","@babel/preset-env":"^7.7.1","@babel/register":"^7.7.0","chai":"^4.2.0","coveralls":"^3.0.7","depcheck":"^0.9.1","eslint":"^6.6.0","eslint-config-semistandard":"^15.0.0","eslint-config-standard":"^14.1.0","eslint-plugin-import":"^2.18.2","eslint-plugin-node":"^10.0.0","eslint-plugin-promise":"^4.2.1","eslint-plugin-standard":"^4.0.1","jsdoc":"^3.6.3","jsdoc-to-markdown":"^5.0.3","mocha":"^7.1.1","nyc":"^14.1.1","rollup":"^1.27.14","rollup-plugin-babel":"^4.3.3","rollup-plugin-terser":"^5.1.3","semistandard":"^14.2.0","standard-version":"^7.1.0","tsd-jsdoc":"^2.4.0"},"dependencies":{},"gitHead":"275dd3e9934b5fff78bad58d395a69af06665175","_id":"suntimes@6.0.1","_nodeVersion":"12.16.1","_npmVersion":"6.14.4","dist":{"integrity":"sha512-tKJ4oLakTEWJXA1GLG3ybZbxeSQcyePYtHD0IOyUlBd3p+tAdZ7xtTBla2P9QFR6zecC9HUzxVFbntTHrq0Pcg==","shasum":"27c7bc0abbccbff8c2eb900ca11f0f98717b8b3f","tarball":"https://registry.npmjs.org/suntimes/-/suntimes-6.0.1.tgz","fileCount":6,"unpackedSize":73882,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJeofZRCRA9TVsSAnZWagAA7mEP+gIfRhJw3iZy3TGJLPHZ\nhF3G9PG5JcF9zYKrXvTku8lm6IvwICHUTdd4kd4oJ9mc99IWRsdbOQ80+voo\n8niACq7mrf02kEqXaP7E3AwdAwGSQL99lom+Y5YCBJgTGTtQJmof9EAbIQ1H\nhDtGUNgkp7eeTlOCQwQ7+aNDdXPvCmjckka7hKi2YMJ8eKhfuZTBki0oxmMu\njyJ0TKXnekvHOilaN7hwAaEDdFi8EIATI3ZKpmR0LsqfYYH6AQoUhgVa4Cz/\n33D863eaNEVCKhLapgPMUsOnrvTzkF7pwm5cXn04G4S2Doa9dTYOBRxFxP/s\ngadejUwxiii7b9WnjPI0vtu/ac34jb2dbQEGNDPK3m1dFeFT5aVVxQdhsb3J\nShlajjIDCBsXTf5suyODIjBhk3Nk6ZMpqNM5YmTJhp6xdeFQ4lNbCV9FggAX\n+IjfG0G0+Eoz6ReabReO+5N2UDu5Dk66+78c8k1Etg3tdiyvR4i1k8L9DqvG\nSHXv1usXzbK8CqM08u+lbAuf3z+PNUL5oE/ip4zGUiwQ4w0puYL4fh1Dgl8P\nJa/SR1ADJJ/b/JZjAqIFgRfVfCqkyQjNlsuicIJrq8SzYmqh56YED+LemY77\nfd0qBvQ0kZbOR59giV7+BHccWOQXjrNfIh6iA2t5vEDfF6pOl/DA7NEuy9KR\nSqqP\r\n=mzj6\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDIjnTDsk94ioX/w5tiDKO/4qG5NtpLnJSeIOk8eNvV8QIgPZM9QkcLmTjDJdjwEifvXxrvRbMQJgJ6cchiJPeYXv0="}]},"maintainers":[{"name":"doniseferi","email":"doni.seferi@gmail.com"}],"_npmUser":{"name":"doniseferi","email":"doni.seferi@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/suntimes_6.0.1_1587672656635_0.05423945629705962"},"_hasShrinkwrap":false},"6.0.2":{"name":"suntimes","version":"6.0.2","description":"A tiny library to get the exact date and time in utc for certain points of the day for any desired location and date.","main":"suntimes.js","typings":"suntimes.d.ts","scripts":{"readme":"jsdoc2md src/declination/getDeclinationOfTheSun.js src/equationOfTime/equationOfTime.js src/hourAngle/getHourAngle.js src/hourAngle/getNoonHourAngle.js src/time/index.js src/index.js","typedef":"jsdoc -t node_modules/tsd-jsdoc/dist -r ./src/","build":"rollup -c","release":"standard-version","pretest":"semistandard && npm run build","test":"nyc mocha **/*.test.js --colors --full-trace --require @babel/register","coverage":"nyc report --reporter=text-lcov | coveralls","fix":"semistandard --fix"},"semistandard":{"ignore":["**/dist/","suntimes.js"]},"repository":{"type":"git","url":"git+https://github.com/doniseferi/suntimes.git"},"keywords":["sun","suntimes","astronomy","celestial","solar","sunrise","sunset","equationOfTime","declination","dusk","dawn","twilight"],"author":{"name":"Edonis Seferi"},"license":"ISC","bugs":{"url":"https://github.com/doniseferi/suntimes/issues"},"homepage":"https://github.com/doniseferi/suntimes#readme","devDependencies":{"@babel/core":"^7.7.0","@babel/preset-env":"^7.10.4","@babel/register":"^7.7.0","chai":"^4.2.0","coveralls":"^3.0.7","depcheck":"^0.9.1","eslint":"^6.6.0","eslint-config-semistandard":"^15.0.0","eslint-config-standard":"^13.0.1","eslint-plugin-import":"^2.18.2","eslint-plugin-node":"^10.0.0","eslint-plugin-promise":"^4.2.1","eslint-plugin-standard":"^4.0.1","jsdoc":"^3.6.3","jsdoc-to-markdown":"^5.0.3","mocha":"^7.1.1","nyc":"^14.1.1","rollup":"^1.27.14","rollup-plugin-babel":"^4.3.3","rollup-plugin-terser":"^5.1.3","semistandard":"^14.2.0","standard-version":"^8.0.1","tsd-jsdoc":"^2.4.0"},"dependencies":{},"gitHead":"acaea67efdb6b80e78db9b39a353e1a5e29aed83","_id":"suntimes@6.0.2","_nodeVersion":"12.16.1","_npmVersion":"6.14.7","dist":{"integrity":"sha512-5KC1IfOXSd9AGE0noLLyrNi7r9SrqMEri1UwnPC2X6zDWrR0rZuw2AeAgutazG17xJQvzFFAwO2LfL9swo5n/w==","shasum":"71562f531ca44255a728d629c447edccecd27a51","tarball":"https://registry.npmjs.org/suntimes/-/suntimes-6.0.2.tgz","fileCount":6,"unpackedSize":73973,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJfHfIACRA9TVsSAnZWagAAlTEP/i6T7tZbsqAZiqhWCafV\nRBLOw1VtCii2Cf7a+1NqjFt5YzC/syeB0ZbyDnr8ORk0vmXrylnKzwYO6qHx\n/96N+SuUKWytPs7q3KDzBXjbX2phpoNnxyGqx5GXAWyM0AWFz4KuvoXjL1Uo\nav0WOgylKaBlzrsdyeEvVj8tpbWIyKKPLl61ijwVvvb9OiykYqAvSqB/JsI3\nP8dYPq1MNju+dvf0WxtLw47aE73uqN8n7n57ItTLNGYiPUTraZMmzMhFihNg\nRsob0/hOX5E818BYQuaRUP+FWn1YVbbZAvD6QgEF6Yh3btQhFZ2wTEsuQJNR\nf5tv/wwq9Z2t4/O17epadVSD4gTFDA/gaTgg707hHfkRW6WmWlCYUYiuWdIa\nOVqupUjyRGjPJmcRHpS6JUVH7VcwwQwyhoGi5bLUavQkvMYPAhs7Q5n69vJS\nq0QnReWpYsE5wMUVobKD8Pgl+6av3cjfjnpi3YkVm+5Hk8tgHObSbiy2s/Ex\nnJdkI+1cLnZYaa5YoWwIvPD87vT6cYAg/R5+raYTkVeRKOzqZQjUjotFMWgn\nKSQ3d3koSRR9tUHvVAHzBChhmKO/HBDmOvQxc3feHdknQ6KirC3V0oIhwo1d\nFI/34nI2z0Jr2ecSWp16WjobSL9oEwHH6xdjPzRNdzqP/irROtXle6oq+Uvx\ns7Cb\r\n=Uxe2\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCICQ9S6ufkD6I9KgwGu10cPbvbB5eDq3WRfIL3Fvx8JZHAiAiq9ZbnkcSEdU8vI0601prYma33lFjYfjXC8H5ZI4WWw=="}]},"maintainers":[{"name":"doniseferi","email":"doni.seferi@gmail.com"}],"_npmUser":{"name":"doniseferi","email":"doni.seferi@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/suntimes_6.0.2_1595798015670_0.3152125680426243"},"_hasShrinkwrap":false},"6.0.3":{"name":"suntimes","version":"6.0.3","description":"A tiny library to get the exact date and time in utc for certain points of the day for any desired location and date.","main":"suntimes.js","typings":"suntimes.d.ts","scripts":{"readme":"jsdoc2md src/declination/getDeclinationOfTheSun.js src/equationOfTime/equationOfTime.js src/hourAngle/getHourAngle.js src/hourAngle/getNoonHourAngle.js src/time/index.js src/index.js","typedef":"jsdoc -t node_modules/tsd-jsdoc/dist -r ./src/","build":"rollup -c","release":"standard-version","pretest":"semistandard && npm run build","test":"nyc mocha **/*.test.js --colors --full-trace --require @babel/register","coverage":"nyc report --reporter=text-lcov | coveralls","fix":"semistandard --fix"},"semistandard":{"ignore":["**/dist/","suntimes.js"]},"repository":{"type":"git","url":"git+https://github.com/doniseferi/suntimes.git"},"keywords":["sun","suntimes","astronomy","celestial","solar","sunrise","sunset","equationOfTime","declination","dusk","dawn","twilight"],"author":{"name":"Edonis Seferi"},"license":"ISC","bugs":{"url":"https://github.com/doniseferi/suntimes/issues"},"homepage":"https://github.com/doniseferi/suntimes#readme","devDependencies":{"@babel/core":"^7.7.0","@babel/preset-env":"^7.10.4","@babel/register":"^7.7.0","chai":"^4.2.0","coveralls":"^3.0.7","depcheck":"^0.9.1","eslint":"^6.6.0","eslint-config-semistandard":"^15.0.0","eslint-config-standard":"^13.0.1","eslint-plugin-import":"^2.18.2","eslint-plugin-node":"^10.0.0","eslint-plugin-promise":"^4.2.1","eslint-plugin-standard":"^4.0.1","jsdoc":"^3.6.3","jsdoc-to-markdown":"^7.1.1","mocha":"^7.1.1","nyc":"^14.1.1","rollup":"^1.27.14","rollup-plugin-babel":"^4.3.3","rollup-plugin-terser":"^5.1.3","semistandard":"^14.2.0","standard-version":"^9.5.0","tsd-jsdoc":"^2.4.0"},"gitHead":"81a23d39bb7ed3f0bff9a5ecabfb9c714ee22030","_id":"suntimes@6.0.3","_nodeVersion":"16.17.0","_npmVersion":"8.15.0","dist":{"integrity":"sha512-RDTCy/dM7ohEAWXQ2l8Am9ip2lCP9ddrKP8cHwE8VdKxtfI1+oMB6gMShQXZd6TaWZWFC6rEkMWHatFFJ6JmDQ==","shasum":"d8df468c3096094426cf63bf59520ef3f703afa1","tarball":"https://registry.npmjs.org/suntimes/-/suntimes-6.0.3.tgz","fileCount":5,"unpackedSize":70598,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIE1KccAbjV8gHFcPorkLcNI0s40Gj+pLge4rg427+oxlAiBdoPY8NgOv9n1zxAH26pLWJKybir449BwjtPWkXhH4Yw=="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJjLH7vACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmpFPw//bjhVNDsb0xP72am+5ESKA7nBVi4KHllogjagBWyp+ZFPGfy5\r\nNmN/3RfE1OSdlQF6+v6jqLPhAQfRPpmt1ymOnF7IoF8/h9bzyc1mXizTQAZ9\r\nC3RC/Z37ubNDTxOZ2YlZW8gkCLIF0Q7cx+0St9gZBNa+oeYn3k0/qXv0wyUl\r\nH5lOFl95OihdFE+sXkz7RkOEfks9A77QF/Lz0Zj1U3Bb0PMLPGz6nY90u3Hr\r\nkH8WCdUoi6Qs5TcW1LLKTkNFqopKCqYi4HNMijcv1pkDUlqW7YQnDpDKM5m7\r\nrfhfgSg0M5vAevWiW17PmFafWi80UwC5f6gX3sC38UV+yqewq0RQjl5z75ns\r\nfUnUVSAt9AP4IIKNvwDR9SHma77285vrRzHqJNKPXDAeHKCZBz9C/r7ZO3Sm\r\nb7sQlTguZkUhn8tWMnFtep+fuiVcxYTHUc7uKituJP1mHZxz5iFFsZ9OJRH9\r\nK/3KvFwTAWVMNJgvXtNBBElkvYDjDQFhLkHmMbipbUTTVkqpcwn09iQCsbNU\r\nk03SIQfZZuTlz6DYvyZNnq3gjg7l3TRlBytRzGtlw0mu2tXzqO9LZVMjWs7V\r\nAJIz1NkVvb24fITyqLVnt3JqLfnRYPlCBCC9VGD/nm8rwPcNc7LmXql/ZBBZ\r\nCUjfM4/wtfJnRnpkXJ/V9RkwCRN4FocwHwE=\r\n=7mvC\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"doniseferi","email":"doni.seferi@gmail.com"},"directories":{},"maintainers":[{"name":"doniseferi","email":"doni.seferi@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/suntimes_6.0.3_1663860462952_0.4780655082983425"},"_hasShrinkwrap":false}},"time":{"created":"2019-11-01T03:44:08.574Z","1.0.0-0":"2019-11-01T03:44:08.748Z","modified":"2022-09-22T15:27:43.235Z","1.0.0-1":"2019-11-01T03:52:17.013Z","1.0.0":"2019-11-01T04:44:24.426Z","1.0.1":"2019-11-04T14:33:19.299Z","2.0.0":"2019-11-06T14:20:09.568Z","2.1.0":"2019-11-06T14:30:33.169Z","2.1.1-0":"2019-11-06T23:05:27.275Z","2.1.1":"2019-11-09T13:34:37.066Z","2.1.2":"2019-11-09T21:23:43.319Z","3.0.0":"2019-11-14T16:49:53.207Z","3.0.1":"2019-11-14T21:39:33.066Z","3.0.2":"2019-11-15T13:26:19.574Z","4.0.0-0":"2020-01-03T20:03:45.785Z","4.0.0-1":"2020-01-03T20:22:54.425Z","4.0.0-2":"2020-01-04T21:29:24.749Z","4.0.0-3":"2020-01-05T15:34:40.633Z","4.0.0-4":"2020-01-06T20:24:10.368Z","4.0.0-5":"2020-01-06T20:32:53.145Z","4.0.0":"2020-01-06T21:09:19.406Z","4.0.1":"2020-01-07T11:33:41.614Z","4.1.2":"2020-01-17T23:22:41.943Z","4.1.4":"2020-03-12T19:25:48.768Z","4.1.5":"2020-03-12T19:33:22.982Z","4.1.6":"2020-03-15T13:28:11.370Z","4.1.7":"2020-03-28T22:05:13.236Z","4.1.8-1":"2020-04-07T13:42:05.682Z","5.0.0-0":"2020-04-07T22:33:18.800Z","5.0.0":"2020-04-07T22:37:28.649Z","5.0.1-0":"2020-04-08T20:52:29.481Z","5.0.1-1":"2020-04-09T21:42:39.525Z","5.0.1-2":"2020-04-10T18:56:14.978Z","5.0.1-3":"2020-04-10T19:23:09.075Z","5.0.1":"2020-04-10T20:18:07.462Z","6.0.0":"2020-04-12T15:37:38.345Z","6.0.1":"2020-04-23T20:10:56.773Z","6.0.2":"2020-07-26T21:13:35.826Z","6.0.3":"2022-09-22T15:27:43.133Z"},"maintainers":[{"name":"doniseferi","email":"doni.seferi@gmail.com"}],"description":"A tiny library to get the exact date and time in utc for certain points of the day for any desired location and date.","homepage":"https://github.com/doniseferi/suntimes#readme","keywords":["sun","suntimes","astronomy","celestial","solar","sunrise","sunset","equationOfTime","declination","dusk","dawn","twilight"],"repository":{"type":"git","url":"git+https://github.com/doniseferi/suntimes.git"},"author":{"name":"Edonis Seferi"},"bugs":{"url":"https://github.com/doniseferi/suntimes/issues"},"license":"ISC","readme":"\n\n
numberThe angular distance of the sun north or south of the earth's equator.
\nnumberThe correction between standard clock time and the time based on the exact position of the sun in the sky represented as decimal\ntime in minutes.
\nnumberGets the hour angle difference between noon and the angle value.
\nnumberGets the noon hour angle for the date and longitude value.
\nstringGets the noon date and time in UTC expressed in an ISO 8601 format for date and longitude value.
\nstringGets the date and time in UTC expressed in an ISO 8601 format for an angle before noon for the angle, date, latitude and longitude value.
\nstringGets the date and time in UTC expressed in an ISO 8601 format for an angle after noon for the angle, date, latitude and longitude value.
\nstringGets the sunrise date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\nstringGets the sunset date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\nstringGets the end of civil dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\nstringGets the start of civil dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\nstringGets the end of nautical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\nstringGets the start of nautical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\nstringGets the end of astronomical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude\nvalue.
\nstringGets the start of astronomical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\nstringGets the start of astronomical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\nstringGets the end of astronomical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude\nvalue.
\nstringGets the end of nautical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\nstringGets the start of nautical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\nstringGets the end of civil dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\nstringGets the start of civil dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
\nnumber\nThe angular distance of the sun north or south of the earth's equator.\n\n**Kind**: global function\n**Returns**: number - The declination in degrees where north is a positive value and south is a negative value within a range of range of -23.45 and 23.45.\n\n| Param | Type | Description |\n| ----- | ----------------- | --------------- |\n| date | Date | A date instance |\n\n**Example** *(Example usage of getDeclinationOfTheSun)*\n```js\n// returns -23.078780854838076\ngetDeclinationOfTheSun(new Date(2019, 0, 1));\n```\n* * *\n\n\n## equationOfTime(date) ⇒ number\nThe correction between standard clock time and the time based on the exact position of the sun in the sky represented as decimal time in minutes.\n\n**Kind**: global function\n**Returns**: number - A number whose value is the equation of time in minutes decimal time for the Date represented by date.\n\n| Param | Type | Description |\n| ----- | ----------------- | ---------------- |\n| date | Date | A date instance. |\n\n**Example** *(Example usage of equationOfTime)*\n```js\n// returns -10.306964615344999\nequationOfTime(new Date(2025, 0, 18));\n```\n* * *\n\n\n## getHourAngleSinceNoon(date, latitude, angle) ⇒ number\nGets the hour angle difference between noon and the angle value.\n\n**Kind**: global function\n**Returns**: number - A number whose value represents the hour angle since noon for the date, latitude and angle value.\n**Throws**:\n\n- RangeError The sun altitude never elevates above the angle specified.\n- RangeError The sun altitude never drops below the angle specified.\n\n\n| Param | Type | Description |\n| -------- | ------------------- | ------------------------------------------- |\n| date | Date | A date instance. |\n| latitude | number | A latitude value in the range of -90 to 90. |\n| angle | number | An angle value. |\n\n**Example** *(Example usage of getHourAngleSinceNoon)*\n```js\n// returns 5.54554469317797\ngetHourAngleSinceNoon(new Date(2025, 0, 18), 51.477730, -12);\n```\n* * *\n\n\n## getNoonHourAngle(date, longitude) ⇒ number\nGets the noon hour angle for the date and longitude value.\n\n**Kind**: global function\n**Returns**: number - The noon hour angle expressed as a number between 0.00 and 23.9.\n\n| Param | Type | Description |\n| --------- | ------------------- | ---------------------------------------------- |\n| date | Date | A date instance. |\n| longitude | number | A longitude value in the range of -180 to 180. |\n\n**Example** *(Example usage of getNoonHourAngle)*\n```js\n// returns 12.17245941025575\ngetNoonHourAngle(new Date(2025, 0, 18), -0.010150);\n```\n* * *\n\n\n## getNoonDateTimeUtc(date, longitude) ⇒ string\nGets the noon date and time in UTC expressed in an ISO 8601 format for date and longitude value.\n\n**Kind**: global function\n**Returns**: string - A string representing noon date and time in UTC, expressed in an ISO 8601 format.\n\n| Param | Type | Description |\n| --------- | ------------------- | ---------------------------------------------- |\n| date | Date | A date instance. |\n| longitude | number | A longitude value in the range of -180 to 180. |\n\n**Example** *(Example usage of getNoonDateTimeUtc)*\n```js\n// returns \"2025-01-18T12:10:20.853Z\"\ngetNoonDateTimeUtc(new Date(2025, 0, 18), -0.010150);\n```\n* * *\n\n\n## getDateTimeUtcOfAngleBeforeNoon(angle, date, latitude, longitude) ⇒ string\nGets the date and time in UTC expressed in an ISO 8601 format for an angle before noon for the angle, date, latitude and longitude value.\n\n**Kind**: global function\n**Returns**: string - A string representing the time and date for an angle before noon in UTC, expressed in an ISO 8601 format.\n\n| Param | Type | Description |\n| --------- | ------------------- | ---------------------------------------------- |\n| angle | number | An angle value. |\n| date | Date | A date instance. |\n| latitude | number | A latitude value in the range of -90 to 90. |\n| longitude | number | A longitude value in the range of -180 to 180. |\n\n**Example** *(Example usage of getDateTimeUtcOfAngleBeforeNoon)*\n```js\n// returns \"2025-01-18T05:57:45.720Z\"\ngetDateTimeUtcOfAngleBeforeNoon(-18, new Date(2025, 0, 18), 51.477730, -0.010150);\n```\n**Example** *(Example usage of getDateTimeUtcOfAngleBeforeNoon)*\n```js\n// returns \"The sun's altitude does not drop to -18° on Wed Jun 18 2025 at latitude 51.47773 and longitude -0.01015\"\ngetDateTimeUtcOfAngleBeforeNoon(-18, new Date(2025, 5, 18), 51.477730, -0.010150);\n```\n**Example** *(Example usage of getDateTimeUtcOfAngleBeforeNoon)*\n```js\n// returns \"The sun's altitude does not rise to 18° on Wed Jun 18 2025 at latitude -51.47773 and longitude -0.01015\"\ngetDateTimeUtcOfAngleBeforeNoon(18, new Date(2025, 5, 18), -51.477730, -0.010150);\n```\n* * *\n\n\n## getDateTimeUtcOfAngleAfterNoon(angle, date, latitude, longitude) ⇒ string\nGets the date and time in UTC expressed in an ISO 8601 format for an angle after noon for the angle, date, latitude and longitude value.\n**Kind**: global function\n**Returns**: string - A string representing the time and date for an angle after noon in UTC, expressed in an ISO 8601 format.\n\n| Param | Type | Description |\n| --------- | ------------------- | ---------------------------------------------- |\n| angle | number | An angle value. |\n| date | Date | A date instance. |\n| latitude | number | A latitude value in the range of -90 to 90. |\n| longitude | number | A longitude value in the range of -180 to 180. |\n\n**Example** *(Example usage of getDateTimeUtcOfAngleAfterNoon)*\n```js\n//returns \"2025-06-18T14:33:42.689Z\"\ngetDateTimeUtcOfAngleAfterNoon(8, new Date(2025, 5, 18), -51.477730, -0.010150);\n```\n**Example** *(Example usage of getDateTimeUtcOfAngleAfterNoon)*\n```js\n// returns \"The sun's altitude does not drop to -18° on Sat Jan 18 2025 at latitude -51.47773 and longitude -0.01015\"\ngetDateTimeUtcOfAngleAfterNoon(-18, new Date(2025, 0, 18), -51.477730, -0.010150);\n```\n**Example** *(Example usage of getDateTimeUtcOfAngleAfterNoon)*\n```js\n// returns \"The sun's altitude does not rise to 18° on Wed Jun 18 2025 at latitude -51.47773 and longitude -0.01015\"\ngetDateTimeUtcOfAngleAfterNoon(18, new Date(2025, 5, 18), -51.477730, -0.010150);\n```\n* * *\n\n\n## getSunriseDateTimeUtc(date, latitude, longitude) ⇒ string\nGets the sunrise date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\n\n**Kind**: global function\n**Returns**: string - A string representing sunrise date and time in UTC, expressed in an ISO 8601 format.\n\n| Param | Type | Description |\n| --------- | ------------------- | ---------------------------------------------- |\n| date | Date | A date instance. |\n| latitude | number | A latitude value in the range of -90 to 90. |\n| longitude | number | A longitude value in the range of -180 to 180. |\n\n**Example** *(Example usage of getSunriseDateTimeUtc)*\n```js\n// returns \"2025-01-18T07:57:29.802Z\"\ngetSunriseDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\n```\n**Example** *(Example usage of getSunriseDateTimeUtc)*\n```js\n// returns \"The sun is up all day on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\ngetSunriseDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\n```\n**Example** *(Example usage of getSunriseDateTimeUtc)*\n```js\n// returns \"The sun is down all day on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\"\ngetSunriseDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\n```\n* * *\n\n\n## getSunsetDateTimeUtc(date, latitude, longitude) ⇒ string\nGets the sunset date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\n\n**Kind**: global function\n**Returns**: string - A string representing sunset date and time in UTC, expressed in an ISO 8601 format.\n\n| Param | Type | Description |\n| --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| date | Date | A date instance. |\n| latitude | number | A latitude value in the range of -90 to 90. |\n| longitude | number | A longitude value in the range of -180 to 180. |\n\n**Example** *(Example usage of getSunsetDateTimeUtc)*\n```js\n// returns \"2025-01-18T16:23:11.903Z\"\ngetSunsetDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\n```\n**Example** *(Example usage of getSunsetDateTimeUtc)*\n```js\n// returns \"The sun is up all day on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\ngetSunsetDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\n```\n**Example** *(Example usage of getSunsetDateTimeUtc)*\n```js\n// returns \"The sun is down all day on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\"\ngetSunsetDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\n```\n* * *\n\n\n## getCivilDawnEndDateTimeUtc(date, latitude, longitude) ⇒ string\nGets the end of civil dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\n\n**Kind**: global function\n**Returns**: string - A string representing the end of civil dawn date and time in UTC, expressed in an ISO 8601 format.\n\n| Param | Type | Description |\n| --- | --- | --- |\n| date | Date | A date instance. |\n| latitude | number | A latitude value in the range of -90 to 90. |\n| longitude | number | A longitude value in the range of -180 to 180. |\n\n**Example** *(Example usage of getCivilDawnEndDateTimeUtc)*\n```js\n// returns \"2025-01-18T07:57:29.802Z\"\ngetCivilDawnEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\n```\n**Example** *(Example usage of getCivilDawnEndDateTimeUtc)*\n```js\n// returns \"The sun is up all day on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\ngetCivilDawnEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\n```\n**Example** *(Example usage of getCivilDawnEndDateTimeUtc)*\n```js\n// returns \"The sun is down all day on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\ngetCivilDawnEndDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\n```\n* * *\n\n\n## getCivilDawnStartDateTimeUtc(date, latitude, longitude) ⇒ string\nGets the start of civil dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\n\n**Kind**: global function\n**Returns**: string - A string representing the start of civil dawn date and time in UTC, expressed in an ISO 8601 format.\n\n\n| Param | Type | Description |\n| --- | --- | --- |\n| date | Date | A date instance. |\n| latitude | number | A latitude value in the range of -90 to 90. |\n| longitude | number | A longitude value in the range of -180 to 180. |\n\n**Example** *(Example usage of getCivilDawnStartDateTimeUtc)*\n```js\n// returns \"2025-01-18T07:19:15.781Z\"\ngetCivilDawnStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\n```\n**Example** *(Example usage of getCivilDawnStartDateTimeUtc)*\n```js\n// returns \"The sun's altitude does not rise to -6° on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\"\ngetCivilDawnStartDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\n```\n**Example** *(Example usage of getCivilDawnStartDateTimeUtc)*\n```js\n// returns \"The sun's altitude does not drop to -6° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\ngetCivilDawnStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\n```\n* * *\n\n\n## getNauticalDawnEndDateTimeUtc(date, latitude, longitude) ⇒ string\nGets the end of nautical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\n\n**Kind**: global function\n**Returns**: string - A string representing the end of nautical dawn date and time in UTC, expressed in an ISO 8601 format.\n\n| Param | Type | Description |\n| --- | --- | --- |\n| date | Date | A date instance. |\n| latitude | number | A latitude value in the range of -90 to 90. |\n| longitude | number | A longitude value in the range of -180 to 180. |\n\n**Example** *(Example usage of getNauticalDawnEndDateTimeUtc)*\n```js\n// returns \"2025-01-18T07:19:15.781Z\"\ngetNauticalDawnEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\n```\n**Example** *(Example usage of getNauticalDawnEndDateTimeUtc)*\n```js\n// returns \"The sun's altitude does not rise to -6° on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\"\ngetNauticalDawnEndDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\n```\n**Example** *(Example usage of getNauticalDawnEndDateTimeUtc)*\n```js\n// returns \"The sun's altitude does not drop to -6° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\ngetNauticalDawnEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\n```\n* * *\n\n\n## getNauticalDawnStartDateTimeUtc(date, latitude, longitude) ⇒ string\nGets the start of nautical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\n\n**Kind**: global function\n**Returns**: string - A string representing the start of nautical dawn date and time in UTC, expressed in an ISO 8601 format.\n\n| Param | Type | Description |\n| --- | --- | --- |\n| date | Date | A date instance. |\n| latitude | number | A latitude value in the range of -90 to 90. |\n| longitude | number | A longitude value in the range of -180 to 180. |\n\n**Example** *(Example usage of getNauticalDawnStartDateTimeUtc)*\n```js\n// returns \"2025-01-18T06:37:36.892Z\"\ngetNauticalDawnStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\n```\n**Example** *(Example usage of getNauticalDawnStartDateTimeUtc)*\n```js\n// returns \"The sun's altitude does not drop to -12° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\ngetNauticalDawnStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\n```\n**Example** *(Example usage of getNauticalDawnStartDateTimeUtc)*\n```js\n// returns \"The sun's altitude does not rise to -12° on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\"\ngetNauticalDawnStartDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\n```\n* * *\n\n\n## getAstronomicalDawnEndDateTimeUtc(date, latitude, longitude) ⇒ string\nGets the end of astronomical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\n\n**Kind**: global function\n**Returns**: string - A string representing the end of astronomical dawn date and time in UTC, expressed in an ISO 8601 format.\n\n| Param | Type | Description |\n| --- | --- | --- |\n| date | Date | A date instance. |\n| latitude | number | A latitude value in the range of -90 to 90. |\n| longitude | number | A longitude value in the range of -180 to 180. |\n\n**Example** *(Example usage of getAstronomicalDawnEndDateTimeUtc)*\n```js\n// returns \"2025-01-18T06:37:36.892Z\"\ngetAstronomicalDawnEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\n```\n**Example** *(Example usage of getAstronomicalDawnEndDateTimeUtc)*\n```js\n// returns \"The sun's altitude does not drop to -12° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\ngetAstronomicalDawnEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\n```\n* * *\n\n\n## getAstronomicalDawnStartDateTimeUtc(date, latitude, longitude) ⇒ string\nGets the start of astronomical dawn date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\n\n**Kind**: global function\n**Returns**: string - A string representing the start of astronomical dawn date and time in UTC, expressed in an ISO 8601 format.\n\n| Param | Type | Description |\n| --- | --- | --- |\n| date | Date | A date instance. |\n| latitude | number | A latitude value in the range of -90 to 90. |\n| longitude | number | A longitude value in the range of -180 to 180. |\n\n**Example** *(Example usage of getAstronomicalDawnStartDateTimeUtc)*\n```js\n// returns \"2025-01-18T05:57:45.720Z\"\ngetAstronomicalDawnStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\n```\n**Example** *(Example usage of getAstronomicalDawnStartDateTimeUtc)*\n```js\n// returns \"The sun's altitude does not drop to -18° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\ngetAstronomicalDawnStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\n```\n* * *\n\n\n## getAstronomicalDuskStartDateTimeUtc(date, latitude, longitude) ⇒ string\nGets the start of astronomical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\n\n**Kind**: global function\n**Returns**: string - A string representing the start of astronomical dusk date and time in UTC, expressed in an ISO 8601 format.\n\n| Param | Type | Description |\n| --- | --- | --- |\n| date | Date | A date instance. |\n| latitude | number | A latitude value in the range of -90 to 90. |\n| longitude | number | A longitude value in the range of -180 to 180. |\n\n**Example** *(Example usage of getAstronomicalDuskStartDateTimeUtc)*\n```js\n// returns \"2025-01-18T17:43:04.813Z\"\ngetAstronomicalDuskStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\n```\n**Example** *(Example usage of getAstronomicalDuskStartDateTimeUtc)*\n```js\n// returns \"The sun's altitude does not drop to -12° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\ngetAstronomicalDuskStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\n```\n* * *\n\n\n## getAstronomicalDuskEndDateTimeUtc(date, latitude, longitude) ⇒ string\nGets the end of astronomical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\n\n**Kind**: global function\n**Returns**: string - A string representing the end of astronomical dusk date and time in UTC, expressed in an ISO 8601 format.\n\n| Param | Type | Description |\n| --- | --- | --- |\n| date | Date | A date instance. |\n| latitude | number | A latitude value in the range of -90 to 90. |\n| longitude | number | A longitude value in the range of -180 to 180. |\n\n**Example** *(Example usage of getAstronomicalDuskEndDateTimeUtc)*\n```js\n// returns \"2025-01-18T18:22:55.985Z\"\ngetAstronomicalDuskEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\n```\n**Example** *(Example usage of getAstronomicalDuskEndDateTimeUtc)*\n```js\n// returns \"The sun's altitude does not drop to -18° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\ngetAstronomicalDuskEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\n```\n* * *\n\n\n## getNauticalDuskEndDateTimeUtc(date, latitude, longitude) ⇒ string\nGets the end of nautical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\n\n**Kind**: global function\n**Returns**: string - A string representing the end of nautical dusk date and time in UTC, expressed in an ISO 8601 format.\n\n| Param | Type | Description |\n| --- | --- | --- |\n| date | Date | A date instance. |\n| latitude | number | A latitude value in the range of -90 to 90. |\n| longitude | number | A longitude value in the range of -180 to 180. |\n\n**Example** *(Example usage of getNauticalDuskEndDateTimeUtc)*\n```js\n// returns \"2025-01-18T17:43:04.813Z\"\ngetNauticalDuskEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\n```\n**Example** *(Example usage of getNauticalDuskEndDateTimeUtc)*\n```js\n// returns The sun's altitude does not rise to -12° on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\ngetNauticalDuskEndDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\n```\n**Example** *(Example usage of getNauticalDuskEndDateTimeUtc)*\n```js\n// returns \"The sun's altitude does not drop to -12° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\ngetNauticalDuskEndDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\n```\n* * *\n\n\n## getNauticalDuskStartDateTimeUtc(date, latitude, longitude) ⇒ string\nGets the start of nautical dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\n\n**Kind**: global function\n**Returns**: string - A string representing the start of nautical dusk date and time in UTC, expressed in an ISO 8601 format.\n\n| Param | Type | Description |\n| --- | --- | --- |\n| date | Date | A date instance. |\n| latitude | number | A latitude value in the range of -90 to 90. |\n| longitude | number | A longitude value in the range of -180 to 180. |\n\n**Example** *(Example usage of getNauticalDuskStartDateTimeUtc)*\n```js\n// returns \"2025-01-18T17:01:25.924Z\"\ngetNauticalDuskStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\n```\n**Example** *(Example usage of getNauticalDuskStartDateTimeUtc)*\n```js\n// returns The sun's altitude does not rise to -6° on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\ngetNauticalDuskStartDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\n```\n**Example** *(Example usage of getNauticalDuskStartDateTimeUtc)*\n```js\n// returns \"The sun's altitude does not drop to -6° on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\ngetNauticalDuskStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\n```\n* * *\n\n\n## getCivilDuskEndDateTimeUtc(date, latitude, longitude) ⇒ string\nGets the end of civil dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\n\n**Kind**: global function\n**Returns**: string - A string representing the end of civil dusk date and time in UTC, expressed in an ISO 8601 format.\n\n| Param | Type | Description |\n| --- | --- | --- |\n| date | Date | A date instance. |\n| latitude | number | A latitude value in the range of -90 to 90. |\n| longitude | number | A longitude value in the range of -180 to 180. |\n\n**Example** *(Example usage of getCivilDuskEndDateTimeUtc)*\n```js\n// returns \"2025-01-18T17:01:25.924Z\"\ngetCivilDuskEndDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\n```\n**Example** *(Example usage of getCivilDuskEndDateTimeUtc)*\n```js\nreturns \"The sun's altitude does not drop to -6° on Wed Jun 18 2025 at latitude -75.100620 and longitude 123.354750\"\ngetCivilDuskEndDateTimeUtc(new Date(2002, 0, 27), -75.100620, 123.354750);\n```\n**Example** *(Example usage of getNauticalDuskEndDateTimeUtc)*\n```js\n// returns The sun's altitude does not rise to -6° on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\ngetCivilDuskEndDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\n```\n* * *\n\n\n## getCivilDuskStartDateTimeUtc(date, latitude, longitude) ⇒ string\nGets the start of civil dusk date and time in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.\n\n**Kind**: global function\n**Returns**: string - A string representing the start of civil dusk date and time in UTC, expressed in an ISO 8601 format.\n\n\n| Param | Type | Description |\n| --- | --- | --- |\n| date | Date | A date instance. |\n| latitude | number | A latitude value in the range of -90 to 90. |\n| longitude | number | A longitude value in the range of -180 to 180. |\n\n**Example** *(Example usage of getCivilDuskStartDateTimeUtc)*\n```js\n// returns \"2025-01-18T16:23:11.903Z\"\ngetCivilDuskStartDateTimeUtc(new Date(2025, 0, 18), 51.477730, -0.010150);\n```\n**Example** *(Example usage of getCivilDuskStartDateTimeUtc)*\n```js\nreturns \"The sun's altitude does not rise to -6° on Wed Jun 18 2025 at latitude -75.100620 and longitude 123.354750\"\ngetCivilDuskStartDateTimeUtc(new Date(2002, 0, 27), -75.100620, 123.354750);\n```\n**Example** *(Example usage of getCivilDuskStartDateTimeUtc)*\n```js\n// returns \"The sun is up all day on Sun Aug 02 2037 at latitude 71.98007 and longitude 102.47427\"\ngetCivilDuskStartDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);\n```\n**Example** *(Example usage of getCivilDuskStartDateTimeUtc)*\n```js\n// returns \"The sun is down all day on Thu Jan 01 2032 at latitude 89.525 and longitude -30.45\"\ngetCivilDuskStartDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);\n```","readmeFilename":"README.md"}