US Naval Observatory

App · 14 actions

Astronomy data from the US Naval Observatory: sunrise, sunset, twilight and moon times for any place and day, moon phases, equinoxes and solstices, solar eclipses, sidereal time, Julian dates, Easter and other holy days, US daylight saving dates and celestial navigation. No account or API key required.

Actions

ActionWhat it does
Convert date to Julian dateTurn a calendar date and time into its Julian date, the day count astronomers use.
Convert Julian date to dateTurn a Julian date into its calendar date, time (UT1) and day of the week.
Get a solar eclipse at a placeSee how a solar eclipse looks from a place: whether it is visible, how much of the Sun is covered, how long it lasts, and when each stage happens with the Sun's position in the sky.
Get celestial navigation dataGet the almanac data for working out a position from sextant sights: for an assumed position and time, each body above the horizon with its declination, Greenwich hour angle, computed altitude and azimuth, and the altitude corrections.
Get equinoxes and solsticesGet the exact times of a year's equinoxes and solstices (the starts of the seasons) and of Earth's perihelion and aphelion (closest to and farthest from the Sun).
Get sidereal timeGet the sidereal (star) time at Greenwich and at a place, mean and apparent, for a moment or a series of moments: what telescopes use to point at the sky.
Get sun and moon timesGet sunrise, sunset, solar noon, dawn and dusk (civil twilight), moonrise, moonset and the Moon's phase and illumination for one day at a place, in local time.
Get US daylight saving time datesGet the dates US daylight saving time begins and ends in a year (1967 onwards).
List Easter and Christian holy daysList the dates of Ash Wednesday, Palm Sunday, Good Friday, Easter, Ascension Day, Pentecost, Trinity Sunday and the First Sunday of Advent in a year (Western churches).
List Islamic holy daysList the dates of the Islamic New Year and the first days of Ramadan and Shawwal that fall in a year, with each one's Islamic calendar year.
List Jewish holy daysList the dates of Rosh Hashanah, Yom Kippur, the first day of Sukkot, Hanukkah, the first day of Passover and Shavuot that fall in a year, with each one's Hebrew calendar year.
List moon phases for a yearList every new moon, first quarter, full moon and last quarter in a calendar year, with their exact times.
List solar eclipses in a yearList the solar eclipses of a year, with their dates and kinds (total, annular, hybrid or partial).
List upcoming moon phasesList the next new moons, first quarters, full moons and last quarters from a date, with their exact times.

Convert date to Julian date

Turn a calendar date and time into its Julian date, the day count astronomers use. Works from 4713 BC to AD 9999; dates before 15 October 1582 are read in the Julian calendar.

Inputs

Datedate_valuedateRequired
The calendar date.
Timetime_of_daytime
The time of day in UT1 (within a second of UTC). Defaults to midnight.
Eraeratext
AD or BC. Defaults to AD.One of: AD (AD (CE)), BC (BC (BCE)).

Outputs

datetext
The calendar date, YYYY-MM-DD (Julian calendar before 15 October 1582)
daynumber
Day of the month
eratext
AD or BC
isotext
The moment as ISO 8601, for AD years 1 to 9999
julian_datenumber
The Julian date
monthnumber
Month
summarytext
One line describing the result
timetext
Time of day (UT1)
yearnumber
Year
Example output
{
  "date": "2026-10-19",
  "day": 19,
  "era": "AD",
  "iso": "2026-10-19T14:30:15Z",
  "julian_date": 2461333.10434,
  "month": 10,
  "summary": "2026-10-19 AD 14:30:15.0 UT1 is Julian date 2461333.104340.",
  "time": "14:30:15.0",
  "year": 2026
}

Convert Julian date to date

Turn a Julian date into its calendar date, time (UT1) and day of the week. Dates before 15 October 1582 come back in the Julian calendar.

Inputs

Julian datejulian_datenumberRequired
The Julian date, 0 to 5373484.5, such as 2451545.0.From 0 to 5373484.5.

Outputs

datetext
The calendar date, YYYY-MM-DD (Julian calendar before 15 October 1582)
daynumber
Day of the month
day_of_weektext
Day of the week
eratext
AD or BC
isotext
The moment as ISO 8601, for AD years 1 to 9999
julian_datenumber
The Julian date
monthnumber
Month
summarytext
One line describing the result
timetext
Time of day (UT1)
yearnumber
Year
Example output
{
  "date": "2026-10-19",
  "day": 19,
  "day_of_week": "Monday",
  "era": "AD",
  "iso": "2026-10-19T14:30:15Z",
  "julian_date": 2461333.10434,
  "month": 10,
  "summary": "Julian date 2461333.104340 is Monday 2026-10-19 AD, 14:30:15.0 UT1.",
  "time": "14:30:15.0",
  "year": 2026
}

