'Sun and Moon Times' Instructions
A brief set of Instructions for using our Sun and Moon Times application
The rest of this page takes you through the various set-up options for using 'Sun and Moon Times'.
It is common for J2ME™ enabled mobile phones to have a set of navigation keys, with a central 'select' of 'fire' key (it is important to note that some phones will use the 'Select' key for a central menu item, and so you will need to use the '5' key on those phones). Phones that do not have this will use the keys '8' and '2' for 'up' and 'down' navigation, '4' and '6' for 'left' and 'right', and '5' for 'select'. These Instructions will give the navigation directions and use the term 'select'.
For touch-screen phones, you can also use 'dragging' to replicate the actions of the 'up', 'down', 'left' and 'right' keys. 'Tapping' will replicate the action of pressing the 'select' key. You are able to directly 'tap' on a setting to highlight it and a second 'tap' will act to change the state for items such as check boxes, or to enable the editing of the various 'parts' of a setting. Because you are able to directly select another setting by touch, subsequent 'taps' on a partially highlighted setting
The first time you use 'Sun and Moon Times' on a phone, you will (after initialisation) be shown a brief description of the application. Like any other page, when there is not enough space to fit it all onto the screen at once, a scroll bar is shown, and you can scroll the page using 'up' and 'down'. This page can be dismissed using your phone's standard application menu system, and selecting 'OK' from it. You will then be shown the settings page. The next time you use the program, you will be shown the calculation results from the last set of saved settings.
How to set the desired settings on the settings page
There are several settings used in 'Sun and Moon Times' that are used to tell it when and where to calculate the rise and set times for.
Each of the individual settings will have up to 3 states:
When an item is in the highlighted state, you can use the 'up' and 'down' keys to move to the next or previous item.
There are three basic types of items on the settings page of 'Sun and Moon Times';
Setting the Date
The first item on the settings page is the date. Initially you cannot change this setting because the option to use the phone's clock is set. There is a checkbox further down the page that can change this option and allow you to set a custom date.
To begin editing the date, first make sure it is in the highlighted state, where the whole item appears with a green background, eg: 29-JUN-2008.
Now press 'select' to begin the editing. You will notice that the highlighted area changes so that just the first part of the date; the first digit of the day of the month is now highlighted, eg: 29-JUN-2008.
The value can be changed by using the 'up' or down 'keys'.
The day of month can only be set to a valid number, so because there are 30 days in June, if you were to change the '2' in the example above to a '3' (by pressing the 'up' key), the '9' will be turned into a '0' so that the day becomes '30'. If you were to then change the '3' into a '0' (pressing 'up' again will do this), because you cannot have a day '00', the '00' will become '01'.
You may find sometimes that in order to set the desired day, you will have to set the month or year first.
To change which part of the date you wish to edit, you can use the 'left' and 'right' keys. This changes which part of the date becomes highlighted:
Pressing 'left' when the first character is highlighted will move to the last digit of the year, and 'right' from there, will highlight the first digit of the day of the month. This wrapping effect is the same for all editable items.
When you have set the desired date, pressing the 'select' key returns to the state where the whole date is highlighted, allowing you to select another item. There is no need to do this if changing the date is all that you wish to do because selecting OK from the menu will begin the Sun and Moon calculation using whatever date is displayed on this page.
Finally, due to accuracy, there is a restriction placed on the year so that you cannot set it higher than 4000.
Setting the Time Zone
The second item on the settings page is the time zone. Editing of this item is accomplished in a similar way to the date, with 'select' used to enter and exit the editing state, 'up' and 'down' to change the values, and 'left' and 'right' to select which part to change.
'Sun and Moon Times' will only allow a recognised time zone to be used here. Some of time zones will allow a fraction of an hour to be set. When this is the case, the highlight can be moved beyond the second hour digit onto the fraction, or where none has been set, onto a blank space, eg: +10 .
When you select a location from the database that comes with this program, this item will be set to the time zone for that location.
The Summertime Checkbox
This checkbox has been included to allow the easy setting of daylight saving. It will effectively add an hour to whatever the time zone is set to when it is in the checked state (with a cross in the box).
This item has no editing mode, when it is highlighted, pressing 'select' will toggle its state. You can also use 'left' and 'right' here to do the same.
The Select Location Button
When this item is highlighted, pressing 'select' will show a screen from which you can select a location from the database of places that is included with 'Sun and Moon Times'. This is detailed later.
The Latitude and Longitude settings
The two coordinate settings are edited in a similar way to the date, with 'select' used to enter and exit from editing, 'left' and 'right' to navigate the individual parts, and 'up' and 'down' to alter them.
This program uses the degrees minutes and seconds format for setting the coordinates, so the degrees is limited to 90 or 180 (depending on if it is for Latitude or Longitude) and the minutes and seconds are limited to 59 (unless the degree part is 90 or 180, where both can only be zero).
You may notice that when editing one of the coordinate settings, the text above the 'Select Location' button may change. This is because the program will try to find a name for the location from its static database and if found, it will place it there.
If you use the database page to select a location, the coordinates will be set accordingly.
The Hemisphere settings
Below each of the coordinates are items to select the hemisphere for them, North or South and West or East.
These work in a similar on/off way to a checkbox, with 'select' used to change their state (the filled circle indicates the current state). Once again, 'left' and 'right' can also be used to change their state.
The Other Checkboxes
The first of these items will set or unset the option to use the date that your phone is set to. When set, you cannot alter the date since it is set from the phone's clock. The program will remember the last manually set date, and reset the date from the current day to this when the checkbox is unchecked. This way you will not lose an important date that has been set when changing this item.
Depending on how many colours your phone can display, there may be another checkbox. This simply shows or hides the background image. On phones with very few colours, this is not shown since the background picture is not displayed at all. Other phones that can only display a limited number of colours do have this item, but the program is set to not show the picture by default. This is because on those phones, the picture can interfere with the readability of the screen.
The Select Location Screen
At first look this page appears simple enough, a field for the countries, a field for the towns or cities within each country, and information on their coordinates and time zone. The way this page operates is probably best described using an example, so we will explain by showing how to select Oslo in Norway:
First you set the country so that you can access the cities in Norway.
When the country item is fully highlighted, you can use 'left' and 'right' to step through the countries (the cities field also works like this). Sometimes it may be easier to do this, but more often you will want to find a country by selecting and changing individual letters. For this example, we will start with the default country, which is Afghanistan, and explain this process.
First we press 'select' to highlight the 'A' of Afghanistan, eg: Afghanistan. We want to find the first country beginning with 'N'. This is Namibia. We do this by using 'up' or 'down' until the first letter changes to 'N'.
Once at Namibia, we want to find the first country beginning with 'No', In the database, this is Northern Ireland (in the database, the British isles has been split up into its main regions, Scotland, England, etc.). Press 'right' so that the first 'a' of Namibia becomes highlighted, eg: Namibia. Then use 'up' or 'down' to change this letter until it becomes an 'o', and the display shows something similar to this: Northern Ireland.
Next you want to move to the next letter that is going to be different between Northern Ireland and Norway; the 't' in Northern Ireland. The next country in the database that begins with 'Nor' is in fact Norway, so highlight the 't' by pressing 'right' a few times: Northern Ireland, and then press 'up' to reveal Norway.
The country is now set and you can press select again now, which allows you to move to the town/city field by using 'up' or 'down'.
Oslo is the only city in the database that begins with 'O' for Norway , so all you have to do here is press 'select' when the whole item is highlighted, so that the first letter of the first city in the database for Norway is highlighted and then use 'up' or 'down' until that letter becomes an 'O'.
You have now chosen a location. To use this for the profile, select 'ok' from the menu. By selecting 'Cancel', you will return to the profile display without changing the location.
So in essence, to find a location in the database, search by changing the first letter in the current place that will not be the same for our desired place. When there is no other place that begins with the same letters, up and down will simply have no effect.
You should note that as well as splitting the UK into regions, the database has the States in the USA classed as 'countries' for ease of navigation. They are stored as US Alaska etc.
Performing a search using the web
This method of setting the location relies on the ability to connect to the Internet and this depends on factors such as signal strength and Operator Contracts. Network Operators will also charge in a variety of ways for the transfer of data in this manor.
To begin, you are shown a screen where the search is defined. There are two parts to a search. Selecting a specific country, and providing the search text. Selecting the country operates in a similar way to using the static database to select a country and city, so please refer to that section for instructions. The difference here is that when 'searching by letter', the 'Any Country' record is not available. The search text is entered using your phone's standard text input interface, which is activated when the search text is highlighted and the 'select' key is pressed.
Once you have set up your search, the 'ok' menu item will start the search and its progress will be shown to you. To save bandwidth, only the first 50 matches are retrieved from geonames.org.
After a search has completed, (or if you chose to pick the location from the stored results of the last search) you will see a page showing the number of matching locations, and which of these you are currently viewing. You can step through the results one-by-one using the 'left' or 'right' keys. It is also possible to jump to a specific number by editing the 'match' item in very much the same manor as other controls in this program are edited.
To complete the search, you may choose 'ok' from the menu and use the location currently displayed , or 'cancel' to abandon the process of searching for a location.
Navigating the Results Pages
Our final section describes what actions can be done on our results display.
There is one page for the Sun information and one for the Moon. Switching between them can be done via the menu or by using the 'left', 'right' or 'select' keys to switch pages.
There are also controls that allow you to view the information for the next and previous dates, those are '#' to advance the date by a day, '*' to go back a day, and '0' to return to whatever date was set by the settings page.