{"id":13760587,"url":"https://github.com/ryanseys/lune","last_synced_at":"2025-04-07T07:05:38.962Z","repository":{"id":14172316,"uuid":"16878388","full_name":"ryanseys/lune","owner":"ryanseys","description":":new_moon: Lune.js — Calculate the phases of the moon","archived":false,"fork":false,"pushed_at":"2023-04-14T22:50:13.000Z","size":66,"stargazers_count":120,"open_issues_count":4,"forks_count":17,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-03-31T06:03:34.233Z","etag":null,"topics":["javascript","lune","moon","phase"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ryanseys.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2014-02-16T04:35:41.000Z","updated_at":"2025-03-27T12:44:49.000Z","dependencies_parsed_at":"2024-01-02T23:30:26.357Z","dependency_job_id":null,"html_url":"https://github.com/ryanseys/lune","commit_stats":{"total_commits":71,"total_committers":6,"mean_commits":"11.833333333333334","dds":0.5352112676056338,"last_synced_commit":"f0498f0ee6fd41f2f02e2abe954b3614b21d0828"},"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ryanseys%2Flune","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ryanseys%2Flune/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ryanseys%2Flune/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ryanseys%2Flune/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ryanseys","download_url":"https://codeload.github.com/ryanseys/lune/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247608150,"owners_count":20965952,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["javascript","lune","moon","phase"],"created_at":"2024-08-03T13:01:13.513Z","updated_at":"2025-04-07T07:05:38.945Z","avatar_url":"https://github.com/ryanseys.png","language":"JavaScript","readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg height=\"150\" width=\"150\"  src=\"http://ryanseys.com/img/moon.png\"/\u003e\n\u003c/div\u003e\n\n# Lune [![Build Status](https://travis-ci.org/ryanseys/lune.svg?branch=0.2.0)](https://travis-ci.org/ryanseys/lune)\n\nLune.js — calculate the phases of the moon.\n\n## Installation\n\n```sh   \nnpm install lune\n```\n\n## Usage\n\n### To calculate *current* phase information:\n\n```javascript\nvar lune = require('lune')\nvar current_phase = lune.phase()\nconsole.log(current_phase)\n```\n\n#### Output:\n\n```javascript\n{ phase: 0.3435664924086369,\n  illuminated: 0.7773055846628978,\n  age: 10.1457207715498,\n  distance: 386679.7626047325,\n  angular_diameter: 0.5150467579643708,\n  sun_distance: 148929846.0148686,\n  sun_angular_diameter: 0.5354732715700135 }\n```\n\n### To calculate phase information for a *specific* date:\n\n```javascript\nvar lune = require('lune')\nvar some_date = new Date('2014-02-17T00:00-0500')\nvar some_date_phase = lune.phase(some_date)\nconsole.log(some_date_phase)\n```\n\n#### Output:\n\n```javascript\n{ phase: 0.568204641580006,\n  illuminated: 0.9547862069882863,\n  age: 16.779417556565985,\n  distance: 396084.54752883443,\n  angular_diameter: 0.5028172882344054,\n  sun_distance: 147822484.14817196,\n  sun_angular_diameter: 0.5394845874736046 }\n```\n\n### To search for recent phases around the *current* date:\n\n```javascript\nvar lune = require('lune')\nvar recent_phases = lune.phase_hunt()\nconsole.log(recent_phases)\n```\n\n#### Output:\n\n```javascript\n{ new_date: Tue Mar 08 2016 20:55:59 GMT-0500 (EST),\n  q1_date: Tue Mar 15 2016 13:04:23 GMT-0400 (EDT),\n  full_date: Wed Mar 23 2016 08:01:38 GMT-0400 (EDT),\n  q3_date: Thu Mar 31 2016 11:18:41 GMT-0400 (EDT),\n  nextnew_date: Thu Apr 07 2016 07:25:20 GMT-0400 (EDT) }\n```\n\n### To search for recent phases around a *specific* date:\n\n```javascript\nvar lune = require('lune')\nvar some_date = new Date('2014-02-17T00:00-0500')\nvar some_date_phase = lune.phase_hunt(some_date)\nconsole.log(some_date_phase)\n```\n\n#### Output:\n\n```javascript\n{ new_date: Thu Jan 30 2014 16:40:35 GMT-0500 (EST),\n  q1_date: Thu Feb 06 2014 14:22:33 GMT-0500 (EST),\n  full_date: Fri Feb 14 2014 18:54:46 GMT-0500 (EST),\n  q3_date: Sat Feb 22 2014 12:16:56 GMT-0500 (EST),\n  nextnew_date: Sat Mar 01 2014 03:02:41 GMT-0500 (EST) }\n```\n\n### To search for phases between two dates:\n\n```javascript\n// print all full moons in the first quarter of 2014\nvar lune = require('lune')\nvar phase_list = lune.phase_range(\n  new Date('2014-01-01T00:00:00.000Z'),\n  new Date('2014-03-31T23:59:59.999Z'),\n  lune.PHASE_FULL\n)\nconsole.log(phase_list)\n```\n\nPossible values for the third argument of the function are:\n\n*   `lune.PHASE_NEW` (new moon)\n*   `lune.PHASE_FIRST` (first quarter moon)\n*   `lune.PHASE_FULL` (full moon)\n*   `lune.PHASE_LAST` (third or last quarter moon)\n\n#### Output:\n\n```javascript\n[ Wed Jan 01 2014 06:15:02 GMT-0500 (EST),\n  Thu Jan 30 2014 16:40:35 GMT-0500 (EST),\n  Sat Mar 01 2014 03:02:41 GMT-0500 (EST),\n  Sun Mar 30 2014 14:48:06 GMT-0400 (EDT) ]\n```\n\n## Image\n\nMoon image graciously provided by [Mike DiLuigi.](https://www.behance.net/mikediluigi)\n\n## Contributing\n\nPlease feel free to contribute to this project! :) Pull requests and feature requests welcome!\n\n## License\n\nSee LICENSE file in this repo\n","funding_links":[],"categories":["Misc"],"sub_categories":["Other"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fryanseys%2Flune","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fryanseys%2Flune","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fryanseys%2Flune/lists"}