Get a solar eclipse at a place

See how a solar eclipse looks from a place: whether it is visible, how much of the Sun is covered, how long it lasts, and when each stage happens with the Sun's position in the sky.

Inputs

Eclipse datedate_valuedateRequired
The date of the eclipse (UTC), from 'List solar eclipses in a year'.
LatitudelatitudenumberRequired
The place's latitude in degrees, -90 to 90 (north is positive).From -90 to 90.
LongitudelongitudenumberRequired
The place's longitude in degrees, -180 to 180 (east is positive).From -180 to 180.
Height (m)height_mnumber
The place's height above sea level in metres. Defaults to 0.From -90 to 10999.
Time zonetime_zonetext
Also give times in this time zone, daylight saving included, such as America/New_York. Leave blank for UTC only.

Outputs

datetext
The date asked about
delta_t_secondsnumber
Delta T used in the calculation, seconds
descriptiontext
What is seen, e.g. Sun in Partial Eclipse at this Location
durationtext
How long the eclipse lasts here, e.g. 1h 39m 41.4s
duration_of_totalitytext
How long totality lasts here, where it is total
eventtext
The eclipse, e.g. Solar Eclipse of 2026 Aug. 12
magnitudenumber
Fraction of the Sun's diameter covered at greatest eclipse
obscuration_percentnumber
Percent of the Sun's area covered at greatest eclipse
stageslist
Each stage of the eclipse, in order
summarytext
One line describing the result
visibletrue/false
False when the eclipse cannot be seen from the place
Example output
{
  "date": "2026-08-12",
  "delta_t_seconds": 74.0,
  "description": "Sun in Partial Eclipse at this Location",
  "duration": "1h 39m 41.4s",
  "duration_of_totality": null,
  "event": "Solar Eclipse of 2026 Aug. 12",
  "magnitude": 0.999,
  "obscuration_percent": 100.0,
  "stages": [
    {
      "iso_utc": "2026-08-12T18:32:18Z",
      "local_date": "2026-08-12",
      "local_iso": "2026-08-12T20:32:18+02:00",
      "local_time": "20:32",
      "position_angle_deg": null,
      "stage": "Maximum Eclipse",
      "sun_altitude_deg": 7.2,
      "sun_azimuth_deg": 283.3,
      "time_utc": "18:32:18.1",
      "vertex_angle_deg": null
    }
  ],
  "summary": "Partial solar eclipse seen from here on 2026-08-12: 100% of the Sun covered, greatest at 20:32.",
  "visible": true
}

Get celestial navigation data

Get the almanac data for working out a position from sextant sights: for an assumed position and time, each body above the horizon with its declination, Greenwich hour angle, computed altitude and azimuth, and the altitude corrections.

Inputs

Assumed latitudelatitudenumberRequired
The assumed position's latitude, -90 to 90 (north is positive).From -90 to 90.
Assumed longitudelongitudenumberRequired
The assumed position's longitude, -180 to 180 (east is positive).From -180 to 180.
Date and timemomentdate and time
The moment, in UTC. Defaults to now.

Outputs

aries_gha_degnumber
Greenwich hour angle of the first point of Aries, for star sights, degrees
bodieslist
The bodies above the horizon, as the almanac lists them
countnumber
How many are in this result
moon_illumination_percentnumber
How much of the Moon is lit, percent
moon_phasetext
The Moon's phase
summarytext
One line describing the result
time_ut1text
The moment used (UT1), YYYY-MM-DD HH:MM
Example output
{
  "aries_gha_deg": 73.595179,
  "bodies": [
    {
      "azimuth_deg": 147.946171,
      "computed_altitude_deg": 27.215128,
      "corrections_apply": true,
      "declination_deg": -19.19974,
      "greenwich_hour_angle_deg": 45.305811,
      "name": "Moon",
      "navigational_star_number": null,
      "parallax_deg": 0.818153,
      "refraction_deg": -0.033525,
      "semidiameter_deg": 0.251254,
      "total_correction_deg": 1.035882
    }
  ],
  "count": 1,
  "moon_illumination_percent": 62.0,
  "moon_phase": "Waxing Gibbous",
  "summary": "27 bodies above the horizon at 2026-10-19 22:00 UT1; the Moon is waxing gibbous, 62% lit.",
  "time_ut1": "2026-10-19 22:00"
}

