home | login | new account | gallery | info | help
Moon rise and set time calculator
 
This gadget provides some up-to-date information on the times of rising and setting of the Moon. The intention is to provide some fun and useful information. This is an example of our exposing aspects of our calculation engine as services via the web. Lunar rising and setting calculations are particularly heinous, as the moon moves quickly through the sky and calculation of its position at any instant are fairly computationally intensive.

Has this stopped working for you?

This is possibly the result of an iGoogle bug. This is currently being discussed in the iGoogle developer forum here.

 

Configuring the gadget

The gadget has a number of configuration parameters for you to play with. These will be described in detail below.

  • Latitude and longitude
    To calculate rise and set times, the gadget needs to know where you are. This is done by specifying your latitude and longitude. There are many tools and pages on the web to help you do this, such as this tool, or this list. Failing that, you could use Google Earth to find your location and read the longitude and latitude off of the screen.
     
    The gadget takes latitude and longitude in any reasonable form. For longitude, East of Greenwich is positive and West of Greenwich is negative. For latitude, North of the Equator is positive, and South of the Equator is negative. Examples of valid longitude values are "153.15", "153 9 E", "153:09:00 East". Examples of valid latitude values are "-27.1", "27:06:00 S", "-27 6", "-27 06 South".
  • Number of hours to show
    By default, the gadget will show all rise and set events within ±24 hours of "right now". You can change that window to be as small as ±6 hours, or as large as ± 48 hours, by using this parameter.
  • Display current info about the moon
    If checked, the gadget will display some extra information about the moon below the rise and set events. This includes whether the moon is above or below the horizon, the constellation it's currently in, how much of the disc is lit up (e.g., "disc is 90% illuminated"), and a description of the phase (e.g., "first quarter" or "waning crescent").
  • Brief description of where to see the moon in the night sky
    If you've checked the "Display current info about the moon" box above, you can check this to also see a brief description of where to see the moon in the night sky.
  • Angular size of the moon
    If you've checked the "Display current info about the moon" box above, you can check this to also see the angular size of the moon.
  • Angular distance from the sun
    If you've checked the "Display current info about the moon" box above, you can check this to also see the angular distance between the moon and the sun.
  • Do not show absolute rise and set times
    The problem with putting a time on a computer screen is that you have to get the user's timezone right, and get it right for every user every time. You can deftly sidestep this whole issue by checking this box. If you do, the times of rise and set events will only include the time to or from each event; e.g., "in 3 hrs 38 mins".
  • Show rise and set times in UTC
    This is my preferred option, but that's just me. Times of rising and setting are always displayed in Coordinated Universal Time (UTC), which is basically the same as Greenwich Mean Time (GMT). This doesn't change with timezone or with Daylight Savings Time.
  • Display times in this timezone
    If you leave the two boxes above unchecked, the gadget will display times in your timezone of choice. Please enter your timezone offset (in hours) here; e.g., for Brisbane, Australia, one would enter "10" because Brisbane is 10 hours ahead of UTC. You can leave this blank and the gadget will guess your approximate timezone (based on your longitude), but this may very well be wrong by an hour or so. You can always check the fine print at the bottom of the gadget to see which timezone it's using. If it is guessing incorrectly, please put the appropriate number in here. If you have Daylight Savings Time at any point in the year, then you'll definitely need to put a number in here sooner or later. It's pretty easy to see if the gadget is working right for you... When it says, for example, that a particular event will occur "in 20 mins, at 03:55 PM" it's easy enough to check whether or not it will be 3:55 PM in 20 minutes.
  • Display your local times in AM/PM format
    If you are displaying times in your local timezone, check this box to display them as AM or PM. Leaving the box unchecked will use a 24-hr clock.

 

Accessing the gadget

There are a number of ways in which you can use the gadget. These are described below.

  • Use the Google Gadget version on iGoogle.
    You can place the gadget on your iGoogle page. This will give you the added flexibility of being able to select the information which is shown. To add this gadget to your iGoogle page, please click here: Add to Google
  • Use the Google Gadget version on your own pages.
    You can place the gadget on webpages of your own. Please click here to make this happen: Add to Google
    If you are placing the gadget on your own web pages, you might like to customise the gadget's title to indicate the location for which the rise and set events are calculated.

What is displayed

The times and dates of rise and set events which occur within the configured "time window" are displayed. This "window" defaults to ±24 hours of now, but can be changed using the configuration options of the gadget (described above).

Rise and set events which occured in the past are displayed against a grey background. Events which will occur in the future are displayed against a white background.

Below this, you can optionally display some current info about the moon, including whether it is above or below the horizon, the constellation it is currently moving through, a general description of the moon's visibility in the night sky, the percentage illumination, a description of the phase (e.g., "waxing crescent"), the angular size of the moon and the angular distance between the moon and the sun.

 

Who uses it?

Who uses this gadget? Please click here for a representation in Google Earth of the locations for which moon rise and set data have been sought during the past day. This is updated daily. The locations shown are approximate.

Future developments

It's up to you! Please get in touch if you have any requests or suggestions for additional features.