Get equinoxes and solstices

Get the exact times of a year's equinoxes and solstices (the starts of the seasons) and of Earth's perihelion and aphelion (closest to and farthest from the Sun).

Inputs

Yearyearnumber
1700 to 2100. Defaults to this year.From 1700 to 2100.
Time zonetime_zonetext
Also give times in this time zone, daylight saving included, such as America/New_York. Leave blank for UTC only.

Outputs

apheliontext
Aphelion: Earth farthest from the Sun
countnumber
How many are in this result
december_solsticetext
The December solstice
eventslist
The six events, in order
june_solsticetext
The June solstice
march_equinoxtext
The March equinox (local ISO 8601 with a time zone, else UTC)
periheliontext
Perihelion: Earth closest to the Sun
september_equinoxtext
The September equinox
summarytext
One line describing the result
yearnumber
The year asked about
Example output
{
  "aphelion": "2026-07-06T13:30:00-04:00",
  "count": 1,
  "december_solstice": "2026-12-21T15:50:00-05:00",
  "events": [
    {
      "date": "2026-03-20",
      "event": "March equinox",
      "iso_utc": "2026-03-20T14:46:00Z",
      "local_date": "2026-03-20",
      "local_iso": "2026-03-20T10:46:00-04:00",
      "local_time": "10:46",
      "time_utc": "14:46"
    }
  ],
  "june_solstice": "2026-06-21T04:24:00-04:00",
  "march_equinox": "2026-03-20T10:46:00-04:00",
  "perihelion": "2026-01-03T12:15:00-05:00",
  "september_equinox": "2026-09-22T20:05:00-04:00",
  "summary": "6 events in 2026; the March equinox is on 2026-03-20.",
  "year": 2026
}

Get sidereal time

Get the sidereal (star) time at Greenwich and at a place, mean and apparent, for a moment or a series of moments: what telescopes use to point at the sky.

Inputs

LatitudelatitudenumberRequired
The place's latitude in degrees, -90 to 90 (north is positive).From -90 to 90.
LongitudelongitudenumberRequired
The place's longitude in degrees, -180 to 180 (east is positive).From -180 to 180.
Date and timemomentdate and time
The moment, in UTC, between 1800 and 2050. Defaults to now.
How many timesrepetitionsnumber
For a series, how many moments, 1 to 500. Defaults to 1.From 1 to 500.
Everyintervalnumber
For a series, the gap between moments, with 'Interval unit'.From 1 to 9999.
Interval unitinterval_unittext
Minutes, hours or days. Defaults to hours.One of: minutes, hours, days.

Outputs

countnumber
How many are in this result
summarytext
One line describing the result
timeslist
One row per moment
truncatedtrue/false
True when USNO cut the series short at the end of its range
Example output
{
  "count": 1,
  "summary": "At 2026-10-19 21:00:00.0 UT1: local mean sidereal time 17:45:16.0005, Greenwich 22:53:23.2005.",
  "times": [
    {
      "date": "2026-10-19",
      "equation_of_equinoxes_seconds": 0.504,
      "greenwich_apparent": "22:53:23.7045",
      "greenwich_mean": "22:53:23.2005",
      "greenwich_mean_hours": 22.889778,
      "local_apparent": "17:45:16.5045",
      "local_mean": "17:45:16.0005",
      "local_mean_hours": 17.754445,
      "ut1_time": "21:00:00.0"
    }
  ],
  "truncated": false
}

Get sun and moon times

Get sunrise, sunset, solar noon, dawn and dusk (civil twilight), moonrise, moonset and the Moon's phase and illumination for one day at a place, in local time.

Inputs

Datedate_valuedateRequired
The day, between 1700 and 2100.
LatitudelatitudenumberRequired
The place's latitude in degrees, -90 to 90 (north is positive).From -90 to 90.
LongitudelongitudenumberRequired
The place's longitude in degrees, -180 to 180 (east is positive).From -180 to 180.
Time zonetime_zonetext
Give times in this time zone, daylight saving included, such as America/New_York. Leave blank for UTC.
UTC offset (hours)utc_offset_hoursnumber
Instead of a time zone, a fixed offset from UTC, -12 to 14 (e.g. -5 or 5.5).From -12 to 14.

Outputs

civil_twilight_beginstext
Dawn: when civil twilight begins (HH:MM, local)
civil_twilight_endstext
Dusk: when civil twilight ends (HH:MM, local)
closest_primary_phasetext
The nearest new, first quarter, full or last quarter moon
closest_primary_phase_datetext
Its date
closest_primary_phase_timetext
Its time (HH:MM, local)
datetext
The date, YYYY-MM-DD
day_lengthtext
Time between sunrise and sunset, e.g. 11h 02m
day_of_weektext
Day of the week
is_daylight_savingtrue/false
True when the time zone given is on daylight saving time that day
moon_always_downtrue/false
True when the Moon never rises that day
moon_always_uptrue/false
True when the Moon never sets that day
moon_eventslist
Every lunar event of the day, in order
moon_illumination_percentnumber
How much of the Moon is lit at local noon, percent
moon_phasetext
The Moon's phase, e.g. Waxing Gibbous
moon_transittext
When the Moon is highest (HH:MM, local)
moonrisetext
Moonrise (HH:MM, local); empty if the Moon does not rise that day
moonsettext
Moonset (HH:MM, local); empty if the Moon does not set that day
solar_noontext
When the Sun is highest (HH:MM, local)
summarytext
One line describing the result
sun_always_downtrue/false
True when the Sun never rises that day (polar night)
sun_always_uptrue/false
True when the Sun never sets that day (polar day)
sun_eventslist
Every solar event of the day, in order
sunrisetext
Sunrise (HH:MM, local)
sunsettext
Sunset (HH:MM, local)
utc_offsettext
The offset the times are in, e.g. -04:00
Example output
{
  "civil_twilight_begins": "06:55",
  "civil_twilight_ends": "18:51",
  "closest_primary_phase": "First Quarter",
  "closest_primary_phase_date": "2026-10-18",
  "closest_primary_phase_time": "12:12",
  "date": "2026-10-19",
  "day_length": "11h 02m",
  "day_of_week": "Monday",
  "is_daylight_saving": true,
  "moon_always_down": false,
  "moon_always_up": false,
  "moon_events": [
    {
      "phenomenon": "Rise",
      "time": "15:09"
    }
  ],
  "moon_illumination_percent": 60.0,
  "moon_phase": "Waxing Gibbous",
  "moon_transit": "20:11",
  "moonrise": "15:09",
  "moonset": "00:17",
  "solar_noon": "12:53",
  "summary": "2026-10-19 (UTC-04:00): Sunrise 07:22, sunset 18:24; moon waxing gibbous (60% lit).",
  "sun_always_down": false,
  "sun_always_up": false,
  "sun_events": [
    {
      "phenomenon": "Rise",
      "time": "07:22"
    },
    {
      "phenomenon": "Set",
      "time": "18:24"
    }
  ],
  "sunrise": "07:22",
  "sunset": "18:24",
  "utc_offset": "-04:00"
}

Get US daylight saving time dates

Get the dates US daylight saving time begins and ends in a year (1967 onwards).

Inputs

Yearyearnumber
1967 to 9999. Defaults to this year.From 1967 to 9999.

Outputs

endstext
The day it ends, YYYY-MM-DD
startstext
The day daylight saving time begins, YYYY-MM-DD
summarytext
One line describing the result
yearnumber
The year asked about
Example output
{
  "ends": "2026-11-01",
  "starts": "2026-03-08",
  "summary": "US daylight saving time in 2026 runs from Sunday 2026-03-08 to Sunday 2026-11-01.",
  "year": 2026
}

List Easter and Christian holy days

List the dates of Ash Wednesday, Palm Sunday, Good Friday, Easter, Ascension Day, Pentecost, Trinity Sunday and the First Sunday of Advent in a year (Western churches).

Inputs

Yearyearnumber
1583 to 9999. Defaults to this year.From 1583 to 9999.

Outputs

countnumber
How many are in this result
eastertext
Easter Sunday, YYYY-MM-DD
observanceslist
The holy days, in date order
summarytext
One line describing the result
yearnumber
The year asked about
Example output
{
  "count": 1,
  "easter": "2026-04-05",
  "observances": [
    {
      "date": "2026-04-05",
      "day_of_week": "Sunday",
      "observance": "Easter"
    }
  ],
  "summary": "Easter 2026 is on Sunday 2026-04-05.",
  "year": 2026
}

List Islamic holy days

List the dates of the Islamic New Year and the first days of Ramadan and Shawwal that fall in a year, with each one's Islamic calendar year. These are calculated dates; local observance can differ by a day.

Inputs

Yearyearnumber
622 to 9999. Defaults to this year.From 622 to 9999.

Outputs

countnumber
How many are in this result
observanceslist
The holy days, in date order
summarytext
One line describing the result
yearnumber
The year asked about
Example output
{
  "count": 1,
  "observances": [
    {
      "calendar_year": 1447,
      "date": "2026-02-18",
      "day_of_week": "Wednesday",
      "observance": "First Day of Ramadan"
    }
  ],
  "summary": "3 Islamic observances in 2026; Ramadan 1447 begins 2026-02-18.",
  "year": 2026
}

List Jewish holy days

List the dates of Rosh Hashanah, Yom Kippur, the first day of Sukkot, Hanukkah, the first day of Passover and Shavuot that fall in a year, with each one's Hebrew calendar year. Holidays begin at sunset the evening before.

Inputs

Yearyearnumber
360 to 9999. Defaults to this year.From 360 to 9999.

Outputs

countnumber
How many are in this result
observanceslist
The holy days, in date order
summarytext
One line describing the result
yearnumber
The year asked about
Example output
{
  "count": 1,
  "observances": [
    {
      "calendar_year": 5787,
      "date": "2026-09-12",
      "day_of_week": "Saturday",
      "observance": "Rosh Hashanah (Jewish New Year)"
    }
  ],
  "summary": "6 Jewish holy days in 2026; Rosh Hashanah 5787 begins 2026-09-12.",
  "year": 2026
}

List moon phases for a year

List every new moon, first quarter, full moon and last quarter in a calendar year, with their exact times.

Inputs

Yearyearnumber
1700 to 2100. Defaults to this year.From 1700 to 2100.
Time zonetime_zonetext
Also give times in this time zone, daylight saving included, such as America/New_York. Leave blank for UTC only.

Outputs

countnumber
How many are in this result
phaseslist
The phases, in order
summarytext
One line describing the result
yearnumber
The year asked about
Example output
{
  "count": 1,
  "phases": [
    {
      "date": "2026-10-26",
      "iso_utc": "2026-10-26T04:12:00Z",
      "local_date": "2026-10-26",
      "local_iso": "2026-10-26T00:12:00-04:00",
      "local_time": "00:12",
      "phase": "Full Moon",
      "time_utc": "04:12"
    }
  ],
  "summary": "50 moon phases in 2026, including 13 full moons.",
  "year": 2026
}

List solar eclipses in a year

List the solar eclipses of a year, with their dates and kinds (total, annular, hybrid or partial).

Inputs

Yearyearnumber
1800 to 2050. Defaults to this year.From 1800 to 2050.

Outputs

countnumber
How many are in this result
eclipseslist
The eclipses, in date order
summarytext
One line describing the result
yearnumber
The year asked about
Example output
{
  "count": 1,
  "eclipses": [
    {
      "date": "2026-08-12",
      "day_of_week": "Wednesday",
      "event": "Total Solar Eclipse of 12 August 2026",
      "kind": "total"
    }
  ],
  "summary": "1 solar eclipse in 2026: Total Solar Eclipse of 12 August 2026.",
  "year": 2026
}

List upcoming moon phases

List the next new moons, first quarters, full moons and last quarters from a date, with their exact times.

Inputs

Fromstart_datedate
The first day to look from. Defaults to today.
How manycountnumber
How many phases to list, 1 to 99. Defaults to 4 (one cycle).From 1 to 99.
Time zonetime_zonetext
Also give times in this time zone, daylight saving included, such as America/New_York. Leave blank for UTC only.

Outputs

countnumber
How many are in this result
phaseslist
The phases, in order
summarytext
One line describing the result
Example output
{
  "count": 1,
  "phases": [
    {
      "date": "2026-10-26",
      "iso_utc": "2026-10-26T04:12:00Z",
      "local_date": "2026-10-26",
      "local_iso": "2026-10-26T00:12:00-04:00",
      "local_time": "00:12",
      "phase": "Full Moon",
      "time_utc": "04:12"
    }
  ],
  "summary": "1 moon phase; next: Full Moon on 2026-10-26 at 04:12 UTC."
}

On this page